|
|
# FlockLab Command Line Tool
|
|
|
|
|
|
:point_right: Remark: this command line tool is deprecated. We recommend to use the [flocklab-tools](Man/flocklab-tools) instead (python based).
|
|
|
|
|
|
For automating FlockLab tests, a command line tool based on _cURL_ is provided:
|
|
|
|
|
|
**Download**: <a href="https://gitlab.ethz.ch/tec/public/flocklab/flocklab/-/tree/master/tools%2Fshell-tool">Command Line Tool</a>
|
|
|
|
|
|
## Setting it up
|
|
|
A config file with the login credentials for FlockLab (same as for web interface) needs to exist in the user's home directory in order to use the command line tool:
|
|
|
|
|
|
Config file in `~/.flocklabauth`:
|
|
|
```
|
|
|
USER=<your username>
|
|
|
PASSWORD=<your password>
|
|
|
```
|
|
|
|
|
|
## Usage
|
|
|
```
|
|
|
usage: ./flocklab [OPTION]
|
|
|
|
|
|
OPTIONS:
|
|
|
-v <testconfig.xml>: validate test config
|
|
|
-c <testconfig.xml>: create / schedule new test
|
|
|
-a <testid>: abort test
|
|
|
-d <testid>: delete test
|
|
|
-g <testid>: get test results (via https)
|
|
|
-f <testid>: fetch test results (via webdav)
|
|
|
-o <platform>: get a list of the currently available (online) observers
|
|
|
-p: get a list of the available platforms
|
|
|
-h: display help
|
|
|
|
|
|
For the commands -g and -f, the download directory can be specified as an additional argument.
|
|
|
```
|
|
|
|
|
|
## Adjust settings
|
|
|
Some additional settings can be adjusted in the script itself:
|
|
|
```
|
|
|
DEST=${3:-/tmp/flocklab} # destination directory (if not specified, the default is used: /tmp/flocklab)
|
|
|
EXTRACT=1 # extract results?
|
|
|
TESTCONFIG=0 # also download XML test config?
|
|
|
``` |