Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
Dynamic Root Disk Administrator's Guide: HP-UX 11i v2, HP-UX 11i v3 > Appendix A DRD Commands

DRD Command Syntax

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

This section explains DRD command syntax, including the options that are specific to certain commands.

NOTE: This section is intended for quick reference after you are familiar with using DRD. Chapters 2 through 6 explain how to perform operations with DRD commands.

The drd activate Command

The drd activate command causes the inactive system image to boot either immediately or the next time the system boots. Immediate or delayed booting is controlled by the -x reboot={true|false} extended option. The default is false.

The drd-activate(1M) command invokes the setboot(1M) command to set the primary boot disk to the target of the drd clone operation. It also optionally sets the alternate and High Availability alternate boot disks to values specified on the command line.

The drd activate command syntax is:

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

Options

-?

Displays the usage message for a DRD command. This option cannot be used with other options.

-p

Sets preview mode. When run with the -p option, a DRD command performs analysis without running the command and reports any errors.

-q

Decreases the verbosity level by one each time it is specified. For example, -qq will reduce the verbosity from the default value of 4 to 2. If both -x verbosity=5 and -qqq are included on the command line, the effective verbosity is 2. The minimum verbosity level is 0. (See also the -x verbosity option.)

-v

Increases the verbosity level by one each time it is specified. For example, -v will increase the effective verbosity from the default value of 4 to 5. If both -x verbosity=1 and -vv are included on the command line, the effective verbosity is 3. The maximum verbosity level is 5. (See also the -x verbosity option.)

-x extended_option=value

Sets the extended option to a value.

-x -?

Displays the list of possible -x (extended) options.

-X option_file

Gets the extended options from a file.

Extended options

The following extended options are available:

-x alternate_bootdisk=block_device_special_file

This is the alternate boot disk. The alternate boot disk must be specified as a block device special file.

-x HA_alternate_bootdisk=block_device_special_file

This is the High Availability alternate boot disk. The High Availability alternate boot disk must be specified as a block device special file. High Availability alternate boot disk is supported only on Itanium-based architecture and for PA-RISC systems that support hardware partitions.

-x ignore_unmounted_fs={true|false}

(Default is false) Controls whether a clone fails when an unmounted file system in the root volume group is detected.

-x logfile=/var/opt/drd/drd.log

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.

-x log_verbosity=4

(Default.) Specifies the level of log verboseness. Replace 4 with the following values:

0 Only ERRORS and the starting/ending BANNER messages. 1 Adds WARNING messages. 2 Adds NOTE messages. 3 Adds INFO messages (informational messages preceded by the * character.) 4 (Default) Adds verbose INFO messages. 5 Adds additional detailed INFO messages.
-x mirrordisk=block_device_special_file

Specifies the target's block device special file of the mirror disk. The block device special file should refer to an entire disk, not to a partition. This option requires that LVM mirroring is installed. The block device special file specified is used to mirror each logical volume in the target of the clone operation.

-x overwrite={true|false}

Specifies whether drd clone should overwrite existing information on the target disk. That is, it controls whether a disk containing boot, LVM, or VxVM records can be overwritten. The -x overwrite=false (default) prevents a disk that contains boot, LVM, or VxVM records from being overwritten. The -x overwrite=true allows a disk to be overwritten, even if it contains boot, LVM, or VxVM records. Note that DRD does not overwrite a disk associated with an active LVM volume group or VxVM disk group, regardless of the setting of the overwrite option. If a previously created clone is mounted, use the drd umount command to unmount it before attempting to create a new clone on the disk.

-x preview={true|false}

If true, run this command in preview mode only. That is, complete the analysis phase and exit; no changes are committed to disk. This option has the same effect as specifying -p on the command line. The default is false. This option is available on every DRD command except drd runcmd.

-x reboot={true|false}

If true, specifies the system is rebooted at the successful completion of a drd activate operation. The default is false.

-x verbosity=3 (Default.)

Specifies the level of stdout/stderr verboseness. Replace 3 with the following values:

0 Only ERRORS and the starting/ending BANNER messages. 1 Adds WARNING messages. 2 Adds NOTE messages. 3 (Default) Adds INFO messages (informational messages preceded by the * character.) 4 Adds verbose INFO messages. 5 Adds additional detailed INFO messages.
-X option_file

Gets the extended options from a file.

The drd clone Command

The drd-clone(1M) command creates a copy of the volume group containing the root file system (/). It does not clone the entire disk configuration.

The drd clone command:

  • Creates Extensible Firmware Interface (EFI) partitions on HP-UX Integrity systems.

  • Creates boot records.

  • Creates a new LVM volume group, or VxVM disk group and a volume, in the new group for each volume in the root volume group. The volume management type of the clone matches that of the root group

  • Configures swap and dump volumes.

  • Copies the contents of each file system in the root volume group to the corresponding file system in the new group.

  • Modifies particular files on the clone that identify the disk on which the volume group resides.

  • For LVM-based systems, modifies volume group metadata on the clone so that the volume group name is the same as the original root volume group when the clone is booted.

