sd(5)

Set up the root, host, and template Access Control Lists (ACLs) on the remote machines to permit root access from the controller system. To do this, run the following command on each remote system:

/usr/lib/sw/mx/setaccess controller

NOTES:

swinstall, swcopy, and swremove have enhanced GUI interfaces for remote operations. Enable the enhanced GUIs by creating the .sdkey file on the controller. Use this command:

touch /var/adm/sw/.sdkey

The interactive commands support a subset of the standard X Toolkit options to control the appearance of the GUI. The supported options are: -bg, -background, -fg, -foreground, -display, -name, -xrm. and -synchronous. See the X(1) manual page for a definition of these options.

Causes the command to operate on target_selections which are software depots rather than root directories.

Causes SD commands to operate on alternate root directories, which must be specified in the @ target_selections option. (This option is not required for alternate root operations but is maintained for backward compatibility.

See the Alternate Root Directory and Depot Directory heading above for more information.)

Runs the command in interactive mode (Graphical User Interface). See the Interactive Operation and Remote Operation headings above for additional details.

(HP-UX 10.X only) Runs the command in linkinstall mode, which makes software installed under a server's shared root available to a diskless client's private root.

When run in linkinstall mode, swinstall:

Mounts are created by examining the share_link product attribute. Not all products support linkinstall. Some products may be visible without creating a new mount if they reside under an existing one.

Previews the task by executing the session through the analysis phase and exiting before the command begins to perform the actual task.

For swlist, recursively includes all objects to the fileset level.

For swjob: recursively includes all objects to the end_target level.

Undo variation of the operation, unconfiguring software using swconfig, unregistering the specified objects using swreg, or removing the specified jobs using the swjob command.

Turns on verbose output to stdout. (The command log file is not affected by this option.) By default, verbose output is enabled for all the SD commands.

List the supported data model revisions.

Specifies particular attributes to display or modify using swlist, swmodify, or the swjob command.

Specifies the pathname of the directory containing an exported catalog. For swask, this catalog stores copies of the response files created by request scripts. For swlist and swmodify, this catalog stores output or input for these commands.

Saves the current options and operands to session_file. (You can recall a session file with the -S session_file option.) See the Session File heading in this manpage for more information.

Deletes an existing entry from the ACL associated with the specified objects using swacl.

Read the list of selections from software_file instead of (or in addition to) the command line operands.

Assigns the ACL contained in acl_file to the specified object using swacl.

Executes the previously scheduled job. This option is used by the swagentd to initiate scheduled jobs.

List all objects at the specified level when using swlist, or define the level of the objects when using swacl, or swreg.

Adds a new ACL entry or changes the permissions of an existing entry using swacl.

Schedules the command for the specified date and time.

Specifies source depot, PSF file, or tape from which software will be installed, copied, listed, or packaged. (SD can read both tar and cpio tape depots.)

Executes the command based on the options and operands saved from a previous session in session_file. (You can save session information to a file with the -C session_file option.) See the Session File heading in this manpage for more information.

Read the list of target_selections from target_file instead of (or in addition to) the command line operands.

Set the session option to value and override the default value (or a value in an alternate option_file specified with the -X option). Multiple -x options can be specified.

Read the session options and behaviors from option_file. These values defined in this file override the default values.

the system-wide default values.

the user-specific default values.

The location for SD logfiles and the default parent directory for the installed software catalog. The default value is /var/adm/sw for normal SD operations. When SD operates in nonprivileged mode (that is, when the run_as_superuser default option is set to true):

SD's nonprivileged mode is intended only for managing applications that are specially designed and packaged. This mode cannot be used to manage the HP-UX operating system or patches to it. For a full explanation of nonprivileged SD, see the Software Distributor Administration Guide, available at the http://docs.hp.com web site.

See also the installed_software_catalog and run_as_superuser options.

Applies to all SD commands except swagent, swagentd, and install-sd.

The location of the agent program invoked by the daemon.

Applies to swagentd.

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. This enhances network reliability and performance. The default value of true means the target agent automatically exits when appropriate. When set to false, the target agent will not exit until the controller ends the session.

Applies to swconfig, swcopy, swinstall, swremove, swverify.

Causes a target agent to exit if it has been inactive for the specified time. This can be used to make target agents more quickly detect lost network connections since RPC can take as long as 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 minutes and 60 minutes is suitable. A value of 60 minutes or more is recommended when the GUI will be used. The default of 10000 is slightly less than 7 days.

Applies to swcopy, swinstall, swjob, swlist, swremove, swverify.

Prevents the installation of an older revision of fileset that already exists at the targets. (Many software products do not support "downdating".) If set to true, the older revision can be installed.

