Scaleout Edge CLI
The Scaleout Edge Command-Line Interface (CLI) provides tools for managing projects, clients, compute packages, and training sessions from the terminal. It is designed to simplify common operations such as starting clients, uploading models, monitoring training progress, and interacting with the Scaleout Edge control plane.
scaleout client
Commands to generate client configs, list or fetch clients, and start a client instance.
Usage
scaleout client [OPTIONS] COMMAND [ARGS]...
get
Get client.
Returns
result: client with given id
Usage
scaleout client get [OPTIONS]
Options
- -id, --id <id>
Required Client ID
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
get-config
Generate client config file(s).
The generated client config file(s) contain the following properties:
client_id: uuid
discover_host: controller, get from context file
name: client name (set prefix with options)
refresh_token: unique refresh token for client
token: unique access token for client
Usage
scaleout client get-config [OPTIONS]
Options
- -n, --name <name>
Required Client name, will be used as prefix for client names. The client name will be suffixed with an index.
- -g, --group <group>
number of clients to generate in a bulk
- -t, --token <token>
Authentication admin token
- -P, --port <port>
Port of api-server (api)
- -H, --host <host>
Hostname of api-server (api)
- --protocol <protocol>
Communication protocol of api-server (api)
- -p, --path <path>
Path to where client yaml file will be located
list
List clients.
Returns
count: number of clients
result: list of clients
Usage
scaleout client list [OPTIONS]
Options
- --n_max <n_max>
Number of items to list
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
start
Start client.
Usage
scaleout client start [OPTIONS]
Options
- -u, --api-url <api_url>
Hostname for scaleout api.
- -p, --api-port <api_port>
Port for discovery services (reducer).
- --token <token>
Authentication token (refresh token). Client will automatically exchange this for an access token.
- -n, --name <name>
- -i, --client-id <client_id>
- --local-package
Enable local compute package
- --log-level <log_level>
Set log level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
- Options:
DEBUG | INFO | WARNING | ERROR | CRITICAL
- -c, --preferred-combiner <preferred_combiner>
name of the preferred combiner
- --combiner <combiner>
Skip combiner assignment from discover service and attach directly to combiner host.
- --combiner-port <combiner_port>
Combiner port, need to be used with –combiner
- -va, --validator <validator>
- -tr, --trainer <trainer>
- -hp, --helper_type <helper_type>
- -in, --init <init>
Set to a filename to (re)init client from file state.
- --dispatcher
Use the dispatcher client instead of the importer client.
- --managed-env
Use the managed environment for the client. Requires an active virtual environment residing in cwd.
scaleout combiner
Commands to list and inspect combiners.
Usage
scaleout combiner [OPTIONS] COMMAND [ARGS]...
get
Get combiner.
Returns
result: combiner with given id
Usage
scaleout combiner get [OPTIONS]
Options
- -id, --id <id>
Required Combiner ID
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
list
List combiners.
Returns
count: number of combiners
result: list of combiners
Usage
scaleout combiner list [OPTIONS]
Options
- --n_max <n_max>
Number of items to list
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
set-public-hostname
Set the public host of a combiner.
Usage
scaleout combiner set-public-hostname [OPTIONS] PUBLIC_HOSTNAME
Options
- -id, --id <id>
Required Combiner ID
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
Arguments
- PUBLIC_HOSTNAME
Required argument
scaleout model
Commands to list models, get a model by ID, and set/upload the active model.
Usage
scaleout model [OPTIONS] COMMAND [ARGS]...
get
Get model by id.
Usage
scaleout model get [OPTIONS]
Options
- -id, --id <id>
Required Model ID
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
list
List models.
Usage
scaleout model list [OPTIONS]
Options
- --n_max <n_max>
Number of items to list
- -s, --session_id <session_id>
models in session with given session id
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
set-active
Set the initial model and upload to model repository.
Usage
scaleout model set-active [OPTIONS]
Options
- -f, --file <file>
Required Path to the model file
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
scaleout package
Commands to create, list/inspect, and upload compute packages.
Usage
scaleout package [OPTIONS] COMMAND [ARGS]...
create
Create compute package.
Make a tar.gz archive of folder given by –path. The archive will be named –name and saved in –output.
Usage
scaleout package create [OPTIONS]
Options
- -p, --path <path>
Required Path to package directory containing scaleout.yaml
- -n, --name <name>
Name of package tarball
- -o, --output <output>
Output directory for the generated tarball
get
Return a package with given id.
Returns
result: package with given id
Usage
scaleout package get [OPTIONS]
Options
- -id, --id <id>
Required Package ID
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
list
Return a list of packages.
Returns
count: number of packages
result: list of packages
Usage
scaleout package list [OPTIONS]
Options
- --n_max <n_max>
Number of items to list
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
set-active
Set a package as active.
Returns
result: package with given id
Usage
scaleout package set-active [OPTIONS]
Options
- -p, --protocol <protocol>
Communication protocol of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -P, --port <port>
Port of controller (api)
- -t, --token <token>
Authentication token
- -f, --file <file>
Required Path to the package file
- -d, --description <description>
Description of the package
- -n, --name <name>
Required Name of the package
- --helper <helper>
Helper to use for the package
scaleout round
Commands to list and inspect rounds.
Usage
scaleout round [OPTIONS] COMMAND [ARGS]...
get
Get round.
Returns
result: round with given id
Usage
scaleout round get [OPTIONS]
Options
- -t, --token <token>
Authentication token
- -o, --output <output_format>
Output in JSON format
- -id, --id <id>
Required Round ID
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
list
List rounds.
Returns
count: number of rounds
result: list of rounds
Usage
scaleout round list [OPTIONS]
Options
- --n_max <n_max>
Number of items to list
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -s, --session_id <session_id>
Rounds in session with given session id
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
scaleout run
Commands to execute tasks defined in scaleout.yaml.
Usage
scaleout run [OPTIONS] COMMAND [ARGS]...
build
Execute ‘build’ entrypoint in scaleout.yaml.
- param ctx:
- param path:
Path to folder containing scaleout.yaml
- param keep_venv:
Flag to keep the created virtual environment after build
- param dispatch:
Flag to indicate that the build should be run in an automatically created venv
- param output:
Output directory for the generated tarball
- type path:
str
Usage
scaleout run build [OPTIONS]
Options
- -p, --path <path>
Required Path to package directory containing scaleout.yaml
- -v, --keep-venv
Use flag to keep the python virtual environment (python_env in scaleout.yaml)
- -d, --dispatch
Use flag to indicate that the build should be run in an automatically created venv
- -o, --output <output>
Output directory for the generated tarball (default: current directory)
install
Install a package environment into active environment.
- param ctx:
- param path:
Path to folder containing scaleout.yaml
- type path:
str
Usage
scaleout run install [OPTIONS]
Options
- -p, --path <path>
Required Path to package directory containing scaleout.yaml
scaleout session
Commands to list sessions, inspect a session, and start a new training session.
Usage
scaleout session [OPTIONS] COMMAND [ARGS]...
get
Get session by id.
Usage
scaleout session get [OPTIONS]
Options
- -id, --id <id>
Required Session ID
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
list
List sessions.
Usage
scaleout session list [OPTIONS]
Options
- --n_max <n_max>
Number of items to list
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
start
Start a new session.
Usage
scaleout session start [OPTIONS]
Options
- -rc, --requested_clients <requested_clients>
The requested number of clients
- -mc, --min_clients <min_clients>
The minimum number of clients required
- -hp, --helper <helper>
The helper type to use
- -v, --validate <validate>
Whether to validate the model after each round
- -d, --delete_models <delete_models>
Whether to delete models after each round at combiner (save storage)
- -rb, --round_buffer_size <round_buffer_size>
The round buffer size to use
- -r, --rounds <rounds>
The number of rounds to perform
- -rt, --round_timeout <round_timeout>
The round timeout to use in seconds
- -m, --model_id <model_id>
The id of the initial model
- -ak, --aggregator_kwargs <aggregator_kwargs>
Aggregator keyword arguments
- -a, --aggregator <aggregator>
The aggregator plugin to use
- -n, --name <name>
Name of the session
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
stop
Stop a session.
Usage
scaleout session stop [OPTIONS]
Options
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
scaleout status
Commands to list and get status entries.
Usage
scaleout status [OPTIONS] COMMAND [ARGS]...
get
Get status.
Returns
result: status with given id
Usage
scaleout status get [OPTIONS]
Options
- -id, --id <id>
Required Status ID
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
list
List statuses.
Returns
count: number of statuses
result: list of statuses
Usage
scaleout status list [OPTIONS]
Options
- --n_max <n_max>
Number of items to list
- -s, --session_id <session_id>
statuses with given session id
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
scaleout validation
Commands to list and get validation results.
Usage
scaleout validation [OPTIONS] COMMAND [ARGS]...
get
Get validation.
Returns
result: validation with given id
Usage
scaleout validation get [OPTIONS]
Options
- -id, --id <id>
Required validation ID
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
list
List validations.
Returns
count: number of validations
result: list of validations
Usage
scaleout validation list [OPTIONS]
Options
- --n_max <n_max>
Number of items to list
- -s, --session_id <session_id>
validations in session with given session id
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
start
Start a validation for given session ID and model ID.
Usage
scaleout validation start [OPTIONS]
Options
- --model-id <model_id>
Required Model ID
- --session-id <session_id>
Required Session ID
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
scaleout
Scaleout command-line interface for starting clients and interacting with API resources such as models, sessions and more.
Usage
scaleout [OPTIONS] COMMAND [ARGS]...
Options
- --version
Show the version and exit.
Use ‘scaleout COMMAND –help’ for detailed help on a command.
client
Commands to generate client configs, list or fetch clients, and start a client instance.
Usage
scaleout client [OPTIONS] COMMAND [ARGS]...
get
Get client.
Returns
result: client with given id
Usage
scaleout client get [OPTIONS]
Options
- -id, --id <id>
Required Client ID
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
get-config
Generate client config file(s).
The generated client config file(s) contain the following properties:
client_id: uuid
discover_host: controller, get from context file
name: client name (set prefix with options)
refresh_token: unique refresh token for client
token: unique access token for client
Usage
scaleout client get-config [OPTIONS]
Options
- -n, --name <name>
Required Client name, will be used as prefix for client names. The client name will be suffixed with an index.
- -g, --group <group>
number of clients to generate in a bulk
- -t, --token <token>
Authentication admin token
- -P, --port <port>
Port of api-server (api)
- -H, --host <host>
Hostname of api-server (api)
- --protocol <protocol>
Communication protocol of api-server (api)
- -p, --path <path>
Path to where client yaml file will be located
list
List clients.
Returns
count: number of clients
result: list of clients
Usage
scaleout client list [OPTIONS]
Options
- --n_max <n_max>
Number of items to list
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
start
Start client.
Usage
scaleout client start [OPTIONS]
Options
- -u, --api-url <api_url>
Hostname for scaleout api.
- -p, --api-port <api_port>
Port for discovery services (reducer).
- --token <token>
Authentication token (refresh token). Client will automatically exchange this for an access token.
- -n, --name <name>
- -i, --client-id <client_id>
- --local-package
Enable local compute package
- --log-level <log_level>
Set log level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
- Options:
DEBUG | INFO | WARNING | ERROR | CRITICAL
- -c, --preferred-combiner <preferred_combiner>
name of the preferred combiner
- --combiner <combiner>
Skip combiner assignment from discover service and attach directly to combiner host.
- --combiner-port <combiner_port>
Combiner port, need to be used with –combiner
- -va, --validator <validator>
- -tr, --trainer <trainer>
- -hp, --helper_type <helper_type>
- -in, --init <init>
Set to a filename to (re)init client from file state.
- --dispatcher
Use the dispatcher client instead of the importer client.
- --managed-env
Use the managed environment for the client. Requires an active virtual environment residing in cwd.
combiner
Commands to list and inspect combiners.
Usage
scaleout combiner [OPTIONS] COMMAND [ARGS]...
get
Get combiner.
Returns
result: combiner with given id
Usage
scaleout combiner get [OPTIONS]
Options
- -id, --id <id>
Required Combiner ID
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
list
List combiners.
Returns
count: number of combiners
result: list of combiners
Usage
scaleout combiner list [OPTIONS]
Options
- --n_max <n_max>
Number of items to list
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
set-public-hostname
Set the public host of a combiner.
Usage
scaleout combiner set-public-hostname [OPTIONS] PUBLIC_HOSTNAME
Options
- -id, --id <id>
Required Combiner ID
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
Arguments
- PUBLIC_HOSTNAME
Required argument
context
Manage CLI contexts.
- Examples:
scaleout context # List all contexts scaleout context production # Switch to context named ‘production’ scaleout context 2 # Switch to context at index 2
Usage
scaleout context [OPTIONS] [SELECTOR]
Arguments
- SELECTOR
Optional argument
login
Usage
scaleout login [OPTIONS] INSTANCE_URL
Arguments
- INSTANCE_URL
Required argument
model
Commands to list models, get a model by ID, and set/upload the active model.
Usage
scaleout model [OPTIONS] COMMAND [ARGS]...
get
Get model by id.
Usage
scaleout model get [OPTIONS]
Options
- -id, --id <id>
Required Model ID
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
list
List models.
Usage
scaleout model list [OPTIONS]
Options
- --n_max <n_max>
Number of items to list
- -s, --session_id <session_id>
models in session with given session id
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
set-active
Set the initial model and upload to model repository.
Usage
scaleout model set-active [OPTIONS]
Options
- -f, --file <file>
Required Path to the model file
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
package
Commands to create, list/inspect, and upload compute packages.
Usage
scaleout package [OPTIONS] COMMAND [ARGS]...
create
Create compute package.
Make a tar.gz archive of folder given by –path. The archive will be named –name and saved in –output.
Usage
scaleout package create [OPTIONS]
Options
- -p, --path <path>
Required Path to package directory containing scaleout.yaml
- -n, --name <name>
Name of package tarball
- -o, --output <output>
Output directory for the generated tarball
get
Return a package with given id.
Returns
result: package with given id
Usage
scaleout package get [OPTIONS]
Options
- -id, --id <id>
Required Package ID
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
list
Return a list of packages.
Returns
count: number of packages
result: list of packages
Usage
scaleout package list [OPTIONS]
Options
- --n_max <n_max>
Number of items to list
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
set-active
Set a package as active.
Returns
result: package with given id
Usage
scaleout package set-active [OPTIONS]
Options
- -p, --protocol <protocol>
Communication protocol of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -P, --port <port>
Port of controller (api)
- -t, --token <token>
Authentication token
- -f, --file <file>
Required Path to the package file
- -d, --description <description>
Description of the package
- -n, --name <name>
Required Name of the package
- --helper <helper>
Helper to use for the package
remove
Remove a CLI context.
- Examples:
scaleout remove production # Remove context named ‘production’ scaleout remove 2 # Remove context at index 2 scaleout remove production -y # Remove without confirmation
Usage
scaleout remove [OPTIONS] SELECTOR
Options
- -y, --yes
Skip confirmation prompt
Arguments
- SELECTOR
Required argument
round
Commands to list and inspect rounds.
Usage
scaleout round [OPTIONS] COMMAND [ARGS]...
get
Get round.
Returns
result: round with given id
Usage
scaleout round get [OPTIONS]
Options
- -t, --token <token>
Authentication token
- -o, --output <output_format>
Output in JSON format
- -id, --id <id>
Required Round ID
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
list
List rounds.
Returns
count: number of rounds
result: list of rounds
Usage
scaleout round list [OPTIONS]
Options
- --n_max <n_max>
Number of items to list
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -s, --session_id <session_id>
Rounds in session with given session id
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
run
Commands to execute tasks defined in scaleout.yaml.
Usage
scaleout run [OPTIONS] COMMAND [ARGS]...
build
Execute ‘build’ entrypoint in scaleout.yaml.
- param ctx:
- param path:
Path to folder containing scaleout.yaml
- param keep_venv:
Flag to keep the created virtual environment after build
- param dispatch:
Flag to indicate that the build should be run in an automatically created venv
- param output:
Output directory for the generated tarball
- type path:
str
Usage
scaleout run build [OPTIONS]
Options
- -p, --path <path>
Required Path to package directory containing scaleout.yaml
- -v, --keep-venv
Use flag to keep the python virtual environment (python_env in scaleout.yaml)
- -d, --dispatch
Use flag to indicate that the build should be run in an automatically created venv
- -o, --output <output>
Output directory for the generated tarball (default: current directory)
install
Install a package environment into active environment.
- param ctx:
- param path:
Path to folder containing scaleout.yaml
- type path:
str
Usage
scaleout run install [OPTIONS]
Options
- -p, --path <path>
Required Path to package directory containing scaleout.yaml
session
Commands to list sessions, inspect a session, and start a new training session.
Usage
scaleout session [OPTIONS] COMMAND [ARGS]...
get
Get session by id.
Usage
scaleout session get [OPTIONS]
Options
- -id, --id <id>
Required Session ID
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
list
List sessions.
Usage
scaleout session list [OPTIONS]
Options
- --n_max <n_max>
Number of items to list
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
start
Start a new session.
Usage
scaleout session start [OPTIONS]
Options
- -rc, --requested_clients <requested_clients>
The requested number of clients
- -mc, --min_clients <min_clients>
The minimum number of clients required
- -hp, --helper <helper>
The helper type to use
- -v, --validate <validate>
Whether to validate the model after each round
- -d, --delete_models <delete_models>
Whether to delete models after each round at combiner (save storage)
- -rb, --round_buffer_size <round_buffer_size>
The round buffer size to use
- -r, --rounds <rounds>
The number of rounds to perform
- -rt, --round_timeout <round_timeout>
The round timeout to use in seconds
- -m, --model_id <model_id>
The id of the initial model
- -ak, --aggregator_kwargs <aggregator_kwargs>
Aggregator keyword arguments
- -a, --aggregator <aggregator>
The aggregator plugin to use
- -n, --name <name>
Name of the session
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
stop
Stop a session.
Usage
scaleout session stop [OPTIONS]
Options
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
status
Commands to list and get status entries.
Usage
scaleout status [OPTIONS] COMMAND [ARGS]...
get
Get status.
Returns
result: status with given id
Usage
scaleout status get [OPTIONS]
Options
- -id, --id <id>
Required Status ID
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
list
List statuses.
Returns
count: number of statuses
result: list of statuses
Usage
scaleout status list [OPTIONS]
Options
- --n_max <n_max>
Number of items to list
- -s, --session_id <session_id>
statuses with given session id
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
validation
Commands to list and get validation results.
Usage
scaleout validation [OPTIONS] COMMAND [ARGS]...
get
Get validation.
Returns
result: validation with given id
Usage
scaleout validation get [OPTIONS]
Options
- -id, --id <id>
Required validation ID
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
list
List validations.
Returns
count: number of validations
result: list of validations
Usage
scaleout validation list [OPTIONS]
Options
- --n_max <n_max>
Number of items to list
- -s, --session_id <session_id>
validations in session with given session id
- -o, --output <output_format>
Output in JSON format
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)
start
Start a validation for given session ID and model ID.
Usage
scaleout validation start [OPTIONS]
Options
- --model-id <model_id>
Required Model ID
- --session-id <session_id>
Required Session ID
- -t, --token <token>
Authentication token
- -P, --port <port>
Port of controller (api)
- -H, --host <host>
Hostname of controller (api)
- -p, --protocol <protocol>
Communication protocol of controller (api)