The drd clone command performs the following checks:

  • If the disk is currently in use by the LVM Manager, it is rejected by the drd clone operation.

  • If the disk is currently in use by the VxVM Manager, it will be accepted only if the following two conditions are met:

    • The disk is an inactive image managed by DRD

    • The extended option -x overwrite=true is specified on the drd clone command

  • If the disk is not currently in use by LVM or VxVM, but contains LVM, VxVM, or boot records, it is only accepted as a drd clone target if -x overwrite=true is specified on the drd clone command.

NOTE: A selected target disk will not be overwritten if it is part of the root volume. However, the drd clone command will overwrite swap or raw data disks—it does not detect this type of usage. For example, any raw disks in use by databases would be overwritten if given as the target clone disk.

When run with the -x overwrite extended option set to true, the drd clone command overwrites any existing data on the target disk. If the target disk contains a mounted inactive system image, run the drd umount command before attempting another clone operation with -x overwrite=true. If other volume groups (not related to DRD) reside on the target disk and you want to overwrite them, use the vgexport(1M) command first to remove any knowledge of them from the booted system.

When run with the -x mirror_disk=block_device_special_file, you must specify the target's block device special file of the mirror disk. The block device special file should refer to an entire disk, not to a partition. For a system with an LVM root, this option requires that LVM mirroring is installed. The block device special file specified will be used to mirror each logical volume in the target of the clone operation.

A log of the cloning operation is available at /var/opt/drd/drd.log. This log is written to the booted system. Because it is located in the /var file system, it is copied during the clone operation to the /var file system on the clone. However, because the clone file systems must be unmounted before the final ending banner message of the operation is written to the log, the record of the clone operation in the log on the clone is truncated at the message indicating that file systems are being copied. The next message in the log on the clone is issued by the next DRD command run on the clone itself after it is booted. The log on the booted system is complete, ending with the final banner message.

The drd clone command syntax is:

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

Options

-?

Displays the usage message for a DRD command. This option cannot be used with other options.

-p

Sets preview mode. When run with the -p option, a DRD command performs analysis without running the command and reports any errors.

-q

Decreases the verbosity level by one each time it is specified. For example, -qq will reduce the verbosity from the default value of 4 to 2. If both -x verbosity=5 and -qqq are included on the command line, the effective verbosity is 2. The minimum verbosity level is 0. (See also the -x verbosity option.)

-v

Increases the verbosity level by one each time it is specified. For example, -v will increase the effective verbosity from the default value of 4 to 5. If both -x verbosity=1 and -vv are included on the command line, the effective verbosity is 3. The maximum verbosity level is 5. (See also the -x verbosity option.)

-t target_device_file

The -t target_device_file option and parameter are required with the drd clone command. This option specifies the block device special file (for example, /dev/dsk/c2t0d0) of a single physical disk on which the cloned system image is to be written. The block device special file must exist on the system and be writeable. All data previously on a disk will be unavailable after a clone operation. (See the -x overwrite extended option.)

-x extended_option= value

Sets the extended option to a value.

-x -?

Displays the list of possible -x (extended) options.

-X option_file

Gets the extended options from a file.

Extended options

The following extended options are available:

-x alternate_bootdisk=block_device_special_file

This is the alternate boot disk. The alternate boot disk must be specified as a block device special file.

-x HA_alternate_bootdisk=block_device_special_file

This is the High Availability alternate boot disk. The High Availability alternate boot disk must be specified as a block device special file. High Availability alternate boot disk is supported only on Itanium-based architecture and for PA-RISC systems that support hardware partitions.

-x ignore_unmounted_fs={true|false}

(Default is false) Controls whether a clone fails when an unmounted file system in the root volume group is detected.

-x logfile=/var/opt/drd/drd.log

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.

-x log_verbosity=4

(Default.) Specifies the level of log verboseness. Replace 4 with the following values:

0 Only ERRORS and the starting/ending BANNER messages. 1 Adds WARNING messages. 2 Adds NOTE messages. 3 Adds INFO messages (informational messages preceded by the * character.) 4 (Default) Adds verbose INFO messages. 5 Adds additional detailed INFO messages.
-x mirrordisk=block_device_special_file

Specifies the target's block device special file of the mirror disk. The block device special file should refer to an entire disk, not to a partition. This option requires that LVM mirroring is installed. The block device special file specified is used to mirror each logical volume in the target of the clone operation.

-x overwrite={true|false}

Specifies whether drd clone should overwrite existing information on the target disk. That is, it controls whether a disk containing boot, LVM, or VxVM records can be overwritten. The -x overwrite=false (default) prevents a disk that contains boot, LVM, or VxVM records from being overwritten. The -x overwrite=true allows a disk to be overwritten, even if it contains boot, LVM, or VxVM records. Note that DRD does not overwrite a disk associated with an active LVM volume group or VxVM disk group, regardless of the setting of the overwrite option. If a previously created clone is mounted, use the drd umount command to unmount it before attempting to create a new clone on the disk.

-x preview={true|false}

If true, run this command in preview mode only. That is, complete the analysis phase and exit; no changes are committed to disk. This option has the same effect as specifying -p on the command line. The default is false. This option is available on every DRD command except drd runcmd.

-x reboot={true|false}

If true, specifies the system is rebooted at the successful completion of a drd activate operation. The default is false.

-x verbosity=3 (Default.)

Specifies the level of stdout/stderr verboseness. Replace 3 with the following values:

