drd(1M)

NAME

drd — manage an inactive system image

SYNOPSIS

drd [-?] [-x -?]

Command Modes

drd activate [-?] [-p] [-v] [-x option=value] [-x -?] [-X option_file]

drd clone [-?] [-p] [-v] -t target_device_file [-x option=value] [-x -?] [-X option_file]

drd deactivate [-?] [-p] [-v] [-x option=value] [-x -?] [-X option_file]

drd mount [-?] [-p] [-v] [-x option=value] [-x -?] [-X option_file]

drd runcmd [-?] [-v] [-x option=value] [-x -?] [-X option_file] cmd [args]

drd umount [-?] [-p] [-v] [-x option=value] [-x -?] [-X option_file]

DESCRIPTION

The drd command provides a command line interface to Dynamic Root Disk (DRD) tools. The drd command has five major modes of operation:

clone

Clones a booted system to an inactive system image. The drd clone mode copies the LVM volume group or VxVM disk group containing the volume on which the root file system (/) is mounted. See drd-clone(1M).

mount

Mounts all file systems in an inactive system image. See drd-mount(1M). The mount point of the root file system is:

/var/opt/drd/mnts/sysimage_000: If the inactive system image was created by the most recent drd clone command.
/var/opt/drd/mnts/sysimage_001: If the inactive system image was the booted system when the most recent drd clone command was run.

umount

Unmounts all file systems in the inactive system image previously mounted by a drd mount command. See drd-umount(1M).

runcmd

Runs a command on an inactive system image. See drd-runcmd(1M). Only a select group of commands may be run by the runcmd mode. These are commands that have been verified to have no affect on the booted system when executed by drd runcmd. Such commands are referred to as DRD-Safe. The commands kctune, swinstall, swjob, swlist, swmodify, swremove, swverify, and view are currently certified DRD-Safe. An attempt to execute any other command will result in a runcmd error. In addition, not every software package may safely be processed by sw* commands. The DRD-Safe SW-DIST commands are aware of running in a DRD session and will reject any unsafe packages. For more information about DRD-Safe packages, see drd-runcmd(1M).

activate

Sets the inactive system image to be the primary boot disk the next time the system is booted. See drd-activate(1M).

deactivate

Sets the active system image (that is, the booted image) to be the primary boot disk the next time the system is booted. See drd-deactivate(1M).

Options

drd without a command mode recognizes the following options:

-?: Displays the usage message.
-x -?: Displays the list of possible -x (extended) options.

In command mode, the -X option_file can be used to get the extended options from a file. See the EXAMPLES section for an example option_file. The option_file can have one or more lines as follows:

extended_option=value

For example: log_verbosity=3

Refer to the Extended -x Options section of each DRD manpage.

major_mode.extended_option=value

For example: clone.verbosity=5

Refer to the DESCRIPTION section for an explanation of major modes.

# comment

Comment lines begin with # and are ignored.

RETURN VALUE

The drd command modes return one of the following values:

0: Success.
1: Error.
2: Warning.

EXAMPLES

To display drd usage information:

drd -? 

To display drd extended option usage:

drd -x -? 

To display usage for the drd clone command:

drd clone -? 

To clone the root LVM volume group or VxVM disk group to a physical device:

For 11i v2:
drd clone -t /dev/dsk/c1t1d0
For 11i v3:
drd clone -t /dev/disk/disk1

To preview the clone of the root LVM volume group or VxVM disk group to a physical device:

For 11i v2:
drd clone -p -t /dev/dsk/c1t15d0
For 11i v3:
drd clone -p -t /dev/disk/disk7

To display all drd clone extended options:

drd clone -x -? 

To mount the inactive system image:

drd mount 

If the system image mounted was created by the most recent drd clone command, the root file system will be mounted at /var/opt/drd/mnts/sysimage_001.

If the system image was booted when the most recent drd clone command was run, the root file system will be mounted at /var/opt/drd/mnts/sysimage_000.

To display all drd mount extended options:

drd mount -x -? 

To unmount the inactive system image:

drd umount 

To display all drd umount extended options:

drd umount -x -? 

To see the software that is installed on the inactive system image (without any need to mount the image first):

drd runcmd swlist 

To install PHCO_0001 from the depot /var/opt/patches, located on the system patchsvr:

drd runcmd swinstall -s patchsvr:/var/opt/patches PHCO_0001 

To run a preview installation of PHCO_0001 from the depot /var/opt/patches, located on the system patchsvr:

drd runcmd swinstall -p -s patchsvr:/var/opt/patches PHCO_0001 

To verify all software on the inactive system image:

drd runcmd swverify \* 

To remove PHKL_9999 from the inactive system image:

drd runcmd swremove PHKL_9999 \* 

To view the swagent log on the inactive system image:

drd runcmd view /var/adm/sw/swagent.log 

To display all drd runcmd extended options:

drd runcmd -x -? 

To set the inactive system image as the primary boot disk:

drd activate 

To set the inactive system image as the primary boot disk and a different disk as the alternate boot disk:

For 11i v2:
drd activate -x alternate_bootdisk=/dev/dsk/c1t1d0
For 11i v3:
drd activate -x alternate_bootdisk=/dev/disk/disk1

To boot to the inactive system image immediately:

drd activate -x reboot=true 

To display all drd activate extended options:

drd activate -x -? 

To restore the active (booted) system image as the primary boot disk:

drd deactivate 

To restore the active (booted) system image as the primary boot disk and set a different disk as the alternate boot disk:

For 11i v2:
drd deactivate -x alternate_bootdisk=/dev/dsk/c1t1d0
For 11i v3:
drd deactivate -x alternate_bootdisk=/dev/disk/disk1

To display all drd deactivate extended options:

drd deactivate -x -? 

To define the log_verbosity extended option for all drd command modes, and the verbosity extended option for the clone, mount, and runcmd modes in an option file named /tmp/drd_defaults:

# more /tmp/drd_defaults 
log_verbosity=3 
clone.verbosity=5 
mount.verbosity=4 
runcmd.verbosity=4 
  

To run the drd clone command using the /tmp/drd_defaults option file:

# drd clone -p  -t /dev/dsk/c1t3d0 -x overwrite=true -X /tmp/drd_defaults 
  

AUTHOR

drd was developed by HP.

FILES

/var/opt/drd/drd.log: Log file.