swconfig.1m (2012 03)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

swconﬁg(1M) swconﬁg(1M)

NAME

swconﬁg - conﬁgure, unconﬁgure, or reconﬁgure installed software

SYNOPSIS

swconfig [-p][-u][

-v][-c catalog ][-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

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

•

swconfig can perform limited interactive operations. See Interactive Operation below.

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

man5sdon the com-

mand line.

DESCRIPTION

The

swconfig command conﬁgures, unconﬁgures, or reconﬁgures installed software products for execu-

tion on the speciﬁed targets. The

swconfig command transitions software between INSTALLED and

CONFIGURED states. Although software is automatically conﬁgured as part of the

swinstall com-

mand and unconﬁgured as part of the

swremove command, swconfig lets you conﬁgure or

unconﬁgure software independently when the need arises.

When

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

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

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

Conﬁguration primarily involves the execution of vendor-supplied conﬁgure scripts . These scripts per-

form conﬁguration tasks which enable the use of the software on the target hosts. A vendor can also sup-

ply unconﬁgure scripts to "undo" the conﬁguration performed by the conﬁgure script.

NOTES:

• You should execute

swconfig when an initial conﬁguration by swinstall failed, was

deferred, or needs to be changed.

• With

swinstall, you can defer conﬁguration by using the defer_configure

default

option.

•

swinstall does not perform conﬁguration on multiple versions of software.

• The

swconfig command only operates on software installed to the primary root ﬁle system.

•

swinstall and swremove do not run conﬁgure or unconﬁgure scripts when you specify an

alternate root directory with those commands.

Other features of

swconfig include:

• By default, the

swconfig command supports only conﬁguration of compatible software.

• If a ﬁleset speciﬁes a prerequisite on other software, that software must be in a "conﬁgured" state

before the software specifying the dependency will be conﬁgured.

• The

swconfig command conﬁgures multiple versions of a product if you set

allow_multiple_versions=true. The vendor must therefore detect and prevent multiple

conﬁgured versions in their conﬁgure scripts, if that is necessary.

• Conﬁgure scripts are useful for software updates and reinstallation, as well as ﬁrst-time installa-

tion.

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

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

Summary of content (14 pages)

PAGE 1
swconfig(1M) swconfig(1M) NAME swconfig - configure, unconfigure, or reconfigure installed software SYNOPSIS swconfig [-p] [-u] [-v] [-c catalog ] [-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 • This command supports operation on remote systems. See Remote Operation below. • swconfig can perform limited interactive operations. See Interactive Operation below.
PAGE 2
swconfig(1M) swconfig(1M) NOTES: 2) • 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.
PAGE 3
swconfig(1M) swconfig(1M) Operands Most SD commands support two types of operands: software selections followed by target selections . These operands are separated by the "at" (@) character. This syntax implies that the command operates on "software selections at targets". Software Selections The swconfig command supports the following syntax for each software_selection: bundle [.product [.subproduct ][.fileset ]][,version ] product [.subproduct ][.
PAGE 4
swconfig(1M) swconfig(1M) A host may be specified by its host name, domain name, or Internet address. If host is specified, the directory must be an absolute path. To specify a relative path when no host is specified, the relative path must start with ./ or ../; otherwise, the specified name is considered as a host.
PAGE 5
swconfig(1M) swconfig(1M) 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. agent_timeout_minutes=10000 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.
PAGE 6
swconfig(1M) swconfig(1M) explicitly selected. This option is ignored when the autoselect_dependencies option is set to false. compress_index=false Determines whether SD commands create compressed INDEX and INFO catalog files when writing to target depots or roots. The default of false does not create compressed files. When set to true, SD creates compressed and uncompressed INDEX and INFO files. The compressed files are named INDEX.gz and INFO.
PAGE 7
swconfig(1M) swconfig(1M) • If global_srp=true, and local_srp_list option is not specified, then swconfig will configure the software only on the global view. • If global_srp=true, and local_srp_list is set, then swconfig will configure the software on the global view and the listed system containers. • If local_srp_list is set, and global_srp option is not specified, then swconfig will configure the software only on the listed system containers.
PAGE 8
swconfig(1M) swconfig(1M) logdetail=false Controls the amount of detail written to the logfile. When set to true, this option adds detailed task information (such as options specified, progress statements, and additional summary information) to the logfile. This information is in addition to log information controlled by the loglevel option. See loglevel below and the sd(5) manual page, by typing man 5 sd, for more information. logfile=/var/adm/sw/swconfig.
PAGE 9
swconfig(1M) swconfig(1M) higher value for a slow or busy network. Lower values will give faster recognition on attempts to contact hosts that are not up, or are not running the 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. 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.
PAGE 10
swconfig(1M) swconfig(1M) Session File Each invocation of the swconfig command defines a configuration session. The invocation options, source information, software selections, and target hosts are saved before the installation or copy task actually commences. This lets you re-execute the command even if the session ends before proper completion. Each session is automatically saved to the file $HOME/.sw/sessions/swremove.last. This file is overwritten by each invocation of swconfig.
PAGE 11
swconfig(1M) swconfig(1M) 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. SW_LOCATION Defines the location of the product, which may have been changed from the default product directory.
PAGE 12
swconfig(1M) swconfig(1M) DIAGNOSTICS The swconfig command writes to stdout, stderr, and to specific logfiles. Standard Output The swconfig command writes messages for significant events. These include: • • a begin and end session message, selection, analysis, and execution task messages for each target_selection. Standard Error The swconfig command also writes messages for all WARNING and ERROR conditions to stderr.
PAGE 13
swconfig(1M) swconfig(1M) /usr/lib/sw/sys.defaults Contains the master list of current SD options with their default values. /var/adm/sw/ The directory which contains all configurable and non-configurable data for SD software management commands. This directory is also the default location of logfiles. /var/adm/sw/defaults Contains the active system-wide default values for some or all SD software management command options. /var/adm/sw/getdate.
PAGE 14
(Notes) A (Notes) sA 14 Hewlett-Packard Company −1− HP-UX 11i Version 3: March 2012