0 Only ERRORS and the starting/ending BANNER messages. 1 Adds WARNING messages. 2 Adds NOTE messages. 3 (Default) Adds INFO messages (informational messages preceded by the * character.) 4 Adds verbose INFO messages. 5 Adds additional detailed INFO messages.
-X option_file

Gets the extended options from a file.

The drd deactivate Command

The drd-deactivate(1M) command invokes the setboot(1M) command to set the primary boot disk to the active (booted) system image the next time the system is booted.

NOTE: drd deactivate is a mechanism for “undoing” a drd activate command.

The drd deactivate command syntax is:

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

Options

-?

Displays the usage message for a DRD command. This option cannot be used with other options.

-p

Sets preview mode. When run with the -p option, a DRD command performs analysis without running the command and reports any errors.

-q

Decreases the verbosity level by one each time it is specified. For example, -qq will reduce the verbosity from the default value of 4 to 2. If both -x verbosity=5 and -qqq are included on the command line, the effective verbosity is 2. The minimum verbosity level is 0. (See also the -x verbosity option.)

-v

Increases the verbosity level by one each time it is specified. For example, -v will increase the effective verbosity from the default value of 4 to 5. If both -x verbosity=1 and -vv are included on the command line, the effective verbosity is 3. The maximum verbosity level is 5. (See also the -x verbosity option.)

-x extended_option=value

Sets the extended option to a value.

-x -?

Displays the list of possible -x (extended) options.

-X option_file

Gets the extended options from a file.

Extended options

The following extended options are available:

-x alternate_bootdisk=block_device_special_file

This is the alternate boot disk. The alternate boot disk must be specified as a block device special file.

-x HA_alternate_bootdisk=block_device_special_file

This is the High Availability alternate boot disk. The High Availability alternate boot disk must be specified as a block device special file. High Availability alternate boot disk is supported only on Itanium-based architecture and for PA-RISC systems that support hardware partitions.

-x ignore_unmounted_fs={true|false}

(Default is false) Controls whether a clone fails when an unmounted file system in the root volume group is detected.

-x logfile=/var/opt/drd/drd.log

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.

-x log_verbosity=4

(Default.) Specifies the level of log verboseness. Replace 4 with the following values:

0 Only ERRORS and the starting/ending BANNER messages. 1 Adds WARNING messages. 2 Adds NOTE messages. 3 Adds INFO messages (informational messages preceded by the * character.) 4 (Default) Adds verbose INFO messages. 5 Adds additional detailed INFO messages.
-x mirrordisk=block_device_special_file

Specifies the target's block device special file of the mirror disk. The block device special file should refer to an entire disk, not to a partition. This option requires that LVM mirroring is installed. The block device special file specified is used to mirror each logical volume in the target of the clone operation.

-x overwrite={true|false}

Specifies whether drd clone should overwrite existing information on the target disk. That is, it controls whether a disk containing boot, LVM, or VxVM records can be overwritten. The -x overwrite=false (default) prevents a disk that contains boot, LVM, or VxVM records from being overwritten. The -x overwrite=true allows a disk to be overwritten, even if it contains boot, LVM, or VxVM records. Note that DRD does not overwrite a disk associated with an active LVM volume group or VxVM disk group, regardless of the setting of the overwrite option. If a previously created clone is mounted, use the drd umount command to unmount it before attempting to create a new clone on the disk.

-x preview={true|false}

If true, run this command in preview mode only. That is, complete the analysis phase and exit; no changes are committed to disk. This option has the same effect as specifying -p on the command line. The default is false. This option is available on every DRD command except drd runcmd.

-x reboot={true|false}

If true, specifies the system is rebooted at the successful completion of a drd activate operation. The default is false.

-x verbosity=3 (Default.)

Specifies the level of stdout/stderr verboseness. Replace 3 with the following values:

0 Only ERRORS and the starting/ending BANNER messages. 1 Adds WARNING messages. 2 Adds NOTE messages. 3 (Default) Adds INFO messages (informational messages preceded by the * character.) 4 Adds verbose INFO messages. 5 Adds additional detailed INFO messages.
-X option_file

Gets the extended options from a file.

The drd mount Command

The drd-mount(1M) command mounts all the file systems in the cloned system image.

If the booted volume group contains the file systems /, /var, /usr, /tmp, /stand, /opt, and /home, the cloned file systems are mounted at the mount points shown in Example A-1.

Example A-1 File System Mount Points

/var/opt/drd/mnts/sysimage_001

/var/opt/drd/mnts/sysimage_001/var

/var/opt/drd/mnts/sysimage_001/usr

/var/opt/drd/mnts/sysimage_001/tmp

/var/opt/drd/mnts/sysimage_001/stand

/var/opt/drd/mnts/sysimage_001/opt

/var/opt/drd/mnts/sysimage_001/home

If the inactive system image was created by the drd clone command, the mount point for the root file system, chosen automatically by the mount command, is /var/opt/drd/mnts/sysimage_001. If the currently-booted system was created by the drd clone command, the mount point of the root file system of the original system (now inactive) is /var/opt/drd/mnts/sysimage_000.

The drd mount command syntax is:

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

Options

-?

Displays the usage message for a DRD command. This option cannot be used with other options.

