Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home

Software Distributor Administration Guide: HP-UX 11i v1, 11i v2, and 11i v3


Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

HP Part Number: 5992-4826

Published: September 2008

Table of Contents

About This Document
Intended Audience
HP-UX 11i Release Names and Release Identifiers
Typographic Conventions
Publication History
Related Documents
HP Encourages Your Comments
1 Introduction to Software Distributor
SD-UX Overview
Network Requirements
SD-UX Programs and Commands
SD-UX Online Documentation
SD-UX Concepts
Important Terminology
Software Structure
Installed Products Database
Control Scripts
Environment Variables
Software Dependencies
Working with Protected Software
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
Software Selections
Target Selections
Using Command Options
Session Files
2 Installing Software
Installation with swinstall
Features and Limitations
Installing with the GUI
Installing from the Command Line
Installation Tasks and Examples
Configuring Your Installation (swconfig)
Features and Limitations
The Configuration Process
Using swconfig
Configuration Tasks and Examples
Verifying Your Installation (swverify)
Features and Limitations
The Verification Process
Using swverify
Verification Tasks and Examples
3 Managing Installed Software
Listing Your Software (swlist)
swlist Features and Limitations
Using the swlist GUI
Using the Command Line
Software Listing Tasks and Examples
Modifying the IPD (swmodify)
IPD Contents
Using swmodify
swmodify Tasks and Examples
Removing Installed Software (swremove)
swremove Features and Limitations
Using the swremove GUI
Removing with the Command Line
Remove Tasks and Examples
4 Managing Software Depots
Depot Management Commands and Concepts
Depot Concepts
Copying Software Depots
swcopy Features and Limitations
Using the swcopy GUI
Using the swcopy Command Line
Copy Tasks and Examples
Registering and Unregistering Depots (swreg)
Register Media or Create Network Depot?
Registration and Security
Using swreg
swreg Examples
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
Starting the Job Browser
Using the Job Browser
Job Browser Icons
The File Menu
The View Menu
The Options Menu
The Actions Menu
Monitoring Jobs from the Command Line
swjob Attributes
swjob Tasks and Examples
Managing and Tuning Jobs with Command Options
Scheduling Jobs from the Command Line
Adding Job Titles
Removing Job Information
7 Remote Operations Overview
Differences Between Remote and Local Operations
Using the Remote Operations GUI
Target Selection Window
Performing Actions
Selecting Multiple Targets
Selecting Individual Targets
Saving a Target Group
Adding a Target Group
Setting Up Remote Operations
Remote Operations Tutorial
Tutorial Set-Up
How to Perform a Single-Target Installation
Remote Interactive swlist
Remote Operations from the Command Line
Target Selections
8 Reliability and Performance
Groups and Source Options
Large Numbers of Targets
Timeout Options
Retry RPC and Retry Interval
Retry Command
Database Checkpointing
INDEX and INFO Compression
Recovery (Install Only)
Installation With Separate Configuration
Multiple Versions
9 SD-UX Security
Default Security
Depots and Depot Registration
Modifying Target Systems
The swacl Command
swacl Output
Basic Security Tasks
Listing User Access
Allowing Users to Manage Products in a Depot
Allowing Users to Manage Roots (Install/Remove)
Restricting Access to Depots
Adding Target Hosts
Temporarily Restricting Access
Closing the SD-UX Network
Editing an ACL
How ACLs are Matched to the User
ACL Entries
ACL Keys
ACL Permissions
Object Protection
ACL Templates
Security on SD-UX Systems
SD-UX Internal Authentication
SD-UX Credentials
Security Between Hosts: The Shared Secrets File
RPC Authorization
How Agents Handle Controller Requests
Local Superuser Authorization
Depot Registration and Daemon/Agent Security
Security Use Models
Security in Remote Distributions
Security in Local Distributions
Security for Software Developers
Permission Requirements, by Command
Packaging (swpackage)
Listing (swlist)
Job Browsing (sd, swjob)
Copying (swcopy)
Installing (swinstall)
Removal (swremove)
Configuration (swconfig)
Verify (swverify)
Registering Depots (swreg)
Changing ACLs (swacl)
Request Scripts (swask)
Modify (swmodify)
10 Creating Software Packages
Overview of the Packaging Process
Identifying the Products to Package
Determining Product Contents
Determining Product Structure
Adding Control Scripts
Creating a Product Specification File (PSF)
Product Specification File Examples
PSF Syntax
Packaging the Software (swpackage)
Using 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
Types of Control Scripts
General Script Guidelines
Packaging Control Scripts
Control Script Location on the File System During Execution
Using Environment Variables
Variables That Affect All SD-UX Commands
Variables That Affect All SD-UX Scripts
Variables That Affect swinstall and swremove
Variables That Affect swverify
Execution of Control Scripts
Details Common to All Control Scripts
Checkinstall Scripts
Preinstall Scripts
Postinstall Scripts
Configure Scripts
Unconfigure Scripts
Verify Scripts
Fix Scripts
Checkremove Scripts
Preremove Scripts
Postremove Scripts
Request Scripts
Execution of Other Commands by Control Scripts
Control Script Input and Output
File Management by Control Scripts
Testing Control Scripts
Testing Installation Scripts
Testing Configuration Scripts
Testing Removal Scripts
Requesting User Responses (swask)
Using swask
Request Script Tasks and Examples
swask Examples
swinstall Examples
swconfig Examples
12 Nonprivileged SD
Who Can Benefit?
How Does It Work?
Setting Up Nonprivileged Mode
Packaging Software for Use in Nonprivileged Mode
Turning On Nonprivileged Mode
How Nonprivileged Mode Changes SD-UX Behavior
Default Configuration
Alternative Configuration
Setting the Admin Directory Option
A Command Options
Changing Command Options
Options Listed Alphabetically
B Troubleshooting
Error Logging
Error Messages
Warning Messages
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
C Replacing or Updating SD-UX
Re-installing SD-UX
Using install-sd
Replacing an Unusable Version of SD-UX
Installing a Newer Version of SD-UX
D Software Distributor Files and File System Structure
Agent File System Structure
Software Distributor Controller File System Structure
Installed Products Database

