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
1. The basic test:
• Run swinstall to install the full product (that is, all the filesets). To avoid testing the
configure script(s), either do not include any in the product, or set the defer_configure
option to “true.”
• After the installation completes, check the ${SW_ROOT_DIRECTORY}var/adm/sw/
swagent.log file for any problems, either in the scripts or the format/contents of the
messages generated by the scripts.
• Study the resulting file system to see if the scripts performed the expected actions.
• Re-run the test by re-installing the same product.
2. If you want to avoid the time spent loading files, then set the reinstall_files option to
“false” and the reinstall_files_use_cksum option to “false.”
3. If a previous version of the product can be updated to this version, then re-run the test by
updating this product where the previous version has been installed.
4. If your checkinstall script can generate error or warning conditions based on the current activity
or configuration of the target system, then enable those conditions to ensure that the checkinstall
script correctly detects them.
5. Re-run the test by installing into an alternate root directory (swinstall -r) instead of the
primary root directory (“/”). Make sure that the scripts perform all of their operations (if any)
within the alternate root directory. (This verifies the correct use of ${SW_ROOT_DIRECTORY}
by your scripts.)
6. If your product is locatable (that is, it can be installed into a different location), then re-run the
tests by installing the product into a different location (swinstall product:new_location).
Make sure that the scripts perform all of their operations in the new location, and not the
default location. (This verifies the correct use of $SW_LOCATION by your scripts.)
7. If you have a complex script, run additional tests for your product that you feel will give you
confidence your product has been installed correctly on the system. For example, only install
certain subsets of your product instead of the full product.
Testing Configuration Scripts
For configure, verify, and unconfigure scripts you should perform at least these tests. All tests can
be performed on the local system (that is, by doing local installs).
1. Run swinstall to install the full product (that is, all the filesets). Let the installation process
perform the configuration task (and run your configure script(s)).
• After the installation and configuration completes, check the
${SW_ROOT_DIRECTORY}var/adm/sw/swagent.log file for any problems, either
in the configure script or the format/contents of the messages generated by it.
• Study the resulting file system to see if the configure script performed the expected actions.
• Test the product itself to see if the necessary configuration tasks were performed such that
the product is ready to use.
2. Run swremove to remove the configured product.
• After the unconfiguration and removal completes, check the
${SW_ROOT_DIRECTORY}var/adm/sw/swagent.log file for any problems, either
in the unconfigure script or the format/contents of the messages generated by it.
• Study the resulting file system to see if the unconfigure script performed the expected
“undo” actions.
Testing Control Scripts 219