hpvmdevtranslate — Translate Integrity VM guest devices into HP-UX 11i v3 agile devices.

giraffelife

NAME
hpvmdevtranslate — Translate Integrity VM guest devices into HP-UX 11i v3 
agile devices.

SYNOPSIS
hpvmdevtranslate [-v] -a hpvm_mgmtdb

hpvmdevtranslate [-v] -a

hpvmdevtranslate [-v] -P guestname

hpvmdevtranslate [-v] -u

hpvmdevtranslate [-v]

DESCRIPTION
The primary purpose of this program is to help Integrity VM administrators 
upgrade an Integrity VM host from HP-UX 11i v2 to HP-UX 11i v3. This program 
produces a script, /var/opt/hpvm/common/hpvm_dev_convert, which can be executed 
to convert existing guest devices into 11i v3 agile devices. This program is 
most useful if the upgrade from 11i v2 to 11i v3 was accomplished using a 
cold-install of 11i v3, rather than update-ux. The cold-install can map storage 
devices to different device names, which prevents guests from running. The 
cold-install changes legacy device names to agile device names, and that is why 
you need to run this script if you do a cold-install.

Use this program to change the guest backing storage devices to the new 11i v3 
agile devices by following these steps:

Back up the /var/opt/hpvm directory from your 11i v2 system.

Shut down the 11i v2 system.

Cold-install 11i v3.

Install Integrity VM Version 4.0, if it is not already installed by the OE.

Stop Integrity VM with the following command /sbin/init.d/hpvm stop.

Remove /var/opt//hpvm/common/hpvm_mgmtdb_pre1131 if it exists at this time. A 
new hpvm_mgmtdb_pre1131 file is created when Integrity VM is started in step 8.

Recover or restore the 11i v2 /var/opt/hpvm contents.

Start Integrity VM with the following command: /sbin/init.d/hpvm start.

Run the following command:


# hpvmdevtranslate -a /var/opt/hpvm/common/hpvm_mgmtdb_pre1131

Edit the script, /var/opt/hpvm/common/hpvm_dev_convert, taking note of ERROR 
lines and commenting out the exit line that prevents the running of the script.

Continue with the remaining 11i v3 Integrity VM Host configuration until the 
host is functionally equivalent to the former 11i v2 VM Host.

You can use the hpvmdevtranslate command to convert all existing guests or a 
single guest to use the 11i v3 agile devices. For example, to convert all 
existing guests, use the following:


# /opt/hpvm/bin/hpvmdevtranslate -a

To convert a single guest, use the following command:


# hpvmdevtranslate -P guestname

You can use the hpvmdevtranslate command to undo the previous translation if 
the translation is not more than five days old. The undo operation is run with 
the following command:


# hpvmdevtranslate -u

Options
The following options can be specified only once.

The hpvmdevtranslate command recognizes the following command-line options and 
arguments:

-v
Displays the version number of the hpvmdevtranslate command. The version number 
is displayed first, followed by the information specified by the other options.

-a
Translates all existing guests. If an hpvm_mgmtdb file is specified, the 
translation uses this file.

-P guestname
Translates the specific guest.

-u
If the translation is not more than five days old, the -u option, performs and 
undo operation.

RETURN VALUES
The hpvmdevtranslate command exits with one of the following values:

0: Successful completion.

1: One or more error conditions occurred.


	

	NOTE: An error exit occurs only if the program was unable to complete 
its processing. However, if the program finds guest devices that cannot be 
translated, the output script will have comment lines indicating the error with 
“ERROR:”

	

DIAGNOSTICS
The hpvmdevtranslate command displays error messages for any of the following 
conditions:

A legacy device has no agile device translation.

EXAMPLES
The following example lists the version of the hpvmdevtranslate command:


# hpvmdevtranslate -v

The following example translates the devices using an 11i v2 hpvm_mgmtdb file:


# hpvmdevtranslate [-v] -a /var/opt/hpvm/common/hpvm_mgmtdb_pre1131

The following example translates all existing guests:


# hpvmdevtranslate [-v] -a

The following example translates a specific guest:


# hpvmdevtranslate [-v] -P guestname

The following examples performs an undo operation if the translation is not 
older than 5 days:


# hpvmdevtranslate [-v] -u

AUTHORS
The hpvmdevtranslate command was developed by HP.

SEE ALSO
On the VM Host:

hpvm(5), hpvmcollect(1M), hpvmconsole(1M), hpvmcreate(1M), hpvmhostrdev(1M), 
hpvminfo(1M), hpvmmigrate(1M), hpvmmodify(1M), hpvmnet(1M), hpvmpubapi(3), 
hpvmremove(1M), hpvmresources(5), hpvmsar(1M), hpvmstart(1M), hpvmstatus(1M), 
hpvmstop(1M), hpvmupgrade(1M), p2assist(1M)

On the Integrity VM guest:

hpvmcollect(1M), hpvminfo(1M), hpvmmgmt(1M), hpvmpubapi()