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 example:
swtest:/var/spool/sw
Command Notes
• The command returns a value of 0 to indicate successful completion and a value of 1 to indicate
an error.
• An install-sd session writes messages for major tasks and the begin and end of each session.
All WARNING and ERROR conditions are written to stderr.
• Detailed events are logged to /var/adm/sw/install-sd.log
Example
install-sd -s swtest:/var/spool/sw
Replacing an Unusable Version of SD-UX
If the version of SD-UX on the target system is unusable, you must first load install-sd and the
swagent.Z file onto your system into /var/tmp, then use install-sd to re-install SW-DIST. The
install-sd utility ships in the catalog/SW-DIST/pfiles directory.
Use cp (if you are copying from a local CD-ROM) or rcp (if you are copying from a software
depot on a remote system) to load install-sd onto your system.
For example, to load install-sd from a local CD-ROM mounted at /SD_CDROM into /var/tmp:
1. Copy install-sd onto your system from the CD-ROM:
# cp /SD_CDROM/catalog/SW-DIST/pfiles/ \
install-sd /var/tmp
2. Copy the swagent.Z file from the CD-ROM:
# cp /SD_CDROM/catalog/SW-DIST/pfiles/ \
swagent.Z /var/tmp
3. Make install-sd executable:
# chmod +x /var/tmp/install-sd
4. Execute install-sd:
# /var/tmp/install-sd -s /SD_CDROM
The SW-DIST product then installs itself onto your system from the CD-ROM.
Installing a Newer Version of SD-UX
If you want to install a newer version of SD-UX on your system and/usr/sbin/install-sd is
not yet on your system, use this procedure.
(In both steps, source_depot_location is the absolute path to the depot or media that contains
the newer version of SD-UX.)
1. As root, enter:
# /usr/sbin/swinstall -r -s \
source_depot_location\SW-DIST.SD-UPDATE \
@ /var/adm/sw/install-sd.root 2>/dev/null
2. Install the newer version:
# /usr/sbin/install-sd -s source_depot_location
NOTE: This install-sd command will not be available in future releases.
Replacing an Unusable Version of SD-UX 263