By default, SSH connections to the CLI are allowed on port 10000. To change the port on which the CLI accepts connections, edit the sshPort="10000" line in the configuration file and change it to the port number you require.

By default, connections to the CLI time out after 15 minutes. To change the timeout period for connections to the CLI client, edit the clientInactivityTimeout="15" line in the configuration file. Set the time out to be between 1-59 minutes. If you do not want the CLI to time out, set this option to -1.

In addition to this timeout option, you can use the ssh ServerAliveInterval option to stop an ssh client from timing out. See the Tip in Section 1.1, “Connecting to the Oracle VM CLI” for more information on using this option.

CLI commands are not case sensitive, so you can enter list vm, List VM, or any other variation in case. By default, data values you use for objects in the CLI are case sensitive, so if a virtual machine has a name of MyVM, then you must use the same case when identifying it in the CLI and cannot use variations such as myvm. You can change the case sensitivity to make data values case insensitive, using the dataCaseSensitive="yes" line in the configuration file, and changing the option to "no".

The connection channel for public key authentication expires after a designated period of time, or if Oracle VM Manager is restarted. The default for keeping the channel open is 1 week (10080 minutes). You can modify this setting by editing the publicKeyAuthChannelTimeout="10080" option in the configuration file. A value of -1 keeps the channel open indefinitely.

When executing multiple concurrent CLI scripts, you may experience lock exceptions around shared resources such as file systems and storage repositories. By default, connections to the CLI time out after 20 seconds if an object that is being requested by the CLI command is locked. If a command fails due to a lock exception, the command is resubmitted 12 times to see if the lock has become free and the command can be executed. To help you tune the CLI to reduce lock exceptions, you can configure the amount of time a command waits for the lock to become free, and the number of times the command is resubmitted with the following options in the configuration file: