swremove.1m (2012 03)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

swremove(1M) swremove(1M)

NAME

swremove - unconﬁgure and remove software products

SYNOPSIS

swremove [XToolkit Options ][

-d|-r][-i][-p][-v

][-C session_ﬁle][-f software_ﬁle]

[

-J jobid][-Q date ][

-S session_ﬁle][-t target_ﬁle][-x option=value ][-X

option_ﬁle]

[software_selections][

@ target_selections]

Remarks

•

swremove supports an interactive user interface (GUI) that can be invoked alone or by the

command. See Interactive Operation below.

• This command supports operations on remote systems. See Remote Operation below.

• For an overview of all SD commands, see the sd(5) man page by typing

man5sdon the com-

mand line.

DESCRIPTION

The

swremove command removes software_selections from target_selections (for example, root ﬁle sys-

tems). When removing installed software,

swremove also unconﬁgures the software before it is

removed. The software is not unconﬁgured when removed from an alternate root directory since it was

not conﬁgured during installation. When removing available software (within a depot),

swremove also

does not perform the unconﬁguration task.

When

HP-UX Containers (SRP) is installed and enabled, the swremove command behavior is

changed to support software management for system containers. (For more information on HP-UX Con-

tainers, refer to srp(1M) and container_system(5) manpages.)

NOTE : Selecting a bundle for removal does not always remove all ﬁlesets in that bundle. If a particular

ﬁleset is required by another bundle, that ﬁleset will not be removed. For example, if the bundles

Pas-

cal and FORTRAN both use the ﬁleset Debugger.Run and you try to remove FORTRAN, the ﬁleset

Debugger.Run will not be removed because it is also used by the bundle Pascal. This prevents the

removal of one bundle from inadvertently causing the removal of ﬁlesets needed by another bundle.

Remote Operation

You can enable Software Distributor (SD) to manage software on remote systems. To let the root user

from a central SD controller (also called the central management server or manager node) perform opera-

tions on a remote target (also called the host or agent ):

1) Set up the root, host, and template Access Control Lists (ACLs) on the remote machines to permit

root access from the controller system. To do this, run the following command on each remote sys-

tem:

/usr/lib/sw/mx/setaccess

controller

NOTES:

• controller is the name of the central management server.

• If remote system is 11.00, make sure SD patch PHCO_22526 or a superseding patch is installed

on remote system before running

setaccess.

• If remote system is older than 11.00 or for some other reason does not have

setaccess in place,

copy setaccess script from an 11.11 or higher system to the remote system.

swinstall, swcopy, and swremove have enhanced GUI interfaces for remote operations. Enable

the enhanced GUIs by creating the .sdkey ﬁle on the controller. Use this command:

touch /var/adm/sw/.sdkey

NOTE: You can also set up remote access by using the swacl directly on the remote machines to grant

root or non-root access to users from the controller system.

Interactive Operation

swremove supports a graphical user interface (GUI) or a terminal user interface (in which screen navi-

gation is done with the keyboard and no mouse) if your terminal or display cannot support the GUI.

To invoke the GUI, type

HP-UX 11i Version 3: March 2012 − 1 − Hewlett-Packard Company 1

Summary of content (16 pages)

