The ovm_managercontrol
utility operates at the
level of the Oracle VM Manager. It allows the administrator to execute
basic commands applicable to the configuration of the entire
environment managed by the Oracle VM Manager.
The ovm_managercontrol
utility has the
following command line options:
-u user name of an Oracle VM Manager admin user (required)
-p password corresponding with the admin user name (required)
-h host name of the server running Oracle VM Manager (required)
-X use SSL to connect to
Oracle VM Manager at tcps://host
:54322
-k name of the keystore file used for SSL
-P password to open the keystore file
-G enable GPG check
-K URL to the GPG key
-B base URL for the YUM server repository
-n CPU compatibility group name
-s name of the Oracle VM Server to add to or remove from a CPU compatibility group
-T timeout in seconds for virtual machine console session (use together with -c getsessiontimeout/setsessiontimeout)
-c console command (required)
[commands:
yuminfo, setupyum, addkeystore, keystoreinfo,
createcpugroup, removecpugroup,
addservertocpugroup, removeserverfromcpugroup,
listcpugroups, getsessiontimeout,
setsessiontimeout
]
See the examples in the next section for typical combinations of parameters and options.
Below are examples of ovm_managercontrol
commands and their respective output.
Set up a keystore file for SSL connectivity and check the keystore settings:
# ./ovm_managercontrol -u admin -ppassword
-h localhost -c addkeystore -kmykeystore.ks
-Ppassword
Oracle VM Manager Control utility 0.5.2. Connected. Command : addkeystore Adding keystore. Restart of Oracle VM Manager is required for this setting to take effect. (/etc/init.d/ovmm stop ; /etc/init.d/ovmm start) Exit... # ./ovm_managercontrol -u admin -ppassword
-h localhost -c keystoreinfo Oracle VM Manager Control utility 0.5.2. Connected. Command : keystoreinfo Key Store information : Key Path : '/u01/app/oracle/ovm-manager-3/keystore/mykeystore.ks' Exit...
Configure the YUM repository for Oracle VM Server updates:
# ./ovm_managercontrol -u admin -ppassword
-h localhost -c setupyum \\ -Bhttp://yumserver.domain.com/repo
-G -Khttp://secure.domain.com/key.gpg
Configure a CPU compatibility group and add an Oracle VM Server:
# ./ovm_managercontrol -u admin -ppassword
-h localhost -c createcpugroup -n MyCPUgroup_Opteron Oracle VM Manager Control utility 0.5.2. Connected. Command : createcpugroup Creating CPU Compatibility Group 'MyCPUgroup_Opteron'. Exit... # ./ovm_managercontrol -u admin -ppassword
-h localhost -c addservertocpugroup -s MyServer1 -n MyCPUgroup_Opteron Oracle VM Manager Control utility 0.5.2. Connected. Command : addservertocpugroup Adding Server to CPU Compatibility group. Exit...
Display the CPU compatibility group configuration, that is: the compatibility groups and their member servers:
# ./ovm_managercontrol -u admin -p password
-h localhost -c listcpugroups
Oracle VM Manager Control utility 0.5.2.
Connected.
Command : listcpugroups
Group : MyCPUgroup_Opteron
Server : MyServer1
Server : MyServer2
Server : MyServer3
Server : MyServer6
Server : MyServer7
Server : MyServer8
Group : MyCPUgroup_Xeon
Server : MyServer4
Server : MyServer5
Exit...