Global arguments (optional)

1 minute readReference

Global arguments supply general information quickly, including cmtool online help.

Global arguments support using the “=” sign character.
Field Description

--help [command]

Prints this message and exits. If a command is specified, prints the help text for that command.

--help-commands

Prints the list of available commands with a short description.

--help-fields <command>

Displays a list of fields for a command—requires the <command> argument.

--version

Prints cmtool version number.

--server <hostname>

CloudBees Build Acceleration server address. Defaults to the ACCELERATOR_SERVER environment variable. If this variable does not exit, default is to localhost.

--port <port>

HTTP listener port on the CloudBees Build Acceleration server. Defaults to port 8030.

--securePort <securePort>

HTTPS listener port on the CloudBees Build Acceleration server. Defaults to port 8031.

--secure

Uses HTTPS to communicate with the CloudBees Build Acceleration server.

--timeout <seconds>

cmtool waits for a response from the server for a specified amount of time. Timeout for server communication defaults to 180 seconds (3 minutes) if no other time is specified. After the timeout, cmtool exits but the server will continue to process the command.

--output <style>

Set output style—default is xml. xml for an XML document; csv for comma-separated values; simple for no formatting; silent for no output

--fields <list>

List is a comma-separated list of fields to emit when using csv or simple output styles. Default is all fields.

--sessionFile <path>

Overrides the location where session information will be stored.