2.1 Using Oracle VM Manager Control

2.1.1 Command Line Options and Parameters of ovm_managercontrol
2.1.2 Examples of ovm_managercontrol Usage

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.

2.1.1 Command Line Options and Parameters of ovm_managercontrol

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]

Note

See the examples in the next section for typical combinations of parameters and options.

2.1.2 Examples of ovm_managercontrol Usage

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 -p password -h localhost -c addkeystore -k mykeystore.ks 
        -P password
    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 -p password -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 -p password -h localhost -c setupyum \\
    -B http://yumserver.domain.com/repo -G -K http://secure.domain.com/key.gpg

    This action can also be achieved using the Oracle VM Command Line Interface.

  • Configure a CPU compatibility group and add an Oracle VM Server:

    # ./ovm_managercontrol -u admin -p password -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 -p password -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...

    These actions can also be achieved using the Oracle VM Command Line Interface.

  • 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...

    This action can also be achieved using the Oracle VM Command Line Interface.

  • Set the session timeout value for the RAS Proxy, which is used to facilitate console access to your virtual machines:

    #  ./ovm_managercontrol -u admin -p Welcome1 -h localhost -c setsessiontimeout -T 300
    Oracle VM Manager
            Control utility 0.5.2.
    Manager version :
            3.2.1.516
    Connected.
    Command :
            setsessiontimeout
    Set RAS timeout to
            300 seconds.
    Exit...
  • Get the session timeout value for the RAS Proxy, which is used to facilitate console access to your virtual machines:

    ./ovm_managercontrol -u admin -p Welcome1 -h localhost -c getsessiontimeout
    Oracle VM Manager
            Control utility 0.5.2.
    Manager version :
            3.2.1.516
    Connected.
    Command :
            getsessiontimeout
    RAS Engine Timeout =
            300
    Exit...