swconfig.1m (2010 09)

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.

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

NOTES:

• controller is the name of the central management server.

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

Summary of content (12 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) 2) swconfig(1M) • 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 file on the controller.
PAGE 3
swconfig(1M) swconfig(1M) 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 ][.fileset ][,version ] • You can specify selections with the following shell wildcard and pattern-matching notations: [ ], *, ? • Bundles and subproducts are recursive. Bundles can contain other bundles and subproducts can contain other subproducts .
PAGE 4
swconfig(1M) swconfig(1M) Target Selections with IPv6 Address The swconfig command also supports specifying the host as an IPv6 address on HP-UX Release 11i v3, as shown below: [host_IPv6_address ][:][/directory ] If both the hostname and the path are specified, then the first occurrence of a slash (/) is treated as the separator. The IPv6 address can optionally be enclosed in a pair of square brackets ([) and (]).
PAGE 5
swconfig(1M) swconfig(1M) 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. 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.
PAGE 6
swconfig(1M) swconfig(1M) 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.gz, and reside in the same directories as the uncompressed files.
PAGE 7
swconfig(1M) swconfig(1M) Caution: use a specific installed_software_catalog to manage a specific application. SD does not support multiple descriptions of the same application in multiple IPDs. See also the admin_directory and run_as_superuser options, which control SD’s nonprivileged mode. (This mode is intended only for managing applications that are specially designed and packaged. This mode cannot be used to manage the HP-UX operating system or patches to it.
PAGE 8
swconfig(1M) swconfig(1M) reconfigure=false Prevents software which is already in the CONFIGURED state from being reconfigured. If set to true, CONFIGURED software can be reconfigured. return_warning_exitcode=false This option controls the exit code returned by SD’s controller commands. This option is applicable only for a single target operation, and ignored when multiple targets are used. When set to the default value of false, swconfig returns: 0 If there were no errors, with or without warnings.
PAGE 9
swconfig(1M) swconfig(1M) verbose=1 Controls the verbosity of the output (stdout). A value of 0 disables output to stdout. (Error and warning messages are always written to stderr). 1 enables verbose messaging to stdout. write_remote_files=false Prevents the configuring of files on a target which exists on a remote (NFS) filesystem. All files on a remote filesystem will be skipped.
PAGE 10
swconfig(1M) swconfig(1M) SW_CONFIG_AFTER_REBOOT This variable should be read only by the configure script. If this is set to any value it indicates the configure script was invoked by the swconfig command during system startup. This variable is set by the /sbin/init.d/swconfig system startup script. SW_CONTROL_DIRECTORY Defines the current directory of the script being executed, either a temporary catalog directory, or a directory within in the Installed Products Database (IPD).
PAGE 11
swconfig(1M) swconfig(1M) RETURN VALUES The swconfig command returns: 0 1 2 The software_selections were successfully configured. The configure operation failed on all target_selections. The configure operation failed on some target_selections. DIAGNOSTICS The swconfig command writes to stdout, stderr, and to specific logfiles. Standard Output The swconfig command writes messages for significant events.
PAGE 12
swconfig(1M) swconfig(1M) FILES $HOME/.swdefaults Contains the user-specific default values for some or all SD software management command options. $HOME/.sw/sessions/ Contains session files automatically saved by the SD software management commands, or explicitly saved by the user. /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.