drd-runcmd man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

drd-runcmd(1M)							drd-runcmd(1M)

NAME
SYNOPSIS
       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 ALSO
       drd(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)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net