Applies to swinstall.

Requires that the software products which are being installed be "compatible" with the target selections. (All of the target selections must match the list of supported systems defined for each selected product.) If set to true, target compatibility is not enforced.

Applies to swconfig, swinstall, and swverify.

Prevents the installation or configuration of another, independent version of a product when a version already is already installed or configured at the target.

If set to true, another version of an existing product can be installed into a new location, or can be configured in its new location. Multiple versions can only be installed if a product is locatable. Multiple configured versions will not work unless the product supports it.

Applies to swconfig, swinstall, and swverify.

Permits the use of single patch filesets without "sibling" filesets. In the default state of false, installation, copy, or removal of a single fileset from a multi-fileset patch automatically includes any other fileset that are part of the patch, based on the ancestor filesets of the target fileset. (This behavior applies to filesets selected directly by the user and to filesets automatically selected by SD to resolve software dependencies.)

When set to true, SD allows a single patch fileset to be installed, copied, or removed without including the sibling filesets. This allows a target to contain a patch that has been "split" into its component filesets. WARNING: Splitting a patch can create a situation in which one fileset in a sibling group would be updated or removed by a patch, while the other filesets would remain at an earlier release or fail to be removed.

Applies to swinstall, swcopy, and swremove.

Defines the alternate source which the agent will use when the use_alternate_source option is set to true. The alternate source is specified using the syntax:

If the host portion is not specified, then the local host is used. If the path portion is not specified, then the path sent by the command is used. The protocol sequence and endpoint given by the option swagent.rpc_binding_info are used when the agent attempts to contact an alternate source depot.

Applies to swagent.

Executes a request script, which asks for a user response. If ask=as_needed, swinstall executes the request script only if a response file does not already exist in the control directory. See swask(1M) for more information on request scripts.

Applies to swask, swconfig, and swinstall.

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 automatically reboots. If set to false, the system continues 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.

Prevents the installation or removal of software requiring a reboot from the non-interactive interface. If set to true, then software can be installed or removed, after which the target system(s) will automatically reboot.

An interactive session always asks for confirmation before software requiring a reboot is installed or removed.

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 swinstall and swremove.

This option permits automatic recovery of original filesets if an installation error occurs. The cost is a temporary increase in disk space and slower performance. The default value of false causes swinstall to remove the original files as a fileset is updated. If an error occurs during the installation (e.g. network failure), then the original files are lost, and you must reinstall the fileset.

If set to true, all files are saved as backup copies until the current fileset finishes loading. If an error occurs during installation, the fileset's original files are replaced, and swinstall continues to the next fileset in the product or the product postinstall script.

When set to true, this option also affects scripts. For example, if a preinstall script fails, this option causes the corresponding unpreinstall script to execute. See the Software Distributor Administration Guide for complete information.

Applies only to swinstall.

This option permits automatic recovery of original product files if an installation error occurs. The cost is a temporary increase in disk space and slower performance. The default value of false causes swinstall to remove any existing product files as a product is updated. If an error occurs during installation (e.g. network failure), then the original files are lost, and you must reinstall the product.

If set to true, all files for a product are saved as backup copies until the entire product finishes loading. Then the files are removed. If an error occurs during installation, the original product files are replaced, and swinstall exits.

When set to true, this option also affects scripts. For example, if a preinstall script fails, this option causes the corresponding unpreinstall script to execute. See Software Distributor Administration Guide for complete information.

Applies only to swinstall.

Controls automatic job removal of completed jobs. If the job is automatically removed, job information (job status or target log files) cannot be queried with swjob.

Controls the automatic selection of prerequisite, corequisite, and exrequisite software that SD automatically selects. When set to true, the requisite software is automatically selected for configuration. When set to false, requisite software which is not explicitly selected is not automatically selected for configuration. When set to as_needed, autoselected dependencies are operated only if the dependency is not already met on the target.

Applies to swconfig, swcopy, swinstall, and swverify.

Controls whether or not SD automatically selects dependent software. A dependent fileset has established either a prerequisite, corequisite, or exrequisite on the selected fileset. Specifying true causes SD to automatically select dependent software. The default value of false prevents SD from automatically selecting dependent software.

Applies to swconfig and swremove.

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 will not be automatically selected.

The patch_filter option can be used in conjunction with autoselect_patches.

Applies to swask, swinstall, and swcopy.

If true, bundles that are sticky will be automatically installed, or copied, along with the software it is made up of. If false, the software can be installed, or copied, without automatically including sticky bundles that contain it.

For swremove, if set to true, any bundle with the is_sticky attribute set to true is removed automatically when the last of its contents is removed. If set to false, the sticky bundles will not be automatically removed.

