Additional command line interface configuration options

Aside from configuring your authentication provider, you can also use command line interface commands to configure other
Automation Orchestrator
options. To use these commands, you must log in to the
Automation Orchestrator Appliance
as a
root
user.
Aside from configuring the authentication provider of your
Automation Orchestrator
deployment, you can use command line interface (CLI) commands for:
  • License configuration
  • System properties configuration
  • Extension configuration
  • Troubleshooting
  • Retrieving system information
  • Logging configuration
For information on configuring the authentication provider with CLI commands, go to Configuring the Automation Orchestrator Appliance authentication provider with the command line interface

License configuration

You can retrieve the current
Automation Orchestrator
license configuration by running the following command:
vracli vro license
You can set a new license key by running the following command:
vracli vro license set <license_key>
You can reset the current license to the default license of the authentication provider by running the following command:
vracli vro license default

System property configuration

You can retrieve a list of all configured
Automation Orchestrator
system properties, as a JSON file, by running the following command:
vracli vro properties
You can set a system property by running the following command:
vracli vro properties set
This system property command has the following properties:
Property
Importance
Description
-k
or
--key
Required
This property defines the name of the system property you want to set.
-v
or
--value
Required
This property defines the value of the system property.
-n
or
--noRestart
Optional
This property defines if the set system property requires a restart of the
Automation Orchestrator
service. By default, setting any new system property performs a restart of the service.
The following is an example of this system property command:
vracli vro properties set -k com.vmware.o11n.property -v true
You can remove existing system properties by running the following command:
vracli vro properties remove -k <key_value>
The
-k
or
--key
property must include the name of the system property you want to remove.
You can retrieve the name, value, and description of the most commonly used system properties by running the following command:
vracli vro properties advanced

Extension configuration

You can retrieve a list of all configured
Automation Orchestrator
extensions by running the following command:
vracli vro extensions
You can activate an extension by running the following command:
vracli vro extensions <extension_name> activate
You can deactivate an extension by running the following command:
vracli vro extensions <extension_name> deactivate
You can list all the configuration properties of a specific extension by running the following command:
vracli vro extensions <extension_name> list
You can set a extension property by running the following command:
vracli vro extensions <extension> set
This extension property command can have the following properties:
Property
Importance
Description
-k
or
--key
Required
This property defines the ID of the extension property.
-v
or
--value
Required
This property defines the value of the extension property.
For example, the workflow of activating an extension, listing all its properties, and setting a system property could look similar to this:
vracli vro extensions tokenreplay activate
vracli vro extensions tokenreplay list
vracli vro extensions tokenreplay set -k recordScripting -v true

Troubleshooting

You can cancel all active workflow runs by running the following command:
vracli vro cancel executions
You can cancel a specific workflow run by adding its ID to the following command:
vracli vro cancel workflow <workflow_id>
You can suspend all active scheduled tasks by running the following command:
vracli vro cancel tasks
You can retrieve a list of all trusted certificates by running the following command:
vracli vro keystore list

System information

You can retrieve the current system information of your
Automation Orchestrator
deployment by running the following command:
vracli vro info
You can add the optional property of
-d
or
--details
to the system information command to all check the health status API of the
Automation Orchestrator
server.

Logging configuration

You can retrieve the current
Automation Orchestrator
logging configuration by running the following command:
vracli vro logs
You can configure the
Automation Orchestrator
logging server by running the following command:
vracli vro logs configure
The logging server command can have the following parameters
Parameter
Importance
Description
-l
or
--level
Optional
This parameter defines the server logging level.
-sc
or
--scripting-count
Optional
This parameter defines the number of saved scripting log rotations.
-sl
or
--scripting-level
Optional
This parameter defines the scripting log level.
-ss
or
--scripting-size
Optional
This parameter defines the scripting log size in megabytes (MB).
The valid level values are
ALL
,
TRACE
,
DEBUG
,
INFO,
WARN
,
ERROR
,
FATAL
and
OFF
.

CLI command logs

Automation Orchestrator
CLI commands print their logs in the
/services-logs/prelude/vco-app/file-logs/vco-server-app_cfg-cli.log
file. When a command returns a result different than zero and the standard output does not show a specific error, the exception is visible in this file.