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
Installing Software That Requires a System Reboot
Software packaged with the is_reboot attribute set to true requires the host to be rebooted after
the software is installed. However, when installing to alternate root file systems, the host will not
be rebooted.
If a local installation entails a reboot, the system reboots the target and the controller, so there is
no process left to report success or failure. (SD-UX does not automatically reconnect to the target
after a reboot.)
To find out if a software product requires the local host to be rebooted, get a description of the
software either from the Software Selection window, using the menu item Show Description of
Software, or from the Analysis dialog using the Product Summary and Product Description buttons.
Using Software Codewords and Customer IDs
To protect software from unauthorized installation, HP (and other vendors) use special codewords
and customer identification numbers to “lock” the software to a particular owner. These codewords
and customer IDs are provided to you when you purchase the software (or receive it as update).
HP lists them on the Software Certificate which is packaged with the software.
To properly store the customer_id/codeword for a CD-ROM, you can run swinstall (or swcopy
or swlist) on the host serving the CD-ROM. After the codeword has been stored, clients installing
software using that host and CD-ROM as a source will no longer require a codeword or customer_id.
SD searches the.codewords file on the server that is providing protected software to other hosts.
It looks for valid customer_id/codeword pairs. In doing so, SD eliminates the need for you to enter
codewords and customer_ids on every host that is “pulling” the software.
This is a time saver if you are updating multiple systems.
SD-UX prompts you for these codewords or numbers prior to the installation of protected software.
You can enter or change the numbers via the GUI using the Add New Codeword choice from the
Actions menu in the GUI, or by using the appropriate default option on the command line:
• -x codeword=xxxx
• -x customer_id=xxx
For example, if you want to store the codeword 123456789101bcdf (from the /CD-ROM mount
point) and your customer_id was xyzCorp, you would enter on the command line:
# swinstall -p -x customer_id=xyzCorp \
-x codeword=123456789101bcdf \
-s /CD_ROM
(Since the purpose of this command is only to store codewords and customer IDs, the -p option
runs the command in preview mode so that no actual software installation takes place.)
The swinstall command supports upto 124 codewords per CD part number.
See Appendix A (page 227) for more information on codeword and customer_id options.
Re-installing Software Distributor
The software product called SW-DIST provides all Software Distributor functionality, commands,
and tools. If the files that make up SW-DIST are deleted or corrupted, you may need to re-install
the product. This process uses the new install-sd command, which is described in Appendix C
(page 262).
50 Installing Software