-p

Sets preview mode. When run with the -p option, a DRD command performs analysis without running the command and reports any errors.

-q

Decreases the verbosity level by one each time it is specified. For example, -qq will reduce the verbosity from the default value of 4 to 2. If both -x verbosity=5 and -qqq are included on the command line, the effective verbosity is 2. The minimum verbosity level is 0. (See also the -x verbosity option.)

-v

Increases the verbosity level by one each time it is specified. For example, -v will increase the effective verbosity from the default value of 4 to 5. If both -x verbosity=1 and -vv are included on the command line, the effective verbosity is 3. The maximum verbosity level is 5. (See also the -x verbosity option.)

-x extended_option=value

Sets the extended option to a value.

-x -?

Displays the list of possible -x (extended) options.

-X option_file

Gets the extended options from a file.

Extended options

The following extended options are available:

-x alternate_bootdisk=block_device_special_file

This is the alternate boot disk. The alternate boot disk must be specified as a block device special file.

-x HA_alternate_bootdisk=block_device_special_file

This is the High Availability alternate boot disk. The High Availability alternate boot disk must be specified as a block device special file. High Availability alternate boot disk is supported only on Itanium-based architecture and for PA-RISC systems that support hardware partitions.

-x ignore_unmounted_fs={true|false}

(Default is false) Controls whether a clone fails when an unmounted file system in the root volume group is detected.

-x logfile=/var/opt/drd/drd.log

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.

-x log_verbosity=4

(Default.) Specifies the level of log verboseness. Replace 4 with the following values:

0 Only ERRORS and the starting/ending BANNER messages. 1 Adds WARNING messages. 2 Adds NOTE messages. 3 Adds INFO messages (informational messages preceded by the * character.) 4 (Default) Adds verbose INFO messages. 5 Adds additional detailed INFO messages.
-x mirrordisk=block_device_special_file

Specifies the target's block device special file of the mirror disk. The block device special file should refer to an entire disk, not to a partition. This option requires that LVM mirroring is installed. The block device special file specified is used to mirror each logical volume in the target of the clone operation.

-x overwrite={true|false}

Specifies whether drd clone should overwrite existing information on the target disk. That is, it controls whether a disk containing boot, LVM, or VxVM records can be overwritten. The -x overwrite=false (default) prevents a disk that contains boot, LVM, or VxVM records from being overwritten. The -x overwrite=true allows a disk to be overwritten, even if it contains boot, LVM, or VxVM records. Note that DRD does not overwrite a disk associated with an active LVM volume group or VxVM disk group, regardless of the setting of the overwrite option. If a previously created clone is mounted, use the drd umount command to unmount it before attempting to create a new clone on the disk.

-x preview={true|false}

If true, run this command in preview mode only. That is, complete the analysis phase and exit; no changes are committed to disk. This option has the same effect as specifying -p on the command line. The default is false. This option is available on every DRD command except drd runcmd.

-x reboot={true|false}

If true, specifies the system is rebooted at the successful completion of a drd activate operation. The default is false.

-x verbosity=3 (Default.)

Specifies the level of stdout/stderr verboseness. Replace 3 with the following values:

0 Only ERRORS and the starting/ending BANNER messages. 1 Adds WARNING messages. 2 Adds NOTE messages. 3 (Default) Adds INFO messages (informational messages preceded by the * character.) 4 Adds verbose INFO messages. 5 Adds additional detailed INFO messages.
-X option_file

Gets the extended options from a file.

The drd rehost Command

The drd-rehost(1M) command copies new host information to EFI/HPUX/SYSINFO.TXT for processing by auto_parms during the boot of the disk.

The drd rehost command considerations are:

  • 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.com/en/DRD for information about the appropriate patches to install.

  • A system administrator can execute the drd rehost command after cloning a system image to setup the clone to run on another system.

  • The initial implementation of drd rehost 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 provided by a patch documented at the DRD Web site, http://docs.hp.com/en/DRD. 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 original 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 syntax of the system information file is checked, but the file is not copied to the target.

The drd rehost command syntax is:

drd rehost [-?] [-p] -f system_information_file [-q] -t device_special_file [-v] [-x extended option=value] [-x -?] [-X option_file]

Options

-?

Displays the usage message for a DRD command. This option cannot be used with other options.

-p

Sets preview mode. When run with the -p option, a DRD command performs analysis without running the command and reports any errors.

-f system_information_file

Specifies the file containing the system information (hostname, IP address, network information, etc.) to be copied to EFI/HPUX/SYSINFO.TXT on the disk specified 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.

-q

Decreases the verbosity level by one each time it is specified. For example, -qq will reduce the verbosity from the default value of 4 to 2. If both -x verbosity=5 and -qqq are included on the command line, the effective verbosity is 2. The minimum verbosity level is 0. (See also the -x verbosity option.)

-t device_special_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.

-v

Increases the verbosity level by one each time it is specified. For example, -v will increase the effective verbosity from the default value of 4 to 5. If both -x verbosity=1 and -vv are included on the command line, the effective verbosity is 3. The maximum verbosity level is 5. (See also the -x verbosity option.)

-x extended_option=value

Sets the extended option to a value.

-x -?

Displays the list of possible -x (extended) options.

-X option_file