Applies to swcopy, swinstall, and swremove.

Causes swverify to verify the time stamp, size, and checksum attributes of files. If set to false, these attributes are not verified.

Applies to swverify.

(This option is ignored if check_contents is set to false.) Controls whether or not swverify validates the size and checksum for compressed files. In the default state of false, swverify checks only the mtime, size and cksum attributes of the compressed file. If set to true, swverify uncompresses the file in memory and verifies the size and cksum attributes of the uncompressed contents.

Only files compressed with SD's internal compressor can be uncompressed during a swverify operation. See the compress_files option of the swpackage(1M) command for more information.

Applies to swverify.

(This option is ignored if check_contents is set to false.) Controls whether or not swverify computes a checksum on the contents of the file. In the default state of true, swverify checks all file attributes including the checksum. If set to false, swverify checks only the file timestamp and size.

Applies to swverify.

Causes swverify to verify the mode, owner, UID, group, and GID attributes of installed files. If set to false, these attributes are not verified.

Applies to swverify.

Causes swverify to verify that the prerequisite, corequisite, and exrequisite dependencies of the software selections are being met. If set to false, these checks are not performed.

Applies to swverify.

Causes swverify to run the fileset/product verify scripts for installed software. If set to false, these scripts are not executed.

Applies to swverify.

Causes swverify to not verify those files marked as volatile (i.e. can be changed). If set to true, volatile files are also checked (for installed software).

Applies to swverify.

Provides the "codeword" needed to unlock protected HP CD-ROM software.

Some HP software products are shipped on CD-ROM as "protected" products. That is, they cannot be installed or copied unless a "codeword" and "customer ID" are provided. The codeword is found on the CD-ROM certificate which you received from HP. This option stores the codeword for future reference; you needs to enter the codeword only once.

Defines the command called 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 swpackage and swagent.

If set to true, uncompressed files are compressed before transfer from a source. This enhances performance on slower networks for swcopy and swinstall, and results in smaller depots for swcopy and swpackage, unless the uncompress_files option is also set to true.

Applies to swcopy, swinstall, and swpackage.

Determines whether SD commands create compressed INDEX and INFO catalog files when writing to target depots or roots. The default of false does not create compressed files. When set to true, SD creates compressed and uncompressed INDEX and INFO files. 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. SD controllers and target agents for HP-UX 11.01 and higher automatically load the compressed INDEX and INFO files from the source agent when:

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.

Applies to swinstall, swcopy, swpackage, swmodify, swconfig, and swremove.

Defines the default compression type used by the agent 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).

Applies to swagent.

Defines the script called by the agent to perform release-specific configure cleanup steps.

Applies to swagent.

Please Note: Transition links do not exist on 11.31 and newer releases so there are no configure cleanup steps to perform therefore the config_cleanup_cmd is never executed for these releases.

When adding or deleting control file objects, this option lists the tags of those control files. There is no supplied default. If there is more than one tag, they must be separated by whitespace and surrounded by quotes.

Applies to swmodify.

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:

This option has no effect on which sources the target uses and is ignored when used with an Interactive User Interface.

Applies to swcopy, swconfig, swinstall, swremove, and swverify.

If creating a target depot, swpackage will create Access Control Lists (ACLs) for the depot (if it is new) and all products being packaged into it. If set to false, and if the user is the superuser, swpackage will not create ACLs. (The swpackage command never creates ACLs when software is packaged on to a distribution tape.)

Applies to swpackage.

Causes the agent to create the target directory if it does not already exist. If set to false, a new target directory will not be created. This option can prevent the erroneous creation of new target depots.

Applies to swcopy and swinstall.

For cumulative source depots, this option allows consistent software selections over time by swlist, swcopy, and swinstall. The default of zero includes all bundles, products, subproducts, and filesets in the source depot as candidates for selection (and autoselection of dependencies and patches), based on the software selections and other options. When set to a time (specified as seconds from epoch), only those bundles, products, and filesets (and the subproducts in the product) with a create_time less than or equal to the specified value are available for selection (or autoselection). To list the create_time of bundles, products and filesets, use:

swlist -a create_time -a create_date

Applies to swlist, swcopy, and swinstall.

This number, printed on the Software Certificate, "unlocks" protected software and restricts installation to a specific site or owner. You can enter the number with the -x customer_id= option or by using the Interactive User Interface. The customer_id can be used on any HP-UX 10.X or later system.

Applies to swinstall, swcopy, swlist.

Causes swinstall to automatically run configure scripts for the software_selections after they are installed. (Alternate root directories are not configured.)

When set to true, swinstall does not run configure scripts. If you want to configure the software later, you must run the swconfig command.

NOTES:

Applies to swinstall.

