Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
Managing HP-UX Software With SD-UX: HP 9000 Computers > Appendix A Default Options and Keywords

Defaults Listed Alphabetically

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

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

  • ask=false

    See ask=true.

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

    [1] Required

    [2] Setting both the loglevel=2 and logdetail=true options is required. With this combination you may get the same logfile behavior as previous HP-UX 10.x releases.

     

    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.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1997 Hewlett-Packard Development Company, L.P.