swremove.1m (2010 09)

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.

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

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,orswremove GUIs.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (14 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) If you have enabled SD’s central management features, swinstall, swcopy, and swremove provide enhanced GUIs to support operations on remote machines. See Remote Operations above. Removing Patches or Patch Rollback Files To remove patch software, rollback files corresponding to the patch must be available for rollback. You must remove the base software modified by the patch. (Removing the base software also removes the patches associated with that software.
PAGE 3
swremove(1M) swremove(1M) -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. -S session_file 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.
PAGE 4
swremove(1M) swremove(1M) operators. • The = (equals) relational operator lets you specify selections with the shell wildcard and pattern-matching notations: [ ], *, ?, ! For example, the expression r=1[01].* returns any revision in version 10 or version 11. • All version components are repeatable within a single specification (for example, r>=A.12, r
PAGE 5
swremove(1M) swremove(1M) is set to true): • The default value is forced to /var/home/LOGNAME/sw. • The path element LOGNAME is replaced with the name of the invoking user, which SD reads from the system password file. • If you set the value of this option to HOME/path , SD replaces HOME with the invoking user’s home directory (from the system password file) and resolves path relative to that directory. For example, HOME/my_admin resolves to the my_admin directory in your home directory.
PAGE 6
swremove(1M) swremove(1M) 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. autoremove_job=false Controls automatic job removal. If the job is automatically removed, job information (job status or controller/agent log files) cannot be queried with swjob. autoselect_dependents=false Automatically selects all software that depends on the specified software.
PAGE 7
swremove(1M) swremove(1M) If set to false, swremove command proceeds if one or more software selections are available. If set to true, the swremove command proceeds only if all the software selections are available. installed_software_catalog=products Defines the directory path where the Installed Products Database (IPD) is stored. This information describes installed software. When set to an absolute path, this option defines the location of the IPD.
PAGE 8
swremove(1M) swremove(1M) See the logdetail option and the sd(5) manual page for more information. lookupcache_timeout_minutes=10 Controls the time in minutes to cache and re-use the results of hostname or IP address resolution lookups. A value of 0 disables the facility to cache and re-use lookup results. The maximum value allowed is 10080 minutes, which is one week. A value of: 0 10080 disables the lookup caching mechanism. is the maximum value allowed.
PAGE 9
swremove(1M) swremove(1M) when using the ncacn_ip_tcp protocol sequence. run_as_superuser=true This option controls SD’s nonprivileged mode. This option is ignored (treated as true) when the invoking user is super-user. When set to the default value of true, SD operations are performed normally, with permissions for operations either granted to a local super-user or set by SD ACLs. (See swacl (1M) for details on ACLs.
PAGE 10
swremove(1M) swremove(1M) From a command-line session, you can save session information by executing the command with the -C session__file option. You can specify an absolute path for a session file. If you do not specify a directory, 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.
PAGE 11
swremove(1M) swremove(1M) variable tells scripts where other control scripts for the software are located (for example, subscripts). 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.
PAGE 12
swremove(1M) swremove(1M) Signals The swremove command catches the signals SIGQUIT, SIGINT, and SIGUSR1. If these signals are received, the command prints a message, sends a Remote Procedure Call (RPC) to the agents to wrap up after completion, and then exits. The agent ignores SIGHUP, SIGINT, and SIGQUIT. It immediately exits gracefully after receiving SIGTERM, SIGUSR1, or SIGUSR2. Killing the agent may leave corrupt software on the system, and thus should only be done if absolutely necessary.
PAGE 13
swremove(1M) swremove(1M) 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 14
(Notes) A (Notes) sA 14 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010