vxchg_rootid(1M) vxchg_rootid(1M)
NAME
vxchg_rootid - set up VxVM root disk that has been cloned or copied from another operational VxVM root disk
SYNOPSIS
/etc/vx/bin/vxchg_rootid [-g new_dg] [-N] [-R] [-S]
[-s script_path] [-v] new_host_name new_root_da
DESCRIPTION
The vxchg_rootid command sets up a VxVM root disk that has been freshly cloned by using the dd command, or by using a hardware-based proce-
dure such as EMC Symmetrix BCV cloning. The disk ID and disk group ID fields in the private region header and the configuration records
are changed from their cloned values to ensure that they are unique. The new host name is written to the host ID fields of the private
region header and to the /etc/vx/volboot file. Script files in /etc, /usr and /var, that contain hard-coded host name values, are modified
to use the new host name (new_host_name).
If no options are specified, values in the /etc/rc.config.d/netconf file are initialized such that when the new root disk is first booted,
the "set_parms initial" dialog menu is displayed. This allows you to enter the system host name and network parameters manually.
OPTIONS
-g new_dg
Specifies the name of the disk group for the new root disk. If this option is not used, the new root disk remains in the same disk
group as the source disk.
-N Provides a method of updating a current host for a new release of the HP-UX operating system.
The command attempts to use NFS to mount the root directory of the current root disk from which new_host_name was booted. This
assumes that the specified host already exists and is accessible over the network. The root directory is temporarily mounted using
the new_host_name:/ syntax. For this to work, the /etc/exports file on the target system must have been edited to contain an entry
for /, and the exportfs command must have been run to give root permission to the host on which the vxchg_rootid command is to be
invoked.
When the old root file system has been mounted, and the freshly cloned root file system has also been temporarily imported and
mounted, system-specific files are copied from the old to the new root file system. The files that are copied include:
/etc/exports
/etc/fstab
/etc/hosts
/etc/lvmtab
/etc/passwd
/etc/rc.config.d/netconf
/etc/resolv.conf
/etc/vx/elm/*
/etc/vx/licenses/*
-R Provides a method of obtaining and updating machine-specific information on a remote target host. When the new disk ID and disk group
ID fields have been changed on the cloned disk, the command uses remsh to execute appropriate commands to find the new root disk as it
is enumerated on the remote host. Once a match has been found, the name and hardware path of the new disk as it exists on the remote
host are extracted. The disk name information is used to update the /stand/bootconf file with the correct value. The hardware path
information is used with the setboot command to set the boot device in the target host's NVRAM.
The criteria for making the setboot changes are as follows:
o If the -v option was specified, the current primary and alternate boot device values are displayed.
o The hardware path of the new root on the remote host is set as the primary boot path.
o The hardware path of the current primary boot device is set as the alternate boot path.
As successful operation of remsh depends on having permission to access the remote host, vxchg_rootid executes a simple remsh command
to test this before any configuration changes have been made. An entry for the host name of the maintenance server and the user run-
ning the command (such as root) must exist in the /.rhosts file on the remote host. See the hosts.equiv(4) manual page for further
information.
-S Starts an interactive Bourne shell when the new root file system has been temporarily mounted. This allows manual changes to be made
to the configuration before it is booted on the new host. When the changes have been completed, exit the shell to allow the
vxchg_rootid command to continue to completion. Immediately before starting the shell, a message is output to indicate the mount point
of the temporarily mounted new root file system.
-s script_path
Runs the specified shell script after the new root file system has been temporarily mounted. This allows you to make any automated
changes to the configuration files that are required. When the script exits, the vxchg_rootid command continues to completion if a 0
exit status is received, or aborts if a non-zero exit status is received.
If any command arguments are required to the script, place script_path and its arguments in quotes.
To allow operational control from the invoked shell script, the new host name and the temporary mount point of the new root file sys-
tem are passed to the script as the last two arguments. Thus, the calling sequence for the invoked shell script is:
user_script script_arguments host_name mount_point
For example, the calling sequence for the script, patch_db, which takes the internal arguments db_path and token would be:
patch_db db_path token newhost temp_mount
-v Outputs verbose messages, including a time stamp, which indicates the major operations that are being performed.
ARGUMENTS
new_host_name The host name of that target machine that is to inherit the newly cloned disk as its root disk when accessed via a SAN boot.
new_root_da The disk access name (CTD name) of the freshly cloned root.
NOTES
The order in which any optional operations are completed is important as it may determine what can be accomplished in a script, or what
must be done manually. This is the order of operations that are performed by vxchg_rootid:
1. Perform sanity checks on the arguments and options specified. These checks include:
o Check that Veritas Volume Manager is running.
o If the -s option was specified, check that the specified script_path exists.
o Check that the new_root_da argument refers to a real disk.
o Check that the disk group name on the freshly cloned disk is rootdg.
o Check that the rootdg disk group contains one disk.
2. If the -N option was specified, attempt to mount the current root file system over NFS. If the target host does not grant access, the
mount is unsuccessful and the vxchg_rootid command exits without performing any configuration operations.
3. The main operations of the vxchg_rootid command are accomplished up to the unmounting of the file systems on the new root. These
operations include:
o Patching the private region to provide unique disk ID and disk group ID values.
o Temporarily importing the new root disk clone, running fsck, and temporarily mounting the new root file system and all file systems
under it.
o Initializing values in the /etc/rc.config.d/netconf file on the new root file system.
o Patching the new host ID into the /etc/vx/volboot file on the new root file system.
o Updating the /stand/bootconf file with the appropriate disk name.
o Updating the host name value in files in the /etc, /usr and /var directories.
4. If the -N option was specified, system-specific files (listed in the DESCRIPTION section) are copied from the old to the new root file
system.
5. If the -s option was specified, the script file is executed.
6. If the -S option was specified, start an interactive Bourne shell. This allows the contents of the new root file system and all of
its subordinate file systems to be inspected, and any required manual operations to be performed. When the shell exits, the
vxchg_rootid command runs to completion.
7. All temporarily mounted file systems are unmounted.
8. The new root disk clone is deported.
9. The host ID value in the new root disk clone's private region is patched with the specified value.
10. The vxchg_rootid command exits.
When the vxchg_rootid command is executed, messages similar to the following may be displayed on the system console:
vxvm:vxconfigd: WARNING: Group rootdg:
Duplicate virtual device number(s):
Volume standvol remapped from 2,5 to 2,8388607
Volume swapvol remapped from 2,1 to 2,8388606
Volume rootvol remapped from 2,0 to 2,8388605
Volume tmpvol remapped from 2,6 to 2,8388604
Volume homevol remapped from 2,7 to 2,8388603
Volume optvol remapped from 2,8 to 2,8388602
Volume usrvol remapped from 2,9 to 2,8388601
Volume varvol remapped from 2,10 to 2,8388600
These messages are the normal consequence of temporarily importing the cloned rootdg disk group and starting its volumes. The minor device
numbers of the indicated volumes are changed, but only for the period that they are temporarily imported.
EXAMPLES
This example shows the vxchg_rootid command being invoked in its simpliest form:
/etc/vx/bin/vxchg_rootid new_host c5t12d0
The next example shows the vxchg_rootid command being invoked with the -s option. Note that quoted script arguments are also specified. In
this case, the test_script script echoes each of the four arguments:
vxchg_rootid -s "/test_script arg1 arg2" furnace c5t12d0
test_script: Args are arg1 arg2 furnace /tmp/tmpmnt1.6523
The next example is similar to the one above, except that the -N, -R and -v options are also specified. (The time stamp is usually placed
on the line as each message, but this output has been edited for clarity.)
# cd /etc/vx/bin
# ./vxchg_rootid -RNvs "/test_script arg1 arg2" hpilb09 c8t4d4
vxchg_rootid 16:29:
Checking configuration of cloned disk and disk group
vxchg_rootid 16:29:
Mounting hpilb09:/ on /tmp/tmpmnt2.6376
vxchg_rootid 16:29:
Checking remsh remote access
vxchg_rootid 16:29:
Patching disk ID and disk group ID values on disk c8t4d4
vxchg_rootid 16:29:
Rescanning the configuration
vxchg_rootid 16:29:
Temporarily importing new root as rootdg.6376 disk group
vxchg_rootid 16:29:
Checking & mounting root FS on /tmp/tmpmnt1.6376
vxchg_rootid 16:29:
Checking & mounting stand FS on /tmp/tmpmnt1.6376/stand
vxchg_rootid 16:29:
Checking & mounting opt FS on /tmp/tmpmnt1.6376/opt
vxchg_rootid 16:29:
Checking & mounting tmp FS on /tmp/tmpmnt1.6376/tmp
vxchg_rootid 16:29:
Checking & mounting var FS on /tmp/tmpmnt1.6376/var
vxchg_rootid 16:29:
Checking & mounting home FS on /tmp/tmpmnt1.6376/home
vxchg_rootid 16:29:
Checking & mounting usr FS on /tmp/tmpmnt1.6376/usr
vxchg_rootid 16:29:
Initializing netconf & Veritas license files.
vxchg_rootid 16:29:
Setting host name into volboot and other selected files.
vxchg_rootid 16:29:
Copying selected files from NFS mounted host.
vxchg_rootid 16:29:
Finding cloned root on remote host hpilb09
vxchg_rootid 16:29:
Disk c8t4d4 will appear as c7t4d4 on target host hpilb09
vxchg_rootid 16:29:
HW path of c7t4d4 on target host is 0/4/0/0.1.3.0.0.4.4
vxchg_rootid 16:29:
Setting devpath in /stand/bootconf file to /dev/dsk/c7t4d4
vxchg_rootid 16:29:
Current setboot values for remote host hpilb09:
vxchg_rootid 16:29:
Primary: 0/4/0/0.1.3.0.0.4.3
vxchg_rootid 16:29:
Alternate: 0/4/0/0.1.3.0.0.4.2
vxchg_rootid 16:29:
Making disk c7t4d4 (0/4/0/0.1.3.0.0.4.4) the primary boot disk
vxchg_rootid 16:29:
Making Alternate boot disk old primary (0/4/0/0.1.3.0.0.4.3)
vxchg_rootid 16:29:
Calling /test_script arg1 arg2 hpilb09 /tmp/tmpmnt1.6376.
test_script: Args are arg1 arg2 hpilb09 /tmp/tmpmnt1.6376
vxchg_rootid 16:29:
Unmounting temporarily mounted file systems.
vxchg_rootid 16:29:
Deporting rootdg.6376 disk group
vxchg_rootid 16:29:
Patching Private Region hostid to hpilb09 on disk c8t4d4.
vxchg_rootid 16:29:
Disk c8t4d4 is now suitable for booting on host hpilb09
SEE ALSO
dd(1), remsh(1), setboot(1M), hosts.equiv(4)
VxVM 5.0.31.1 24 Mar 2008 vxchg_rootid(1M)