Gets the extended options from a file.

Extended options

The following extended options are available:

-x alternate_bootdisk=block_device_special_file

This is the alternate boot disk. The alternate boot disk must be specified as a block device special file.

-x HA_alternate_bootdisk=block_device_special_file

This is the High Availability alternate boot disk. The High Availability alternate boot disk must be specified as a block device special file. High Availability alternate boot disk is supported only on Itanium-based architecture and for PA-RISC systems that support hardware partitions.

-x ignore_unmounted_fs={true|false}

(Default is false) Controls whether a clone fails when an unmounted file system in the root volume group is detected.

-x logfile=/var/opt/drd/drd.log

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.

-x log_verbosity=4

(Default.) Specifies the level of log verboseness. Replace 4 with the following values:

0 Only ERRORS and the starting/ending BANNER messages. 1 Adds WARNING messages. 2 Adds NOTE messages. 3 Adds INFO messages (informational messages preceded by the * character.) 4 (Default) Adds verbose INFO messages. 5 Adds additional detailed INFO messages.
-x mirrordisk=block_device_special_file

Specifies the target's block device special file of the mirror disk. The block device special file should refer to an entire disk, not to a partition. This option requires that LVM mirroring is installed. The block device special file specified is used to mirror each logical volume in the target of the clone operation.

-x overwrite={true|false}

Specifies whether drd clone should overwrite existing information on the target disk. That is, it controls whether a disk containing boot, LVM, or VxVM records can be overwritten. The -x overwrite=false (default) prevents a disk that contains boot, LVM, or VxVM records from being overwritten. The -x overwrite=true allows a disk to be overwritten, even if it contains boot, LVM, or VxVM records. Note that DRD does not overwrite a disk associated with an active LVM volume group or VxVM disk group, regardless of the setting of the overwrite option. If a previously created clone is mounted, use the drd umount command to unmount it before attempting to create a new clone on the disk.

-x preview={true|false}

If true, run this command in preview mode only. That is, complete the analysis phase and exit; no changes are committed to disk. This option has the same effect as specifying -p on the command line. The default is false. This option is available on every DRD command except drd runcmd.

-x reboot={true|false}

If true, specifies the system is rebooted at the successful completion of a drd activate operation. The default is false.

-x verbosity=3 (Default.)

Specifies the level of stdout/stderr verboseness. Replace 3 with the following values:

0 Only ERRORS and the starting/ending BANNER messages. 1 Adds WARNING messages. 2 Adds NOTE messages. 3 (Default) Adds INFO messages (informational messages preceded by the * character.) 4 Adds verbose INFO messages. 5 Adds additional detailed INFO messages.
-X option_file

Gets the extended options from a file.

The drd runcmd Command

The drd-runcmd(1M) command runs a DRD-safe command, which is specified by command <args>, on the cloned (inactive) system image.

The drd runcmd command runs the designated command on the inactive system image. Several commands, known as DRD-safe commands, can be executed with drd runcmd . See Maintaining Software on the Cloned Image for more information about the DRD-safe commands.

The drd runcmd command mounts the inactive system image if it has not been mounted. Generally, when drd runcmd completes, it unmounts the inactive system image. However, if the inactive system image was mounted before the command, drd runcmd leaves it mounted after completion of drd runcmd.

The drd runcmd command returns the following error codes:

0 Success

1 Error

2 Warning

The drd runcmd operation involves two commands: drd runcmd and the HP-UX command that is its argument, but it returns only a single error code. The code reflects the worst result of the two commands. If both commands are successful, the error code is 0. If either command has an error or warning result, the error code is 1 or 2. To determine which command issued the error or warning, examine the messages.

For additional information, see the drd-runcmd(1M) manpage (man drd-runcmd)

The drd runcmd command syntax is:

drd runcmd [-?] [-q] [-v] [-x extended option=value] [-x -?] [-X option_file] command <args>

Options

-?

Displays the usage message for a DRD command. This option cannot be used with other options.

-q

Decreases the verbosity level by one each time it is specified. For example, -qq will reduce the verbosity from the default value of 4 to 2. If both -x verbosity=5 and -qqq are included on the command line, the effective verbosity is 2. The minimum verbosity level is 0. (See also the -x verbosity option.)

-v

Increases the verbosity level by one each time it is specified. For example, -v will increase the effective verbosity from the default value of 4 to 5. If both -x verbosity=1 and -vv are included on the command line, the effective verbosity is 3. The maximum verbosity level is 5. (See also the -x verbosity option.)

-x extended_option=value

Sets the extended option to a value.

-x -?

Displays the list of possible -x (extended) options.

-X option_file

Gets the extended options from a file.

Extended options

The following extended options are available:

-x alternate_bootdisk=block_device_special_file

This is the alternate boot disk. The alternate boot disk must be specified as a block device special file.

-x HA_alternate_bootdisk=block_device_special_file

This is the High Availability alternate boot disk. The High Availability alternate boot disk must be specified as a block device special file. High Availability alternate boot disk is supported only on Itanium-based architecture and for PA-RISC systems that support hardware partitions.

-x ignore_unmounted_fs={true|false}

(Default is false) Controls whether a clone fails when an unmounted file system in the root volume group is detected.

