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
Packaging In Place
If you set the package_in_place option to true, swpackage packages each of the specified
products such that the source files are not copied into the target depot. Instead, swpackage inserts
references to the source files that make up the contents of each fileset. Control scripts are always
copied.
This feature lets you package products in a development or test environment without consuming
the full disk space of copying all the source files into the target depot. Disk space analysis is skipped
when the package_in_place option is true.
The source files must remain in existence. If some are deleted, any operations that use the depot
as a source (for example, installing the product with swinstall) will fail when they try to access
the missing source files.
If a source file changes and the product is not repackaged, the information that describes the
source file will be incorrect (for example, the file checksum). This incorrect information will not
prevent the use of that target depot as a source (for example, installing with swinstall). However,
the incorrect information will be propagated along each time the product is copied or installed
from the depot. The result is that a swverify operation on the installed product always flags the
inconsistencies with an error unless you disable the check of file contents.
Following Symbolic Links in the Source
If you set the follow_symlinks option to true, swpackage follows every source file that is a
symbolic link and include the file it points to in the packaged fileset.
swpackage also follows each source directory that is a symbolic link, which affects the behavior
of the file * keyword (recursive file specification). Instead of including just the symbolic link in
the packaged fileset, the directory it points to and all files contained below it will be included in
the packaged fileset.
The default value for this option is false, which causes symbolic links that are encountered in the
source to be packaged as symbolic links. The symbolic link can point to a file that is also part of
the fileset, or to a file that is not.
Generating File Revisions
If you set the include_file_revisions option to true, swpackage examines each source file
using the what and ident commands to extract an SCCS or RCS revision value and assign it as
the file’s revision attribute.
Because a file can have multiple revision strings embedded within it, swpackage uses the first
one returned. It extracts the revision value from the full revision string and stores it.
This option is time consuming, especially when a what search fails and the ident command is then
executed.
The default value for this option is false, which causes swpackage to skip the examination. No
value for the revision attribute is assigned to the files being packaged.
Depots on Remote File Systems
Because the swpackage analysis and build phases operate as the superuser, there are constraints
on how swpackage creates, adds to, or modifies products on a depot that exists in an NFS-mounted
file system.
If the superuser does not have write permission on the remote file system, swpackage will be
unable to create a new depot-it will terminate before the analysis phase begins.
If the superuser does have write permission on the remote file system but the option
write_remote_files is false, swpackage will be unable to create a new depot - it will terminate
before the analysis phase begins.
198 Creating Software Packages