swinstall.1m (2010 09)
s
swinstall(1M) swinstall(1M)
local swagentd. This action allows other SD commands to automatically "see" this
depot. If set to false, a new depot is not automatically registered. It can be registered
later with the swreg command.
register_new_root=true
(Applies only to swinstall.) Causes alternate roots to be registered during
swin-
stall. These can be listed with swlist
.
reinstall=false
When re-installing an existing revision of a fileset, this option causes that fileset to be
skipped, that is, not re-installed. If set to
true, the fileset is re-installed. See also
recopy=false.
reinstall_files=false
Controls the overwriting of files, which may enhance performance on slow networks or
disks. At the default value of false, SD compares each file in a source fileset to
corresponding files on the target system. SD compares the files based on size, timestamp,
and (optionally) the checksum (see reinstall_files_use_cksum
). If the files are
identical the files on the target system are not overwritten.
When set to true, SD does not compare files and overwrites any identical files on the tar-
get.
reinstall_files_use_cksum=true
Controls the use of checksum comparisons when the reinstall_files
option is set to
false. At the default value of true, this option causes SD to compute and compare check-
sums to determine if a new file should overwrite an old file. Use of checksums slows the
comparison but is a more robust check for equivalency than size and time stamp.
If set to false, SD does not compute checksums and compares files only by size and times-
tamp.
remove_obsolete_filesets=false
(Applies only to swcopy.) Controls whether swcopy automatically removes obsolete
filesets from target products in the target depot. If set to true, swcopy removes
obsolete filesets from the target products that were written to during the copy process.
Removal occurs after the copy is complete. Filesets are defined as obsolete if they were
not part of the most recent packaging of the product residing on the source depot.
retry_rpc=1
Defines the number of times a lost source connection is retried during file transfers in
swinstall or swcopy. A lost connection is one that has timed out. When used in con-
junction with the rpc_timeout option, the success of installing over slow or busy net-
works can be increased. If set to zero, any rpc_timeout to the source causes the task
to abort. If set from 1 to 9, the install of each fileset is 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.
This option also applies to the controller contacting the agent. If the agent session fails
to start for any reason, the controller tries to recontact that agent for the number of times
specified in
retry_rpc, using the values from the retry_rpc_interval option to
determine how long to wait between each attempt to recontact the agent.
retry_rpc_interval={0}
Specifies in minutes the length of the interval for repeated attempts to make a connection
to a target after an initial failure. Used in conjunction with the retry_rpc option. If
the number of values in this option equals the value of retry_rpc, SD tries reestablish-
ing a source connection for the number of times specified in retry_rpc. If the number
of values in retry_rpc_interval is less than the value in retry_rpc, SD repeats
the final interval value until the number of retries matches retry_rpc.
For example, if a session failed to start and
retry_rpc was set to 9 and
retry_rpc_interval was set to {1 2 4 8 15} to allow long waits to handle transient
network failures, the SD controller would attempt to recontact the agent after 1 minute
for the first retry, then 2 minutes for the second retry, 4 for the third, then 8, then 15 for
all additional retries until nine retries were attempted. With these values, a file load
failure could cause the operation to pause for 90 minutes (1+2+4+8+15+15+15+15+15).
If retry_rpc was set to 5 and retry_rpc_interval was set to {1 2 4 8 15}, the
14 Hewlett-Packard Company − 14 − HP-UX 11i Version 3: September 2010