NAME
drd-activate: drd — activate mode sets the inactive system image to be the primary boot disk the next time the system is booted
SYNOPSIS
drd activate
[-?]
[-p]
[-q]...
[-v]...
[-x option=value]...
[-x -?]
[-X
option_file]
DESCRIPTION
The
drd activate
command invokes the
setboot
command (see
setboot(1M))
to set the primary boot disk to the inactive system image.
If a clone has just been created,
the inactive system image is the target of the clone operation.
If the clone has been booted,
the inactive system image is the original system that was cloned.
Note:
Running
drd activate
multiple times with no intervening boot has the same effect as running it once.
To "undo"
drd activate,
use
drd deactivate.
See
drd-deactivate(1M).
Options
drd activate
recognizes the following options:
- -?
Displays the usage message.
- -p
Sets preview mode.
See also
-x preview,
in the
Extended -x Options
section below.
- -q
Decreases the verbosity level by one each time it is specified.
For the interaction with
-x verbosity,
see the
Extended -x Options
section below.
- -v
Increases the verbosity level by one each time it is specified.
For the interaction with
-x verbosity,
see the
Extended -x Options
section below.
- -x -?
Displays the list of possible
-x
(extended) options.
- -x option=value
Sets the extended option to a value.
See the
Extended -x Options
section below.
- -X option_file
Gets the extended options from a file.
See
drd(1M)
for an explanation of the format and an example of an option file.
Extended -x Options
drd activate
recognizes the following
-x
(extended) options.
If a default value exists, it is shown in
bold.
- -x alternate_bootdisk=diskpath
Usage: Basic
This is the alternate boot disk.
The
diskpath
must be specified as a block device file.
- -x HA_alternate_bootdisk=diskpath
Usage: Basic
This is the High Availability alternate boot disk.
The
diskpath
must be specified as a block device file.
The High Availability alternate boot disk is
supported only on Itanium-based architecture
and on PA-RISC systems that support hardware partitions.
- -x logfile=/var/opt/drd/drd.log
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.
- -x log_verbosity=4
Usage: Basic
Specifies the level of message verbosity in the log file.
(See also
-x verbosity.)
Legal values are:
- 0
Saves only ERROR messages 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
Adds verbose INFO messages.
- 5
Adds very-verbose INFO messages.
- -x preview=false
Usage: Basic
If
true,
run this command in preview mode only
(that is, complete the analysis phase and exit;
do not commit changes to disk).
Setting this option to
true
has the same effect as specifying
-p
on the command line.
- -x reboot=false
Usage: Basic
If
true,
the system is rebooted at the successful completion of a
drd activate
operation.
- -x verbosity=3
Usage: Basic
Specifies the level of standard error verboseness.
Legal values are:
- 0
Displays only ERROR messages 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
Adds verbose INFO messages.
- 5
Adds very-verbose INFO messages.
See also the
-v
and
-q
options in the
Options
section above.
The
-v
option increases the verbosity by 1
(for example, from 3 to 4) and the
-q
option decreases the verbosity by 1.
The
-v
and
-q
options can be given more than once.
Multiples can be merged, as in
-qq.
For example,
if both
-x verbosity=5
and
-qqq
are included on the command line, the effective verbosity is 2.
The minimum combined verbosity level is 0.
For example,
if both
-x verbosity=1
and
-vv
are included on the command line, the effective verbosity is 3.
The maximum combined verbosity level is 5.
RETURN VALUE
drd activate
returns one of the following values:
- 0
Success.
- 1
Error.
- 2
Warning.
EXAMPLES
To set the inactive system image as the primary boot disk:
To set the inactive system image as the primary boot disk
and a different disk as the alternate boot disk:
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:
AUTHOR
drd
was developed by HP.
FILES
- /var/opt/drd/drd.log
Log file.