PAGE 1
swremove(1M) swremove(1M) NAME swremove - unconfigure and remove software products SYNOPSIS swremove [XToolkit Options ] [-d|-r] [-i] [-p] [-v] [-C session_file ] [-f software_file ] [-J jobid ] [-Q date ] [-S session_file ] [-t target_file ] [-x option=value ] [-X option_file ] [software_selections] [@ target_selections] Remarks • swremove supports an interactive user interface (GUI) that can be invoked alone or by the sd command. See Interactive Operation below.
PAGE 2
swremove(1M) swremove(1M) swremove on the command line (without command-line arguments) or include -i with any other command-line options when you invoke swremove from the command line. The sd command provides an interactive interface for monitoring software jobs. You can also use it to invoke the swinstall, swcopy, or swremove GUIs. If you have enabled SD’s central management features, swinstall, swcopy, and swremove provide enhanced GUIs to support operations on remote machines.
PAGE 3
swremove(1M) swremove(1M) You can recall a session file with the -S option. -f software_file Read the list of software_selections from software_file instead of (or in addition to) the command line. -J jobid Executes a previously scheduled job. This is the syntax used by the daemon to start the job. -Q date Schedules a job for the specified date. You can change the date format by modifying the file /var/adm/sw/getdate.templ.
PAGE 4
swremove(1M) • swremove(1M) The (relational operator) component can be of the form: =, ==, >=, <=, <, >, or != which performs individual comparisons on dot-separated fields. For example, r>=B.10.00 chooses all revisions greater than or equal to B.10.00. The system compares each dot-separated field to find matches. Shell patterns are not allowed with these operators.
PAGE 5
swremove(1M) swremove(1M) The policy options that apply to swremove are: admin_directory=/var/adm/sw (for normal mode) admin_directory=/var/home/LOGNAME/sw (for nonprivileged mode) The location for SD logfiles and the default parent directory for the installed software catalog. The default value is /var/adm/sw for normal SD operations. When SD operates in nonprivileged mode (that is, when the run_as_superuser default option is set to true): • The default value is forced to /var/home/LOGNAME/sw.
PAGE 6
swremove(1M) swremove(1M) autoreboot=false 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.
PAGE 7
swremove(1M) swremove(1M) execution phase failed. If false, all script errors are treated as warnings, and swremove attempts to continue operation. A warning message appears reporting that the execution succeeded. The message wording identifies whether the failure occurred in the configure/unconfigure, checkremove, preremove, or postremove phases. enforce_selections=false Controls the behavior of swremove command by checking the software_selections available.
PAGE 8
swremove(1M) swremove(1M) local_srp_list= This option is only supported in an HP-UX Containers (SRP) enabled system. This option is used in conjunction with the global_srp option to remove software inside each system container. The list contains space separated system container names enclosed in quotes and can be a subset of all configured system containers.
PAGE 9
swremove(1M) swremove(1M) 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. remove_empty_depot=true Controls whether a depot is removed once the last product/bundle has been removed. If the depot is removed, the depot’s swagent.log and directory structure are not removed by default. If the swagent.
PAGE 10
swremove(1M) swremove(1M) Distributor Administration Guide , available at the http://www.hp.com/go/sddocs web site. See also the admin_directory and installed_software_catalog options. run_scripts=true Controls whether or not control scripts are run during a remove session. (See above for the list of control scripts typically run during swremove.) Control scripts provide important cleanup when software is removed. Setting this to false may result in some manual cleanup being required.
PAGE 11
swremove(1M) swremove(1M) the default location is $HOME/.sw/sessions/. To re-execute a saved session from an interactive session, use the Recall Session option from the File menu. To re-execute a session from a command-line, specify the session file as the argument for the -S option. When you re-execute a session file, the values in the session file take precedence over values in the system defaults file.
PAGE 12
swremove(1M) swremove(1M) SW_CONTROL_TAG Holds the tag name of the control_file being executed. When packaging software, you can define a physical name and path for a control file in a depot. This lets you define the control_file with a name other than its tag and lets you use multiple control file definitions to point to the same file. A control_file can query the SW_CONTROL_TAG variable to determine which tag is being executed.
PAGE 13
swremove(1M) swremove(1M) SW_ALLOW_LOCAL_SRP_OPS This variable is usually not set. If it is set to TRUE or 1, this variable allows swremove to run on a system container. If a value other than TRUE or 1 is specified, or if a value is not specified, a system container does not support swremove. Signals The swremove command catches the signals SIGQUIT, SIGINT, and SIGUSR1.
PAGE 14
swremove(1M) swremove(1M) file swagent.log beneath the depot directory (for example, /var/spool/sw). You can view command and target log files using the sd or swjob command. swagentd Disabled If the swagentd daemon has been disabled on the host, it can be enabled by the host’s system administrator by setting the SW_ENABLE_SWAGENTD entry in /etc/rc.config.d/swconfig to 1 and executing /usr/sbin/swagentd -r.
PAGE 15
swremove(1M) swremove(1M) SD customer web site at http://www.hp.com/go/sd-docs.
PAGE 16
(Notes) A (Notes) sA 16 Hewlett-Packard Company −1− HP-UX 11i Version 3: March 2012