Defines the default location of the source depot (when the source_type is directory). You can also use the host:path syntax. The -s option overrides this default.

Applies to swcopy, swinstall, and swpackage.

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.

Defines the default location of the target tape device file. The target_selection operand overrides this default.

Applies to swpackage.

Requires that all dependencies specified by the software_selections be resolved either in the specified source, or at the target_selections themselves.

The swconfig, swcopy, and swinstall commands will not proceed unless the dependencies have also been selected or already exist at the target in the correct state (INSTALLED, CONFIGURED, or AVAILABLE). This prevents unusable software from being installed on the system. It also ensures that depots contain usable sets of software.

For swremove, if a selected fileset has dependents (i.e. other software depends on the fileset) and they are not selected, do not remove the selected filesets.

If set to false, dependencies are checked, but not enforced. Corequisite dependencies, if not enforced, may keep the selected software from working properly. Prerequisite or exrequisite dependencies, if not enforced, may cause the installation or configuration to fail.

Applies to swconfig, swcopy, swinstall, swremove, and swverify.

Prevents a command from proceeding past the analysis phase if the disk space required is beyond the available free space of the impacted file systems. If set to false, then the install, copy, or package operation will use the file systems' minfree space and may fail because it reaches the file system's absolute limit.

Applies to swcopy, swinstall, and swpackage.

When set to the default value of true, this option generates an error if a command tries to relocate a non-relocatable fileset. (Relocatable filesets are packaged with the is_relocatable attribute set to true). When set to false, the usual error handling process is overridden, and SD permits the command to relocate the fileset.

Note that although this option is defined for swverify, there is no behavior associated with the option.

Applies to swinstall and swverify.

The default value of true prevents swinstall from proceeding past the kernel build phase if the kernel build processes fail. If set to false, the install operation continues despite failures or warnings in the system preparation process or the kernel build process.

Applies to swinstall.

Controls the handling of errors generated by scripts. If true, and a script returns an error, the command halts, and an error message appears reporting that the execution failed. If false, script-generated errors are treated as warnings, and the command attempts to continue. A warning message appears and reports that the command was successful. Where appropriate, the message identifies the phase in which the error occurred (configure/unconfigure, preinstall/postinstall, preremove/postremove, etc.).

Applies to swask, swconfig, swinstall and swremove.

When adding or deleting file objects, this option lists the pathnames of those file objects. There is no supplied default. If there is more than one pathname, they must be separated by whitespace.

Applies to swmodify.

Controls the swinstall response to explicitly packaged software (software packaged with explicit file specifications). The default value of false causes swinstall to set permissions (as specified in the product specification file) on new directories but never on pre-existing directories. When set to true, swinstall also sets the permissions on pre-existing directories.

Applies to swinstall.

Do not follow symbolic links in the package source files, but include the symbolic links in the packaged products. A value of true for this keyword causes swpackage to follow symbolic links in the package source files and include the files they reference in the packaged products.

Applies to swpackage.

This option applies only to the Interactive User Interface on a system that is a diskless server. It causes swremove to run in a single target mode, even though a diskless server normally causes swremove to run in multi-target mode.

Applies to swremove.

Do not include each source file's revision attribute in the products being packaged. Because this operation is time consuming, by default the revision attributes are not included. If set to true, swpackage will execute what(1) and possibly ident(1) (in that order) to try to determine a file's revision attribute.

Applies to swpackage.

Defines 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. This script is executed after all filesets have been installed, just before the reboot to the new operating system.

Applies to swagent.

Please Note: Transition links do not exist on 11.31 and newer releases so there are no install cleanup steps to perform therefore the install_cleanup_cmd is never executed for these releases.

Defines the directory path where the Installed Products Database (IPD) is stored. This information describes installed software. When set to an absolute path, this option defines the location of the IPD. When this option contains a relative path, the SD controller appends the value to the value specified by the admin_directory option to determine the path to the IPD. For alternate roots, this path is resolved relative to the location of the alternate root. This option does not affect where software is installed, only the IPD location.

This option permits the simultaneous installation and removal of multiple software applications by multiple users or multiple processes, with each application or group of applications using a different IPD.

Caution: use a specific installed_software_catalog to manage a specific application. SD does not support multiple descriptions of the same application in multiple IPDs.

See also the admin_directory and run_as_superuser options, which control SD's nonprivileged mode. (This mode is intended only for managing applications that are specially designed and packaged. This mode cannot be used to manage the HP-UX operating system or patches to it. For a full explanation of nonprivileged SD, see the Software Distributor Administration Guide, available at the http://docs.hp.com web site.)

Applies to all SD commands except swacl, swask, swconfig, swinstall, swlist, swmodify, swremove, and swverify.

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 to swagent.

