Tools That Make Your Work with Oracle VM Easier

Posted in: Technical Track

After completing your Oracle VM and Oracle VM Manager installation (see my previous blog posts here), you are ready to start your friendship with Oracle VM technology. However, to make your life and experience even more enjoyable, I suggest you follow a few simple steps listed below.

Configure Public Oracle YUM and install additional tools:

cd /etc/yum.repos.d
yum install man
yum install vnc-server
yum install firefox
yum install telnet

Added on 2012.05.20

yum install strace
yum install time

After some time playing with Oracle VM, you will realize that you’ll like to manage it via command prompt and scripts. Hopefully, Oracle will come with a command line interface (cli) soon. Meanwhile, you may want to install a set of tools from Wim Coekaerts @wimcoekaerts (Oracle VM team) that would do exactly that.

MOS Patch 13602094
cd /u01/app/oracle/ovm-manager-3/
unzip /tmp/
MANPATH=/u01/app/oracle/ovm-manager-3/ovm_utils/man:$MANPATH; export MANPATH

As with the patch README’s, it isn’t too obvious what these tools could do for you. I’ll provide some parts of MAN pages bellow. Helpfully after reading these, you will no longer be doubtful of whether you should install those tools or not :) For official utilities documentation from Oracle, please see Chapter 2. Using the Oracle VM Utilities from Oracle® VM Utilities Guide for Release 3.

Enjoy your Oracle VM experience,


       The Oracle VM utilities are provided as-is and are not formally supported.
ovm_managercontrol - basic Oracle VM Manager control utility

ovm_managercontrol [OPTIONS]

ovm_managercontrol operates on the Oracle VM Manager level. The utility allows the admin to execute basic Manager level commands. Set
up the YUM repository, create CPU Compatibility Groups and configure an SSL keystore.

Oracle VM Manager control command (required)
[yuminfo, setupyum, addkeystore, keystoreinfo, createcpugroup, removecpugroup, addservertocpugroup,  removeserverfromcpugroup,
listcpugroups, getsessiontimeout, setsessiontimeout]

yuminfo                  : display yum configuration
setupyum                 : configure yum
addkeystore              : configure the SSL keystore
keystoreinfo             : display keystore file and path
createcpugroup           : create a CPU Compatibility group
removecpugroup           : delete CPU Compatibility group
addservertocpugroup      : add server to CPU Compatibility group
removeserverfromcpugroup : remove server from CPU Compatibility group
listcpugroups            : list all CPU Compatibility groups and its servers
setsessiontimeout        : set VM Console session timeout
getsessiontimeout        : display VM Console session timeout

ovm_poolcontrol - basic Oracle VM Pool control utility

ovm_poolcontrol [OPTIONS]

ovm_poolcontrol  operates on the Oracle VM Server Pool level. The utility allows the admin to execute basic pool management commands,
query status and info on a given Oracle VM server pool.

Oracle VM pool control command (required)
[list, events, status, info, refresh, addserver, removeserver]

status   : display the current status of the server pool
info     : display server pool  info such as memory, utilization, servers,...
list     : list all server pools registered with this Oracle VM Manager instance
events   : list all latest event types for this server pool
addserver: add server to this server pool (-S server name)
removeserver: remove server to this server pool (-S server name)
refresh  : refresh storage in the server pool

ovm_repocontrol - basic Oracle VM Repository control utility

ovm_repocontrol [OPTIONS]

ovm_repocontrol allows you query the status of an Oracle VM repository.
repository control command (required)
[list, status, info, refresh, fixup, create]
list    : list all repositories
status  : query repository status
info    : display repository information
refresh : send a repository refresh command
fixup   : fix a failed repository create
create  : create repository on a storage device br


ovm_servercontrol - basic Oracle VM Server control utility

ovm_servercontrol [OPTIONS]

ovm_servercontrol  operates on a physical Oracle VM server. The utility allows the admin to execute basic server management commands,
query status and info on a given Oracle VM server.
Oracle VM server control command (required)
[start, stop, restart, kill, mainton, maintoff, status, info, lock, upgrade, list, events, discover, listnfsexports, deletenf-
sexport, createnfsexport]

start           : use IPMI to power-on the server
stop            : shutdown the server
kill            : use IPMI to power-off the server
mainton         : turn on maintenance mode for this server
maintoff        : turn off maintenance mode for this server
status          : display the current status of the server (Running, Stopped,...)
info            : display server info such as memory, utilization, serverpool,...
lock            : temporarily lock the server disallowing any updates to happen
upgrade         : send an upgrade command to the server
list            : list all servers registered with this Oracle VM Manager instance
events          : list all latest event types for this server
discover        : discover server with provided hostname or IP address and Oracle VM agent password (-P)
listnfsexports  : list NFS exports on this server
deletenfsexport : delete an NFS export on this server
createnfsexport : create a new NFS export on this server

