 |
» |
|
|
|
agent=/usr/lbin/swagent This is the default location of the
executable invoked to perform agent tasks.
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.
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 recommended when a graphical interface will be
used. The default is 10,000 minutes, which is slightly
less than seven days.
allow_downdate=false Normally set to "false," 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 still be issued.
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 only to swinstall,
swverify, swconfig.
allow_multiple_versions=false Normally set to "false," 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 swinstall,
swconfig, swverify.
alternate_source= Syntax is host:/path, used when use_alternate_source
default is set to "true." By default, this option is not defined, meaning
use the same path as the controller. See the use_alternate_source
default.
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 to swremove
only.
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 selection of
the software and automatically reboots the local host. Applies to swinstall,
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 re-tried. 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: This autorecover operation will not work properly
if any software has pre-install scripts that move or remove 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. This option does not apply to swconfig -u. Applies to swinstall,swcopy, swverify, swconfig.
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
-u 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 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. If "false," the software can be installed without
the bundle that contains it. Applies to swinstall,
swcopy and swremove.
check_contents=true Normally set to "true," verify mtime,
size and cksum
of files. 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=xxxxx This default allows you to enter your
codeword for the software licensing procedure. Once entered you
need not re-enter the codeword.
compress_cmd=gzip This is the command called by the
source agent to compress files before transmission. The default
value is /usr/contrib/bin/gzip.
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. Applies to swinstall,
swcopy 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
Applies to swpackage
and 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 whitespace and surrounded by quotes. Applies only to swmodify.
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.
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 only to swinstall,
swcopy.
customer_id=xxxxxx 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 either using the
-x customer_id= option or by using the
Interactive User Interface.
default_private_root_tree=/export/private_roots/ Defines the default location of the
private root tree. Applies to swinstall,
swlist and swremove.
default_shared_root_tree=/export/shared_roots Defines the default location of the
shared root tree. Applies to swinstall,
swlist and swremove.
defer_configure=false Normally set to "false," swinstall will configure
the software just installed. If an alternate root directory is specified,
configuration is not done, since only hosts that are actually using
the software should be configured. If set to "true," configuration is not performed.
This option allows configuration to be manually performed later
even when the root directory is /
and is useful when installing multiple versions. Note: A multiple version of software will not be
configured if another version is already configured by swinstall. The swconfig command must be
run separately. This option is ineffective if ANY
of the installed software causes a system reboot. In that case,
the specification of ALL software installed
in the session is appended to the needs_config
file for configuration after reboot.
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 remove 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 swinstall,
swcopy, swremove, swconfig, 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 swinstall,
swcopy, 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.
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,
swremove.
files= When adding or deleting file objects,
this option can list the pathnames 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 pathname, they must be
separated by whitespace 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.
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.
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.
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.
kernel_build_cmd=/usr/sbin/mk_kernel This is the script called by the agent
for kernel building.
kernel_path=/stand/vmunix The path to the system's bootable
kernel.
layout_version=1.0[0.8] Defines the semantics to use when
parsing the PSF file. To ensure POSIX 1387.2 semantics, define a
layout_version of 1.0.
level= Level designation to list: depots,
bundles, products, subproducts, filesets or files. Applies to swlist,
swacl and swreg.
logfile=/var/adm/sw/<command>.log This is the default controller logfile
for each command. The agent logfiles are always located relative
to the depot or installation, <depot_path>/swagent.log
and <root>/var/adm/swagent.log,
respectively. <root>
is / unless an
alternate root install was performed. Applies to all commands except swlist and swacl.
logfile=/var/adm/sw/swagentd.log This is the default daemon logfile.
loglevel=x logdetail=false[true] Here are 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 logfile | loglevel=1 | logdetail=false | Only POSIX events are logged. (This is
the default.) | loglevel=1 | logdetail=true | POSIX detail as above plus task progress
messages. (Setting the loglevel=1 option
is not necessary because it is the default.) | loglevel=2 [1] | logdetail=false | POSIX and file level messages only. Setting
the logdetail=false option is not necessary. | loglevel=2 [2] | logdetail=true | All generated information is logged. |
log_msgid=0 Controls whether numeric identification
numbers are prepended to logfile 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
logfile messages.
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 to swinstall
only.
max_agents=-1 The maximum number of agents that
are permitted to run simultaneously. The value of -1 means there
is no limit.
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 |
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 only to swinstall,
swcopy, swverify, swremove, swconfig.
mount_cmd=/sbin/mount This is the command called by the
agent to mount all file systems.
objects_to_register= Defines the default root selections.
If there is more than one root selection listed, they must be separated
by spaces.
one_liner=<attributes> 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).
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.
patch_filter=software_specification
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 swinstall
and swcopy. patch_match_target=false
If set to true,
this option selects the latest patches (i.e., 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 swinstall
and swcopy. patch_one_liner=title patch_state Specifies 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. 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 swinstall,
swcopy and swremove.
reboot_cmd=/sbin/reboot This is the command called by the
agent to reboot the system.
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.
register_new_root=true Causes roots to be registered during
swinstall.
reinstall=false Normally set to "false," an existing
revision of a fileset that is already installed or available will
not be re-installed or re-copied. If set to "true," the fileset will be re-installed
or re-copied. Applies to swinstall,
swcopy.
reinstall_files=true Normally set to "true," all files
within a fileset will be re-installed (overwritten) when that fileset
is installed or re-installed (see reinstall=false
option above). When set to "false," files that have the same checksum
(see next option), size and mtime
will not be re-installed. This enhances performance on slower networks. Applies to swinstall,
swcopy, 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 the 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 swinstall,
swcopy, 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. Applies only to swremove.
rpc_binding_info=ncadg_ip_udp:[2121] An advanced feature that determines
what protocol sequence(s) and endpoint(s) should be used to contact
the daemon. This should be consistent among all hosts that work
together. This value can be a list of one or more entries of the
following form: - A DCE string binding containing
a protocol sequence (for example, ncacn_ip_tcp)
and, optionally, an endpoint (a port number). The syntax is: protocol_sequence: [endpoint].
If an endpoint is specified, the daemon uses the specified protocol
sequence with the specified "well-known" endpoint. If no endpoint
is specified, this form has the same effect as the next form. - The name of a DCE protocol sequence. An entry
of this form shows that the named protocol sequence should be used;
it does not mean an endpoint. DCE must be installed and the DCE
endpoint mapper rpcd must be running.
It will be used to find the endpoint registered by the daemon. - The literal string "all." This entry means to
use all protocol sequences supported by the Remote Procedure Call
(RPC) runtime. It should be the only entry in the list. The rpcd
must be running.
Applies to all commands except swpackage.
rpc_timeout=7 Relative length of the communications
timeout. This is a value in the range from 0 to 9 and is interpreted
by the RPC runtime. 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 running
or non-existent. Applies to all commands except 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. If the -t
target file is not specified or there
were no targets otherwise specified on the command line, the local
host is selected. This option applies only to the Command Line User
Interface only. The GUI (in the multiple target case) will never
automatically select the local system as a target. The -t
option only applies to the HP OpenView Software Distributor product
and in diskless client installations and removals.
software= 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.
software_view=all_bundles 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
commands.
source_directory=:/var/spool/sw The default depot location is /var/spool/sw. To change
this location, use the syntax host:/path. Applies to swinstall,
swcopy, swpackage.
source_file=psf This keyword defines the default package_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 The default tape location, usually
the name of an archive device with an optional host (host:/path). Applies to swinstall,
swcopy.
source_type=directory The default source type (choices are
directory, tape or file)
that points to one of the next three options. The source type derived
from the -s source
file option overrides this default. Applies to swinstall,
swcopy, swpackage.
swagent.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. (Note that 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 swagent.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.
system_file_path=/stand/system The path to the kernel's template
file.
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.
target_directory=/var/spool/sw Defines the default distribution directory
in which products will be packaged. The -d option overrides this
default. Applies to all commands except swinstall and swconfig.
target_tape=/dev/rmt/0m Defines the default tape on which
products will be packaged. The -d
options overrides this default.
target_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.
targets= There is no supplied default (see
select_local above). If there is more
than one target, they must be surrounded by brackets { } or quotes.
Targets are usually specified in a target input file, as options
on the command line or in the GUI. Multiple target specification
is available only with the HP OpenView Software Distributor product. Applies to all commands except swpackage.
uncompress_cmd=/usr/bin/uncompress This is the command called by the
source agent to uncompress files after transmission.
uncompress_files=false When set to "true," files are uncompressed
using the current uncompress_cmd. 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."
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 will apply this path to the file system of its own local
host. If only the host component exists (for example,
alternate_source=host), the agent will
apply the controller-supplied path to this host. If there is no
configured value at all for the alternate_source,
the agent will apply the controller-supplied path to its own local
host. Applies to swinstall,
swcopy.
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 or (for swpackage only) to 2 for
file level messages.
write_remote_files=false Normally set to "false," controls
whether swpackage
will write to a depot that exists on a remote (NFS) file system.
By default, files that would be installed, copied or removed on
a remote (NFS) file system will be skipped. If set to "true" and superuser has NFS
root access on the remote file system, swpackage will create or
change a depot on that file system. Applies to swinstall,
swcopy, swremove, swpackage and swconfig.
|
Printable version
