swconfig.1m (2011 09)

s
swconfig(1M) swconfig(1M)
SW_SESSION_OPTIONS
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 com-
mand 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.
SW_SOFTWARE_SPEC
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.
Environment variables that affect
swconfig
in SRP:
SW_ALLOW_LOCAL_SRP_OPS
This variable is usually not set. If it is set to TRUE or 1, this variable allows
swcon-
fig to run on a local SRP. If a value other than TRUE or 1 is specified, or if a value
is not specified, a local SRP does not support swconfig.
Signals
The
swconfig command catches the signals SIGQUIT and SIGINT, and SIGUSR1. If these signals are
received, swconfig prints a message, sends a Remote Procedure Call (RPC) to the agents to wrap up,
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. Note that when an SD command is killed, the agent does not
terminate until completing the task in progress.
The daemon ignores SIGHUP, SIGINT and SIGQUIT. It immediately exits gracefully after receiving
SIGTERM and SIGUSR2. After receiving SIGUSR1, it waits for completion of a copy or remove from a
depot session before exiting, so that it can register or unregister depots if necessary. Requests to start
new sessions are refused during this wait.
Each agent will complete the configuration task (if the execution phase has already started) before it
wraps up. This avoids leaving software in a corrupt state.
RETURN VALUES
The
swconfig command returns:
0 The software_selections were successfully configured.
1 The configure operation failed on all target_selections.
2 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. 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.
Logging
The
swconfig command logs summary events at the host where the command was invoked. It logs
detailed events to the swagent logfile associated with each target_selection.
Command Log
The
swconfig command logs all stdout and stderr messages to the the logfile
/var/adm/sw/swconfig.log. (The user can specify a different logfile by modifying the log-
file option.)
HP-UX 11i Version 3: September 2011 − 11 − Hewlett-Packard Company 11