When Oracle VM Manager starts, it reads the CLI configuration file. The configuration file is located at:
/u01/app/oracle/ovm-manager-3/ovm_cli/config/CLIConfigParams.xml
You can change a number of options in the configuration file. These options are listed in this section.
Before you change any options in the configuration file, you should back up the original and change the permissions of the file to make it writeable:
# chmod +w /u01/app/oracle/ovm-manager-3/ovm_cli/config/CLIConfigParams.xml
Any changes to this configuration file require a restart of Oracle VM Manager for the changes to take effect. To stop Oracle VM Manager, enter:
# service ovmm stop
To start Oracle VM Manager, enter:
# service ovmm start
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:
The lock time out period is defined by the
lockExceptionRetryInterval="20"
option.
This option must be a value between 6 and 119 seconds, with
the default being 20.
The number of retry attempts is defined by the
lockExceptionRetryCount="12"
option. This
option must be greater than 0.