drd-rehost(1M)drd-rehost(1M)NAME
drd rehost - copy the system information file, containing hostname,
IP address, and other system-specific information, to EFI/HPUX/SYS‐
INFO.TXT on the disk to be rehosted.
SYNOPSIS
system_information_file target_device_file] option_file]
DESCRIPTION
The command copies new host information to EFI/HPUX/SYSINFO.TXT for
processing by auto_parms(1M) during the boot of the disk.
Patches to the auto_parms utility are needed to process the SYSINFO.TXT
file during the boot of the disk. Please refer to the DRD web site,
http:docs.hp.comenDRD for information about the appropriate patches to
install.
A system administrator can execute the command after cloning a system
image to setup the clone to run on another system.
The initial implementation of only supports rehosting of an LVM-managed
root volume group on an Integrity virtual machine to another Integrity
virtual machine, or an LVM-managed root volume group on a Blade with
Virtual Connect I/O to another such Blade.
The format of the sysinfo file is defined in sysinfo(4), which is pro‐
vided by a patch documented at the DRD web site, http:docs.hp.comenDRD.
Only files conforming to sysinfo(4) can be used for rehosting.
The disk to be rehosted must be a bootable disk and may be specified as
the argument of the "-t" option. If no "-t" option is specified, the
disk to be rehosted is the inactive system image. The inactive system
image is either a clone created by the drd clone command, or the origi‐
nal booted image that was cloned, whichever is not currently booted.
If no "-t" option is specified, the inactive image chosen is checked to
ensure that it is managed by LVM. However, if a disk is specified
using the "-t" option, the volume management of the disk is not
checked.
If a preview operation is run (by specifying the "-p" option), the syn‐
tax of the system information file is checked, but the file is not
copied to the target.
Options
recognizes the following options:
Displays the usage message.
Sets preview mode.
Specifies the file containing the system information (hostname,
IP address, network information, etc.)
to be copied to EFI/HPUX/SYSINFO.TXT on the disk speci‐
fied by the "-t" option. See sysinfo(4) for the syntax
of this file. If not specified, the file defaults to
/etc/opt/drd/default_sysinfo_file.
Decreases the verbosity level by one each time it is specified.
For example,
will reduce the verbosity from the default value of 4 to
2. If both and are included on the command line, the
effective verbosity is 2. The minimum verbosity level is
0. (See also the option).
Increases the verbosity level by one each time it is specified.
For example,
will increase the effective verbosity from the default
value of 4 to 5. If both and are included on the command
line, the effective verbosity is 3. The maximum verbosity
level is 5. (See also the option).
Displays the list of possible
(extended) options.
Sets the extended option to a value. See Extended -x Options
definitions below.
Gets the extended options from a file.
Specifies the block device special file of a single writeable
physical disk.
The file specified by the "-f" option will be written to
EFI/HPUX/SYSINFO.TXT in the EFI partition of this disk.
If no target is specified, the inactive system image is
used as a target.
Extended -x Options
recognizes the following (extended) options:
Usage: Basic
This is the path to the log file for this command. Each time
DRD is run, this file will grow larger. This can be changed,
for example, to a month-specific location for easier archiving,
off-host backup, and rotation.
Usage: Basic
Specifies the level of message verbosity in the log file (See
also -x verbosity). Legal values are:
Only ERROR messages and the startingending BANNER messages.
Adds WARNING messages.
Adds NOTE messages.
Adds INFO messages (informational messages preceded by the '*'
character).
Adds verbose INFO messages.
Adds very-verbose INFO messages.
Usage: Basic
This is the file containing system information attributes, such
as hostname and IP address, that is copied to the EFI partition
by the drd rehost command and consequently applied by
auto_parms(1M) when the rehosted image is booted. The file can
be removed from the EFI partition and optionally copied back to
the file system with the drd unrehost command. This extended
option provides the same functionality as the -f option.
Usage: Basic
Specifies the level of stderr verboseness:
Only ERROR messages and the startingending BANNER messages.
Adds WARNING messages.
Adds NOTE messages.
Adds INFO messages (informational messages preceded by the '*'
character).
Adds verbose INFO messages.
Adds very-verbose INFO messages.
Note: The '-v' option is equivalent to increasing ver‐
bosity by 1 (e.g., from 3 to 4) and the '-q' option is
equivalent to decreasing verbosity by 1. The '-v' and
'-q' options can be used more than once.
Return Values
returns the following values:
Success.
Error.
Warning.
Examples
To copy the default system information file /etc/opt/drd/default_sys‐
info_file to EFI/HPUX/SYSINFO.TXT in the EFI partition of the inactive
system image:
To copy the default system information file /etc/opt/drd/default_sys‐
info_file to EFI/HPUX/SYSINFO.TXT in the EFI partition of the disk
/dev/disk/disk9:
To copy the system information file /home/sysadmin/sysinfo_test to
EFI/HPUX/SYSINFO.TXT in the EFI partition of the inactive system image:
To copy the system information file /home/sysadmin/sysinfo_test to
EFI/HPUX/SYSINFO.TXT in the EFI partition of the disk /dev/dsk/c0t0d0:
AUTHOR
was developed by Hewlett-Packard Development Company, L.P.
FILES
Log file.
SEE ALSOauto_parms(1M), drd(1M), drd-activate(1M), drd-clone(1M), drd-deacti‐
vate(1M), drd-mount(1M), drd-runcmd(1M), drd-status(1M), drd-
umount(1M), drd-unrehost(1M), sysinfo(4)
Dynamic Root Disk Administrator's Guide, available at
http:docs/hp.comenDRD.
drd-rehost(1M)