ovm_vmcontrol - basic Oracle VM Virtual Machine(VM) control utility

ovm_vmcontrol [OPTIONS]

ovm_vmcontrol  allows  you  to send basic VM control commands to the Oracle VM Management server.  It allows you to start, stop, sus-
pend, resume, kill, restart and list the VM(s). It is also possible to simply query the  status  of  the  Virtual  Machine  (Running,
Stopped) , get VM info, such as memory, serverpool, number of vCPUs etc.
Virtual Machine control command (required)
[start,  stop,  suspend, kill, resume, restart, status, info, lock, list, migrate, events, vcpuset, vcpuget, gettags, settags,
fixcfg, delete]

start    : start the Virtual Machine
stop     : Power-off the Virtual Machine
suspend  : Suspend a running Virtual Machine
kill     : Kill the Virtual Machine
resume   : Resume a suspended Virtual Machine
restart  : Restart a running Virtual Machine (Power-off, start)
status   : display the current status of the Virtual Machine (Running, Stopped, Suspended)
info     : display Virtual Machine info such as memory, utilization, serverpool,...
lock     : temporarily lock the server disallowing any updates to happen
events   : list all latest events for this Virtual Machine requiring acknowledgement
list     : list all Virtual Machines registered with this Oracle VM Manager instance
vcpuset  : bind virtual cpuâs to physical threads for this Virtual Machine
vcpuget  : list bindings of virtual cpus to physical threads for this Virtual Machine
settags  : store a set of comma separate custom tags for a Virtual Machine
gettags  : retrieve list of tags for this Virtual Machine
fixcfg   : fix Virtual Machine Configuration file
delete   : delete Virtual Machine


ovm_vmdisks - basic Oracle VM Virtual Machine(VM) disk query utility

ovm_vmdisks [OPTIONS]

ovm_vmdisks  is a utility designed to help the admin make backups of Virtual Machines. In particular when the Virtual Disks are files
in a repository on a remote NFS server. The utility takes a Virtual Machine name or UUID and lists out every Virtual  Disk  file  for
that VM, including the Virtual Machine configuration file. This allows an admin to take the files listed in the output of the utility
and back them up to a server or tape.

If the Virtual Disks are actual physical devices directly attached to the VM, the utility lists the device mapper device of server to
which the VM is assigned. In the case of files on an NFS server, the utility lists the NFS servername, mountpoint and file name/loca-

ovm_vmmessage - Oracle VM Virtual Machine Message Send/Receive utility

ovm_vmmessage [OPTIONS]

ovm_vmmessage  is  a  utility that allows the user to send a message to a running Virtual Machine, or to query the value of a message
sent from within a Virtual Machine to the Oracle VM Management server using the Oracle VM API messaging interface.

These values are basic key/value pairs such as foo=bar. New Oracle VM templates released by Oracle contain  a  configuration  utility
called  ovmd  which  is  used to do firstboot installation configuration. Either locally from the Virtual Machine console or remotely
through this messaging interface. Ovmd also allows the owner of the Virtual Machine to send messages back to the management server.

The following is an example of how you should run the utilities:

[root@team5lab ovm_utils]# ovm_managercontrol -u admin -p < password >  -h localhost -c yuminfo
Oracle VM Manager Control utility 0.5.2.
Manager version :
Command : yuminfo
YUM Repository information :
        Base URL       : 'Undefined'
        Enable GPG Key : 'false'
        GPG Key        : 'undefined'
[root@team5lab ovm_utils]#

Interested in working with Yury? Schedule a tech call.

About the Author

Yury is a nice person who enjoys meeting and working with people on challenging projects in the Oracle space. He started to work as an Oracle DBA 14 years ago (1997). For the past 10 years (since 2001) his main area of expertise is Oracle e-Business Suite. Yury is an OCP 7,8,9,10g and OCM 9i,10g. He is a frequent presenter at Oracle related conferences such as Hotsos, UKOUG and AUOUG. Yury is a socially active person. Apart from Social Media (Twitter, Bloging, Facebook) he is the primary organizer of Sydney Oracle Meetup group (250 people). So if you happen to be in Sydney (Australia) drop Yury a message and stop by at one of his Meetups.

4 Comments. Leave new

Hello dear,

Would like to know if it is possible access and to backup (copy) vms on HARD DISK as partition (local) is raw with oracle vm 3 ? In order to upload in other oracle vm3 ?
is ovm_vmdisk able to do that ?


Also is there a way to change ip address easily like with ovm 2


Is it possible to change the ovs-agent password on the pool?
I changed the ovs-agent password on two servers belonging to a server pool, but I did it from cli, and now the servers are shown as offline.


@Kenneth Let me know if you are still facing the issue


Leave a Reply

Your email address will not be published. Required fields are marked *