Please Note: Transition links do not exist on 11.31 and newer releases so there are no install setup steps to perform therefore the install_setup_cmd is never executed for these releases.

This is an ASCII string giving a title to a job. It is displayed along with the job ID to provide additional identifying information about a job when swjob is invoked.

Applies to swconfig, swcopy, swinstall, swremove, and swverify.

Defines the script called by the agent for kernel building.

Applies to swagent.

Defines the path to the system's bootable kernel. This path is passed to the kernel_build_cmd via the SW_KERNEL_PATH environment variable.

Applies to swagent.

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". SD for HP-UX version 10.10 and later can read or write either layout version.

SD object and attribute syntax conforms to the layout_version 1.0 specification of the IEEE POSIX 1387.2 Software Administration standard. SD commands still accept the keyword names associated with the older layout version, but you should use layout_version=0.8 only 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. (See swpackage(4) for more information on PSFs.)

Layout version 1.0 adds significant functionality not recognized by systems supporting only 0.8, including:

In addition to adding new attributes and objects, layout_version 1.0 changes the following preexisting 0.8 objects and attributes as follows:

Applies to swpackage, swcopy, swmodify, and swlist.

Specifies a software level for swlist, swacl, or swreg.

For swlist:

Lists all objects down to the specified level. Both the specified level(s) and the depth of the specified software_selections control the depth of the swlist output. The supported software levels are:

The supported depot and root levels are:

For swacl:

The level option defines the level of ACLs to view or modify:

For swreg:

The level option defines the level of object to register or unregister:

Applies to swacl, swlist, and swreg.

Adds numeric identification numbers at the beginning of SD logfile messages:

Applies to swconfig, swcopy, swinstall, swmodify, swpackage, swreg, swremove, and swverify.

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. This information is in addition to log information controlled by the loglevel option.

Here are the possible combinations of loglevel and logdetail options:

Applies to swconfig, swcopy, swinstall, swreg, swremove, and swverify.

Defines the default log file for each SD command. (The agent log files are always located relative to the target depot or target root, e.g. /var/spool/sw/swagent.log and /var/adm/sw/swagent.log.)

Applies to all commands except swacl, swlist, and swjob.

Controls the log level for the events logged to the command logfile, the target agent logfile, and the source agent logfile by prepending identification numbers to SD logfile messages. This information is in addition to the detail controlled by the logdetail option. See logdetail for more information.

A value of:

Applies to swconfig, swcopy, swinstall, swmodify, swpackage, swremove, and swverify.

If set to true, software selection is done by locating filesets on the source that match the target system's installed filesets. If multiple targets are specified, the first in the list is used as the basis for selections.

Applies to swinstall.

The maximum number of agents that are permitted to run simultaneously. The value of -1 means that there is no limit.

Applies to swagentd.

When set to a positive integer, this option limits the number of concurrent install or copy operations to the number specified. As each copy or install operation completes, another target is selected and started until all targets are completed.

Server and network performance determines the optimal setting; a recommended starting point is 25 (the default value). If you set this option to a value of less than one, SD attempts to install or copy to all targets at once.

Applies to swcopy and swinstall.

If creating a distribution tape or multiple-directory media such as a CD-ROM, this keyword 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 the default of 1,330 Mbytes for tape or to the amount of free space on the disk up to minfree for a disk file. SD uses the same format across multiple directory media as it does for multiple serial media, including calculations of the correct size based partitioning of filesets and setting of the media_sequence_number attributes.

Applies to swpackage.

Defines the type of distribution to create. The recognized types are directory and tape.

Applies to swpackage.

Defines in minutes how often the daemon wakes up to scan the job queue for scheduled jobs that must start. If set to 0, no scheduled jobs are initiated.

Applies to swagentd.

By default, the SD commands attempt to mount all filesystems in the /etc/fstab file at the beginning of the analysis phase, to ensure 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, and that the expected files are available for a remove or verify operation.

If set to false, the mount operation is not attempted, and no check of the current mounts is performed.

Applies to swconfig, swcopy, swinstall, swremove, and swverify.

Defines the command called by the agent to mount all filesystems.

Applies to swagent.

Defines the default objects to register or unregister. There is no supplied default (see select_local above). If there is more than one object, they must be separated by spaces.

Applies to swreg.

Defines the attributes which are listed in the non-verbose listing.

Applies to swlist and swjob.

This option can be used in conjunction with os_release to specify fileset selection for an HP-UX update. os_name should only be specified from the command line. Refer to the SD readme file for correct syntax. You can display the readme file by entering:

swlist -d -a readme SW-DIST [@ host:/depot ]

