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
updating the num_entries value can result in unreported problems and cause SD-UX to deny
access. A common failure could occur, for instance, if a you inserted user entry in the ACL file.
This could push the any_otherentry down beyond the num_entries limit. The ACL manager
would never read the any_other entry, and you would have access problems. The best guard
against this situation is to always use the swacl command to manipulate ACLs.
Inter-host Secrets
The default /var/adm/sw/security/secrets file contains a single entry:
default -sdu-
If you wish to explicitly name all hosts from which controllers can be run, you must replace the
-sdu- with a different default secret, or eliminate the entire entry. See Chapter 9: “SD-UX Security
” (page 141) for a thorough discussion of the secrets file.
The controller (for swinstall, swcopy, etc.) looks up the secret for the system on which it runs
and passes it in an encrypted form to its agent. The agent receiving a request from the controller
looks up the secret for the host from which the call comes, encrypts it, and compares the encryption
to that provided by the controller. If the two secrets do not match, access is denied. If you have
problems with this mechanism, make sure that all systems have matching entries. You can also
revert to the old secrets file (/etc/newconfig/sd/secrets on 9.x and /usr/newconfig/
var/adm/sw/security/secrets on 10.x) on all hosts, or simply copy a single secrets file to
all hosts.
Working With Depot Images
You may encounter a problem in using cp, tar, cpio, dd, and other commands to copy images of
depots for use on other systems. Depot and product ACLs in the image have built-in knowledge of
the host on which the depot originated. In particular, an ACL default realm will be wrong and
local users will be confused with users on the originating host. For example, attempts to add local
users to the access list will, in fact, grant access to remote users. There is no way to alter the default
realm of an ACL from that set when it is created.
Another common problem with such images occurs if you import them to systems that cannot resolve
all the hostnames (see resolver(4) and nslookup(1)) that exist in the ACLs.
If your purpose is to create a “staged” installation, use swcopy to propagate the depot. This creates
new ACLs, based on local templates, for each instance of the depot.
If the sole intent of a depot is for such image distribution, you may wish to set the swpackage
create_target_acls option to false to prevent ACL creation on the depot and products during
the swpackage operation. This option creates tape and CD-ROM images. Depots and products
without ACLs grant the local superuser all privileges, while all other users and systems have read
access. Note that when you copy or install this ACL-less depot with swcopy or swinstall, the
copies (installations) are automatically protected by ACLs based on templates on the destination
host.
Slow Network Performance
When using swinstall or swcopy in an environment where network bandwidth is the
“bottleneck,” the file transfer rate between source and target can become very slow.
Resolution
The compress_files=true option compresses files transferred from a source depot to a target.
This can reduce network usage by approximately 50%; the exact amount of compression depends
on the type of files. Binary files compress less than 50%, text files more.
The greatest throughput improvements are seen when transfers are across a slow network
(approximately 50kbyte/sec or less), and the source depot server is serving a few target hosts at
a time.
Common Problems 257