Notices

Preface

Part 1: Description

1. Overview

1.1 Overview of the JP1/Software Distribution system

1.1.1 Features of a JP1/Software Distribution system

1.1.2 Types of systems comprising the JP1/Software Distribution system

1.1.3 Functions of the JP1/Software Distribution system

1.2 Configuration of a JP1/Software Distribution system

1.2.1 Network configuration

1.2.2 Software configuration

1.3 Functions and operating environment of JP1/Software Distribution Client

1.3.1 Organization of JP1/Software Distribution Client functions

1.3.2 Files used by JP1/Software Distribution Client

1.3.3 Conditions for using JP1/Software Distribution Client

2. Remote Installation

2.1 Software distribution overview

2.1.1 Distribution via a temporary package storehouse on a relay system

2.1.2 Distribution with UAP startup before and after package installation

2.1.3 Distribution specifying the installation timing

2.1.4 Distribution specifying the installation date and time

2.1.5 Distributing shared packages to Windows machines

2.1.6 Distributing through the selection of the package by the distribution-destination system user

2.1.7 Distribution with recovery specified during installation failure

2.1.8 Package overwrite installation

2.1.9 Distribution with OS restart in distribution-destination systems after installation

2.1.10 Preventing package distribution by checking versions

2.2 Software packaging

2.2.1 Software classification

2.2.2 Media that can register the software

2.2.3 Packaging procedure

2.2.4 Creating the files to be specified during packaging

2.2.5 Notes on packaging

2.3 Package management

2.3.1 Resource classification

2.3.2 Checking the user that will perform packaging

2.3.3 Displaying package attributes

2.3.4 Deleting packages

2.4 Package distribution

2.4.1 Executing the distribution job by the managing server

2.4.2 Package relay system

2.4.3 Checking for a distribution job at the end workstation

2.4.4 Checking for a distribution job at the client workstation

2.4.5 Confirming the operational status of the package distribution command

2.4.6 Note on remote installation

2.5 Package installation

2.5.1 Installing packages with installation timing specified

2.5.2 Scheduled installation

2.5.3 Selecting the package to install (Send package, allow client to choose job)

2.5.4 Recovery when installation fails

2.5.5 Checking the installation result

2.5.6 Reporting the installation results

2.5.7 Cautionary notes to follow during package installation

2.6 OS patch distribution

2.6.1 Formats of distributable OS patches

2.6.2 Procedure for distributing an OS patch

2.6.3 Notes on configuring the packager

2.6.4 Notes on configuring the managing server

2.6.5 Required settings in distribution-destination systems and required checking at installation

3. Remote Collection

3.1 Overview of file collection

3.1.1 Collection via a temporary collection storehouse on a relay system

3.1.2 Collection by archiving files

3.1.3 Collection by specifying collection timing

3.1.4 Collection by starting UAP before file collection

3.2 Registering attributes of collection files

3.2.1 Creating the collection-information file

3.2.2 Creating the collection path file

3.2.3 Creating a UAP that executes during collection

3.3 Executing a file collection job

3.4 Reuse of collected resources

3.5 Note on remote collection

4. Management of the Distribution-Destination System by the Managing Server

4.1 Overview of distribution-destination management

4.2 System configuration management

4.2.1 Setting the automatic registration function of the system configuration

4.2.2 Deleting a client system from the system configuration information

4.3 Inventory management

4.3.1 System information management

4.3.2 Software information management

4.3.3 Reporting of inventory information from the distribution-destination system

4.4 Grouping distribution-destinations

4.4.1 ID group

4.4.2 ID group definition (client services)

4.4.3 ID group definition (distributor tools)

4.5 Reporting information to the upper-level managing server

4.5.1 Reporting distribution/collection results (client services)

4.5.2 Reporting the distribution results (distributor tools)

4.5.3 Reporting user resource status

4.6 Managing the communication condition of the distribution-destination system

4.6.1 Periodic monitoring of the communication condition

4.6.2 Reporting startup failure of the distribution-destination system

4.7 Using a related software product to manage the operation status

4.7.1 Using JP1/IM - Manager to manage the operation status

5. Job Management

5.1 Registering and executing jobs

5.1.1 Job list

5.1.2 Controlling job registration/execution

5.1.3 Changing installation methods during job registration

5.1.4 Creating an installation script file during job registration

5.2 Managing job status

5.2.1 Job status types

5.2.2 Displaying job execution status

5.2.3 Acquiring job execution results (Execution status)

5.3 Deleting jobs

5.3.1 Deleting individual jobs

5.3.2 Batch job deletion

Part 2: Introduction/Operation

6. Installation Tasks

6.1 Procedure for setting the operating environment

6.2 Estimating of the disk space and memory requirements

6.2.1 Disk space requirements for the relay system

6.2.2 Hard disk space required in the distribution-destination system

6.2.3 Disk space requirement for the packager

6.2.4 Disk space requirements for the managing server

6.2.5 Memory requirement

6.2.6 Changing the work directory

6.3 Setting the network environment

6.3.1 Setting the port numbers

6.3.2 Setting the user ID

6.3.3 Setting the host name

6.3.4 Defining the network interface for JP1/Software Distribution

6.3.5 Setting the host name in the login permission file

6.3.6 Settings when using firewalls

6.3.7 Examples of operating environment setup

