You are here

2. VMPinfo3 Installation for Diagnostic Capture & Troubleshooting

2. VMPinfo3 Installation for Diagnostic Capture & Troubleshooting

Applicable to all Oracle VM 3.x Releases.
VMPinfo3 is a modified version of sosreport for Oracle VM that bundled with Oracle VM 3.2 and above. VMPinfo3 is a set of tools with a command line interface that use the Oracle VM API to collect log files and troubleshooting information from Oracle VM Server pools. VMPinfo3 runs from the Oracle VM Manager host and collects and consolidates log files from each Oracle VM Server managed by Oracle VM Manager.
 
Tip: VMPinfo3 is Oracle support's primary tool for working Oracle VM Service Requests (SRs). To expedite your Oracle VM SRs, always include a VMPinfo3 diagnostic capture.
 
Table 6 Shows the Oracle VM VMPInfo3 Support Matrix and Command Syntax:
Oracle VM Release
Installed By Default?
Command Syntax

Oracle VM 3.3

YES
Note: VMPinfo is installed by default with Oracle VM Manager
# cd /u01/app/oracle/ovm-manager-3/ovm_tools/support
VMPINFO3 Usage:
 Basic Usage to gather details from all Oracle VM Servers:   ./vmpinfo3.sh --username=admin
 List all available Oracle VM Servers:   ./vmpinfo3.sh --username=admin listservers
 Gather details from individual servers:   ./vmpinfo3.sh --username=admin servers=server1,server5,server9,etc
Note: The diagnostic capture will be created in the /tmp directory with the following name, date and format “vmpinfo3-<date-time>.tar.bz2”.

Oracle VM 3.2

YES
Note: VMPinfo is installed by default with Oracle VM Manager
# cd /u01/app/oracle/ovm-manager-3/ovm_shell/tools/vmpinfo
VMPINFO3 Usage
 Basic Usage for all servers:   ./vmpinfo3.sh --username=admin --password=passwd
 List available servers:   ./vmpinfo3.sh --username=admin --password=passwd listservers
 Usage to run vmpinfo3 on individual servers:   ./vmpinfo3.sh --username=admin --password=passwd servers=server1,server5,server9,etc
Note: The diagnostic capture will be created in the /tmp directory with the following name, date and format “vmpinfo3-<date-time>.tar.bz2”.
Oracle VM 3.0.2 up to 3.1.1
NO
Note:  VMPinfo is not installed by default with Oracle VM Manager
# cd /home/oracle
# ./vmpinfo3.sh --username=admin --password=PASSWORD
Note: The diagnostic capture will be created in the /tmp directory with the following name, date and format “vmpinfo3-<date-time>.tar.bz2”.
 
Note: vmpinfo3 must be run from the directory with the vmpinfo3.sh script. 
 
Applicable only for Oracle VM 3.0.1 up to 3.1.1.
VMPinfo3 consists of two RPM packages. The vmpinfo-manager-1.0.0-1.noarch.rpm RPM is installed on the Oracle VM Manager host. The vmpinfo-sosreport-1.0.3-1.noarch.rpm RPM is installed on each Oracle VM Server. The VMPinfo3 RPMs are downloadable from My Oracle Support via ID 1364933.1.

Once you have downloaded the VMPinfo3 RPMs, copy the vmpinfo-manager-1.0.0-1.noarch.rpm RPM to the Oracle VM Manager host, and vmpinfo-sosreport-1.0.3-1.noarch.rpm RPM to each Oracle VM Server.

On the Oracle VM manager host, as root type “rpm -ivh  vmpinfo-manager-1.0.0-1.noarch.rpm”
to install the vmpinfo-manager RPM.

On Oracle VM Server 3.1.1 and above, before installing the vmpinfo-sosreport-1.0.3-1.noarch.rpm RPM, remove the conflicting “vmpinfo3-sosreport-1.0.0-4.el5.noarch” RPM package by typing  “rpm -e  “vmpinfo3-sosreport-1.0.0-4.el5.noarch”. Next, type “rpm -ivh  vmpinfo-sosreport-1.0.3-1.noarch.rpm” to install vmpinfo3-sosreport.

To run VMPinfo3 and create a diagnostic capture, access the Oracle VM Manager host as the oracle user, and change to the “/home/oracle/vmpinfo3/” directory. From the vmpinfo3 directory, run the vmpinfo3.sh script as show in the next example.
$ cd vmpinfo3/
$ ./vmpinfo3.sh --username=admin --password=<ADMIN PASSWORD>

The password used for the vmpinfo3.sh script is for the Oracle VM Manager “admin” user account.  The diagnostic capture will be created in the /tmp directory with the following name, date and format “vmpinfo3-<date-time>.tar.bz2”.
Download PDF Now!