List of Figures

1-1 SD-UX Systems
1-2 Example of HP-UX Software Structure
1-3 The Terminal User Interface (TUI)
1-4 GUI Window Components
1-5 Software Selection Window
1-6 Column Editor
1-7 Filter Dialog
1-8 Sort Dialog
1-9 Options Dialog
1-10 Save Software Group Dialog
1-11 Specify Source Dialog
1-12 Select Target Path Dialog
1-13 Shared Root Paths Dialog
1-14 Typical On-Line Help Screen
1-15 Sample Command
2-1 Specify Source Dialog
2-2 swinstall Software Selection Window
2-3 Analysis Dialog
2-4 Disk Space Analysis Window
2-5 Install Window
3-1 The swlist Browser
3-2 swremove Software Selection Window
3-3 Remove Analysis dialog
3-4 Remove Window
4-1 Select Target Depot Path Dialog
4-2 Specify Source Dialog
4-3 Software Selection Window
4-4 Copy Analysis Dialog
4-5 Disk Space Analysis Window
4-6 Copy Window
6-1 The SD Job Browser Window
6-2 Copy Icon
6-3 Active Install Job Icon
6-4 Scheduled Install Job Icon
6-5 Install Job with Warnings Icon
6-6 Install Job with Errors Icon
6-7 Scheduled Remove Installed Software Job Icon
6-8 Scheduled Remove Depot Software Job Icon
6-9 Verify Job Icon
6-10 Jobs Displayed by Properties
6-11 Refresh Interval Dialog
6-12 Job Results Dialog
6-13 Show Job Description
6-14 Remove a Job dialog
7-1 Target Selection Window
7-2 Add Targets Dialog
7-3 Target Selection Window
7-4 Add Target Dialog (for multiple or non default targets)
7-5 Specify Source Dialog
7-6 Software Selection Window
7-7 Install Preferences Dialog
7-8 Install Analysis Dialog
7-9 Install Window dialog
7-10 The swlist Browser
9-1 Access Control Lists
9-2 ACL Templates
9-3 SD-UX Security Process
10-1 An Overview of the Packaging Process

List of Tables

HP-UX 11i Releases
1-1 Chapter Topics
1-2 SD Commands
1-3 Operator Types
2-1 Chapter Topics
2-2  GUI Installation Steps
2-3 swinstall Command Options and Default Values
2-4 Product Compatibility
2-5 swconfig Command Options and Default Values
2-6 swverify Command Options and Default Values
3-1 Chapter Topics
3-2 The -l Options
3-3 swlist Command Options and Default Values
3-4 The -l Options
3-5 Listing Depots
3-6 Sample Attributes
3-7 swmodify Command Options and Default Values
3-8  GUI Removal Steps
3-9 swremove Command Options and Default Values
4-1 Chapter Topics
4-2 Commands for Depot Management
4-3 Copy Process Steps
4-4 swcopy Command Options and Default Values
4-5 swreg Command Options and Default Values
6-1 Chapter Topics
6-2 Job Actions Options
6-3 swjob Command Options and Default Values
6-4 Typical job attributes
7-1 Chapter Topics
7-2 Installation Steps
7-3 Software Selection List
8-1 Chapter Topics
9-1 Chapter Topics
9-2 swacl Command Options and Default Values
9-3 SD-UX ACL Entry Types
9-4 SD-UX ACL Entry Key Values
9-5 ACL Permissions
9-6 SD-UX ACL Permission Definitions
9-7 Host ACL Permissions
9-8 Root Permissions
9-9 Depot Permissions
9-10 Product Principals
9-11 Product Permissions
10-1 Chapter Topics
10-2 Keywords Used in the Product Specification File
10-3 Control File Attributes
10-4 swpackage Process Phases
10-5 swpackage Command Options and Default Values
11-1 Chapter Topics
11-2 Control Script Keywords
11-3 swask Command Options and Default Values
12-1 Chapter Topics
A-1 Chapter Topics
A-2 loglevel and logdetail Combinations
B-1 Chapter Topics
B-2 Common Problems
C-1 Chapter Topics
D-1 Chapter Topics
D-2 Agent Component
D-3 Controller File System Structure
Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1997, 2000-2003, 2006, 2007, 2008 Hewlett-Packard Development Company, L.P.