6.4 Creating settings files

6.4.1 General rules for the settings files

6.4.2 Syntax of the relay system settings file

6.4.3 Syntax of the end workstation settings file

6.4.4 Syntax of the client workstation settings file

6.4.5 Syntax of the settings file for the distributor tools

6.5 Creating the settings file (environment settings file) for the generator tools

6.5.1 Environment settings file name

6.5.2 Syntax of the environment settings file

6.6 Creating the host file

6.6.1 Conditions that require a host file

6.6.2 Host file creation rules

6.6.3 Host file syntax

6.7 Setting the language for messages

6.7.1 Files that specify LANG and TZ

6.7.2 Example of changing the language

6.8 Configuring the operating-environment settings file

6.8.1 File name for the operating-environment settings file

6.8.2 Items set in the operating-environment settings file

6.9 Setting the system files

6.9.1 Setting HP-UX system files

6.9.2 Setting Solaris system files

6.9.3 Setting AIX system files

6.10 Creating the backup directory

6.10.1 How to create the backup directory

6.10.2 Notes on creating the backup directory

7. Operating the System

7.1 Managing the temporary package storehouse

7.1.1 Initializing the temporary package storehouse

7.1.2 Deleting the expired packages

7.1.3 Allocating the temporary package storehouse

7.1.4 Size of the temporary package storehouse

7.1.5 Acquiring the backup of the temporary package storehouse in case of errors

7.2 Managing the temporary job storehouse

7.2.1 When RESOURCE_DELETE is specified

7.2.2 When MANUAL is specified

7.3 Managing the temporary collection storehouse

7.3.1 Initializing the temporary collection storehouse

7.3.2 Forcibly deleting resources from the temporary collection storehouse

7.3.3 Allocating the temporary collection storehouse

7.4 Package backup

7.4.1 Acquiring backups

7.4.2 Managing backups

7.5 Processing to be performed if clients do not respond

7.6 Acquiring software information

8. JP1 Event Processing Using JP1/IM - Manager

8.1 Overview of the operations using JP1/IM - Manager

8.1.1 Overview of the automatic action

8.1.2 JP1 events that JP1/Software Distribution Client may send

8.1.3 Notes on using automatic actions

8.2 Details of JP1 events that JP1/Software Distribution Client may send

8.2.1 JP1 Events issued by the client services

8.2.2 JP1 Events issued by the generator tools

8.2.3 JP1 events issued by the distributor tools

Part 3: Operations

9. Command Operations for Client Services and Generator Tools

Types of commands

Method of command input

How to read the command syntax description

rdsatrup

rdsbkclear

rdscfclr

rdsclr

rdscm

rdsdlv

rdsdlvclr

rdsdlvse

rdsentry

rdsft

rdsgroupid

rdsiddefine

rdsidexec

rdsinsset

rdskillsrv

rdslistdel

rdslst

rdsma

rdsrecover

rdsrf

rdsrsclst

rdssnd

rdsstart

rdsstrbkup

rdsstrrcv

rdssts

rdssys

rdssysmig

rdsupt

rdsusnd

rdsusnd2

rdsusrinv

10. Command Operations for Distributor Tools

Types of commands

Method of command input

How to read the command syntax description

rdsafbkup

rdsafcdef

rdsafenv

rdsafgid

rdsafind

rdsafrcvr

rdsafrsc

rdsafsci

rdsafse

11. GUI Operations for Packaging

11.1 Basic operations

11.1.1 Starting and exiting from GUI

11.1.2 Overview of packaging

11.2 Configuration of GUI

11.2.1 Configuration of the Packaging window

11.2.2 Configuration of the Packaging Details dialog box

11.3 Packaging operations

11.3.1 Packaging a program product

11.3.2 Packaging another company's software

11.3.3 Packaging a user resource

11.3.4 Packaging an OS Patch

Part 4: Troubleshooting and Messages

12. Troubleshooting

12.1 Checking failure information by messages

12.1.1 Failure information during packaging

12.1.2 Failure information during package distribution or file collection

12.2 Failure types and troubleshooting

12.2.1 Failures in the client services

12.2.2 Failures in the distributor tools

12.2.3 Failures in a program performing user-specific processing

12.3 Acquiring failure information

rdssubget command

rdssubslget command

rdscltget command

rdscltslget command

rdsget command

rdsafget command

13. Messages

13.1 Message format

13.1.1 Message output format

13.1.2 Formats for messages output during package distribution or during file collection

13.1.3 Severity of messages that are reported to the managing server

13.2 Messages for client services

13.3 Messages for generator tools

13.4 Messages for distributor tools

Appendixes

A. File Structures in JP1/Software Distribution Client

A.1 File structure of the client services

A.2 File structure of the generator tools

A.3 File structure of the distributor tools

B. Status Codes

B.1 Status codes for the client services

B.2 Status codes for the distributor tools

C. Port Numbers

C.1 Port numbers

C.2 Direction in which data passes through the firewall

D. Processes for Monitoring JP1/Software Distribution Client

D.1 Monitoring processes for systems other than HP-UX

D.2 Monitoring processes for HP-UX

E. Kernel Parameter List

E.1 For HP-UX

E.2 For Solaris

E.3 For AIX

F. Differences with JP1/Software Distribution for Windows

G. Version Changes

H. Glossary

Index

All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.