swm-install(1M)swm-install(1M)NAME
swm install - installs or updates selected software
SYNOPSIS
selections_file] source] option_file] [[software_selections]...]
NOTE
The list and install major modes are not supported in this release.
Options, modes and behavior will change in future versions. These com‐
mands are provided for evaluation purposes only.
DESCRIPTION
The swm install command installs or updates selected software packages.
recognizes the following options:
Displays the usage message.
Displays the list of possible
(extended) options.
Launches interactive user interface.
(Mutually exclusive with
Sets preview mode. (Mutually exclusive with -i.)
The verbosity level is decreased by one for each time
is specified. (See also the option).
The verbosity level is increased by one for each time
is specified. (See also the option).
Gets software selections from a file.
Specifies the source depot.
Sets the extended option to a value. See Extended -x Options
definitions below.
Gets the extended options from
option_file. (See the file: for a description
and examples of syntax for this file).
The extended options may be specified on the command line using the
option, in a file specified using the option, or in one of the configu‐
ration files: or If the same option is given in multiple locations, the
following order is prioritized from highest to lowest:
1. Options specified on the command line
2. Options specified within an extended_option_file (-X file)
3. Options specified within the $HOME/.swm.conf file
4. Options specified within the /etc/opt/swm/swm.conf file
Note: If the same option or extended option is given multiple times
with the same location, the last option takes effect. If the option
has a single letter equivalent and both are used on the command line,
the single letter option takes effect. If the single letter option
allows a list of arguments, specifying the single letter option multi‐
ple times will append to the list.
recognizes the following (extended) options:
Usage: Advanced
Protects against inadvertently overwriting currently installed
software with otherwise identical software which has an older
revision.
Allow the installation of an older revision.
Prevent the installation of an older revision.
Usage: Advanced/Dangerous
Enforces compatibility between selected software and the target
system.
Allow the installation of software even if it is not
compatible with the target system.
Prevent the installation of software that is not compatible
with target system.
Usage: Advanced/Dangerous
Determines whether partial patches are allowed to be installed
or not.
Allow a single patch fileset to install to a target
without dragging along appropriate sibling filesets.
Appropriate sibling filesets are filesets that have an
ancestor on the target that would usually be loaded if
the option was set to its default value of false. This is
allowing a target to contain a patch that has been
'split' up into component filesets. This can be a poten‐
tially bad situation as it could allow one fileset in a
sibling group to be updated, while others remain at an
earlier release. This can result in a difficult system
to maintain andor troubleshoot, or possibly result in a
non-booting system in the case of kernel related file‐
sets.
Include in installation of a single fileset from a
multi-fileset patch, other filesets that are appropriate
for install as well, (based on target ancestors). This
is applicable for dependency resolution of patch filesets
as well as straightforward selections.
Usage: Basic
Protects against inadvertently installing software that requires
a system reboot when SWM is invoked non-interactively (Command
Line). Protects against local system rebooting without user
confirmation when SWM is run interactively. See also the
option.
Software that requires a system reboot can be
installed. All target system(s) will be automatically
rebooted without requiring further confirmation.
If in Command Line mode and software that requires a
system reboot is selected for installation, the install
session will exit with an error message. If in Interac‐
tive mode, software that requires a reboot can be
installed. A confirmation message will be presented
before rebooting the local target system.
Usage: Advanced
Controls the automatic selection of prerequisite and corequisite
software that is not explicitly selected by the user.
Requisite software will be automatically marked for
installationconfiguration.
Requisite software which is not explicitly selected will
not be automatically marked for installationconfigura‐
tion.
Usage: Basic
Selects the latest patches (based on superseding and ancestor
attributes) for a software object that a user selects for an
install operation. This allows patches to be automatically
installed in the same install session as the filesets which they
patch. When set to false, the patches corresponding to the
selected object will not be automatically selected for install.
Allow the auto selection of patches.
Prevent the auto-selection of patches.
Usage: Advanced
Determines if reference bundles are automatically selected.
Installs any bundle object that contains one or more of the
selected filesets as long as the bundle has the attribute
'is_reference=true'. The bundle object is used for ref‐
erence purposes only meaning that only the specified
filesets get installed instead of the entire contents of
the bundle.
Bundles purchased from HP are designed to follow this
behavior in order to allow a user to determine what was
purchased from HP as well as which filesets are related
to each purchase.
The above behavior is deactivated so that bundle objects
that are not selected are not automatically installed.
Usage: Basic
Enables the compression of files during transfer from a source.
This enhances performance on slower networks.
Uncompressed files are compressed before transfer from
a source.
Files are transfered from source as is.
Usage: Basic
Specifies whether compressed INDEX and INFO catalog files are
created when writing to target depots or roots. The compressed
files are named INDEX.gz and INFO.gz, and reside in the same
directories as the uncompressed files. Compressed files can
enhance performance on slower networks, although they may
increase disk space usage due to a larger Installed Products
Database and depot catalog.
The compressed INDEX and INFO files are automatically loaded
from the source agent when:
+ The source agent supports this feature.
+ INDEX.gz or INFO.gz exist on the source depot.
+ INDEX.gz or INFO.gz are not older than the corresponding
uncompressed INDEX or INFO files.
The uncompressed INDEX or INFO file is accessed by the source
agent if any problem occurs when accessing, transferring, or
uncompressing the INDEX.gz or INFO.gz file.
Creates compressed and uncompressed INDEX and INFO files.
Does not create compressed files.
Usage: Basic
Allows user to defer a system reboot. If a reboot is needed,
the user must manually reboot after the software has been
installed.
Defers reboot of system.
Allows SWM to initiate a reboot automatically when -x
auto_reboot=true is set.
Usage: Advanced
Prerequisites and corequisites specified by the software_selec‐
tions must be resolved either in the specified source, or
already installed on the target system. This helps prevent
unusable software from being installed on the system.
The correct requisite software must either be selected for
installation in the current session or it must already
exist on the target in the correct state, either
'installed' or 'configured'. An unresolved requisite
will result in an ERROR, and the software will be unse‐
lected.
Dependencies will be checked, but their absence
results in a WARNING instead of an ERROR.
Usage: Advanced/Dangerous
Controls whether or not a failure in the disk space analysis
(DSA) part of the analysis phase is fatal to the session.
A failure in DSA will result in a failure of Analysis
phase for the entire session. The command will not pro‐
ceed.
A failure in DSA will be logged, but the session will
be allowed to proceed. There is a risk of filling a
mounted disk or volume to its maximum capacity at some
point during the session. Attempts to exceed the capac‐
ity will result in a catastrophic failure of the session,
and possibly leave an unusable system.
Usage: Advanced/Dangerous
Controls whether or not a failure in either of the kernel build
steps (system_prep and mk_kernel) is fatal to the install ses‐
sion.
Failure to build a kernel will cause the install process
to exit if in non-interactive mode, or to prompt the user
if in an interactive mode.
A failure return from a kernel build process will be
ignored, and the install session will proceed. The cur‐
rently running kernel will remain in place.
Usage: Advanced/Dangerous
Controls the handling of errors generated by scripts. If
enforce_scripts equals false, then all script error returns are
treated as warnings, and the task continues as it would with
script warnings. If enforce_scripts equals true, and a script
returns an error, then the error is handled as appropriate for
the command executing and the type of fileset. Setting
enforce_scripts=false provides a way to continue on with kernel
fileset failures, where the default behavior is to suspend.
Generally, the option determines if a failure in a script will
result in the filesetproduct being deselected.
For install, a failure return from a product checkinstall
script will cause all filesets in that product to be des‐
elected. A failure return from a fileset checkinstall
script will cause that fileset to be deselected; the sta‐
tus of other filesets in that product will be unaffected
by the deselection.
A failure return from a checkinstallcheckremove script
will not change the selection status of either a product
or a fileset. Installation will be attempted regardless
of the failure.
Usage: Basic
Controls the install response to explicitly packaged software
(software packaged with explicit file specifications). The
default value of false causes install to set permissions (as
specified in the product specification file) on new directories
but never on pre-existing directories. When set to true, install
also sets the permissions on pre-existing directories.
Set permissions on new and pre-existing directories.
Set permissions on new directories only.
Usage: Advanced
This is the command that is executed to build a kernel.
Usage: Advanced
The path to the system's bootable kernel. It is passed to the
kernel_build_cmd via the SW_KERNEL_PATH environment variable.
Usage: Basic
This is the path to the log file for this command. Each time
SWM is run, this file will grow larger. This can be changed,
for example, to a month-specific location for easier archiving,
off-host backup, and rotation.
Usage: Basic
Specifies the level of message verbosity in the log file (See
also -x verbosity). Legal values are:
Only ERROR messages and the startingending BANNER messages.
Adds WARNING messages.
Adds NOTE messages.
Adds INFO messages (informational messages preceded by the '*'
character).
Adds verbose INFO messages.
Adds very-verbose INFO messages.
Usage: Basic
Controls whether an additional software_selection ('%match') is
added. This type of selection tells the software selection
algorithm to 'match select' all software in the source depot
that matches the software already installed on the target sys‐
tem. A match occurs if the name of the software object matches,
or if the source object's 'ancestor' (in the case of filesets)
or 'precursor' (in the case of bundles) attribute matches the
installed software.
Note: This option is for backwards compatibility, and performs
matching for the entire contents of the source depot. Finer-
grain control can be achieved by using the '%match' syntax after
the software specification of a given software object (e.g.,
'bundle%match' will only match the bundle, and software objects
below that bundle).
add '%match' to the software_selection to cause
matching to occur.
do not add '%match' to the software_selection.
Usage: Basic
Controls whether or not the process will attempt to mount all
filesystems in the etcfstab file at the beginning of the analy‐
sis phase. This step ensures that all listed filesystems are
mounted before proceeding. This policy helps to ensure that
files are not loaded into a directory that may be below a future
mount point.
The file containing the list of mounted filesystem
will be read, and an attempt will be made to mount any
filesystems which are not already mounted. If this
attempt fails, and a listed filesystem cannot be mounted,
an ERROR results and the command cannot proceed.
The mount operation is not attempted, and no check
of the current mounts is performed.
Usage: Basic
Specifies the command used to mount all file systems. The '-Q'
and '-a' options are passed to the command. Additional options
may be specified here.
SWM sets the PATH and will default to use 'sbinmount' except
during an OE update when the PATH is changed to point to OE
update safe commands.
Usage: Basic
Defines the format string which will be used for listing soft‐
ware objects when no -a or -o options are specified on the com‐
mand line. This option is identical to the 'swm list -o <for‐
mat-string>' option.
Usage: Basic
Controls whether an additional software_selection ('*,t=patch‐
col%match') is added. This type of selection tells the software
selection algorithm to 'match select' all patches in the source
depot that matches the software already installed on the target
system. A match occurs if the name of the patch's 'ancestor'
fileset is installed on the system.
Note: This option is for backwards compatibility, and performs
matching for the entire contents of the source depot. Finer-
grain control can be achieved by using the '%match' syntax after
the software specification of a given software object (e.g.,
'bundle%match' will only match the bundle, and software objects
below that bundle).
add '*,t=patchcol%match' to the
software_selection to cause matching to occur.
do not add '*,t=patchcol%match' to the
software_selection.
Usage: Basic
Saves patched files, which permits future rollback of patches.
When set to false, patches cannot be rolled back (removed)
unless the non-patch software modified by the patch is removed
at the same time.
Usage: Advanced
Indicates whether or not SWM should perform analysis of selected
software for installing on the targeted system. This command
only applies in preview mode (-p) when using the option on the
command line (i.e., this option does not apply to the TUI).
This option is useful in quickly generating a file containing
the results of the selections, based upon the command line.
Perform analysis on the selected software.
Do not perform analysis on the selected software.
Usage: Basic
If true, run this command in preview mode only (i.e., complete
the analysis phase and exit; no changes are committed to disk).
Setting this option to true has the same effect as specifying -p
on the command line.
Usage: Advanced
Defines the command used to reboot the system when necessary
during an install operation.
Usage: Advanced
When reinstalling a fileset, each of its files
will be reinstalled even if the file on the depot is
identical with the file already on the system.
When reinstalling a fileset, each file on the
depot will be compared to the corresponding file on the
system. If the files are identical (see the option) the
file in the system will not be over-written.
Usage: Advanced
Controls the method used to determine if a file in the depot is
identical to a file on the target system. This option is
checked only if the option is 'false'. The result of this
identity check will determine if the file will or will not be
overwritten. Including the checksum is a slower but more robust
test for equivalence.
When comparing individual ordinary files (not directories
or links) to determine whether or not they are identical,
include a checksum (actually a CRC) comparison to verify
their equivalence.
When comparing individual files to determine whether they
are identical or not, omit the above checksum comparison.
Test for equivalence using only the size in bytes and the
modification time for each file.
Usage: Basic
Controls whether or not filesets already on the system will be
reinstalled if the user selects them. It is intended to save
time by not forcing the reinstallation of filesets already in
place.
Every selected fileset will be reinstalled, even
if its current revision (the one in the depot) is already
installed and configured on the target system.
A fileset will not be installed if the same revision
that is in the depot is already installed and configured
on the target system.
Usage: Advanced
The retry_rpc_interval option controls the interval schedule (in
minutes) for repeated attempts to make a connection after an
initial failure. This option is used in conjunction with the
option. If the number of values in the list is equal to the
value of retry_rpc, the target will be retried retry_rpc times
with the given wait intervals. If the number of values is less
than retry_rpc, the last value given is repeated until the num‐
ber of actual retries is equal to retry_rpc.
For example, a value of '1 2 4 8 15' for this option, along with
a value of 5 for the option, will cause a wait of up to 30 min‐
utes during transient network failures. See the option and the
sd(5) man page for more details.
Usage: Advanced
Defines the number of times a lost source connection will be
retried during file transfers. A lost connection is one that
has timed out. When used in conjunction with the rpc_timeout
option, the success of installing over slow or busy networks can
be increased. If set to zero, then any timeout to the source
will cause the task to abort. If set from 1 to 9, then the
install of each fileset will be attempted that number of times.
The reinstall_files option should also be set to false to avoid
installing files within the fileset that were successfully
installed. Also see the sd(5) man page.
Usage: Advanced
Defines the network protocol sequence(s) and endpoint(s) that
should be used when accessing remote SD depots. HP-UX supports
both the udp (ncadg_ip_udp:[2121]) and tcp (ncacn_ip_tcp:[2121])
protocol sequenceendpoint. See the sd(5) man page for more info.
Usage: Advanced
Relative length of the communications timeout. This is a value
in the range from 0 to 9 and is interpreted by the DCE RPC.
Higher values mean longer times; you may need a higher value for
a slow or busy network. Lower values will give faster recogni‐
tion on attempts to contact hosts that are not up, or are not
running 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. This option may not have any
noticeable impact when using the ncacn_ip_tcp protocol sequence.
Usage: Advanced
Defines file location to send selection output to. The default
is to send selection output to stdout for SWM list. In other
swm major-modes, no selection output is produced unless this
option is set. Setting selection_output to '-' means stdout.
Usage: Basic
Defines the default software selections. If there is more than
one software selection listed, they must be separated by spaces.
The selections listed at the end of the command line will over‐
write this option.
Usage: Basic
Defines the default source to use. This option is overriden by
-s on the commande line.
Usage: Basic
The path to the kernel template file. The path is passed to the
system_prep_command via the SW_SYSTEM_FILE_PATH environment
variable.
Usage: Basic
Specifies the level of stderr verboseness:
Only ERROR messages and the startingending BANNER messages.
Adds WARNING messages.
Adds NOTE messages.
Adds INFO messages (informational messages preceded by the '*'
character).
Adds verbose INFO messages.
Adds very-verbose INFO messages.
Note: The '-v' option is equivalent to increasing ver‐
bosity by 1 (e.g., from 3 to 4) and the '-q' option is
equivalent to decreasing verbosity by 1. The '-v' and
'-q' options can be used more than once.
Usage: Basic
Prevents the modification of files on a target which exists on a
remote (NFS) filesystem. Files destined for a remote filesystem
will be skipped. If set to true and if the superuser has write
permission on the remote filesystem, the remote files will be
installed.
Allow files to be written to target.
Prevent files from be written to target.
Selects a group of software objects to be used for an operation.
software_selections
Selects a group of software objects to be used for an
operation. In addition to the SD syntax, the following
syntax is supported for
Where can be:
[,r <op> revision][,a <op> arch][,v <op> vendor]
[,c <op> category][,q=qualifier][,l=location]
[,fr <op> revision][,fa <op> arch]
Where can be:
The = (equals) relational operator lets you specify selections
with the shell wildcard and
The syntax causes that selection to be deselected even if it was
listed on the command line as part of other selections.
The syntax causes the bundle to be selected and if the bundle is
an OE bundle the required contents are selected. Remaining con‐
tents are matched according to what is currently installed on
the target. If the bundle is not an OE bundle, contents that are
new are selected (new contents have no previous revision or
their precursor/ancestor does not exist in the revision of the
bundle currently installed). Remaining contents are matched
according to what is currently installed on the target. If with
no bundle is specified, the entire source depot is matched
against software installed on the target.
Return Values
returns the following values:
Success.
Error.
Warning.
EXAMPLES
Display usage for the major mode:
Install everything from
To reinstall
To do a "dry run" or preview showing what is selected to stdout, but
turning off actual installation and analysis:
To turn on several (potentially dangerous) options that allow a product
to be installed:
AUTHOR
was developed by HP.
FILES
System-wide SWManager configuration file.
Per-user SWManager configuration file.
Template file that documents each -x option.
Log file.
SEE ALSOswm(1M), swm-oeupdate(1M), swm-job(1M), swm-list(1M), swinstall(1M).
swm-install(1M)
