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
If the depot is a new depot or if you are packaging to a tape, this authorization check is
skipped. If you have permission to create a new depot, then you have permission to create
products within it. Since a tape session first writes to a temporary depot then copies it to tape,
if you have permission to create a new (temporary) depot, you can package to tape.
3. Check for software being repackaged.
For each selected product, swpackage checks to see if the product already exists in the target
depot.
• If it does exist, swpackage checks to see which filesets are being added (new filesets)
or modified.
• If it exists and all filesets are selected, swpackage checks to see if any existing filesets
have been obsoleted by the new product.
4. Performing Disk Space Analysis (DSA)
swpackage verifies that the target depot has enough free disk space to package the selected
products.
• If adequate disk space is available for the packaging operation to proceed, swpackage
writes a note to the log file to note the impact on disk space.
• An error results if the package will encroach into the disk’s minfree space.
• An error results if the package phase requires more disk space than is available.
• If you set the enforce_dsa command option to false, swpackage changes disk space
errors to warnings and continues. This lets you cross into the minfree space to complete
a packaging operation.
Phase III: Build
When packaging a product, if the target depot does not exist, swpackage creates it. If it does
exist, swpackage will merge new product(s) into it. For each different version of the product, a
directory is created using the defined product tag attribute and a unique instance number (instance
ID) for all the product versions that have the same tag.
Before a new storage directory is created, swpackage checks to see if this product version has
the same identifying attributes as an existing product version.
If all the identifying attributes match, you are re-packaging (modifying) an existing version.
Otherwise, swpackage creates a new version in the target distribution.
The packaging process uses an explicit ordering to avoid corrupting the target distribution if a
fatal error occurs. Each product is packaged in its entirety and when all specified products have
been packaged successfully, the distribution’s global INDEX file is built/rebuilt. Within each product
construction, the following order is adhered to:
1. Check if the product is new or already exists. If it is new, create the product’s storage directory.
2. For each fileset in the product, copy the fileset’s files into their storage location (within the
product’s storage directory), and create the fileset’s catalog (database information) files.
3. After the individual filesets, create the product’s informational files (meta-files).
A target depot is only the first step in creating a CD-ROM. If the ISO 9660 standard format is
desired, a utility to perform this conversion would be necessary. This conversion is not supported
by swpackage.
Distribution tapes are created in tar format (although SD-UX commands can also read depots from
cpio format tapes). To create the tape, swpackage first builds the products into a temporary
distribution depot. (The depot is removed when swpackage completes.) To conserve space, all
files exist as references to the real source files. After the distribution depot is constructed, swpackage
then archives it, along with the real files, onto the tape device.
Packaging the Software (swpackage) 191