-x logfile=/var/opt/drd/drd.log

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.

-x log_verbosity=4

(Default.) Specifies the level of log verboseness. Replace 4 with the following values:

0 Only ERRORS and the starting/ending BANNER messages. 1 Adds WARNING messages. 2 Adds NOTE messages. 3 Adds INFO messages (informational messages preceded by the * character.) 4 (Default) Adds verbose INFO messages. 5 Adds additional detailed INFO messages.
-x mirrordisk=block_device_special_file

Specifies the target's block device special file of the mirror disk. The block device special file should refer to an entire disk, not to a partition. This option requires that LVM mirroring is installed. The block device special file specified is used to mirror each logical volume in the target of the clone operation.

-x overwrite={true|false}

Specifies whether drd clone should overwrite existing information on the target disk. That is, it controls whether a disk containing boot, LVM, or VxVM records can be overwritten. The -x overwrite=false (default) prevents a disk that contains boot, LVM, or VxVM records from being overwritten. The -x overwrite=true allows a disk to be overwritten, even if it contains boot, LVM, or VxVM records. Note that DRD does not overwrite a disk associated with an active LVM volume group or VxVM disk group, regardless of the setting of the overwrite option. If a previously created clone is mounted, use the drd umount command to unmount it before attempting to create a new clone on the disk.

-x preview={true|false}

If true, run this command in preview mode only. That is, complete the analysis phase and exit; no changes are committed to disk. This option has the same effect as specifying -p on the command line. The default is false. This option is available on every DRD command except drd runcmd.

-x reboot={true|false}

If true, specifies the system is rebooted at the successful completion of a drd activate operation. The default is false.

-x verbosity=3 (Default.)

Specifies the level of stdout/stderr verboseness. Replace 3 with the following values:

0 Only ERRORS and the starting/ending BANNER messages. 1 Adds WARNING messages. 2 Adds NOTE messages. 3 (Default) Adds INFO messages (informational messages preceded by the * character.) 4 Adds verbose INFO messages. 5 Adds additional detailed INFO messages.
-X option_file

Gets the extended options from a file.

The drd status Command

The drd-status(1M) command displays system-specific information about the clone (the inactive system image) and the original disk (the active system image). The drd-status command provides the following convenient information:

  • Clone Disk – specifies the target disk used to create the clone of the original image.

  • Clone Disk State – reports whether the boot loader, AUTO file, and SYSINFO.TXT file (Itanium® only) are present on the clone disk.

  • Date Created – specifies when the clone image was created.

  • Clone Mirror Disk – indicates “None” if the clone does not have a mirror, or lists the device special file of the mirror disk.

  • Mirror Disk State – reports whether the boot loader, AUTO file, and SYSINFO.TXT file (Itanium® only) are present on the mirror disk.

  • Original Disk – specifies which disk the original image is on.

  • Original Disk State – reports whether the boot loader, AUTO file, and SYSINFO.TXT file (Itanium® only) are present on the original disk.

  • Booted Disk – specifies which disk is currently booted.

  • Activated Disk – upon reboot, the system will boot off this disk.

NOTE: Disk State varies depending on the system's architecture. The drd status command will list either LIF Area or EFI Partition instead of Disk State. For Itanium® systems, the Disk State will report whether the personality file, SYSINFO.TXT, exists on the specified disk. This file is used to rehost a disk. See the drd-rehost(1M) man page for more information.

Disk State varies depending on the system's architecture. The drd status command lists either Clone LIF Area or Clone EFI Partition.

The drd status command syntax is:

drd status [-?] [-q] [-v] [-x extended option=value] [-x -?] [-X option_file]

Options

-?

Displays the usage message for a DRD command. This option cannot be used with other options.

-q

Decreases the verbosity level by one each time it is specified. For example, -qq will reduce the verbosity from the default value of 4 to 2. If both -x verbosity=5 and -qqq are included on the command line, the effective verbosity is 2. The minimum verbosity level is 0. (See also the -x verbosity option.)

-v

Increases the verbosity level by one each time it is specified. For example, -v will increase the effective verbosity from the default value of 4 to 5. If both -x verbosity=1 and -vv are included on the command line, the effective verbosity is 3. The maximum verbosity level is 5. (See also the -x verbosity option.)

-x extended_option=value

Sets the extended option to a value.

-x -?

Displays the list of possible -x (extended) options.

-X option_file

Gets the extended options from a file.

Extended options

The following extended options are available:

-x alternate_bootdisk=block_device_special_file

This is the alternate boot disk. The alternate boot disk must be specified as a block device special file.

-x HA_alternate_bootdisk=block_device_special_file

This is the High Availability alternate boot disk. The High Availability alternate boot disk must be specified as a block device special file. High Availability alternate boot disk is supported only on Itanium-based architecture and for PA-RISC systems that support hardware partitions.

-x ignore_unmounted_fs={true|false}

(Default is false) Controls whether a clone fails when an unmounted file system in the root volume group is detected.

-x logfile=/var/opt/drd/drd.log

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.

-x log_verbosity=4

(Default.) Specifies the level of log verboseness. Replace 4 with the following values:

0 Only ERRORS and the starting/ending BANNER messages. 1 Adds WARNING messages. 2 Adds NOTE messages. 3 Adds INFO messages (informational messages preceded by the * character.) 4 (Default) Adds verbose INFO messages. 5 Adds additional detailed INFO messages.
-x mirrordisk=block_device_special_file

Specifies the target's block device special file of the mirror disk. The block device special file should refer to an entire disk, not to a partition. This option requires that LVM mirroring is installed. The block device special file specified is used to mirror each logical volume in the target of the clone operation.

-x overwrite={true|false}

Specifies whether drd clone should overwrite existing information on the target disk. That is, it controls whether a disk containing boot, LVM, or VxVM records can be overwritten. The -x overwrite=false (default) prevents a disk that contains boot, LVM, or VxVM records from being overwritten. The -x overwrite=true allows a disk to be overwritten, even if it contains boot, LVM, or VxVM records. Note that DRD does not overwrite a disk associated with an active LVM volume group or VxVM disk group, regardless of the setting of the overwrite option. If a previously created clone is mounted, use the drd umount command to unmount it before attempting to create a new clone on the disk.

-x preview={true|false}

If true, run this command in preview mode only. That is, complete the analysis phase and exit; no changes are committed to disk. This option has the same effect as specifying -p on the command line. The default is false. This option is available on every DRD command except drd runcmd.

-x reboot={true|false}

If true, specifies the system is rebooted at the successful completion of a drd activate operation. The default is false.

-x verbosity=3 (Default.)

Specifies the level of stdout/stderr verboseness. Replace 3 with the following values:

0 Only ERRORS and the starting/ending BANNER messages. 1 Adds WARNING messages. 2 Adds NOTE messages. 3 (Default) Adds INFO messages (informational messages preceded by the * character.) 4 Adds verbose INFO messages. 5 Adds additional detailed INFO messages.
-X option_file

Gets the extended options from a file.

The drd umount Command

The drd-umount(1M) command unmounts all the file systems in the cloned system image.

The drd umount command fails:

  • If the inactive system image was created by a drd clone command and no file system is mounted at /var/opt/drd/mnts/sysimage_001.

  • If the inactive system image was the original source system when a drd clone command was run and no file system is mounted at /var/opt/drd/mnts/sysimage_000.

If a cloned file system is mounted, drd umount unmounts the file systems, unmounting the root file system (/) last. For a system with an LVM root, drd umount uses deactivate and vgexport to export the inactive volume group from the system. This makes the unmounted inactive system image invisible to LVM management commands. For a system with a VxVM root, the inactivate image must remain imported to ensure that it is bootable.

The drd umount command syntax is:

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

Options

-?

Displays the usage message for a DRD command. This option cannot be used with other options.

-p

Sets preview mode. When run with the -p option, a DRD command performs analysis without running the command and reports any errors.

-q

Decreases the verbosity level by one each time it is specified. For example, -qq will reduce the verbosity from the default value of 4 to 2. If both -x verbosity=5 and -qqq are included on the command line, the effective verbosity is 2. The minimum verbosity level is 0. (See also the -x verbosity option.)

-v

Increases the verbosity level by one each time it is specified. For example, -v will increase the effective verbosity from the default value of 4 to 5. If both -x verbosity=1 and -vv are included on the command line, the effective verbosity is 3. The maximum verbosity level is 5. (See also the -x verbosity option.)

-x extended_option=value

Sets the extended option to a value.

-x -?

Displays the list of possible -x (extended) options.

-X option_file

Gets the extended options from a file.

Extended options

The following extended options are available:

-x alternate_bootdisk=block_device_special_file

This is the alternate boot disk. The alternate boot disk must be specified as a block device special file.

-x HA_alternate_bootdisk=block_device_special_file

This is the High Availability alternate boot disk. The High Availability alternate boot disk must be specified as a block device special file. High Availability alternate boot disk is supported only on Itanium-based architecture and for PA-RISC systems that support hardware partitions.

-x ignore_unmounted_fs={true|false}

(Default is false) Controls whether a clone fails when an unmounted file system in the root volume group is detected.

-x logfile=/var/opt/drd/drd.log

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.

-x log_verbosity=4

(Default.) Specifies the level of log verboseness. Replace 4 with the following values:

0 Only ERRORS and the starting/ending BANNER messages. 1 Adds WARNING messages. 2 Adds NOTE messages. 3 Adds INFO messages (informational messages preceded by the * character.) 4 (Default) Adds verbose INFO messages. 5 Adds additional detailed INFO messages.
-x mirrordisk=block_device_special_file

Specifies the target's block device special file of the mirror disk. The block device special file should refer to an entire disk, not to a partition. This option requires that LVM mirroring is installed. The block device special file specified is used to mirror each logical volume in the target of the clone operation.

-x overwrite={true|false}

Specifies whether drd clone should overwrite existing information on the target disk. That is, it controls whether a disk containing boot, LVM, or VxVM records can be overwritten. The -x overwrite=false (default) prevents a disk that contains boot, LVM, or VxVM records from being overwritten. The -x overwrite=true allows a disk to be overwritten, even if it contains boot, LVM, or VxVM records. Note that DRD does not overwrite a disk associated with an active LVM volume group or VxVM disk group, regardless of the setting of the overwrite option. If a previously created clone is mounted, use the drd umount command to unmount it before attempting to create a new clone on the disk.

