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

In general, the term target refers to either a host (specifically, the host’s file system) or a depot that
resides on a host. The term source refers to a depot from which software is being installed or copied
(sometimes referred to as a source depot).
For example, a basic install operation with the swinstall command involves installing software
from a source depot to a target location on the host itself. The source depot might be physical
media accessible from the target, or a directory depot on some server on the network. The target
host might be the same host on which the command was invoked (i.e., the local host) or, if remote
operation is enabled, some other host on the network.
A basic copy operation (using the swcopy command) is very similar, except that the target is a
depot on the host, rather than the host itself.
For most operations, controller programs access hosts and depots using an agent called swagent,
which performs the basic software management tasks. The agent is accessed via a daemon called
swagentd. When SD-UX operates on the local host, both controller and agent run on the local
host. For remote operations, the agent runs on a remote host.
Figure 1: “SD-UX Systems”, shows how software can be developed and then packaged into
SD-formatted media, which can either be accessed directly or copied to a depot directory on a
server and accessed via the network.
Figure 1 SD-UX Systems
Software Structure
SD-UX commands work on a hierarchy of software objects that make up the applications or operating
systems components you want to manage.
Software Objects
Bundles Collections of filesets, possibly from several different products, “encapsulated”
for a specific purpose. Bundles can reside in software depots, and SD-UX
commands act on bundles as single entities. All HP-UX OS software is packaged
in bundles. Bundles can consist of groups of filesets or of products. Customer
creation of bundles is not supported.
Products Collections of filesets or (optionally) subproducts and control scripts. The SD-UX
commands maintain a product focus but still allow you to specify subproducts
and filesets.
Different versions of a product can be defined for different platforms and
operating systems, as well as different revisions (releases) of the product itself.
Several different versions could be included on one distribution media or depot.
Subproducts If a product contains several filesets, subproducts can be used to group logically
related filesets.
20 Introduction to Software Distributor