Applies to swinstall.

This option can be used in conjunction with os_name to specify fileset selection for an HP-UX update. os_release should only be specified from the command line. Refer to the SD readme file for correct syntax. You can display the readme file by entering:

swlist -d -a readme SW-DIST [@ host:/depot ]

Applies to swinstall.

If set to true, swpackage will package the specified products such that the target depot will not 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 products to be packaged without consuming the full disk space of copying all the source files into the target depot.

Applies to swpackage.

Commits a patch by removing files saved for patch rollback. When set to true, and run with swmodify, you cannot roll back (remove) a patch unless you remove the associated base software that the patch modified.

Applies to swmodify.

Specifies a software_specification for a patch filter. The default value is *.*.

This option can be 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.

Applies to swask, swcopy, and swinstall,

If set to true, this option selects the latest patches (software identified by the is_patch attribute) that correspond to software on the target root or depot.

The patch_filter= option can be used in conjunction with patch_match_target.

Applies to swcopy and swinstall.

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.

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.

Defines in seconds the polling interval used by interactive (GUI) sessions. It specifies how often each target agent will be polled to obtain status information about the task being performed. When operating across wide-area networks, the polling interval can be increased to reduce network overhead.

Applies to swcopy, swinstall, and swremove.

Preserves the original create time when you copy depots, which produces consistent results when you use the copies. The default of false sets the create_time of software bundles, products, and filesets equal to the time the object was created in the depot. When set to true, the create_time of software bundles, products, and filesets is set to that specified in the source depot. Note that using this option when copying to a master depot can change the objects that are visible when you use the create_time_filter option.

Applies to swcopy.

Defines the command called by the agent to reboot the system.

Applies to swagent.

Prevents software which is already in the CONFIGURED state from being reconfigured. If set to true, CONFIGURED software can be reconfigured.

Applies to swconfig.

This option prevents SD from recopying (overwriting) an existing revision of a fileset. If set to true, the fileset will be recopied.

Applies to swcopy.

Causes swcopy to register a newly created depot with the local swagentd. This action allows other SD commands to automatically "see" this depot. If set to false, a new depot will not be automatically registered. (It can be registered later with the swreg command.)

Applies to swcopy.

Causes swinstall to register a newly created alternate root with the local swagentd. This action 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 to swinstall.

This option prevents SD from re-installing (overwriting) an existing revision of a fileset. If set to true, the fileset will be overwritten.

Applies to swinstall.

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 target.

Applies to swinstall, swcopy, and swpackage.

(For swpackage, the default value for this option is false.) 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 checksums 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 timestamp.

Applies to swcopy, swinstall, and swpackage.

Remove an empty depot when the last product is removed. If set to false, an empty depot will not be removed, preserving any depot ACLs.

Applies to swremove.

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.

Applies to swcopy.

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 to swagentd.

Please Note: Transition links do not exist on 11.31 and newer releases so there are no remove preparation steps to perform therefore the remove_setup_cmd is never executed for these releases.

Defines the number of times a lost (timed out) source connection will be retried during file transfers. 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, then the install of each fileset will be attempted that number of times. (You can use the retry_rpc_interval option to specify the length of the interval between each retry attempt.)

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.

Applies to swcopy and swinstall.

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 reestablishing 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 an agent 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 controller would try to contact the target five times over a 30-minute period.

Applies to swcopy and swinstall.

Defines the protocol sequence(s) and endpoint(s) on which the daemon listens and on which the other commands use to contact the daemon. If the connection fails for one protocol sequence, the next is attempted. SD supports both the tcp (ncacn_ip_tcp:[2121]) and udp (ncadg_ip_udp:[2121]) protocol sequence on most platforms.

The value (or values for swagentd) can have following form:

Applies to all commands except swask, swpackage, and swmodify.

Defines the protocol sequence(s) and endpoint(s) used when the agent attempts to contact an alternate source depot specified by the alternate_source option. SD supports both the udp (ncadg_ip_udp:[2121]) and tcp (ncacn_ip_tcp:[2121]) protocol sequence/endpoint.

Applies to swagent.

Defines the protocol sequence(s) and endpoint(s) used to contact the daemon for source access. If set to no value (default) the value of rpc_binding_info is used.

Applies to swinstall and swcopy.

Defines the protocol sequence(s) and endpoint(s) used to contact the daemon for target access. If set to no value (default) the value of rpc_binding_info is used.

Applies to swinstall and swcopy.

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 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.

Applies to all commands except swpackage and swmodify.

This option controls SD's nonprivileged mode. This option is ignored (treated as true) when the invoking user is super-user.