-x preview={true|false}

If true, run this command in preview mode only. That is, complete the analysis phase and exit; no changes are committed to disk. This option has the same effect as specifying -p on the command line. The default is false. This option is available on every DRD command except drd runcmd.

-x reboot={true|false}

If true, specifies the system is rebooted at the successful completion of a drd activate operation. The default is false.

-x verbosity=3 (Default.)

Specifies the level of stdout/stderr verboseness. Replace 3 with the following values:

0 Only ERRORS and the starting/ending BANNER messages. 1 Adds WARNING messages. 2 Adds NOTE messages. 3 (Default) Adds INFO messages (informational messages preceded by the * character.) 4 Adds verbose INFO messages. 5 Adds additional detailed INFO messages.
-X option_file

Gets the extended options from a file.

The drd unrehost Command

The drd-unrehost(1M) command removes EFI/HPUX/SYSINFO.TXT, and optionally preserves a copy of it in a file on the booted system.

A system administrator can execute the drd unrehost command after having previously issued the drd rehost command, specifying the same target, if the disk should not be rehosted.

The format of the sysinfo file is defined in sysinfo(4). To determine the most recent patch that supplies sysinfo(4), please refer to the DRD Web site, http://docs.hp.com/en/DRD.

The drd unrehost command syntax is:

drd unrehost[-?] [-p] -f system_information_file [-q] -t device_special_file [-v] [-x extended option=value] [-x -?] [-X option_file]

Options

-?

Displays the usage message for a DRD command. This option cannot be used with other options.

-p

Sets preview mode. When run with the -p option, a DRD command performs analysis without running the command and reports any errors.

-f system_information_file

Specifies the file containing the system information (hostname, IP address, network information, etc.) to be copied to EFI/HPUX/SYSINFO.TXT on the disk specified 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.

-q

Decreases the verbosity level by one each time it is specified. For example, -qq will reduce the verbosity from the default value of 4 to 2. If both -x verbosity=5 and -qqq are included on the command line, the effective verbosity is 2. The minimum verbosity level is 0. (See also the -x verbosity option.)

-t device_special_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.

-v

Increases the verbosity level by one each time it is specified. For example, -v will increase the effective verbosity from the default value of 4 to 5. If both -x verbosity=1 and -vv are included on the command line, the effective verbosity is 3. The maximum verbosity level is 5. (See also the -x verbosity option.)

-x extended_option=value

Sets the extended option to a value.

-x -?

Displays the list of possible -x (extended) options.

-X option_file

Gets the extended options from a file.

Extended options

The following extended options are available:

-x alternate_bootdisk=block_device_special_file

This is the alternate boot disk. The alternate boot disk must be specified as a block device special file.

-x HA_alternate_bootdisk=block_device_special_file

This is the High Availability alternate boot disk. The High Availability alternate boot disk must be specified as a block device special file. High Availability alternate boot disk is supported only on Itanium-based architecture and for PA-RISC systems that support hardware partitions.

-x ignore_unmounted_fs={true|false}

(Default is false) Controls whether a clone fails when an unmounted file system in the root volume group is detected.

-x logfile=/var/opt/drd/drd.log

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.

-x log_verbosity=4

(Default.) Specifies the level of log verboseness. Replace 4 with the following values:

0 Only ERRORS and the starting/ending BANNER messages. 1 Adds WARNING messages. 2 Adds NOTE messages. 3 Adds INFO messages (informational messages preceded by the * character.) 4 (Default) Adds verbose INFO messages. 5 Adds additional detailed INFO messages.
-x mirrordisk=block_device_special_file

Specifies the target's block device special file of the mirror disk. The block device special file should refer to an entire disk, not to a partition. This option requires that LVM mirroring is installed. The block device special file specified is used to mirror each logical volume in the target of the clone operation.

-x overwrite={true|false}

Specifies whether drd clone should overwrite existing information on the target disk. That is, it controls whether a disk containing boot, LVM, or VxVM records can be overwritten. The -x overwrite=false (default) prevents a disk that contains boot, LVM, or VxVM records from being overwritten. The -x overwrite=true allows a disk to be overwritten, even if it contains boot, LVM, or VxVM records. Note that DRD does not overwrite a disk associated with an active LVM volume group or VxVM disk group, regardless of the setting of the overwrite option. If a previously created clone is mounted, use the drd umount command to unmount it before attempting to create a new clone on the disk.

-x preview={true|false}

If true, run this command in preview mode only. That is, complete the analysis phase and exit; no changes are committed to disk. This option has the same effect as specifying -p on the command line. The default is false. This option is available on every DRD command except drd runcmd.

-x reboot={true|false}

If true, specifies the system is rebooted at the successful completion of a drd activate operation. The default is false.

-x verbosity=3 (Default.)

Specifies the level of stdout/stderr verboseness. Replace 3 with the following values:

0 Only ERRORS and the starting/ending BANNER messages. 1 Adds WARNING messages. 2 Adds NOTE messages. 3 (Default) Adds INFO messages (informational messages preceded by the * character.) 4 Adds verbose INFO messages. 5 Adds additional detailed INFO messages.
-X option_file

Gets the extended options from a file.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2008 Hewlett-Packard Development Company, L.P.