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
• 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-UX 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.
• lookupcache_timeout_minutes=10
This option controls the time in minutes to cache and re-use the results of hostname or IP address
resolution lookups. A value of 0 disables the facility to cache and re-use lookup results. The
maximum value allowed is 10080 minutes, which is one week.
Applies to swacl, swagentd, swask, swconfig, swcopy, swinstall, swjob, swlist,
swmodify, swpackage, swreg, 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.
• max_targets=25
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-UX attempts to
install or copy to all targets at once.
Applies to swcopy and swinstall.
• media_capacity=1330
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 million bytes for tape or to the amount of free space on the disk up to
minfree for a disk file.
Options Listed Alphabetically 241