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

Key points in this structure are:
• Where are shareable (for example, executables) and non-shareable (for example, configuration)
files installed?
• How is configuration used to put non-shareable files in place?
Determining Product Structure
Determine the product structure that your software should follow. SD-UX provides four levels of
software objects:
Level Objects
Filesets (Required) Filesets include the actual product files, information that describes
those files (attributes) and separate control scripts that are run before, during
or after the fileset is installed, copied or removed. Filesets are the smallest
manageable (selectable) software object. Files must be grouped into one or
more filesets. Filesets must be grouped into one or more products. (Filesets can
be members of only a single product.)
Subproducts (Optional) Subproducts are used to group related filesets within a product if the
product contains several filesets. Subproduct definitions are optional.
Products (Required) Filesets (and/or subproducts) must be grouped into one or more
products. They are usually grouped into collections that form a set of related
software, or match the products that a customer purchases. The SD-UX commands
maintain a product focus, while still allowing the flexibility to manage subsets
of the products via subproducts and filesets.
Bundles (Optional) Bundles are provided only by the HP factory. Customer packaging
of bundles is not supported.
NOTE: You can define different versions of products for different platforms and operating systems,
as well as different revisions (releases) of the product itself. You can include different product
versions on the same distribution media.
Adding Control Scripts
SD-UX supports execution of product and fileset control scripts that allow you to perform additional
checks and operations with other HP-UX commands and functions. The swask, swinstall,
swconfig, swverify, and swremove commands each can execute one or more control scripts
on the primary roots. You can write the scripts and include them in your software package. All
scripts are optional but many times are needed correctly complete the task that you want your
software package to perform. See Chapter 11: “Using Control Scripts ” (page 201) for a complete
discussion of control scripts.
SD-UX supports the following types of scripts, which can be defined for products and fileset:
Checkinstall Analyses each target to determine if the installation and configuration can
take place. (Executed by swinstall.)
Checkremove Analyses each target to determine if removal and unconfiguration can take
place. (Executed by swremove.)
Configure Configures installed filesets or products. (Executed by swconfig and
swinstall.)
Fix Corrects and reports on problems in installed software. (Executed by
swverify.)
Postinstall Performs additional install operations (such as resetting default files)
immediately after a fileset or product has been installed. (Executed by
swinstall.)
166 Creating Software Packages