Software Distributor (SD-UX) Administration Guide HP-UX 11i v1, 11i v2, and 11i v3 (762797-001, March 2014)
Table Of Contents
- Software Distributor Administration Guide
- Contents
- HP secure development lifecycle
- About This Document
- 1 Introduction to Software Distributor
- SD-UX Overview
- SD-UX Concepts
- Using the GUI and TUI Commands
- The Terminal User Interface
- Starting the GUI/TUI Commands
- Window Components
- Opening and closing items in the object list
- Marking Items in the Object List
- Preselecting Host Files
- Software Selection Window
- Session and File Management—The File Menu
- Changing Software Views—The View Menu
- Changing Options and Refreshing the Object List—The Options Menu
- Performing Actions—The Actions Menu
- Getting Help—The Help Menu
- XToolkit Options and Changing Display Fonts
- Working from the Command Line
- 2 Installing Software
- Installation with swinstall
- Features and Limitations
- Installing with the GUI
- Installing from the Command Line
- Installation Tasks and Examples
- Updating to HP-UX 11i
- Installing Patches
- Recovering Updated Files
- Installing Software That Requires a System Reboot
- Using Software Codewords and Customer IDs
- Re-installing Software Distributor
- Installing Multiple Versions
- Installing to an Alternate Root
- Compatibility Filtering and Checking
- Software Selection Checking
- Configuring Your Installation (swconfig)
- Verifying Your Installation (swverify)
- Installation with swinstall
- 3 Managing Installed Software
- 4 Managing Software Depots
- Depot Management Commands and Concepts
- Copying Software Depots
- Registering and Unregistering Depots (swreg)
- Verifying Signed Software Signatures
- Additional Depot Management Tasks and Examples
- Combining Patch Depots
- Creating a Tape Depot for Distribution
- Setting Depot Attributes
- Creating a Network Depot
- Managing Multiple Versions of HP-UX
- Listing Registered Depots
- Listing the Contents of a Depot (swlist -d)
- Source Depot Auditing
- Verifying a Depot (swverify -d)
- Removing Software from Depots
- Removing a Depot
- 5 HP-UX Patching and Patch Management
- 6 Using Jobs and the Job Browser
- 7 Remote Operations Overview
- 8 Reliability and Performance
- 9 SD-UX Security
- 10 Creating Software Packages
- Overview of the Packaging Process
- Identifying the Products to Package
- Adding Control Scripts
- Creating a Product Specification File (PSF)
- Product Specification File Examples
- PSF Syntax
- PSF Object Syntax
- Selecting the PSF Layout Version
- PSF Value Types
- Product Specification File Semantics
- Re-Specifying Files
- Packaging the Software (swpackage)
- Packaging Tasks and Examples
- Registering Depots Created by swpackage
- Creating and Mastering a CD-ROM Depot
- Compressing Files to Increase Performance
- Packaging Security
- Repackaging or Modifying a Software Package
- Packaging In Place
- Following Symbolic Links in the Source
- Generating File Revisions
- Depots on Remote File Systems
- Verifying the Software Package
- Packaging Patch Software
- Writing to Multiple Tapes
- Making Tapes from an Existing Depot
- 11 Using Control Scripts
- Introduction to Control Scripts
- General Script Guidelines
- Packaging Control Scripts
- Using Environment Variables
- Execution of Control Scripts
- Execution of Other Commands by Control Scripts
- Control Script Input and Output
- File Management by Control Scripts
- Testing Control Scripts
- Requesting User Responses (swask)
- Request Script Tasks and Examples
- 12 Nonprivileged SD
- A Command Options
- B Troubleshooting
- Error Logging
- Common Problems
- Cannot Contact Target Host’s Daemon or Agent
- GUI Won’t Start or Missing Support Files
- Access To An Object Is Denied
- Slow Network Performance
- Connection Timeouts and Other WAN Problems
- Disk Space Analysis Is Incorrect
- Packager Fails
- Command Logfile Grows Too Large
- Daemon Logfile Is Too Long
- Cannot Read a Tape Depot
- Installation Fails
- swinstall or swremove Fails With a Lock Error
- Use of Square Brackets ([ and ]) Around an IPv6 Address Causes an Error
- Some SD commands do not work after network configuration changes
- C Replacing or Updating SD-UX
- D Software Distributor Files and File System Structure
- Glossary
- Index
The depot's swagent.log file and directory structure are not removed by default. If the
swagent.log file and directory should be removed, the remove_empty_depot_directory
option must also be set to “true”.
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_empty_depot_directory=false
If false (default), the depot's swagent.log file and directory are not removed when the last
product (or bundle) in the depot is removed.
If the remove_empty_depot_directory and the remove_empty_depot options are set to true,
and the last product (or bundle) in a depot is removed, the depot's swagent.log file and
directory are also removed.
Applies to swremove.
• remove_obsolete_filesets=false
This command controls whether swcopy and swpackage automatically remove obsolete
filesets from target products in the target depot.
If set to true, swcopy and swpackage remove obsolete filesets from the target products that
were written during the copy or package process. Removal occurs after the copy or package
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 or during the current packaging of the product
defined in the source PSF.
Applies to swcopy and swpackage.
• 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 is retried during file
transfers. 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.
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_intervaloption to determine how long
to wait between each attempt to recontact the agent.
Applies to swcopy and swinstall.
• retry_rpc_interval={0}
Specifies in minutes the length of the interval for repeated attempts to make a connection to
a target after an initial failure. Used in conjunction with the retry_rpc option.
If the number of values in this option equals the value of retry_rpc, SD-UX tries to reestablish
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-UX 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 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 retry, 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 both options were set
to 5, the controller would try to contact the target five times over a 30-minute period.
246 Command Options