drd-runcmd(1M)drd-runcmd(1M)NAMESYNOPSIS
option_file] cmd <args>
DESCRIPTION
The mode runs a command on the inactive system image that will not make
any changes to the booted system, the kernel, or the process space.
The command enables an administrator to make changes to the inactive
system image without incurring any disruption to the currently booted
system. This means that not all commands can safely be executed by the
drd runcmd operation. For example, commands that start or stop daemons
or change dynamic kernel tuneables are disruptive to current processes
and must be prevented by the
Commands which are not disruptive to the booted system and which per‐
form appropriate actions on the inactive system are known as DRD-Safe.
A short list of commands is recognized by the An attempt to use DRD to
run commands that are not DRD-Safe will terminate with an ERROR return
code without executing the command. The DRD-Safe commands are listed
below under the cmd parameter.
Options
recognizes the following options:
Displays the usage message.
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 DRD-Safe command to be run. The value of "cmd"
must be one of the following
┌───────────┬─────────────────────────────────────────┐
│cmd │ Description │
│kctune │ Change or display kernel tunables. │
│swinstall │ Install software products and patches │
│ │ that are DRD safe. │
│swjob │ Display job information │
│swm job │ Display job information after running │
│ │ update-ux through drd. To use this │
│ │ command you must also specify list, │
│ │ log or status: │
│ │ list - List jobs │
│ │ log - Display the log of a job │
│ │ status - Display the status of a job │
│swlist │ Display information about software │
│ │ products and patches. │
│swmodify │ Modify software products and patches. │
│swremove │ Remove software products and patches. │
│swverify │ Verify software products and patches. │
│view │ Read files on the inactive image. │
│update-ux │ Update software products and patches │
│ │ that are DRD safe from 11iv3 initial │
│ │ release, update 1, update 2, or update │
│ │ 3) to 11iv3 update 4. │
└───────────┴─────────────────────────────────────────┘
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
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.
Restrictions on commands executed by runcmd
When calling swinstall and update-ux, supports installation from direc‐
tory depots on the booted system and on remote servers. Note that
installing or updating from serial depots or from depots on the inac‐
tive system image is not supported.
can also be used to swlist, swverify, swremove and swmodify software
that is installed on the inactive image. It cannot be used to list or
modify any depot's contents. Using these commands outside of allows
for depot listing and management.
Syntax restrictions for sw* commands
Since depot manipulation is not supported under any option that indi‐
cates a depot target is not supported. This includes the following:
-d on swlist, swmodify, swverify, and swremove
@ options on swinstall, swlist, swverify
Any double quotation marks (") or wild cards (* or ?) in the command
line of the command to be run must be escaped to prevent inappropriate
shell expansion or truncation of the command.
Any file referenced by the command line, that is, the argument of the
view command and any argument of any of the options or must reside on
the inactive system image and must be designated by the path it would
have if the inactive image were booted. This is the same as its path
relative to the mount point of a mounted inactive image. For example,
the location that will be /var/opt/list when the image is booted is
either /var/opt/drd/mnts/sysimage_001/var/opt/list or
/var/opt/drd/mnts/sysimage_000/var/opt/list when the inactive image is
mounted. If this file is an argument of one of the options listed
above, it should be specified as simply /var/opt/list.
This restriction also applies to the arguments of "-x logfile" and "-x
patch_filter" that appear in a file that is the argument of the "-X"
option, and to paths that appear in a file that is the argument of a
"-S" option.
Note that this restriction does NOT apply to local directory depots,
which must reside on the booted system, and be designated by their
location on the booted system.
The following (rare) options of sw* commands are not supported by
┌─────────────────────────────────┬──────────────────────────────────────────────────────┐
│Option │ Notes │
├─────────────────────────────────┼──────────────────────────────────────────────────────┤
│-c │ Specification of a catalog is not supported. │
│-d │ Depot targets are not supported by drd runcmd. │
│ │ (See discussion above.) │
│-F │ │
│ │ Execution of fix scripts is not supported │
│ │ by drd runcmd. │
│-J │ Scheduling of jobs is not supported by drd runcmd. │
│-Q │ Scheduling of jobs is not supported by drd runcmd. │
│-r │ Installation to SD-style alternate roots is not │
│ │ supported by drd runcmd. │
│-t │ The inactive system image is always the target in │
│ │ a drd runcmd operation. │
│-x admin_dir │ Non-standard IPD locations are not supported by │
│ │ drd runcmd. │
│-x agent_auto_exit │ Non-standard IPD locations are not supported by │
│ │ drd runcmd. │
│-x ask │ Use of response files is not supported by │
│ │ drd runcmd. │
│-x auto_kernel_build │ Regardless of the value of this option, a swremove │
│ │ executed by drd runcmd builds the kernel for the │
│ │ next boot. │
│-x autoreboot │ Regardless of the value of this option, drd runcmd │
│ │ suppresses all reboots. │
│-x controller_source │ This option is not supported by drd runcmd. │
│-x distribution_source_directory │ This option is not supported by drd runcmd. │
│-x distribution_target_directory │ This option is not supported by drd runcmd. │
│-x force_single_target │ This option is obsolete and is not supported by │
│ │ drd runcmd. │
│-x mount_all_filesystems │ This option defaults to false in a drd runcmd │
│ │ operation. If it is set to true on the command line, │
│ │ the operation will probably not succeed. │
│-x rpc_binding_info_target │ This operation is ignored for drd runcmd operations. │
│-x remove_empty_depot │ Operations targeted at depots are not supported by │
│ │ drd runcmd. │
│-x un_as_superuser │ This option is not meaningful for drd runcmd, since │
│ │ it must be run as root. │
│-x select_local │ This option is not supported by drd runcmd. │
│-x source_tape │ Tape depots are not supported by drd runcmd. │
│-x target_shared_root │ This option is obsolete and is not supported by │
│ │ drd runcmd. │
│-x targets │ This option is not supported by drd runcmd. │
│ │ The target is always the inactive system image. │
│-x use_alternate_source │ This option is obsolete and is not supported by │
│ │ drd runcmd. │
└─────────────────────────────────┴──────────────────────────────────────────────────────┘
Return Values
returns the following values:
Success.
Error.
Warning.
Examples
To perfrom a preview of an update to 0903 HPUX11i-DC-OE on the inactive
system image from the depot /var/opt/1131_0903_DCOE:
To update the inactive image to 0903 HPUX11i-DC-OE from the depot
/var/opt/1131_0903_DCOE, and explicitly deselect T1458AA:
To see the software that is installed on the inactive system image
(without any need to mount the image first):
To install PHCO_0001 from the depot /var/opt/patches, located on the
system patchsvr:
To run a preview installation of PHCO_0001 from the depot
/var/opt/patches, located on the system patchsvr:
To verify all software on the inactive system image:
To remove PHKL_9999 from the inactive system image:
To view the swagent log on the inactive system image:
To display all extended options:
AUTHOR
was developed by Hewlett-Packard Development Company, L.P.
FILES
Log file.
SEE ALSOdrd(1M), drd-activate(1M), drd-clone(1M), drd-deactivate(1M), drd-
mount(1M), drd-rehost(1M), drd-status(1M), drd-umount(1M), drd-unre‐
host(1M), kctune(1M), swinstall(1M), swlist(1M), swmodify(1M), swm-
job(1M), swremove(1M), swverify(1M), update-ux(1M), view(1)
Dynamic Root Disk Administrator's Guide, available at
http:docs/hp.comenDRD.
drd-runcmd(1M)