2.7. Using Oracle VM Repository Control

2.7. Using Oracle VM Repository Control
Prev	Chapter 2. Using the Oracle VM Utilities	Next

2.7.1. Command Line Options and Parameters of ovm_repocontrol
2.7.2. Examples of ovm_repocontrol Usage

The ovm_repocontrol utility allows the administrator to quickly retrieve information about status and contents of a given storage repository, and send a refresh command to update the storage repository contents listed.

2.7.1. Command Line Options and Parameters of ovm_repocontrol

The ovm_repocontrol 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
-r storage repository name
-I storage repository UUID
-s name of an Oracle VM Server with access to the storage under the repository (use together with -c create)
-i UUID of a LUN where a storage repository should be created (use together with -c create)
-c console command (required)
[commands: list, status, info, refresh, fixrepo, create]

Note

The refresh command initiates a storage repository refresh operation through Oracle VM Manager.

The list command does not need a storage repository name or UUID argument. It lists every storage repository registered with the system.

The fixrepo command removes partial configuration information in case the creation of a storage repository on a physical disk has failed. This allows you to redo the creation operation for the storage repository.

2.7.2. Examples of ovm_repocontrol Usage

Below are examples of ovm_servercontrol commands and their respective output.

List all registered storage repositories:

# ./ovm_repocontrol -u admin -p password -h localhost -c list
Oracle VM Repository Control utility 0.5.2.
Connected.
Command : list
Repository : 'MyIscsiRepo1'
     ID     : '0004fb0000030000b0272c74e714ab12'
     Status : 'Online'

Repository : 'MyIscsiRepo2'
     ID     : '0004fb0000030000a1d2474a7325ab25'
     Status : 'Online'

Repository : 'MyNfsRepo'
     ID     : '0004fb0000030000a3ff6bbfe68511a6'
     Status : 'Online'

Exit...

Create a new storage repository on a LUN:

# ./ovm_repocontrol -u admin -p password -h localhost -c create -r MyIscsiRepo3 -s MyServer4 \
-i 3600144f057ef8a0000004fb3194b0001
Oracle VM Repository Control utility 0.5.2.
Connected.
Command : create
Found LUN with id '3600144f057ef8a0000004fb3194b0001'
Creating filesystem...
Creating repository... Please wait...
Create repository completed.
Exit...

Check the status of a storage repository:

# ./ovm_repocontrol -u admin -p password -h localhost -r MyIscsiRepo2 -c status
Oracle VM Repository Control utility 0.5.2.
Connected.
Command : status
Repository : 'MyIscsiRepo2'
   Status  : 'Online'
Exit...

Display detailed information of a storage repository:

# ./ovm_repocontrol -u admin -p password -h localhost -r MyIscsiRepo1 -c info
Oracle VM Repository Control utility 0.5.2.
Connected.
Command : info
Repository : 'MyIscsiRepo1'
   Total Space       : 7500000 MB
   Available Space   : 4146146 MB
   Assigned Servers  :
        Server : MyServer6
        Server : MyServer7
Assemblies :
Virtual CDroms :
    CDrom : ubuntu-11.10-desktop-i386.iso
     uuid : 0004fb0000150000d8de2efc475b4ea5.iso
         VM list : (MyUbuntu1110)
    CDrom : EnterpriseLinux-R6U1-Server-x86_64.iso
     uuid : 0004fb0000150000da320985ba0c2f9b.iso
         VM list : (MyOL6)
Virtual Disks :
    Virtual Disk : MyOL6_bootdisk
            uuid : 0004fb000012000086bf184d2996f0cf.img
         VM list : (MyOL6)
    Virtual Disk : MyOL6_datadisk
            uuid : 0004fb00001200007d18ce0a22e16658.img
         VM list : (MyOL6)
    Virtual Disk : MySolaris11_bootdisk
            uuid : 0004fb00001200008a27187d18c6fe0a.img
         VM list : (MySolaris11)
    Virtual Disk : MyUbuntu1110_bootdisk
            uuid : 0004fb000012000096f0ce0a27d18c6f.img
         VM list : (MyUbuntu1110)
Virtual Machine Configs :
    Config  : 0004fb0000220000b1fc2e486c1c1b7a
        VM  : (MySolaris11)
    Config  : 0004fb0000220000b68857e77465eafc
        VM  : (MyOL6)
    Config  : 0004fb0000220000eb037b82dee6b10b
        VM  : (MyUbuntu1110)
Exit...

Refresh the contents of a storage repository:

# ./ovm_repocontrol -u admin -p password -h localhost -r MyIscsiRepo1 -c refresh
Oracle VM Repository Control utility 0.5.2.
Connected.
Command : refresh
refreshing 3300000006160a212
Lun Refresh completed...
Exit...

Prev	Up	Next
2.6. Using Oracle VM Pool Control	Home	Chapter 3. Using the Oracle VM Guest Additions