RCE features a command console.
This command console is accessible via the command console view in RCE’s desktop mode or via SSH.
Commands consist of one or two tokens e.g. "im" for one token and "im list" for two tokens.
Beside the user commands that are documented in RCE’s User Guide, there are developer commands supporting additional developer features.
A list of all developer commands is shown in the following section.
Commands are structured in groups. A command group is defined by the first token of a command. This means, that commands like "im info" and "im list" are in the same command group. Some command groups like "stats" consist only of a single command. For each group there is a table explaining all the related commands.
| Command | Description |
|---|---|
dev <command group> [--details|-d] [--asciidoc] | Alias of "help --dev". <command group>: (optional) the command group of which the commands should be shown |
| Command | Description |
|---|---|
dm create-test-data [--prefix <prefix>] [--workflows <workflow number>] [--iterations <iterations number>] [--allowedDeviation <deviation>] [--smallfiles|-s] [--bigfiles|-b] | Creates test data in the database. [--prefix <prefix>]: prefix for created workflows |
| Command | Description |
|---|---|
dummy | Prints a test message. |
| Command | Description |
|---|---|
force-crash <delay> | "kills" the instance without proper shutdown at <delay> milliseconds after the command is executed. <delay>: delay in milliseconds |
| Command | Description |
|---|---|
im configure <instances…> [--set-rce-version <version>] [--apply-template <template name>] [--set-name <name>] [--set-comment <comment>] [--set-relay-option <(is relay)>] [--set-workflow-host-option <(is worflow host)>] [--set-custom-node-id <node id>] [--set-tempdir-path <tempdir>] [--add-server-port <id> <host> <port>] [--add-connection <id> <host> <port> <auto-connect>] [--remove-connection <id>] [--configure-ssh-server <ip> <port>] [--add-ssh-account <username> <role> <enable ssh-account> <password>] [--remove-ssh-account <username>] [--set-ip-filter-option <(has ip-filter)>] [--enable-im-ssh-access <port>] [--set-request-timeout <r timeout>] [--set-forwarding-timeout <f timeout>] [--add-allowed-inbound-ip <ip>] [--remove-allowed-inbound-ip <ip>] [--add-ssh-connection <name> <display name> <host> <port> <login name>] [--remove-ssh-connection <name>] [--add-uplink-connection <ip> <hostname> <port> <client id> <is gateway> <connect on startup> <auto-retry> <username> <passwrod keyword> <password>] [--remove-uplink-connection <id>] [--publish-component <name>] [--unpublish-component <name>] [--set-background-monitoring <id> <interval>] [--reset] [--wipe] [--disable-ssh-server] | Configures the configuration.json file of the specified RCE instance(s). <instances…>: list of instances to manage |
im dispose <instances…> | Disposes the specified instance meaning deletion of the profile directory. <instances…>: list of instances to manage |
im info | Shows additional information. |
im install <install policy: if-missing|force-download|force-reinstall> <major version> <installation id> [--timeout <timeout>] | Downloads and installs a new RCE installation. <install policy: if-missing|force-download|force-reinstall>: specify install policy |
im list <affected items: all|instances|installations|templates> | Lists information about instances, installations or templates. <affected items: all|instances|installations|templates>: specify group of affected items |
im reinstall <install policy: if-missing|force-download|force-reinstall> <major version> <installation id> | Stops all instances running the given installation id, downloads and installs the new RCEinstallation, and starts the instances again with the new installation. <install policy: if-missing|force-download|force-reinstall>: specify install policy |
im restart <instances…> <installation id> [--timeout <timeout>] [--gui <start with gui>] [--command-arguments <command arguments>] | Restarts a list of RCE instances with the given instance IDs and the given installation. <instances…>: list of instances to manage |
im start <instances…> <installation id> [--timeout <timeout>] [--gui <start with gui>] [--command-arguments <command arguments>] | Starts a list of new RCE instances with the desired instance IDs and the desired installation. <instances…>: list of instances to manage |
im start-all <installation id> [--timeout <timeout>] [--command-arguments <command arguments>] | Starts all available instances. Uses the given installation. <installation id>: id for the installation |
im stop <instances…> [--timeout <timeout>] | Stops a list of running RCE instances. <instances…>: list of instances to manage |
im stop-all <installation id> [--timeout <timeout>] | Stops all running instances. <installation id>: id for the installation |
| Command | Description |
|---|---|
net bench <taskdef> | Run communication benchmark. <taskdef>: <targetNode|*>([<numMessages>],[<requestSize>],[<responseSize>],[<responseDelay(msec)>],[<threadsPerTarget>]) |
net graph <base name> [--all|-a] | Generates a Graphviz file of the current network topology. <base name>: base name parameter |
net np | Show known RCE node properties. |
| Command | Description |
|---|---|
osgi <command> [-o <filename>] | Executes an OSGi/Equinox console command; use -o to write text output to a file. <command>: osgi command |
| Command | Description |
|---|---|
ra cancel <session token> | Cancels a session. <session token>: token of the session |
ra describe-tool <tool id> <tool version> [-n <tool node id>] [--template|-t] | Prints names and data types of the tool’s or workflow’s intputs and outputs. <tool id>: id of the tool |
ra describe-wf <workflow id> <workflow version> | Prints names and data types of the tool’s or workflow’s intputs and outputs. <workflow id>: id of the workflow |
ra dispose <session token> | Releases resources used by a remote access session. <session token>: token of the session |
ra get-doc-list <tool id> <tool version> | Get tool documentation list. <tool id>: id of the tool |
ra get-tool-doc <session token> <tool id> <tool version> <tool node id> <hash value> | Download documentation. <session token>: token of the session |
ra init [--compact|-c] | Initializes a remote access session, and returns a session token. [--compact|-c]: compact output |
ra list-tools [-f <format>] [--with-load-data <time span> <time limit>] | Lists all available tool ids and versions for the "run-tool"command. [-f <format>]: output format |
ra list-wfs [-f <format>] | Lists all available workflow ids and versions for the "list-wfs"command. [-f <format>]: output format |
ra protocol-version | Prints the protocol version of this interface. |
ra run-tool <session token> <tool id> <tool version> [-n <tool node id>] [-p <parameters…>] [--dynInputs <dyn inputs>] [--dynOutputs <dyn outputs>] [--nonReqInputs <non req inputs>] [--show-output|-o] [uncompressed upload|-u] [simple description format|--simple] | Invokes a tool by its id and version. <session token>: token of the session |
ra run-wf <session token> <workflow id> <workflow version> [-p <parameters…>] [--show-output|-o] | Invokes a published workflow by its id. <session token>: token of the session |
| Command | Description |
|---|---|
run-test <tag name filters…> <build under test id> [--format <pretty|json>] | Run a test. <tag name filters…>: filter for tag names |
| Command | Description |
|---|---|
run-tests <tag name filters…> <build under test id> [--format <pretty|json>] | (alias of "run-test"). <tag name filters…>: filter for tag names |
| Command | Description |
|---|---|
stats | Show internal statistics. |
| Command | Description |
|---|---|
tasks [--all|-a] [--unique|-i] | Show information about internal tasks. [--all|-a]: Show all tasks, including inactive ones |
| Command | Description |
|---|---|
tc close_view <close view parameter> | Closes a GUI view. <close view parameter>: one of the following view keys is a valid input:[Workflow_List, Log, Optimizer, Data_Management_Browser, CPACS_Writer, Properties, Component_Publishing, Cluster_Job_Monitor, TIGL_Viewer, Workflow_Console, Timeline, Excel, Parametric_Study, Command_Console, Network] |
tc close_welcome | Closes the welcome screen if present. |
tc compare_wf_runs <abs export workflow path> <abs export workflow path> | Compares the two given workflowruns and indicates if they are identical or wether their are differences. <abs export workflow path>: absolute path to exported workflowrun |
tc export_all_wf_runs <abs path to export dir> | Exports all workflow runs into the given export directory. <abs path to export dir>: absolute path to export directory |
tc export_wf_run <absolute directory path> <workflow title> | Exports the run corresponding to the workflowtitle to the given directory. <absolute directory path>: absolute path to directory |
tc open_view <open view parameter> | Opens a GUI view and sets focus to it. <open view parameter>: one of the following view keys is a valid input:[Workflow_List, Log, Optimizer, Data_Management_Browser, CPACS_Writer, Properties, Component_Publishing, Cluster_Job_Monitor, TIGL_Viewer, Workflow_Console, Timeline, Excel, Parametric_Study, Command_Console, Network] |
| Command | Description |
|---|---|
wf check-self-test-cases | Check if all test workflows are part of at least one test case. |
wf graph <workflow file> | Prints .dot string representation of a workflow (can be used to create graph visualization with Graphviz). <workflow file>: path to the workflow file |
wf list-self-test-cases | List available test cases for wf self-test. |
wf self-test [--dispose <onfinished|never|always>] [--delete <onfinished|never|always>] [--pr <parallel runs>] [--sr <sequential runs>] [--python <python exe path>] [--cases <cases…>] | Batch test workflow files of the test workflow files bundle. [--dispose <onfinished|never|always>]: dispose behaviour |
RCE commands can use three different types of parameters. These are positional parameters, named parameters and flags. Positional and named parameters take at least one value. However, some of them also take a list parameters. List parameters are denoted by three dots after their name in the tables above, while parameters that take only a single value do not have it, e.g. <parameter…>. Multiple values for list parameters are entered using comma separation, e.g. value0, value1, value2.
Positional parameters must be entered immediately after a command. The order of the parameters must be followed for the command to process the parameters correctly. After all positional parameters have been entered, other types of parameters can be entered.
Named parameters are optional parameters. The command input of these parameters always start with a double dash, e.g. --name. The value must be specified after the parameter name.
Command flags are used to modify the operation of a command. They are always optional. Flags start with a dash or a double dash. A single dash is used for flags consisting of only a single character, e.g. -a. Double dash is used for flags composed of more than one letter, e.g. --all. This long form is more descriptive and is therefore easier to understand. Command flags can have both long and short form, e.g. -a and --all, which do not differ in execution.
Part of this documentation is automatically generated. This is done by executing the help --asciidoc command in RCE. The output of this command has to be copied to the file de.rcenvironment.documentation.core/src/asciidoc/generated/user-commands.ad. This can be done by using the saveto command.