When set to the default value of true, SD operations are performed normally, with permissions for operations either granted to a local super-user or set by SD ACLs. (See swacl(1M) for details on ACLs.)

When set to false and the invoking user is local and is not super-user, nonprivileged mode is invoked:

SD's nonprivileged mode is intended only for managing applications that are specially designed and packaged. This mode cannot be used to manage the HP-UX operating system or patches to it. For a full explanation of nonprivileged SD, see the Software Distributor Administration Guide, available at the http://docs.hp.com web site.

See also the admin_directory and installed_software_catalog options.

Applies to all SD commands except swagent, swagentd, and install-sd.

Displays or hides superseded patches in swlist output. In the default state of false, swlist will not display superseded patches even if you perform a swlist command on the superseded patch. Setting this option to true permits display of superseded patches.

Applies to swlist.

If no target_selections are specified, select the default target_directory of the local host as the target_selection for the command.

Applies to swacl, swconfig, swcopy, swinstall, swlist, swreg, swremove, and swverify.

Defines the default software_selections. There is no supplied default. If there is more than one software selection, they must be separated by spaces. Software is usually specified in a software input file, as operands on the command line, or in the GUI.

Applies to all commands except swreg and swjob.

Indicates the software view to be used by the interactive interface of the commands and by swlist for the default listing level. It can be set to products, all_bundles, or a bundle category tag (to indicate to show only bundles of that category).

Applies to swcopy, swinstall, swlist, and swremove.

Specify a source to automatically bypass the GUI and CLI source selection dialog box. This has the same effect as the -ssource command line option. Specify the source using the following syntax.

[path]

Applies to swcopy and swinstall.

Defines the default location of the source CD-ROM using the syntax [host]: [path].

Applies to swinstall.

If both source and target machine are updated to SD revision B.11.00 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/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 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 non-writable depots).

Users can invoke the swlist interactive user interface (using swlist -i -d) to view, print, or save the audit information on a remote or local depot. Users can view audit information based on language preference, as long as the system has the corresponding SD message catalog files on it. For example, a user 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.

Defines the default location of the source product specification file (PSF). The host:path syntax is not allowed, only a valid path can be specified. The -s option overrides this value.

Applies to swpackage and swmodify.

Defines the default location of the source tape, usually the character-special file of a local tape device. You can also use the host:path syntax, but the host must match the local host. The -s option overrides this value. (Note that SD can read both tar and cpio tape depots.)

Applies to swcopy and swinstall.

Defines the default source type: cdrom, file, directory, or tape. The source type derived from the -s option overrides this value. (Note that SD can read both tar and cpio tape depots.)

Applies to swcopy, swinstall, and swpackage. (The values cdrom, and tape apply to swcopy and swinstall only. The value file applies to swpackage only.)

Defines the path to the kernel's template file. This path is passed to the system_prep_cmd via the SW_SYSTEM_FILE_PATH environment variable.

Applies to swagent.

Defines 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 about to be built. This script is called before any kernel filesets have been loaded.

Applies to swagent.

Defines the default target_selections. There is no supplied default (see select_local above). If there is more than one target selection, they must be separated by spaces. Targets are usually specified in a target input file, as operands on the command line, or in the GUI.

Applies to all commands.

Defines the command to uncompress files when installing, copying, or packaging. This command processes files which were stored on the media in a compressed format. If the compression_type of the file is gzip then the internal uncompression (funzip) is used instead of the external uncompress_cmd.

Applies to swpackage and swagent.

If the files being transferred from a source are compressed, setting this option will uncompress the files before storing them on the target depot.

Applies to swcopy and swpackage.

Lets each target agent use its own configured alternate source, instead of the one specified by the user. If false, each target agent will use the same source, namely the source specified by the user and validated by the command. If true, each target agent will instead use its own configured value for the source.

Applies to swcopy and swinstall.

Controls the verbosity of a non-interactive command's output:

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.

Prevents file operations on remote (NFS) file systems. All files destined for installation, copy, removal, or packaging on targets on a remote (NFS) file systems are skipped.

If set to true and if the superuser has write permission on the remote file system, the remote files are not skipped, but are installed, copied, packaged, or removed.

Applies to swconfig, swcopy, swinstall, swpackage, and swremove.

the system-wide default list of hosts,

the user-specific default list of hosts.

the system-wide default list of patch filters.

the user-specific default list of patch filters.

Determines the language in which messages are displayed. If LANG is not specified or is set to the empty string, a default value of C is used. See lang(5) for more information.

NOTE: The language in which the SD agent and daemon log messages are displayed is set by the system configuration variable script, /etc/rc.config.d/LANG. For example, /etc/rc.config.d/LANG, must be set to LANG=ja_JP.SJIS or LANG=ja_JP.eucJP to make the agent and daemon log messages display in Japanese.

