HP Integrity Virtual Machines 4.2: Installation, Configuration, and Administration

hpvmdevtranslate(1M)
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 or the upgrade
between two 11i v3 versions was accomplished using a cold-install of 11i v3, rather than update-ux.
The update-ux procedure preserves all device names.
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, which is why you
need to run this script if you do a cold-install. With this program, you can also change a single
guest or all guests backing storage devices to use the new 11i v3 agile devices.
Use the following procedure if a cold install upgrade is required.
1. Stop Integrity VM by running the following:
/sbin/init.d/hpvm stop
2. Do a backup of /var/opt/hpvm.
3. Do the cold-install of HP-UX.
4. Install Integrity VM V4.*
5. Stop Integrity VM by running the following:
/sbin/init.d/hpvm stop
6. Tar in or recover the backup of /var/opt/hpvm to /var/opt/hpvm.
7. Move /var/opt/hpvm/common/hpvm_mgmtdb to /var/opt/hpvm/common/
hpvm_mgmtdb.orig.
8. Start Integrity VM with the following command:
/sbin/init.d/hpvm start
9. Run the following command:
# hpvmdevtranslate -a /var/opt/hpvm/common/hpvm_mgmtdb.orig
10. Carefully edit the created script, /var/opt/hpvm/common/hpvm_dev_convert , making
sure that you comment out the early exit line and taking note of any ERROR lines. The
ERROR lines flag translations that could not be made. These ERRORs are from devices that
could not be uniquely identified, and therefore require the administrator to resolve after
running the script.
11. Run the edited script /var/opt/hpvm/common/hpvm_dev_convert.
12. Continue with the remaining 11i v3 Integrity VM Host configuration until the host is
functionally equivalent to the former 11i version Host configuration.
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
252