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