This variable applies to all SD commands.

Determines the locale to be used to override any values for locale categories specified by the settings of LANG or any environment variables beginning with LC_.

Determines the interpretation of sequences of bytes of text data as characters (e.g., single-versus multibyte characters in values for vendor-defined attributes).

Determines the language in which messages should be written.

Determines the format of dates (create_date and mod_date) when displayed by swlist. Used by all utilities when displaying dates and times in stdout, stderr, and logging.

Determines the time zone for use when displaying dates and times.

Holds the path to the Installed Products Database (IPD), relative to the path in the SW_ROOT_DIRECTORY environment variable. Note that you can specify a path for the IPD using the installed_software_catalog default option.

Defines the current directory of the script being executed, either a temporary catalog directory, or a directory within in the Installed Products Database (IPD). This variable tells scripts where other control scripts for the software are located (e.g. subscripts).

Holds the tag name of the control_file being executed. When packaging software, you can define a physical name and path for a control file in a depot. This lets you define the control_file with a name other than its tag and lets you use multiple control file definitions to point to the same file. A control_file can query the SW_CONTROL_TAG variable to determine which tag is being executed.

Defines the location of the product, which may have been changed from the default product directory. When combined with the SW_ROOT_DIRECTORY, this variable tells scripts where the product files are located.

A PATH variable which defines a minimum set of commands available for use in a control script (e.g. /sbin:/usr/bin).

Defines the root directory in which the session is operating, either / or an alternate root directory. This variable tells control scripts the root directory in which the products are installed. A script must use this directory as a prefix to SW_LOCATION to locate the product's installed files. The configure script is only run when SW_ROOT_DIRECTORY is /.

Contains the pathname of a file containing the value of every option for a particular command, including software and target selections. This lets scripts retrieve any command options and values other than the ones provided explicitly by other environment variables. For example, when the file pointed to by SW_SESSIONS_OPTIONS is made available to a request script, the targets option contains a list of software_collection_specs for all targets specified for the command. When the file pointed to by SW_SESSIONS_OPTIONS is made available to other scripts, the targets option contains the single software_collection_spec for the targets on which the script is being executed.

This variable contains the fully qualified software specification of the current product or fileset. The software specification allows the product or fileset to be uniquely identified.

This variable should be read only by the configure script. If this is set to any value it indicates the configure script was invoked by the swconfig command during system startup. This variable is set by the /sbin/init.d/swconfig system startup script.

Only applies to swinstall. This variable is normally unset. If it is set, the actions necessary for preparing the system file /stand/system cannot be accomplished from within the postinstall scripts, but instead must be accomplished by the configurescripts. This occurs whenever software is installed to a directory other than /, such as for a cluster client system. This variable should be read only by the configure and postinstall scripts of a kernel fileset. The swinstall command sets these environment variables for use by the kernel preparation and build scripts.

Only applies to swinstall. This variable is normally unset. If it is set, the swinstall session is being run as the back end of an initial system software installation ("cold" install).

Only applies to swinstall. The path to the kernel. The default value is /stand/vmunix, defined by the swagent option or kernel_path.

Indicates whether a kernel build is scheduled for the current install/remove session. A TRUE value indicates that the selected kernel fileset is scheduled for a kernel build and that changes to /stand/system are required. A null value indicates that a kernel build is not scheduled and that changes to /stand/system are not required.

The value of this variable is always equal to the value of SW_SESSION_IS_REBOOT.

Indicates whether a reboot is scheduled for a fileset selected for removal. Because all HP-UX kernel filesets are also reboot filesets, the values of this variables is always equal to the value of SW_SESSION_IS_KERNEL.

A value of 1 indicates the SD command was invoked by the update-ux command during an Operating System update. This variable is set by the update-ux command.

Only applies to swinstall. The path to the kernel's system file. The default value is /stand/system.

The commands log messages to /var/adm/sw/sw<task>.log. (You can specify a different logfile by modifying the logfile option.)

A swagent process performs the actual swacl, swconfig, swcopy, swinstall, swremove, and swverify operation at each target_selection. For operations on target root objects, the swagent logs messages to the file var/adm/sw/swagent.log beneath the root directory (e.g. / or an alternate root directory). For operations on target depot objects, the swagent logs messages to the file swagent.log beneath the depot directory (e.g. /var/spool/sw).

The swagentd running on a host logs events to the file /var/adm/sw/swagentd.log.

If both source and target machine are updated to SD revision B11.00 or later, the system administrator at the source depot machine can track which user pulls which software from a depot on the source machine and when the software is pulled. Refer to the source_depot_audit option in swagent(1M) for more information.