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

For a product to be recoverable, no files should be removed by preinstall or postinstall scripts.
Configure scripts are a good place to remove obsolete files.
NOTE: Product level unpostinstall scripts are not supported.
• Configure Script
This script is run by swinstall or by swconfig to configure the host for the software, or
configure the software for host-specific information. For example, this script could change a
host’s specific configuration file such as /etc/services, add the host name or other host
resources such as available printers to its own configuration file, or perform compilations.
Configure scripts are run by swinstall for all products (in prerequisite order) after the
products have completed the Load phase. However, they are only run when installing to a
system that will actually be using the software. They are deferred when installing to an alternate
root (for example, for diskless or building test file systems) and run instead by the swconfig
command when the alternate root is now the root of the system using the software.
The swconfig command can also be used to rerun configure scripts that failed during a
normal install. A successful execution of the configure step (whether there is a script or not)
moves the software from the installed state to the configured or ready-to-use state. Configure
scripts (and all others) must be able to be run many times (that is, they must be re-executable).
Configure scripts are a good place to remove obsolete files.
Configure scripts are not run for installations to alternate roots.
• Verify Script
Verify scripts are run by the swverify command any time after the software has been installed
and configured. Like other scripts, they are intended to verify anything that the SD-UX software
management tools do not verify by default. For example, this script could check to see that
the software is configured properly and that you have a proper license to use it.
• Fix Script
Defines the fix script run by swverify to correct and report problems on installed software. The
fix script can create missing directories, correct file modifications (mode, owner, group, major,
and minor), and recreate symbolic links.
• Unconfigure Script
A script run by swconfig or swremove to undo a host or software configuration originally
performed by a configure script. For example, an unconfigure script could remove the
configuration from the /etc/services file. (The unconfigure task moves the software from
the configured state back to the installed state.)
Only the swremove command actually removes software, although you can run unconfigure
scripts using swconfig. Unconfigure scripts are not run for removals from alternate roots.
• Checkremove Scripts
The checkremove script is run by swremove during the remove analysis phase to allow any
checks before the software is permanently removed. For example, the script could check
whether anyone was currently using the software before removing it.
• Preremove Scripts
This script is executed just before removing files. It can be destructive to the application because
files will be removed next. It could remove files that the postinstall script created. For example,
a preremove script could save a specific fileset to another location before removing the rest
of the filesets in the product.
Introduction to Control Scripts 203