swremove(1M)

a script executed during the analysis of each target_selection, it checks to make sure the removal can be attempted. If this check fails, the software product will not be removed.

a script executed immediately before the software files are removed.

a script executed immediately after the software files are removed.

a script executed during the unconfiguration of each target_selection, it unconfigures the host for the software (and the software for the host). The preremove and postremove scripts are not intended for unconfiguration tasks. They are to be used for simple file management needs such as restoring files moved during install. The unconfigure script allows the swremove command to unconfigure the hosts on which it has been running before removing the software specified.

The swremove command supports a subset of the standard X Toolkit options to control the appearance of the GUI. The supported options are: -bg, -background, -fg, -foreground, -display, -name, -xrm, and -synchronous. See the X(1) manual page for a definition of these options.

Operate on a depot rather than installed software.

(optional) Operate on an alternate root rather than /. Unconfigure scripts are not run when removing software from an alternate root directory.

Runs swremove in interactive mode (invokes the Graphical User Interface). The swremove command also supports an interactive terminal user interface (TUI) in which screen navigation is done with the keyboard (no mouse).

Previews a remove task by running the session through the analysis phase only.

Turns on verbose output to stdout. (The swremove log file is not affected by this option.) Verbose output is controlled by the default verbose=x.

Save the current options and operands to session_file. You can enter a relative or absolute path with the file name. The default directory for session files is $HOME/.sw/sessions/. You can recall a session file with the -S option.

Read the list of software_selections from software_file instead of (or in addition to) the command line.

(HP OpenView Software Distributor only)

Executes the previously scheduled job. This is the syntax used by the daemon to start the job.

(HP OpenView Software Distributor only)

Schedules the job for the specified date. The date format can be changed by modifying the file /var/adm/sw/getdate.templ.

Execute swremove based on the options and operands saved from a previous session, as defined in session_file. You can save session information to a file with the -C option.

Read the list of target_selections from target_file instead of (or in addition to) the command line.

Set the session option to value and override the default value (or a value in an alternate option_file specified with the -X option). Multiple -x options can be specified.

Read the session options and behaviors from option_file.

the system-wide default values.

the user-specific default values.

Causes the target agent to automatically exit after Execute phase, or after a failed Analysis phase. This is forced to false when the controller is using an interactive user interface, or when -p (preview) is used. This enhances network reliability and performance. The default is true - the target agent will automatically exit when appropriate. If set to false, the target agent will not exit until the controller ends the session.

Causes a target agent to exit if it has been inactive for the specified time. This can be used to make target agents more quickly detect lost network connections since RPC can take as long as 130 minutes to detect a lost connection. The recommended value is the longest period of inactivity expected in your environment. For command line invocation, a value between 10 minutes and 60 minutes is suitable. A value of 60 minutes or more is recommended when the GUI will be used. The default of 10000 is slightly less than 7 days.

Normally set to true. Specifies whether the removal of a kernel fileset should rebuild the kernel or not. If the kernel rebuild succeeds, the system automatically reboots. If set to false, the system continues to run the current kernel.

If the auto_kernel_build option is set to true, the autoreboot option must also be set to true. If the auto_kernel_build option is set to false, the value of the autoreboot option does not matter.

Prevents the removal of software requiring a reboot from the non-interactive interface. If set to true, then this software can be removed and the target system(s) will be automatically rebooted.

An interactive session always asks for confirmation before software requiring a reboot is removed.

If the auto_kernel_build option is set to true, the autoreboot option must also be set to true. If the auto_kernel_build option is set to false, the value of the autoreboot option does not matter.

Applies only to the HP OpenView Software Distributor product. Controls automatic job removal. If the job is automatically removed, job information (job status or controller/agent log files) cannot be queried with swjob.

Automatically selects all software that depends on the specified software. When set to true, and any software that other software depends on is selected for remove, swremove automatically selects that other software. If set to false, automatic selections are not made to resolve requisites.

If true, bundles that have the is_sticky attribute set to true will be automatically removed when the last of its contents is removed. If false, the sticky bundles will not be automatically removed.

Specifies the location of a depot for the controller to access to resolve selections. Setting this option can reduce network traffic between the controller and the target. Use the target selection syntax to specify the location:

This option has no effect on which sources the target uses and is ignored when used with the Interactive User Interface.

Defines the default location of the target depot.

Requires that all dependencies specified by the software_selections be resolved at the target_selections. For swremove, if a selected fileset has dependents (i.e. other software depends on the fileset) and they are not selected, do not remove the selected filesets. If set to false, dependencies will still be checked, but not enforced.

By default, if a fileset checkremove script fails (i.e. returns with exit code 1), that fileset will not be removed. If a product checkremove script fails, none of the filesets in that product will be removed . If set to false, the remove operation will proceed even when a check script fails.

This option applies only to the Interactive User Interface when no SD-OV license is in effect on a system that is a diskless server. It causes swremove to run in a single target mode, even though a diskless server normally causes swremove to run in multi-target mode.

Specifies an ASCII string giving a title to a job. It is displayed along with the job ID to provide additional identifying information about a job when swjob is invoked.

Controls whether numeric identification numbers are prepended to log file messages produced by SD:

Controls the amount of detail written to the log file. When set to true, this option adds detailed task information (such as options specified, progress statements, and additional summary information) to the log file. This information is in addition to log information controlled by the loglevel option.

See the loglevel option and the sd(5) manual page for more information.

This is the default command log file for the swremove command.

