1.1. Downloading and Installing Oracle VM Utilities

1.1. Downloading and Installing Oracle VM Utilities
Prev	Chapter 1. Oracle VM Utilities Overview	Next

1.1.1. Installing Oracle VM Utilities on Oracle VM Manager
1.1.2. Installing Oracle VM Utilities on Oracle Linux
1.1.3. Directory Structure of Oracle VM Utilities

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.

1.1.1. Installing Oracle VM Utilities on Oracle VM Manager

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.

Note

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.

# cp ovm_utils_archive.zip /u01/app/oracle/ovm-manager-3/
# cd /u01/app/oracle/ovm-manager-3
# unzip ovm_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.

1.1.2. Installing Oracle VM Utilities on Oracle Linux

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.

# cp ovm_utils_archive.zip /usr/local/bin/oracle/
# cd /usr/local/bin/oracle
# unzip ovm_utils_archive.zip

Caution

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.

1.1.3. Directory Structure of Oracle VM Utilities

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