Skip to content

GitLab

Commit 9bf5c7a7 authored by Shufan Huang's avatar Shufan Huang Committed by chicm-ms
Browse files

Fix bug in NNICTLDOC and add several examples (#961) 

* update doc

* update example
parent 4deeeae1
Hide whitespace changes
Inline Side-by-side
Showing with 158 additions and 46 deletions
docs/en_US/NNICTLDOC.md
View file @ 9bf5c7a7
...@@ -25,7 +25,8 @@ nnictl support commands: ...@@ -25,7 +25,8 @@ nnictl support commands:
### Manage an experiment ### Manage an experiment
<a name="create"></a> <a name="create"></a>
* __nnictl create__
![](https://placehold.it/15/1589F0/000000?text=+) `nnictl create`
* Description * Description
...@@ -47,13 +48,34 @@ nnictl support commands: ...@@ -47,13 +48,34 @@ nnictl support commands:
|--port, -p|False| |the port of restful server| |--port, -p|False| |the port of restful server|
|--debug, -d|False||set debug mode| |--debug, -d|False||set debug mode|
* Examples
> create a new experiment with the default port: 8080
```bash
nnictl create --config nni/examples/trials/mnist/config.yml
```
> create a new experiment with specified port 8088
```bash
nnictl create --config nni/examples/trials/mnist/config.yml --port 8088
```
> create a new experiment with specified port 8088 and debug mode
```bash
nnictl create --config nni/examples/trials/mnist/config.yml --port 8088 --debug
```
Note: Note:
``` ```
Debug mode will disable version check function in Trialkeeper. Debug mode will disable version check function in Trialkeeper.
``` ```
<a name="resume"></a> <a name="resume"></a>
* __nnictl resume__
![](https://placehold.it/15/1589F0/000000?text=+) `nnictl resume`
* Description * Description
...@@ -69,12 +91,21 @@ nnictl support commands: ...@@ -69,12 +91,21 @@ nnictl support commands:
|Name, shorthand|Required|Default|Description| |Name, shorthand|Required|Default|Description|
|------|------|------ |------| |------|------|------ |------|
|id| False| |The id of the experiment you want to resume| |id| True| |The id of the experiment you want to resume|
|--port, -p| False| |Rest port of the experiment you want to resume| |--port, -p| False| |Rest port of the experiment you want to resume|
|--debug, -d|False||set debug mode| |--debug, -d|False||set debug mode|
* Example
> resume an experiment with specified port 8088
```bash
nnictl resume [experiment_id] --port 8088
```
<a name="stop"></a> <a name="stop"></a>
* __nnictl stop__
![](https://placehold.it/15/1589F0/000000?text=+) `nnictl stop`
* Description * Description
...@@ -85,18 +116,33 @@ nnictl support commands: ...@@ -85,18 +116,33 @@ nnictl support commands:
```bash ```bash
nnictl stop [id] nnictl stop [id]
``` ```
* Detail
1. If there is an id specified, and the id matches the running experiment, nnictl will stop the corresponding experiment, or will print error message. * Details & Examples
2. If there is no id specified, and there is an experiment running, stop the running experiment, or print error message.
3. If the id ends with *, nnictl will stop all experiments whose ids matchs the regular. 1. If there is no id specified, and there is an experiment running, stop the running experiment, or print error message.
4. If the id does not exist but match the prefix of an experiment id, nnictl will stop the matched experiment.
5. If the id does not exist but match multiple prefix of the experiment ids, nnictl will give id information. ```bash
6. Users could use 'nnictl stop all' to stop all experiments. nnictl stop
```
2. If there is an id specified, and the id matches the running experiment, nnictl will stop the corresponding experiment, or will print error message.
```bash
nnictl stop [experiment_id]
```
3. Users could use 'nnictl stop all' to stop all experiments.
```bash
nnictl stop all
```
4. If the id ends with *, nnictl will stop all experiments whose ids matchs the regular.
5. If the id does not exist but match the prefix of an experiment id, nnictl will stop the matched experiment.
6. If the id does not exist but match multiple prefix of the experiment ids, nnictl will give id information.
<a name="update"></a> <a name="update"></a>
* __nnictl update__
![](https://placehold.it/15/1589F0/000000?text=+) `nnictl update`
* __nnictl update searchspace__ * __nnictl update searchspace__
* Description * Description
...@@ -111,10 +157,18 @@ nnictl support commands: ...@@ -111,10 +157,18 @@ nnictl support commands:
* Options * Options
|Name, shorthand|Required|Default|Description| |Name, shorthand|Required|Default|Description|
|------|------|------ |------| |------|------|------ |------|
|id| False| |ID of the experiment you want to set| |id| False| |ID of the experiment you want to set|
|--filename, -f| True| |the file storing your new search space| |--filename, -f| True| |the file storing your new search space|
* Example
`update experiment's new search space with file dir 'examples/trials/mnist/search_space.json'`
```bash
nnictl update searchspace [experiment_id] --file examples/trials/mnist/search_space.json
```
* __nnictl update concurrency__ * __nnictl update concurrency__
* Description * Description
...@@ -129,10 +183,18 @@ nnictl support commands: ...@@ -129,10 +183,18 @@ nnictl support commands:
* Options * Options
|Name, shorthand|Required|Default|Description| |Name, shorthand|Required|Default|Description|
|------|------|------ |------| |------|------|------ |------|
|id| False| |ID of the experiment you want to set| |id| False| |ID of the experiment you want to set|
|--value, -v| True| |the number of allowed concurrent trials| |--value, -v| True| |the number of allowed concurrent trials|
* Example
> update experiment's concurrency
```bash
nnictl update concurrency [experiment_id] --value [concurrency_number]
```
* __nnictl update duration__ * __nnictl update duration__
...@@ -145,12 +207,21 @@ nnictl support commands: ...@@ -145,12 +207,21 @@ nnictl support commands:
```bash ```bash
nnictl update duration [OPTIONS] nnictl update duration [OPTIONS]
``` ```
* Options * Options
|Name, shorthand|Required|Default|Description| |Name, shorthand|Required|Default|Description|
|------|------|------ |------| |------|------|------ |------|
|id| False| |ID of the experiment you want to set| |id| False| |ID of the experiment you want to set|
|--value, -v| True| |the experiment duration will be NUMBER seconds. SUFFIX may be 's' for seconds (the default), 'm' for minutes, 'h' for hours or 'd' for days.| |--value, -v| True| |the experiment duration will be NUMBER seconds. SUFFIX may be 's' for seconds (the default), 'm' for minutes, 'h' for hours or 'd' for days.|
* Example
> update experiment's duration
```bash
nnictl update duration [experiment_id] --value [duration]
```
* __nnictl update trialnum__ * __nnictl update trialnum__
* Description * Description
...@@ -165,13 +236,22 @@ nnictl support commands: ...@@ -165,13 +236,22 @@ nnictl support commands:
* Options * Options
|Name, shorthand|Required|Default|Description| |Name, shorthand|Required|Default|Description|
|------|------|------ |------| |------|------|------ |------|
|id| False| |ID of the experiment you want to set| |id| False| |ID of the experiment you want to set|
|--value, -v| True| |the new number of maxtrialnum you want to set| |--value, -v| True| |the new number of maxtrialnum you want to set|
* Example
> update experiment's trial num
```bash
nnictl update trialnum --id [experiment_id] --value [trial_num]
```
<a name="trial"></a> <a name="trial"></a>
* __nnictl trial__
![](https://placehold.it/15/1589F0/000000?text=+) `nnictl trial`
* __nnictl trial ls__ * __nnictl trial ls__
...@@ -187,9 +267,9 @@ nnictl support commands: ...@@ -187,9 +267,9 @@ nnictl support commands:
* Options * Options
|Name, shorthand|Required|Default|Description| |Name, shorthand|Required|Default|Description|
|------|------|------ |------| |------|------|------ |------|
|id| False| |ID of the experiment you want to set| |id| False| |ID of the experiment you want to set|
* __nnictl trial kill__ * __nnictl trial kill__
...@@ -203,15 +283,24 @@ nnictl support commands: ...@@ -203,15 +283,24 @@ nnictl support commands:
nnictl trial kill [OPTIONS] nnictl trial kill [OPTIONS]
``` ```
* Options * Options
|Name, shorthand|Required|Default|Description| |Name, shorthand|Required|Default|Description|
|------|------|------ |------| |------|------|------ |------|
|id| False| |ID of the trial to be killed| |id| False| |ID of the trial to be killed|
|--experiment, -E| True| |Experiment id of the trial| |--experiment, -E| True| |Experiment id of the trial|
* Example
> kill trail job
```bash
nnictl trial [trial_id] --vexperiment [experiment_id]
```
<a name="top"></a> <a name="top"></a>
* __nnictl top__
![](https://placehold.it/15/1589F0/000000?text=+) `nnictl top`
* Description * Description
...@@ -231,7 +320,8 @@ nnictl support commands: ...@@ -231,7 +320,8 @@ nnictl support commands:
|--time, -t| False| |The interval to update the experiment status, the unit of time is second, and the default value is 3 second.| |--time, -t| False| |The interval to update the experiment status, the unit of time is second, and the default value is 3 second.|
<a name="experiment"></a> <a name="experiment"></a>
### Manage experiment information
![](https://placehold.it/15/1589F0/000000?text=+) `Manage experiment information`
* __nnictl experiment show__ * __nnictl experiment show__
...@@ -282,7 +372,8 @@ nnictl support commands: ...@@ -282,7 +372,8 @@ nnictl support commands:
``` ```
<a name="config"></a> <a name="config"></a>
* __nnictl config show__
![](https://placehold.it/15/1589F0/000000?text=+) `nnictl config show`
* Description * Description
...@@ -295,7 +386,8 @@ nnictl support commands: ...@@ -295,7 +386,8 @@ nnictl support commands:
``` ```
<a name="log"></a> <a name="log"></a>
### Manage log
![](https://placehold.it/15/1589F0/000000?text=+) `Manage log`
* __nnictl log stdout__ * __nnictl log stdout__
...@@ -318,6 +410,14 @@ nnictl support commands: ...@@ -318,6 +410,14 @@ nnictl support commands:
|--tail, -t| False| |show tail lines of stdout| |--tail, -t| False| |show tail lines of stdout|
|--path, -p| False| |show the path of stdout file| |--path, -p| False| |show the path of stdout file|
* Example
> Show the tail of stdout log content
```bash
nnictl log stdout [experiment_id] --tail [lines_number]
```
* __nnictl log stderr__ * __nnictl log stderr__
* Description * Description
...@@ -358,12 +458,14 @@ nnictl support commands: ...@@ -358,12 +458,14 @@ nnictl support commands:
|--experiment, -E| False| |Experiment ID of the trial, required when id is not empty.| |--experiment, -E| False| |Experiment ID of the trial, required when id is not empty.|
<a name="webui"></a> <a name="webui"></a>
### Manage webui
![](https://placehold.it/15/1589F0/000000?text=+) `Manage webui`
* __nnictl webui url__ * __nnictl webui url__
<a name="tensorboard"></a> <a name="tensorboard"></a>
### Manage tensorboard
![](https://placehold.it/15/1589F0/000000?text=+) `Manage tensorboard`
* __nnictl tensorboard start__ * __nnictl tensorboard start__
...@@ -411,7 +513,8 @@ nnictl support commands: ...@@ -411,7 +513,8 @@ nnictl support commands:
|id| False| |ID of the experiment you want to set| |id| False| |ID of the experiment you want to set|
<a name="package"></a> <a name="package"></a>
### Manage package
![](https://placehold.it/15/1589F0/000000?text=+) `Manage package`
* __nnictl package install__ * __nnictl package install__
* Description * Description
...@@ -430,6 +533,14 @@ nnictl support commands: ...@@ -430,6 +533,14 @@ nnictl support commands:
|------|------|------ |------| |------|------|------ |------|
|--name| True| |The name of package to be installed| |--name| True| |The name of package to be installed|
* Example
> Install the packages needed in tuner SMAC
```bash
nnictl package install --name=SMAC
```
* __nnictl package show__ * __nnictl package show__
* Description * Description
...@@ -443,7 +554,8 @@ nnictl support commands: ...@@ -443,7 +554,8 @@ nnictl support commands:
``` ```
<a name="version"></a> <a name="version"></a>
### Check NNI version
![](https://placehold.it/15/1589F0/000000?text=+) `Check NNI version`
* __nnictl --version__ * __nnictl --version__
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment