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

3. Check state of versions currently installed:
• If the product is non-existent or corrupt, the task issues an error that says the product
cannot be configured and to use swinstall to install and configure this product.
• If the versions currently installed are not configured and if the -u (unconfigure) option is
set, the system issues a note that the selected file or fileset is already unconfigured.
• If the state of versions currently installed is configured, the check is affected by the
reconfigure option. A note saying the fileset is already configured and will
(reconfigure is true) or will not (reconfigure is false) be reconfigured is issued.
4. Check for configuring a second version:
If the allow_multiple_versions option is set to false, an error is generated stating that
another version of this product is already configured and the fileset will not be configured. If
the option is set to true, the second version is also configured.
5. Check states of dependencies needed:
• An error or warning is issued if a dependency cannot be met. This is controlled by the
enforce_dependencies option. If enforce_dependencies is set to true the fileset
will not be configured. If enforce_dependencies is false, the fileset will be configured
anyway.
• If the dependency is a prerequisite, the configuration fails.
• If the dependency is a corequisite, the configuration of this fileset will likely succeed, but
the product may not be usable until its corequisite dependency is installed and configured.
Phase III: Configuration
In this phase, the actual software configuration takes place. Configure or unconfigure scripts are
executed and the software state is changed from installed to configured (or unconfigured).
The purpose of configuration is to configure the host for the software and configure the product
for host specific information. For example, software may need to change the host’s .rc setup, or
the default environment set in /etc/profile. Or you may need to ensure that proper codewords
are in place for that host or do some compilations. Unconfiguration reverses these steps.
The sequence of configuration tasks is shown below.
NOTE: Products are ordered by prerequisite dependencies, if any. Fileset operations are also
ordered by any prerequisites or corequisites. The loadorder_use_coreqs option can modify
load order of the filesets. For more information on loadorder_use_coreqs, see “Options Listed
Alphabetically” (page 228).
1. (Un)configure each product.
2. Run scripts for associated filesets, checking return values.
If an error occurs, the fileset is left in the installed state. If a warning occurs, the fileset will still
be configured.
3. Update the IPD to show the proper installed or configured state.
Configure scripts must also adhere to specific guidelines. For example, these scripts are only
executed in the context of the host that the software will be running on, so they are not as restrictive
as customized scripts. For more information on scripts, see Chapter 11: “Using Control Scripts ”
(page 201).
54 Installing Software