Controls the log level for the events logged to the command logfile, the target agent logfile, and the source agent logfile. This information is in addition to the detail controlled by the logdetail option.

See the logdetail option and the sd(5) manual page for more information.

By default, the swremove command attempts to automatically mount all filesystems in the /etc/fstab file at the beginning of the analysis phase, to ensure that all listed filesystems are mounted before proceeding. This policy helps to ensure that files which may be on mounted filesystems are available to be removed.

If set to false, the mount operation is not attempted, and no check of the current mounts is performed.

Defines the polling interval used by the Interactive UI of the controller. It specifies how often each target agent will be polled to obtain status information about the task being performed. When operating across wide-area networks, the polling interval can be increased to reduce network overhead.

Controls whether a depot is removed once the last product/bundle has been removed. Useful to set to false if you want to retain existing depot ACLs for subsequent depot reuse.

Defines the protocol sequence(s) and endpoint(s) on which the daemon listens and the other commands contact the daemon. If the connection fails for one protocol sequence, the next is attempted. SD supports both the tcp (ncacn_ip_tcp:[2121]) and udp (ncadg_ip_udp:[2121]) protocol sequence on most platforms.

See the sd(5) manual page (type man 5 sd) for more information.

Relative length of the communications timeout. This is a value in the range from 0 to 9 and is interpreted by the DCE RPC. Higher values mean longer times; you may need a higher value for a slow or busy network. Lower values give faster recognition on attempts to contact hosts that are not up or not running swagentd. Each value is approximately twice as long as the preceding value. A value of 5 is about 30 seconds for the ncadg_ip_udp protocol sequence. This option may not have any noticeable impact when using the ncacn_ip_tcp protocol sequence.

Defines the default software_selections. There is no supplied default. If there is more than one software selection, they must be separated by spaces.

Indicates the software view to be used by the Interactive UI of the controller. It can be set to products, all_bundles, or a bundle category tag to indicate to show only bundles of that category.

Defines the default target_selections. There is no supplied default (see select_local above). If there is more than one target selection, they must be separated by spaces.

Defines the default location of the alternate root directory.

Controls the verbosity of the output (stdout). A value of

Prevents the removal of files from a remote (NFS) file system. When set to false, files on a remote file system are not removed.

If set to true and if the superuser has write permission on the remote file system, the remote files are removed.

the system-wide default list of hosts

the user-specific default list of hosts

Determines the language in which messages are displayed. If LANG is not specified or is set to the empty string, a default value of C is used. See the lang(5) man page by typing man 5 sd for more information.

NOTE: The language in which the SD agent and daemon log messages are displayed is set by the system configuration variable script, /etc/rc.config.d/LANG. For example, /etc/rc.config.d/LANG, must be set to LANG=ja_JP.SJIS or LANG=ja_JP.eucJP to make the agent and daemon log messages display in Japanese.

Defines the current directory of the script being executed, either a temporary catalog directory, or a directory within in the Installed Products Database (IPD). This variable tells scripts where other control scripts for the software are located (e.g. subscripts).

Defines the location of the product, which may have been changed from the default product directory. When combined with the SW_ROOT_DIRECTORY, this variable tells scripts where the product files are located.

A PATH variable which defines a minimum set of commands available for use in a control script (e.g. /sbin:/usr/bin).

Defines the root directory in which the session is operating, either "/" or an alternate root directory. This variable tells control scripts the root directory in which the products are installed. A script must use this directory as a prefix to SW_LOCATION to locate the product's installed files. The configure script is only run when SW_ROOT_DIRECTORY is "/".

Contains the pathname of a file containing the value of every option for a particular command, including software and target selections. This lets scripts retrieve any command options and values other than the ones provided explicitly by other environment variables. For example, when the file pointed to by SW_SESSIONS_OPTIONS is made available to a request script, the targets option contains a list of software_collection_specs for all targets specified for the command. When the file pointed to by SW_SESSIONS_OPTIONS is made available to other scripts, the targets option contains the single software_collection_spec for the targets on which the script is being executed.

This variable contains the fully qualified software specification of the current product or fileset. The software specification allows the product or fileset to be uniquely identified.

This variable and the UNIX95 variable are exported with a value that forces "classic" behavior of swremove instead of UNIX95 behavior. For HP-UX 10.30 and later versions, this variable is set to "1".

Indicates whether a kernel build is scheduled for the current install/remove session. A TRUE value indicates that the selected kernel fileset is scheduled for a kernel build and that changes to /stand/system are required. A null value indicates that a kernel build is not scheduled and that changes to /stand/system are not required.

The value of this variable is always equal to the value of SW_SESSION_IS_REBOOT.

Indicates whether a reboot is scheduled for a fileset selected for removal. Because all HP-UX kernel filesets are also reboot filesets, the value of this variables is always equal to the value of SW_SESSION_IS_KERNEL.

This variable, along with the PRE_U95 variable, is exported with a value that forces "classic" behavior of swremove instead of UNIX95 behavior. For the 10.30 or later release of HP-UX, this variable is cleared.

A non-interactive swremove session logs all stdout and stderr messages to the the logfile /var/adm/sw/swremove.log. Similar messages are logged by an interactive swremove session. The user can specify a different logfile by modifying the logfile option.

A swagent process performs the actual remove operation at each target_selection. When removing installed software, the swagent logs messages to the file var/adm/sw/swagent.log beneath the root directory (e.g. / or an alternate root directory). When removing available software (within a depot), the swagent logs messages to the file swagent.log beneath the depot directory (e.g. /var/spool/sw).