 |
» |
|
|
 |
agent=/usr/lbin/swagent This is the default location of the executable invoked to
perform agent tasks. Applies to swagentd. agent_auto_exit=true Causes the target agent to automatically exit after execute
phase, or after a failed analysis phase. This is forced to "false"
when the controller is using an interactive UI, or when -p
(preview) is used. Enhances network reliability and performance. The default is "true" - the target agent
will automatically exit when appropriate. If set to "false", the target agent will
not exit until the controller explicitly ends the session. Applies to swconfig, swcopy,
swinstall, swremove, and swverify. agent_timeout_minutes=10000 Causes a target agent to exit if it has been inactive for
the specified time. You can use this default value to make target agents more
quickly detect lost network connections. (RPC can take as long 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 and 60 minutes
is suitable. More than 60 minutes is recommended when a graphical
interface will be used. The default is 10,000 minutes, which is slightly less than
seven days. Applies to swcopy, swinstall,
swlist, swremove, and swverify. allow_downdate=false Normally set to "false," so installing an
older version of software than already exists is disallowed. This
keeps you from installing older versions by mistake. Additionally,
many software products will not support this "downdating." If set to "true," a previous version can
be installed but a warning message will be issued. Applies to swinstall. allow_incompatible=false Normally set to "false," only software compatible
with the local host is allowed to be installed or configured. If set to "true," no compatibility checks
are made. Applies to swconfig, swinstall,
and swverify. allow_multiple_versions=false Normally set to "false," so installed or
configured multiple versions (for example, the same product, but
a different revision, installed into a different location) are disallowed.
Even though multiple installed versions of
software are supported if the software is locatable, multiple configured
versions will not work unless the product supports it. If set to "true," you are allowed to install
and manage multiple versions of the same software. Applies to swconfig, swinstall, and swverify. alternate_source= Syntax is host:path,
used when use_alternate_source default is set
to "true." By default, this option is not defined. If the host portion
is not specified, the local host is used. If the path is not specified,
the path sent by the command is used. See the use_alternate_source
default. The protocol sequence and endpoint given by the option rpc_binding_info_alt_source
are used when the agent attempts to contact an alternate source
depot. Applies only to swagent. ask=true Executes a request script, which asks for a user response. The ask
option has three possible values; - true
(Default for swask) Executes
the request script (if one exists for the selected software) and
stores the user response in a file named response. - false
(Default for swinstall and swconfig.)
Does not execute request scripts. - as_needed
Before executing a request script, swask
first determines if a response file already exists and executes
the request script only if the response file is absent from the
control directory.
See Chapter 12 “Requesting User Responses” for
more information on the swask command. See Chapter 11 “Using Control Scripts ” for more information
on request scripts. Applies to swask, swconfig,
and swinstall. auto_kernel_build=true[false] Normally set to true. Specifies whether the removal of a kernel
fileset should rebuild the kernel or not. If the kernel rebuild
succeeds, the system will automatically reboot. If set to false,
the system will continue to run the current kernel. If the auto_kernel_build option is set
to "true", the autoreboot option
must also be set to "true". If the auto_kernel_build
option is set to "false" the value of the autoreboot
option does not matter. Applies only to swremove. autoreboot=false Normally set to "false," installation of
software requiring a reboot is not allowed from the command line. If set to "true," this option allows installation
or removal of the software and automatically reboots the local host. If the auto_kernel_build option is set
to "true," this option must also be set to "true." Applies to swinstall
and swremove. autorecover_product=false Normally "false," files are removed as they
are updated by swinstall. If
there is a load error, the product loading will be marked "corrupt"
and the install must be retried. When this option is "true," all files are
saved as backup copies until all filesets in the current product
loading are complete; then they are removed. At the cost of a temporary
increase in disk space and slower performance, this allows for automatic
recovery of filesets in that product if the load fails. Note: The autorecover operation will not work properly if
any software has pre-install scripts that move or remove files.
This includes HP-UX operating system files. Applies only to swinstall. autoselect_dependencies=true Causes SD-UX to automatically select requisites when software
is being selected. When set to "true," and any
software which has requisites is selected, it makes sure that the
requisites are met. If they are not already met, they are automatically
selected for you. If set to "false," automatic
selections are not made to resolve requisites. Applies to swconfig,
swcopy, swinstall
and swverify. autoselect_dependents=false Causes swconfig
to automatically select dependents when software is being selected.
When set to "true," and any software on which
other software depends is selected, SD-UX makes sure that the dependents
are also selected. If they are not already selected, they are automatically
selected for you. If set to "false," dependents
are not automatically selected. Applies to swconfig and
swremove. autoselect_patches=true Automatically
selects the latest patches (based on superseding and ancestor attributes)
for a software object that a user selects for a swinstall
or swcopy operation. When set
to "false," the patches corresponding to the selected
object are not automatically selected. You can use the patch_filter=
option in conjunction with autoselect_patches. Applies to swask, swinstall
and swcopy. autoselect_reference_bundles=true If "true," a bundle that is "referenced"
will be installed along with the software from which it is made. Applies to swcopy, swinstall
and swremove. check_contents=true Normally set to "true," verify mtime,
size and cksum
of files. If "false," the software can be installed
without the bundle that contains it. Applies only to swverify. check_permissions=true Normally set to "true," verify owner, uid,
group, gid and mode attributes of files. Applies only to swverify. check_requisites=true Normally set to "true," verify that the
prerequisites and corequisites of filesets are being met. Applies only to swverify. check_scripts=true Normally set to "true," run the vendor-supplied
verify scripts when installing software. Applies only to swverify. check_volatile=false Normally
set to "false," include installed files in the
verification that have the is_volatile
attribute set. By default, installed volatile files do not have
their attributes verified because they are volatile by definition. Applies only to swverify. codeword= This default allows you to enter your codeword for the software
licensing procedure. Once entered you need not re-enter the codeword. If a new HP product is purchased and a previous codeword has
been entered for that CD-ROM, enter the new codeword normally, and
the codewords will be merged internally. compress_cmd=/usr/contrib/bin/gzip This is the command called by the source agent to compress
files before installing, copying or packaging. If the compression_type option is set to
other than gzip or compress,
this path must be changed. Applies to swagent and swpackage. compress_files=false Normally set to "false," files will not
be compressed before transfer from a remote source and uncompressed
after transfer. If set to "true," compressing files will
enhance performance on slower networks (50 Kbytes/sec. or less)
However, it may not improve fast networks. If set to "true," depots will be smaller,
unless uncompress_files is also set to "true." Applies to swcopy, swinstall
and swpackage. compression_type=gzip Defines the default compression type used by the agent (or
set by swpackage) when it compresses
files during or after transmission. If uncompress_files is set to "false,"
the compression type is recorded for each file compressed so that
the correct uncompression can later be applied during a swinstall,
or a swcopy with uncompress_files
set to "true." The compress_cmd specified must produce
files with the compression_type
specified. The uncompress_cmd must be able to process
files of the compression_type
specified unless the format is "gzip" which is
uncompressed by the internal uncompressor ("funzip").
To use "gzip" you must load the SW-DIST.GZIP fileset.
If the SW-DIST.GZIP fileset (which is optional freeware) is loaded,
then you may set the compression options to: compress_cmd=/usr/contrib/bin/gzip uncompress_cmd=/usr/contrib/bin/gunzip compression_type=gzip Applies to swpackage
and swagent. config_cleanup_cmd=/usr/lbin/sw/config_clean Defines the script called by the agent to perform release-specific
configure cleanup steps. Applies only to swagent. control_files= When adding or deleting control file objects, this option
lists the tags of those control files. There is no supplied default.
(Control file objects being added can also be specified in the given
product specification file.) If there is more than one tag, they must be separated by white
space and surrounded by quotes. Applies only to swmodify. controller_source= Specifies the location of a depot for the controller to access
to resolve selections. Setting this option can reduce network traffic
between the controller and the target. Use the target selection
syntax to specify the location: [host][:][path] This option has no effect on which sources the target uses
and is ignored when used with an Interactive User Interface. Applies to swconfig, swcopy,
swinstall, swremove and swverify. create_target_acls=true Normally set to "true," this default determines
whether swpackage will create
Access Control Lists (ACLs) in the depot. If you are superuser and this option is set to "false,"
ACLs for each new product being packaged (and for the depot, if
it is new) will not be created. When swpackage is invoked
by any other user, it will always create ACLs in the distribution
depot. This default has no impact on the ACLs that already exist
in the depot. The swpackage
command never creates ACLs when software is packaged onto a distribution
tape. Applies only to swpackage. create_target_path=true Normally set to "true," creates the target
directory if it does not already exist. If "false," target directory is not created.
This option can be used to avoid creating new depots by mistake. Applies to swcopy and swinstall. customer_id= This default allows you to enter your customer identification
number for the software licensing procedure. Once entered, you need
not re-enter the customer_id. The customer_id is printed next to the codeword on your HP
Software Certificate which you receive with the software. The customer_id must be typed in using either the -x
customer_id= option or the Interactive
User Interface. defer_configuration=false Causes swinstall to automatically configure software_selections
after they are installed. When an alternate root directory is specified,
swinstall never performs the configuration task,
since only hosts using the software should be configured. If set
to "true," this option allows configuration to
be deferred, even when the root directory is /. When installing a successive version of a product, it will
not be configured if another version is already configured. The
swconfig command must be run separately. Applies only to swinstall distribution_source_directory=:/var/spool/sw Defines
the default distribution directory to read as the source when source_type
is directory. The -s
option overrides this default. Applies to swcopy, swinstall,
and swpackage. distribution_target_directory=/var/spool/sw Defines the default distribution directory of the target depot.
The target_selection operand overrides
this default. Applies to swacl, swcopy,
swlist, swmodify, swpackage,
swreg, swremove and swverify. distribution_target_serial=/dev/rmt/0m Defines
the default location of the target tape device file. The target_selection
operand overrides this default. Applies only to swpackage. enforce_dependencies=true Normally
set to "true," dependencies will be enforced.
The install, configure and copy commands will not proceed unless
necessary dependencies have been selected, or already exist in the
proper state ("installed," "configured"
or "available", respectively). This prevents unusable
software from being installed on the system. It also ensures that
depots contain usable sets of software. The swremove
command also supports this option, which means that, by default,
dependent software cannot be removed. If set to "false," dependencies will still
be checked, but not enforced. Corequisite dependencies, if not enforced,
may keep the software from working properly. Prerequisite dependencies,
if not enforced, may cause the installation or configuration to
fail. Applies to swconfig, swcopy,
swinstall, swremove
and swverify. enforce_dsa=true Normally set to "true," installations will
not proceed if the disk space required to install the software is
more than the available free space. Use this option to allow installation
into minfree space, or to attempt the load even though it may fail
because the disk reaches its absolute limit. If set to "false," space checks are still
performed but a warning is issued that the system may not be usable
if the disk fills past the minfree threshold. An installation will
fail if you run out of disk space. Applies to swcopy, swinstall
and swpackage. enforce_kernbld_failure = true Controls
whether or not a failure in either of the kernel build steps (system_prep
and mk_kernel) is fatal to the install
session. A failure to build a kernel will cause the install process
to exit if in non-interactive mode, or to suspend if in an interactive
mode. If set to "false", a failure return from
a kernel build process will be ignored, and the install session
will proceed. The currently running kernel will remain in place. Applies only to swinstall. enforce_scripts=true Normally set to "true," if a product or
fileset checkinstall or checkremove
script fails (that is, returns with exit code 1), none of the filesets
in that product will be loaded. If set to "false," the operation will proceed
even though a check script fails. This option can be used to force
installation or removal by circumventing check scripts. Applies to swinstall
and swremove. files= When adding or deleting file objects, this option can list
the path names of those files. There is no supplied default. File
objects being added can also be specified in the given product specification
file. If there is more than one path name, they must be separated
by white space and surrounded by double-quotes. Applies only to swmodify. follow_symlinks=false Do not follow symbolic links that exist in the packaging source;
instead, package them as symlinks. Applies only to swpackage. include_file_revisions=false Normally set to "false," controls whether
swpackage includes each source file's revision
attribute in the product(s) being packaged. Because this operation
is very time consuming, the revision attributes are not included
by default. A value of "true" for this keyword causes
swpackage to execute what(1)
and possibly ident(1) (in that
order) to try to determine a file's revision. Applies only to swpackage. install_cleanup_cmd= /usr/lbin/sw/install_clean The script called by the agent to perform release-specific
install cleanup steps immediately after the last postinstall script
has been run. For an OS update, this script should at least remove
commands that were saved by the install_setup
script. Applies only to swagent. install_setup_cmd=/usr/lbin/sw/install_setup Defines the script called by the agent to perform release-specific
install preparation. For an OS update, this script should at least
copy commands needed for the checkinstall, preinstall, and postinstall
scripts to a path where they can be accessed while the real commands
are being updated. This script is executed before any kernel filesets are loaded. Applies only to swagent. kernel_build_cmd=/usr/sbin/mk_kernel This is the script called by the agent for kernel building. Applies only to swagent. kernel_path=/stand/vmunix The path to the system's bootable kernel. It is passed to
the kernel_build_cmd via the SW_KERNEL_PATH
environment variable. Applies only to swagent. layout_version=1.0 Specifies the POSIX layout version to which the SD commands
conform when writing distributions and swlist
output. Supported values are 1.0 (default) and 0.8. The SD commands
for HP-UX version 10.10 and later can read or write either version. SD object and attribute syntax conforms to layout version
1.0 of the IEEE Standard 1387.2, Software Administration
(POSIX). SD commands still accept the keyword names associated
with the older layout version, but you should only use layout version
0.8 to create distributions readable by older versions of SD. The version used by swpackage can be controlled
by specifying the layout version attribute in the product specification
file (PSF). However, if the layout version attribute in the PSF
is 1.0, the is_locatable attribute
defaults to "true" in all cases, and must be explicitly
set to "false." Layout version 1.0 adds significant functionality not recognized
by systems supporting only version 0.8, including: Category class objects (formerly
the category and category_title
attributes within the bundle or product class). Patch-handling attributes, including applied_patches,
is_patch, and patch_state. The fileset architecture
attribute, which permits you to specify the architecture of the
target system on which the product will run.
In addition to adding new attributes and objects, layout version
1.0 changes the following preexisting 0.8 objects and attributes: Replaces the depot media_sequence_number
with the media object with a sequence number attribute. Replaces the vendor definition within products and
bundles with a vendor_tag attribute
and a corresponding vendor object defined outside the product or
bundle. Pluralizes the corequisite
and prerequisite fileset attributes. Changes the timestamp
attribute to mod_time.
Applies to swcopy, swlist,
swmodify and swpackage.
level= Specifies
a software level for swacl, swlist
and swreg. For swlist -- lists all objects down to
the specified level. Both the specified levels and the depth of
the specified software_selections control
the depth of the swlist output. The supported
software levels are: bundle -- show all objects down to
the bundle level. product -- show all objects down to the product
level. Also use -l bundle -l
product to show bundles. subproduct -- show all objects down to the subproduct
level. fileset -- show all objects down to the fileset
level. Also use -l fileset
-l subproduct to show
subproducts. file -- show all objects down to the file level
(depots, products, filesets, and files). category -- show all categories of available software
objects. patch -- show all applied patches.
The supported depot and root levels are: depot -- show only the depot level
(depots that exist at the specified target hosts. root -- list all alternate roots. shroot -- list all registered shared roots (HP-UX
10.X only). prroot -- list all private roots (HP-UX 10.X only).
For swacl -- the level
option defines the level of ACLs to view or modify: host -- view or modify the ACL protecting
the host systems identified by the target_selections. depot -- view or modify the ACL protecting the software
depots identified by the target_selections. root -- view or modify the ACL protecting the root
file systems identified by the target_selections. product -- view or modify the ACL protecting the
software product identified by the software_selection.
Applies only to products in depots, not installed products in roots product_template -- view or modify the template
ACL used to initialize the ACLs of future products added to the
software depots identified by the target_selections. global_soc_template -- view or modify the template
ACL used to initialize the ACLs of future software depots or root
file systems added to the hosts identified by the target_selections. global_product_template -- view or modify the template
ACL used to initialize the product_template
ACLs of future software depots added to the hosts identified by
the target_selections.
For swreg -- the level option defines the
level of object to register or unregister. depot -- depots that exist at the
specified target hosts. root -- all alternate roots. shroot -- all registered shared roots (HP-UX 10.X
only). prroot -- all registered private roots (HP-UX 10.X
only).
Applies to swacl, swlist,
and swreg. log_msgid=0 Controls whether numeric identification numbers are prepended
to log file messages produced by SD-UX. The default value of 0 indicates
no such identifiers are attached. Values of 1-4 indicate that identifiers
are attached to messages: 1 applies to ERROR messages only 2 applies to ERROR and WARNING messages 3 applies to ERROR, WARNING, and NOTE messages 4 applies to ERROR, WARNING, NOTE, and certain other
log file messages.
Applies to swconfig, swcopy,
swinstall, swreg, swremove
and swverify. logdetail=false The logdetail option controls the amount
of detail written to the log file. When set to "true,"
this option adds detailed task information, such as options specified,
progress statements, and additional summary information, to the
log file. Table A-1 shows the possible combinations of loglevel
and logdetail options. Table A-1 loglevel
and logdetail Option Combinations Log Level | Log Detail | Information Included |
|---|
loglevel=0 | | No information is written to the log
file | loglevel=1 | logdetail=false | Only key events are logged. This is the
default. | loglevel=1 | logdetail=true | Event detail as above plus task progress
messages. (Setting loglevel=1 is not
necessary; it is the default.) | loglevel=2 [1] | logdetail=false | Event and file level messages only. Setting
the logdetail=false option is not necessary. | loglevel=2 [2] | logdetail=true | All information is logged. |
Applies to swconfig, swcopy,
swinstall, swreg, swremove
and swverify. logfile=/var/adm/sw/<command>.log This
is the default controller log file for each command. The agent log
files are always located relative to the target depot or target
root: /var/spool/sw/swagent.log
and /var/adm/sw/swagent.log,
respectively. Applies to all commands except swacl, swlist
and swjob. loglevel=1 This option controls the log level for events logged to the
command log file, the target agent log file and the source agent
log file by prepending identification numbers to SD log file messages.
This information is in addition to the detail controlled by the
logdetail option. A value of: 0 -- provides no information to the
log files 1 -- enables verbose logging to the log files 2 -- enables very verbose logging to the log files.
Applies to swconfig, swcopy,
swinstall, swmodify, swpackage,
swremove and swverify. match_target=false If set to "true," forces selection of filesets
from the source that match filesets already installed on the target
system. Filesets on the source which specify an installed fileset
as an "ancestor" will be selected. This option overrides any other software selections. Selections cannot be ambiguous. Applies only to swinstall. max_agents=-1 The maximum number of agents that are permitted to run simultaneously.
The value of -1 means there is no limit. Applies only to swagentd. media_capacity=1330 If
you are creating a distribution tape, this default specifies the
capacity of the tape in one million byte units (not Mbytes). This
option is required if the media is not a DDS tape or a disk file.
Without this option, swpackage
sets the size to: tape 1330 megabytes disk file free space on the disk up to minfree |
Applies only to swpackage. media_type=directory Defines the type of distribution to create. The recognized
types are directory and tape.
Without this option, swpackage
creates a distribution directory (depot) by default. Applies only to swpackage. mount_all_filesystem=true Normally
set to "true," the commands automatically try
to mount all file systems in the file system table (/etc/checklist)
at the beginning of the analysis phase and make sure that all those
file systems are mounted before proceeding. When set to "false," no additional file
systems are mounted. Applies to swconfig, swcopy,
swinstall, swremove,
swverify. mount_cmd=/sbin/mount This is the command called by the agent to mount all file
systems. Applies only to swagent. objects_to_register= Defines the default objects to register or unregister. If
there is more than one object, they must be separated by spaces. There is no supplied default. See also select_local. Applies only to swreg. one_liner=<attributes> Defines the attributes listed in the non-verbose listing. If there is more than one attribute, they must be separated
by a space and surrounded by quotes. one_liner="revision size title" You must choose which attributes (that is, revision, size,
title, etc.) a default listing of software should use. Note: the
tag attribute is always displayed
for bundles, products, subproducts and filesets; the path
will always be displayed for files. Any attributes may be chosen but a particular attribute may
not exist for all applicable software classes (bundle, product,
subproduct, fileset). For example, the software attribute, title
is available for bundles, products, subproducts and filesets, but
the attribute architecture is only available
for products. In the absence of the -v
or -a option, swlist
will display one_liner information for
each software object (bundles, products, subproducts and filesets). Applies only to swlist. os_name Specifies fileset selection for an HP-UX update. (This option
should always be used with the os_release
option.) You must specify this option from the command line or when
invoking the swinstall GUI. This options has the following syntax: os_name=operating_system:width operating_system
specifies the name of the operating system, such as HP-UX.
See the uname(1) manual page for complete information. width specifies the word
width in bits (either 32 or 64) of the OS to be installed. operating_system and
width must be separated by a colon (:).
Applies only to swinstall. os_release Specifies fileset selection for an HP-UX update. (This option
should always be used with the os_name
option.) You must specify this option from the command line or when
invoking the swinstall GUI. This options has the following syntax: os_release=release release specifies the HP-UX release.
Values include: | B.10.01 B.10.10 B.10.20 B.10.30 B.11.00 |
Applies only to swinstall. package_in_place=no Normally set to "no," a value of "yes"
for this keyword causes swpackage
to build the specified products such that the depot will not actually
contain the files that make up a product. Instead, swpackage
inserts references to the original source files used to build a
product. This behavior allows the packaging of products in a development
or test environment without consuming the full disk space of copying
all the source files into the distribution depot. Applies only to swpackage. patch_commit=false Commits a patch by removing files saved for patch rollback.
The default value is "false." When set to "true,"
this option removes the saved files for the patches specified in
the software selections for the command. Once you have run this
option on a patch, you cannot remove the patch unless you remove
the associated base software that the patch modified. Applies only to swmodify. patch_filter=*.* Specifies a software_specification
for a patch filter. This option can be is used in conjunction with the autoselect_patches
and patch_match_target options
to filter the selected patches to meet the criteria specified by
software_specification. The default software_specification
value is *.*. Applies to swask, swcopy
and swinstall. patch_match_target=false If set to "true," this option selects the
latest patches (software packaged with the is_patch
attribute set to "true") that correspond to software
on the target root or depot. The patch_filter= option
can be used with the patch_match_target
option. Applies to swcopy and
swinstall. patch_one_liner=title patch_state Use this command to specify the attributes displayed for each
object listed when the -l patch
option is invoked and when no -a
or -v option is specified.
The default display attributes are title
and patch_state. Applies to swlist and
swjob. patch_save_files=true Saves patched files, which permits future rollback of patches.
When set to "false," patches cannot be rolled
back (removed) unless the base software modified by the patch is
removed at the same time. Applies to swinstall. polling_interval=2 Normally set to 2. The polling_interval
option applies only to interactive sessions. It specifies how often
each target will be polled for status information during the analysis
and execution phases. When operating across wide-area networks,
the polling interval can be increased (higher number=longer interval
between polls) to reduce network overhead. Applies to swcopy, swinstall
and swremove. reboot_cmd=/sbin/reboot This is the command called by the agent to reboot the system. Applies to swagent. reconfigure=false This option prevents software that is already in the configured
state from being reconfigured. If set to "true,"
configured software can be reconfigured. Applies to swconfig. register_new_depot=true Normally set to "true," a newly created
depot is registered on its host. This allows other commands to automatically
see this depot. If set to "false," new depots are not registered.
This could allow you to create a private depot on which to test,
then later register it with swreg. Applies only to swcopy. register_new_root=true Causes swinstall to register
a newly-created alternate root with the local swagentd.
This allows other SD commands to automatically see this root. If set to "false," a new root will not be
automatically registered. It can be registered later with the swreg
command. Applies only to swinstall. reinstall=false Normally set to "false," an existing revision
of a fileset that is already installed or available will not be
reinstalled or recopied. If set to "true," the fileset will be reinstalled
or recopied. Applies to swcopy and
swinstall. reinstall_files=true Normally set to "true," all files within
a fileset will be reinstalled (overwritten) when that fileset is
installed or reinstalled (see reinstall=false
option above). When set to "false," files that have the
same checksum (see next option), size
and mtime will not be reinstalled. This
enhances performance on slower networks. Applies to swcopy, swinstall
and swpackage. reinstall_files_use_cksum=true Normally set to "true," this option affects
the operation when the reinstall_files option
is set to "false." Using cksum is slower, but
is a more robust way to check for files being equivalent. This is
the default for swinstall and
swcopy. The default is "false"
for swpackage, a less reliable,
but faster option. Applies to swcopy, swinstall
and swpackage. remove_empty_depot=true When the last product (or bundle) in a depot is removed, the
depot itself will be removed. If set to "false," the depot is not removed
when the last product (or bundle) in it is removed. This preserves
that depot's ACL. Applies only to swremove. remove_obsolete_filesets=false This command 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 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. Applies only to swcopy. remove_setup_cmd=/usr/lbin/sw/remove_setup Defines
the script called by the agent to perform release-specific removal
preparation. For an OS update, this script invokes the tlink
command when a fileset is removed. Applies only to swagentd. retry_rpc=1 This command 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, 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 that
were successfully installed within the fileset. Applies to swcopy and swinstall. rpc_binding_info=ncacn_ip_tcp:[2121]
ncadg_ip_udp:[2121] An advanced feature that determines on what protocol sequence(s)
and endpoint(s) the daemon listens. If the connection fails for
one protocol sequence, the next is attempted. SD supports both the
tcp and udp protocols on most platforms. The value (values for swagentd) can have
the following form: A DCE string binding containing a
protocol sequence and an endpoint (a port number). The syntax is: protocol_sequence:[endpoint] The name of a DCE protocol sequence with no endpoint specified.
This syntax is: ncadg_ip_udp or ncacn_ip_tcp Since no endpoint is specified, the DCE endpoint mapper rpcd
must be running and is used to find the endpoint registered by swagentd The literal string "all." This
entry means to use all protocol sequences supported by the DCE Remote
Procedure Call (RPC) runtime. It should be the only entry in the
list. The rpcd must be running.
Applies to all commands except swask, swmodify,
and swpackage. rpc_timeout=5 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 recognition of attempts to contact
hosts that are not up or are not running swagentd. Each value is approximately twice as long as the lower one.
A value of 5 is about 30 seconds for the ncadg_ip_udp
protocol sequence. This option may not have noticeable impact when
using the ncacn_ip_tcp protocol sequence. Applies to all commands except swmodify
and swpackage. select_local=true Normally set to "true," selects the default
depot or installation directory of the local host as the target
of the command. Applies to swacl, swconfig,
swcopy, swinstall, swlist,
swreg, swremove, swverify. software= Defines the default software_selections. There is no supplied default. If there is more than one software_selection,
they must be surrounded by brackets { } or quotes. Software is usually
specified in a software_selections input file, as options on the
command line or in the GUI or TUI. Applies to all commands except swreg. software_view=products Indicates
which software view is to be used in the GUI. It can be set to products,
all_bundles, or a bundle category
tag (shows only bundles of that category). The default view is all_bundles
plus products that are not part of a bundle. Applies to swcopy, swinstall,
swlist and swremove. source_cdrom=/SD_CDROM Defines the default location of the source CD-ROM. The syntax
can be: host:path. Applies only to swinstall. source_depot_audit=true If both source and target machine are updated to HP-UX version
10.30 or later, the system administrator at the source depot machine
can set this option to track which user
pulls which software from a depot on
the source machine and when the software
is pulled. A user running swinstall
or swcopy from a target machine
cannot set this option; only the administrator of the source depot
machine can set it. When source_depot_audit
is set to its default value of "true," a swaudit.log
file is created on the source depot (for writable directory depots)
or in /var/tmp (for tar
images, CD-ROMs, or other nonwritable depots). To view, print, or save the audit information, invoke the
swlist interactive user interface
(using swlist -i -d). You can view audit information based on language preference,
as long as the system has the corresponding SD message catalog files
on it. For example, you can view the source audit information in
Japanese during one invocation of swlist,
then view the same information in English at the next invocation. Applies to swagent, swinstall,
and swlist. source_file=psf This keyword defines the default product_specification_file
to read as input to the packaging or swmodify
session. It may be a relative or absolute path. Applies to swpackage
and swmodify. source_tape=:/dev/rmt/0m Defines the default tape location, usually the character-special
file of a local tape device. If the host:path
syntax is used, the host must match the local host. The -s
option overrides this value. Applies to swcopy and swinstall. source_type=directory The default source type (choices are cdrom,
file, directory,
or tape) that points to one of the next
three options. The source type derived from the -s
source file option overrides this default. The cdrom and tape
values apply to swcopy and swinstall.
The file value applies only to swpackage. system_file_path=/stand/system The path to the kernel's template file. The path is passed
to the system_prep_command via the SW_SYSTEM_FILE_PATH
environment variable. Applies only to swagent. system_prep_cmd=/usr/lbin/sysadm/system_prep The kernel build preparation script called by the agent. This
script must do any necessary preparation so that control scripts
can correctly configure the kernel that is about to be built. Applies only to swagent. targets= There is no supplied default (see also select_local).
If there is more than one target, they must be separated by spaces.
Targets are usually specified in a target input file, as options
on the command line or in the GUI. Applies to all commands. uncompress_cmd= This is the command called by the source agent to uncompress
files when installing, copying or packaging. This command processes files that were stored on the media
in compressed format. If the compression_type
of the file is gzip, the internal compression
(funzip) is used instead of the external uncompress
command. Applies to swagent and swpackage. uncompress_files=false When set to "true," files are uncompressed
using the current uncompress_cmd before
storing them on the target depot. Only one of the uncompress_files and compress_files
options may be set to "true" during a swpackage
session. The uncompress_files option may not be
set to "true" if package_in_place
is set to "true" or if the media_type
is set to "tape." Applies to swcopy and swpackage. use_alternate_source=false When the local host begins an analysis or task, the request
usually includes information describing the source binding and depot
path that the local host should use as the software source. If "false" (the normal case), the local
host will use this information to contact the source. If "true," the local host will instead use
its own configured value. On the local host, the agent's configured value for alternate_source
is specified in host:/path
format. If this value contains only a path component (for example,
alternate_source=:/path), the agent applies
this path to the file system of its own local host. If only the host component exists (for example, alternate_source=host),
the agent applies the controller-supplied path to this host. If
there is no configured value at all for the alternate_source,
the agent applies the controller-supplied path to its own local
host. Applies to swcopy and swinstall. verbose=1 By default, the command sends output to stdout
for task summary messages. Alternatively, the verbose option can
be set to 0 for session level messages (no output to stdout)
or (for swpackage and swmodify)
to 2 for file level messages. Error and warning messages are always written to stderr. For the swlist command, a verbose listing
includes all attributes that have been defined for the appropriate
level of each software_selection operand.
The attributes are listed one per line, prefaced by the attribute
keyword. The -v option overrides this default, if
it is set to 0. Applies to all commands. write_remote_files=false Prevents installation, copying or packaging of files to a
target that exists on a remote (NFS) file system. By default, files
that would be installed, copied or removed on a remote (NFS) file
system or are already there will be skipped. If set to "true" and superuser has write
permission on the remote file system, the remote files will be installed,
copied, packaged or removed. Applies to swcopy, swinstall,
swpackage, and swremove.
|