NAME
hpvmdevtranslate — Translate Integrity VM guest devices into
HP-UX 11i v3 agile devices.
SYNOPSIS
hpvmdevtranslate [-v] -a hpvm_mgmtdb
hpvmdevtranslate [-v] -P guestname
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:
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.
DIAGNOSTICS
The hpvmdevtranslate command
displays error messages for any of the following conditions:
A legacy device has no agile device translation.
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()
Printable version
