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 Oracle VM Utilities can be installed on directly on the system running Oracle VM Manager or, alternately, on any server or desktop system running Oracle Linux. 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 have already downloaded the
.zip
file and show how to copy the
.zip
file into the installation directory,
where it is unzipped.
# 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
Oracle VM Manager host, 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