The Oracle VM Utilities are available for download as a
.zip
file via the Oracle VM Downloads page:
http://www.oracle.com/technetwork/server-storage/vm/downloads/index.html
The sections below describe how and where to install these utilities. An overview of the installation directory structure and files is also provided.
When installing Oracle VM Utilities on the same server as
Oracle VM Manager, it is recommended that you put them in the software
directory of the Oracle VM Manager application. The Oracle VM Utilities
are bundled in a .zip
archive. To install,
simply download the archive and extract in the appropriate
directory.
In the example below, we downloaded the
.zip
file to a file server that is also
accessible from the server where we intend to install the
Oracle VM Utilities. We mount this network drive on the
server file system and copy the .zip
file
into the installation directory, where we unzip it. Depending
on your local configuration and preferences you may use
different methods to place the downloaded file in the
installation directory.
# cpovm_utils_archive
.zip /u01/app/oracle/ovm-manager-3/ # cd /u01/app/oracle/ovm-manager-3 # unzipovm_utils_archive
.zip
At this point, the command line scripts are ready to use. Note
that these scripts execute a Java program and use the default
Java VM on the host computer. On the server running Oracle VM Manager,
the appropriate Java VM is installed as part of the Oracle VM Manager
application in /u01/app/oracle/java
. No
further configuration is required.
When installing Oracle VM Utilities on an Oracle Linux server or
desktop computer, you may put them in the installation directory
of your choice; for example: /usr/local/bin
.
The Oracle VM Utilities are bundled in a
.zip
archive. To install, simply download the
archive, copy and extract in the appropriate directory.
# cpovm_utils_archive
.zip /usr/local/bin/oracle/ # cd /usr/local/bin/oracle # unzipovm_utils_archive
.zip
Oracle VM Utilities do not
work with the Open JDK or GNU Compiler for Java (GCJ). You
must install a standard Java VM, version 1.6.x, and make sure
it is defined as the default Java VM by the
JAVA_HOME
environment variable or included
in the PATH
variable on your system.
The command line scripts in Oracle VM Utilities execute a Java program and use the default Java VM on the host computer. To verify the exact path to the Java executable and the active Java version, use the following commands:
# which java /usr/java # java -version java version "1.6.0_26" Java(TM) SE Runtime Environment (build 1.6.0_26-b03) Java(TM) Server VM (build 20.1-b02, mixed mode)
If a standard Java VM, version 1.6.x, is not available on your
system, download and install the version suited for your
platform from
http://java.com/en/download/.To
ensure that the appropriate Java VM version is used, set the
JAVA_HOME
and PATH
variables as follows:
Edit the Oracle Linux shell profile.
# vi /etc/profile - OR - # vi /etc/bashrc
Add the lines below to the profile. If your Java path does
not match /usr/java
, replace with the
actual path on your system.
JAVA_HOME=/usr/java
export JAVA_HOME
PATH=$PATH:$JAVA_HOME/bin
export PATH
Save the file. Log out and log back in to activate your changes.
Verify the Java path and version again, to make sure that the correct Java VM is used.
# which java /usr/java # java -version java version "1.6.0_26" Java(TM) SE Runtime Environment (build 1.6.0_26-b03) Java(TM) Server VM (build 20.1-b02, mixed mode)
At this point, the command line scripts are ready to use.
When you unzip the Oracle VM Utilities archive, a subdirectory
named ovm_utils
is created, containing these
utility scripts:
ovm_managercontrol
ovm_servercontrol
ovm_vmcontrol
ovm_vmdisks
ovm_vmmessage
ovm_poolcontrol
ovm_repocontrol
For each of these utility scripts, a man
page is also included. These help files can be found
in .../ovm_utils/man/man8
.
# ls /u01/app/oracle/ovm-manager-3/ovm_utils/man/man8/ ovm_managercontrol.8 ovm_repocontrol.8 ovm_vmcontrol.8 ovm_vmmessage.8 ovm_poolcontrol.8 ovm_servercontrol.8 ovm_vmdisks.8
Use the man
command to display the help; for
example:
# man man/man8/ovm_servercontrol.8