IBM Tivoli Configuration Managerpublib.boulder.ibm.com/tividd/td/ITCM/SC23-4711-01/... · This...
Transcript of IBM Tivoli Configuration Managerpublib.boulder.ibm.com/tividd/td/ITCM/SC23-4711-01/... · This...
-
IBM
Tivoli
Configuration
Manager
User’s
Guide
for
Software
Distribution
Version
4.2.1
SC23-4711-01
���
-
IBM
Tivoli
Configuration
Manager
User’s
Guide
for
Software
Distribution
Version
4.2.1
SC23-4711-01
���
-
Note
Before
using
this
information
and
the
product
it
supports,
read
the
information
in
“Notices”
on
page
351.
Second
Edition
(December
2003)
This
edition
applies
to
version
4,
release
2,
modification
level
1
of
IBM
Tivoli
Configuration
Manager
(program
number
5724-C06)
and
to
all
subsequent
releases
and
modifications
until
otherwise
indicated
in
new
editions.
This
edition
replaces
SC23-4711-00.
©
Copyright
International
Business
Machines
Corporation
2002,
2003.
All
rights
reserved.
US
Government
Users
Restricted
Rights
–
Use,
duplication
or
disclosure
restricted
by
GSA
ADP
Schedule
Contract
with
IBM
Corp.
-
Contents
Figures
.
.
.
.
.
.
.
.
.
.
.
.
.
. vii
Tables
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. ix
Preface
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. xi
Who
Should
Read
This
Guide
.
.
.
.
.
.
.
. xi
What
This
Guide
Contains
.
.
.
.
.
.
.
.
. xi
Publications
.
.
.
.
.
.
.
.
.
.
.
.
.
. xiii
IBM
Tivoli
Configuration
Manager
Library
.
. xiii
Related
Publications
.
.
.
.
.
.
.
.
.
. xiv
Accessing
Publications
Online
.
.
.
.
.
.
. xiv
Ordering
Publications
.
.
.
.
.
.
.
.
.
. xv
Accessibility
.
.
.
.
.
.
.
.
.
.
.
.
.
. xv
Contacting
Software
Support
.
.
.
.
.
.
.
. xv
Conventions
Used
in
This
Guide
.
.
.
.
.
.
. xvi
Typeface
Conventions
.
.
.
.
.
.
.
.
.
. xvi
Operating
system-dependent
Variables
and
Paths
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. xvi
Software
Distribution
Icons
.
.
.
.
.
.
. xvii
Part
1.
Preparing
Software
Packages
1
Chapter
1.
Overview
of
Software
Distribution
.
.
.
.
.
.
.
.
.
.
.
.
. 5
What
Is
New
in
This
Version
.
.
.
.
.
.
.
.
. 5
Software
Distribution
Highlights
.
.
.
.
.
.
.
. 6
Software
Package
Preparation
.
.
.
.
.
.
. 6
Support
for
Previous
Product
Releases
.
.
.
.
. 8
Software
Package
Distributions
and
Operations
.
. 8
Multiplexed
Distributions
.
.
.
.
.
.
.
. 10
The
Software
Distribution
Environment
.
.
.
.
. 11
Source
Host
.
.
.
.
.
.
.
.
.
.
.
.
. 12
Distribution
Targets
.
.
.
.
.
.
.
.
.
.
. 12
Software
Packages
.
.
.
.
.
.
.
.
.
.
.
. 12
Object-related
Actions
.
.
.
.
.
.
.
.
.
. 13
System
Actions
.
.
.
.
.
.
.
.
.
.
.
. 13
Program
Actions
.
.
.
.
.
.
.
.
.
.
.
. 14
Nested
Software
Packages
.
.
.
.
.
.
.
. 15
Software
Package
Formats
.
.
.
.
.
.
.
.
. 15
Software
Package
(.sp)
File
.
.
.
.
.
.
.
. 15
Software
Package
Definition
(.spd)
File
.
.
.
. 16
Software
Package
Block
(.spb)
.
.
.
.
.
.
. 16
Software
Package
Object
.
.
.
.
.
.
.
.
. 16
Choosing
a
Software
Package
Format
.
.
.
.
. 16
Tivoli
Desktop
Operations
.
.
.
.
.
.
.
.
. 17
Software
Distribution
Operations
.
.
.
.
.
.
. 17
Chapter
2.
Launching
the
Software
Package
Editor
.
.
.
.
.
.
.
.
.
.
. 19
Launching
the
Software
Package
Editor
on
Endpoints
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 19
From
the
Desktop
.
.
.
.
.
.
.
.
.
.
. 19
From
the
Command
Line
.
.
.
.
.
.
.
.
. 20
Launching
the
Software
Package
Editor
on
Managed
Nodes
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 21
Determining
the
Type
of
Package
You
Will
Create
23
Embedding
a
Native
Package
into
a
Software
Package
.
.
.
.
.
.
.
.
.
.
.
.
.
. 23
Creating
a
Software
Package
with
AutoPack
.
. 23
Creating
a
Software
Package
using
a
Template
.
. 23
Customizing
a
Sample
Software
Package
.
.
. 23
Creating
a
Software
Package
for
Mixed
Target
Types
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 24
Working
with
an
Existing
Software
Package
.
. 24
Customizing
the
Software
Package
Editor
GUI
.
. 24
Customizing
the
Welcome
Page
.
.
.
.
.
. 25
Creating
a
New
Software
Package
Sample
.
.
. 26
Creating
a
New
Software
Package
Template
.
. 26
Setting
the
Default
Path
.
.
.
.
.
.
.
.
. 27
Chapter
3.
Creating
Packages
Using
the
Software
Package
Editor
.
.
.
.
. 29
Creating
a
Software
Package
.
.
.
.
.
.
.
.
. 29
Creating
the
Appsample
Software
Package
.
.
.
. 29
Naming
the
Appsample
Software
Package
.
.
. 31
Checking
Disk
Space
.
.
.
.
.
.
.
.
.
. 32
Adding
Directories
and
Files
.
.
.
.
.
.
. 34
Adding
Windows
Platform
Actions
to
a
Generic
Container
.
.
.
.
.
.
.
.
.
.
.
.
.
. 37
Adding
OS/2
Platform
Actions
to
a
Generic
Container
.
.
.
.
.
.
.
.
.
.
.
.
.
. 50
Adding
an
Execute
Program
Action
.
.
.
.
. 57
Adding
a
Restart
Action
.
.
.
.
.
.
.
.
. 59
The
Appsample
Software
Package
.
.
.
.
.
. 60
Setting
Properties
on
the
Package
.
.
.
.
.
.
. 61
General
Properties
.
.
.
.
.
.
.
.
.
.
. 62
Server
Options
.
.
.
.
.
.
.
.
.
.
.
. 64
Endpoint
Options
.
.
.
.
.
.
.
.
.
.
. 67
Log
File
Properties
.
.
.
.
.
.
.
.
.
.
. 70
Description
.
.
.
.
.
.
.
.
.
.
.
.
. 72
Copyright
.
.
.
.
.
.
.
.
.
.
.
.
.
. 72
Variable
List
.
.
.
.
.
.
.
.
.
.
.
.
. 73
Nested
Packages
.
.
.
.
.
.
.
.
.
.
.
. 73
Editing
Software
Package
Properties
.
.
.
.
.
. 74
Program
Actions
in
the
Software
Package
Editor
.
. 75
The
InstallShield
Program
Action
.
.
.
.
.
. 76
The
Microsoft
Setup
Program
Action
.
.
.
.
. 78
Remove
Actions
.
.
.
.
.
.
.
.
.
.
.
.
. 78
Saving
the
Software
Package
.
.
.
.
.
.
.
. 79
Chapter
4.
Creating
a
Software
Package
for
Devices
.
.
.
.
.
.
.
.
. 83
Creating
a
Device
Object
Software
Package
.
.
.
. 83
Adding
Directories
to
Devices
.
.
.
.
.
.
. 84
Adding
Files
to
Devices
.
.
.
.
.
.
.
.
. 86
Running
Programs
on
Devices
.
.
.
.
.
.
. 87
Customizing
Device
Settings
.
.
.
.
.
.
.
. 88
©
Copyright
IBM
Corp.
2002,
2003
iii
||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
-
Distributing
the
Device
Object
Software
Package
to
Targets
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 90
Chapter
5.
Using
Software
Distribution
on
OS/400
.
.
.
.
.
.
.
.
.
.
.
.
. 91
Defining
Software
Packages
with
OS/400
Objects
.
. 91
The
OS/400
Native
and
Integrated
File
Systems
.
. 92
Using
the
OS/400
Software
Package
Editor
.
.
.
. 93
Launching
the
OS/400
Software
Package
Editor
93
Adding
OS/400
Libraries
and
Objects
.
.
.
. 94
Adding
OS/400
Objects
.
.
.
.
.
.
.
.
. 96
Removing
OS/400
Libraries
.
.
.
.
.
.
.
. 97
Removing
OS/400
Objects
.
.
.
.
.
.
.
. 98
Adding
OS/400
Licensed
Programs
.
.
.
.
. 99
Removing
OS/400
Licensed
Programs
.
.
.
. 100
Changing
an
OS/400
Sysval
.
.
.
.
.
.
. 101
Using
Non-OS/400-Specific
Functions
.
.
.
.
. 102
Adding
Non-Native
Objects
to
the
OS/400
Native
File
System
.
.
.
.
.
.
.
.
.
. 102
Running
an
OS/400
Executable
Program
.
.
. 104
Saving
an
OS/400
Software
Package
.
.
.
.
.
. 106
Chapter
6.
Embedding
Native
Objects
into
a
Software
Package
.
.
.
.
.
.
. 107
Using
the
Software
Package
Editor
to
Embed
Native
Objects
.
.
.
.
.
.
.
.
.
.
.
.
. 107
Benefits
of
Embedding
Native
Objects
.
.
.
.
. 108
Creating
a
Software
Package
that
Embeds
a
Native
Object
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 108
Defining
Supported
Software
Distribution
Operations
in
a
Native
Installation
.
.
.
.
. 109
Using
a
Wizard
.
.
.
.
.
.
.
.
.
.
.
.
. 112
Using
the
Install
MSI
Product
Importer
.
.
.
. 113
Using
the
PDF
Importer
.
.
.
.
.
.
.
.
. 116
Using
Dialogs
.
.
.
.
.
.
.
.
.
.
.
.
. 120
Using
Dialogs
to
Embed
or
Edit
an
AIX
Package
121
Using
Dialogs
to
Embed
or
Edit
a
Solaris
Package
.
.
.
.
.
.
.
.
.
.
.
.
.
. 124
Using
Dialogs
to
Embed
or
Edit
a
Linux
Package
.
.
.
.
.
.
.
.
.
.
.
.
.
. 127
Using
Dialogs
to
Embed
or
Edit
an
HP-UX
Package
.
.
.
.
.
.
.
.
.
.
.
.
.
. 130
Using
Dialogs
to
Embed
or
Edit
an
MSI
Package
135
The
Execute
CID
Program
Action
.
.
.
.
.
. 142
The
InstallShield
Program
Action
.
.
.
.
.
. 142
The
Microsoft
Setup
Program
Action
.
.
.
. 142
Making
a
Native
Installation
Conditional
.
.
. 142
Defining
an
Inventory
Signature
for
a
Native
Package
.
.
.
.
.
.
.
.
.
.
.
.
.
. 144
Chapter
7.
How
Does
AutoPack
Work?
145
AutoPack
Components
.
.
.
.
.
.
.
.
.
. 146
AutoPack
Configuration
File
.
.
.
.
.
.
.
. 147
Customizing
the
Configuration
File
.
.
.
.
. 150
Dealing
with
Shared
Objects
.
.
.
.
.
.
. 152
Autopack.ini
Default
for
Windows
2003
.
.
. 152
Autopack.ini
Default
for
Windows
XP
.
.
.
. 153
Autopack.ini
Default
for
Windows
2000
.
.
. 154
Autopack.ini
Default
for
UNIX
Systems
.
.
. 155
Autopack.ini
Default
on
OS/2
Systems
.
.
.
. 155
Chapter
8.
Generating
a
Software
Package
Using
AutoPack
.
.
.
.
.
. 157
Running
AutoPack
.
.
.
.
.
.
.
.
.
.
. 158
Creating
the
First
Snapshot
.
.
.
.
.
.
.
.
. 158
Manual
Installation
Option
.
.
.
.
.
.
.
.
. 164
Resuming
the
Second
Snapshot
.
.
.
.
.
. 165
The
Automatic
Installation
Option
.
.
.
.
.
. 168
Part
2.
Planning
and
Distributing
Software
Packages
.
.
.
.
.
.
.
. 173
Chapter
9.
Preparing
a
Software
Package
for
Distribution
.
.
.
.
.
.
. 177
Creating
a
Software
Distribution
Profile
.
.
.
. 177
Setting
the
Profile
Subscribers
.
.
.
.
.
.
. 181
Importing
a
Software
Package
into
the
Tivoli
Environment
.
.
.
.
.
.
.
.
.
.
.
.
. 182
Creating
a
New
Software
Package
and
Importing
it
into
a
Software
Package
Profile
.
. 182
Importing
an
Existing
Software
Package
into
a
Software
Package
Profile
.
.
.
.
.
.
.
. 183
Deleting
a
Software
Package
Profile
.
.
.
.
. 186
Software
Package
Properties
.
.
.
.
.
.
.
. 186
Calculating
the
Size
of
a
Software
Package
.
.
. 188
Converting
a
Software
Package
.
.
.
.
.
.
. 189
Not-built
to
Built
.
.
.
.
.
.
.
.
.
.
. 189
Built
to
Not-built
.
.
.
.
.
.
.
.
.
.
. 190
Exporting
a
Software
Package
.
.
.
.
.
.
.
. 190
Change
Management
Operations
.
.
.
.
.
.
. 191
Software
Package
States
.
.
.
.
.
.
.
.
. 191
Executing
Change
Management
Operations
.
. 192
Customizing
the
GUI
Settings
.
.
.
.
.
.
. 195
Installing
the
Appsample^1.0
Software
Package
196
Advanced
Options
.
.
.
.
.
.
.
.
.
. 201
Installing
the
Device
Object
Software
Package
210
Distributing
Nested
Software
Packages
.
.
.
.
. 212
Things
To
Consider
.
.
.
.
.
.
.
.
.
. 213
Checking
the
Outcome
of
a
Distribution
.
.
.
. 215
Checkpoint
Restart
Service
for
Network
Failure
or
Power
Interruptions
.
.
.
.
.
.
.
.
.
.
. 216
Example
.
.
.
.
.
.
.
.
.
.
.
.
.
. 216
Scheduling
a
Distribution
.
.
.
.
.
.
.
.
. 217
Chapter
10.
Using
Data
Moving
.
.
.
. 221
Configuring
the
Data
Moving
Service
.
.
.
.
. 221
Data
Moving
Scenarios
.
.
.
.
.
.
.
.
.
. 222
Sending
Data
to
Multiple
Destinations
.
.
.
. 222
Data
Retrieval
from
Multiple
Origins
.
.
.
. 224
Deleting
a
File
on
Multiple
Systems
.
.
.
.
. 227
Moving
Files
from
Endpoint
to
Endpoint
.
.
. 229
Defining
the
Advanced
Options
.
.
.
.
.
. 229
Using
Pre-
and
Post-Processing
Scripts
.
.
.
.
. 230
Examples
.
.
.
.
.
.
.
.
.
.
.
.
.
. 231
The
Data
Moving
Service
in
an
OS/400
Environment
.
.
.
.
.
.
.
.
.
.
.
.
. 233
Chapter
11.
Configuring
a
Network
Topology
.
.
.
.
.
.
.
.
.
.
.
.
. 235
Introducing
NoonTide
.
.
.
.
.
.
.
.
.
. 236
iv
IBM
Tivoli
Configuration
Manager:
User’s
Guide
for
Software
Distribution
||||
|||
||
|
|
|
|
|
|
|
-
Network
Architecture
.
.
.
.
.
.
.
.
.
. 237
Creating
a
Repeater
Hierarchy
.
.
.
.
.
.
.
. 238
Configuring
Repeater
Sites
.
.
.
.
.
.
.
. 241
Setting
Repeater
Parameters
.
.
.
.
.
.
. 242
How
Software
Distribution
Works
.
.
.
.
.
. 250
Software
Distribution
Methods
.
.
.
.
.
.
. 253
Software
Distribution
Scenarios
.
.
.
.
.
.
. 253
Scenario
1:
Distributing
from
a
Tivoli
Management
Region
Server
through
a
Gateway
. 254
Scenario
2:
Distributing
from
a
Source
Host/Tivoli
Management
Region
Server
to
a
Repeater
.
.
.
.
.
.
.
.
.
.
.
.
.
. 255
Scenario
3:
Distributing
from
a
Source
Host
through
Repeater
Depots
.
.
.
.
.
.
.
. 257
Scenario
4:
Distributing
from
a
Tivoli
Management
Region
Server
to
a
Mobile
Endpoint
Installing
Images
from
a
CD-ROM
.
. 259
Scenario
5:
Performing
Data
Moving
Operations
260
Chapter
12.
Integrating
the
Tivoli
Enterprise
Console
.
.
.
.
.
.
.
.
. 263
Enabling
the
Tivoli
Enterprise
Console
.
.
.
.
. 263
Steps
to
Enable
the
Integration
.
.
.
.
.
. 263
The
tecad_sd.conf
File
.
.
.
.
.
.
.
.
.
. 264
Creating
the
Software
Distribution
Console
.
.
. 267
Software
Distribution
Classes
.
.
.
.
.
.
.
. 268
Chapter
13.
Integrating
Inventory
with
Software
Distribution
.
.
.
.
.
.
.
. 271
Configuration
Repository
.
.
.
.
.
.
.
.
. 271
Query
Facility
.
.
.
.
.
.
.
.
.
.
.
.
. 272
Describing
Software
Distribution
Tables
.
.
.
. 272
How
the
Integration
Works
.
.
.
.
.
.
.
.
. 273
Enabling
and
Disabling
the
Historical
Database
and
Change
Management
Status
.
.
.
.
.
. 274
Exchanging
Information
between
Software
Distribution
and
Inventory
.
.
.
.
.
.
.
. 274
Defining
an
Inventory
Signature
.
.
.
.
.
. 276
Creating
the
INVENTORY_QUERIES
.
.
.
.
. 277
Running
an
INVENTORY_QUERY
.
.
.
.
.
. 277
Desktop
.
.
.
.
.
.
.
.
.
.
.
.
.
. 277
Command
Line
.
.
.
.
.
.
.
.
.
.
.
. 279
Modifying
SWDISTDATA_QUERY
.
.
.
.
.
. 279
Desktop
.
.
.
.
.
.
.
.
.
.
.
.
.
. 280
Command
Line
.
.
.
.
.
.
.
.
.
.
.
. 282
Chapter
14.
Upgrading
Windows
2000
Professional
to
Windows
XP
.
.
.
.
. 283
Environment
Configuration
.
.
.
.
.
.
.
.
. 283
Creating
a
Response
File
.
.
.
.
.
.
.
.
. 283
Copying
the
Files
That
You
Need
to
Perform
the
Migration
to
the
Tivoli
Server
.
.
.
.
.
.
.
. 284
Copying
the
Windows
XP
Files
to
the
Image
Server
285
Customizing
the
Inst_wXP.spd
Software
Package
Definition
File
.
.
.
.
.
.
.
.
.
.
.
.
. 285
Creating
the
Software
Package
on
the
Tivoli
Server
286
Subscribing
the
Endpoints
to
the
Upgrades
Profile
Manager
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 287
Distributing
the
Software
Package
to
the
Tivoli
Endpoints
.
.
.
.
.
.
.
.
.
.
.
.
.
. 287
Using
the
Check_OS^1.0.spd
to
Verify
the
Upgrade
287
Chapter
15.
Troubleshooting
.
.
.
.
. 289
Troubleshooting
Process
.
.
.
.
.
.
.
.
.
. 289
Hints
and
Tips
.
.
.
.
.
.
.
.
.
.
.
. 293
Improving
Performance
.
.
.
.
.
.
.
.
.
. 293
Setting
the
Number
of
Endpoints
to
Be
Handled
293
Setting
the
Report
Timeout
for
the
Server
.
.
. 294
Setting
the
Number
of
Threads
.
.
.
.
.
. 294
Checking
Configuration
Files
.
.
.
.
.
.
.
. 294
Base
Configuration
Information
on
the
Distribution
Server
and
Source
Host
.
.
.
.
. 294
Base
Configuration
Information
on
the
Endpoint
294
Software
Distribution
Logs
.
.
.
.
.
.
.
.
. 296
Software
Package
Log
.
.
.
.
.
.
.
.
. 297
Data
Moving
Logs
.
.
.
.
.
.
.
.
.
.
. 302
Log
Object
List
.
.
.
.
.
.
.
.
.
.
.
. 303
Notices
and
Mail
.
.
.
.
.
.
.
.
.
.
. 303
Tivoli
Enterprise
Console
.
.
.
.
.
.
.
. 304
Configuration
Repository
.
.
.
.
.
.
.
. 304
Examining
the
SPD
File
.
.
.
.
.
.
.
.
.
. 305
Troubleshooting
the
Software
Package
Editor
GUI
305
Checking
Repeaters,
Gateways,
and
Endpoints
.
. 306
Setting
Timeout
Values
for
a
Distribution
.
.
. 307
Verifying
Setup
for
Endpoints
.
.
.
.
.
.
. 309
Checking
lost-n-found
.
.
.
.
.
.
.
.
.
. 310
Checking
the
Default
Directory
on
a
Target
System
311
Part
3.
Appendixes
.
.
.
.
.
.
.
. 313
Appendix
A.
Accessibility
.
.
.
.
.
. 315
Navigating
the
Interface
Using
the
Keyboard
.
.
. 315
Software
Package
Editor
.
.
.
.
.
.
.
.
. 315
Magnifying
What
Is
Displayed
on
the
Screen
.
.
. 315
Enabling
the
IBM
Home
Page
Reader
to
Function
with
the
Software
Package
Editor
.
.
.
.
.
. 316
Appendix
B.
Using
Deployment
Services
with
Software
Distribution
.
. 317
Activity
Planner
.
.
.
.
.
.
.
.
.
.
.
. 317
Change
Manager
.
.
.
.
.
.
.
.
.
.
.
. 317
Web
Interface
.
.
.
.
.
.
.
.
.
.
.
.
. 318
Resource
Manager
.
.
.
.
.
.
.
.
.
.
.
. 318
Enterprise
Directory
Query
Library
.
.
.
.
.
. 318
Pristine
Manager
.
.
.
.
.
.
.
.
.
.
.
. 318
Appendix
C.
Pristine
Installations
.
.
. 319
Overview
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 319
Typical
Network
Environment
.
.
.
.
.
.
. 320
Prerequisites
.
.
.
.
.
.
.
.
.
.
.
.
. 321
Windows
Steps
.
.
.
.
.
.
.
.
.
.
.
.
. 323
Pristine
Installation
Scenario
.
.
.
.
.
.
. 323
Step
1:
Planning
.
.
.
.
.
.
.
.
.
.
. 323
Step
2:
Creating
and
Maintaining
Code
Server
Objects
.
.
.
.
.
.
.
.
.
.
.
.
.
. 324
Step
3:
Creating
and
Maintaining
Code
Server
Object
Configurations
.
.
.
.
.
.
.
.
. 329
Step
4:
Preparing
a
System
Diskette
.
.
.
.
. 333
Step
5:
Creating
a
Pristine
Boot
Diskette
.
.
. 334
Contents
v
||
|
|
-
Step
6:
Running
a
Pristine
Installation
.
.
.
. 335
OS/2
Steps
.
.
.
.
.
.
.
.
.
.
.
.
.
. 337
Pristine
Installation
Scenario
.
.
.
.
.
.
. 337
Step
1:
Planning
.
.
.
.
.
.
.
.
.
.
. 337
Step
2:
Creating
and
Maintaining
a
Code
Server
Object
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 338
Step
3:
Adding
System
Files
to
Code
Server
Objects
.
.
.
.
.
.
.
.
.
.
.
.
.
. 340
Step
4:
Creating
and
Maintaining
Code
Server
Object
Configurations
.
.
.
.
.
.
.
.
. 342
Step
5:
Preparing
the
System
Diskettes
.
.
.
. 344
Step
6:
Creating
Pristine
Boot
Diskettes
.
.
.
. 345
Step
7:
Running
a
Pristine
Installation
.
.
.
. 346
Appendix
D.
Authorization
Roles
.
.
. 349
Setting
Up
Software
Distribution
Profiles
.
.
.
. 349
Defining
and
Deleting
Profiles
.
.
.
.
.
.
.
. 349
Performing
Operations
.
.
.
.
.
.
.
.
.
. 350
Notices
.
.
.
.
.
.
.
.
.
.
.
.
.
. 351
Trademarks
.
.
.
.
.
.
.
.
.
.
.
.
.
. 352
Glossary
.
.
.
.
.
.
.
.
.
.
.
.
. 355
Index
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 361
vi
IBM
Tivoli
Configuration
Manager:
User’s
Guide
for
Software
Distribution
-
Figures
1.
MDist
2
and
change
management
operations
250
2.
Distribution
from
Tivoli
server
through
a
gateway.
.
.
.
.
.
.
.
.
.
.
.
.
. 254
3.
Distributing
from
a
host
through
a
repeater
256
4.
Distribution
from
Tivoli
server
to
mobile
endpoints.
.
.
.
.
.
.
.
.
.
.
.
. 259
5.
Data
moving
retrieve
operation
.
.
.
.
. 261
6.
Troubleshooting
the
distribution
of
a
software
package
.
.
.
.
.
.
.
.
.
.
.
.
. 290
7.
Pristine
installation
scenario
.
.
.
.
.
. 320
©
Copyright
IBM
Corp.
2002,
2003
vii
-
viii
IBM
Tivoli
Configuration
Manager:
User’s
Guide
for
Software
Distribution
-
Tables
1.
Software
Package
Editor
Directory
Structure
25
2.
Supported
Software
Distribution
operations
for
the
MSI
package
native
object
.
.
.
.
. 109
3.
Supported
Software
Distribution
operations
for
the
MSI
patch
native
object
.
.
.
.
.
. 109
4.
Supported
Software
Distribution
operations
for
the
AIX
package
native
object
.
.
.
.
. 110
5.
Supported
Software
Distribution
operations
for
the
AIX
updates
native
object
.
.
.
.
. 110
6.
Supported
Software
Distribution
operations
for
the
Solaris
package
native
object
.
.
.
. 110
7.
Supported
Software
Distribution
operations
for
the
Solaris
patch
native
object
.
.
.
.
. 110
8.
Supported
Software
Distribution
operations
for
Linux
package
native
object
.
.
.
.
. 111
9.
Supported
Software
Distribution
operations
for
HP-UX
package
native
object
.
.
.
.
. 111
10.
Mapping
of
Software
Distribution
reinstall
mode
values
to
the
MSI
command
line
.
.
. 139
11.
Components
monitored
by
AutoPack
and
supported
platforms
.
.
.
.
.
.
.
.
. 146
12.
Customizing
default
values
for
distribution
options
.
.
.
.
.
.
.
.
.
.
.
.
. 195
13.
Software
Distribution
methods
and
corresponding
operations
and
commands
.
. 253
14.
Software
Distribution
Tivoli
Enterprise
Console
events
.
.
.
.
.
.
.
.
.
.
. 268
15.
Tivoli
Enterprise
Console
event
attributes
for
Software
Distribution
.
.
.
.
.
.
.
.
. 269
16.
Location
of
swdis.ini
file
.
.
.
.
.
.
.
. 294
17.
Directory
assignments
in
swdis.ini
file
295
18.
Keyboard
shortcuts
for
the
Software
Package
Editor
.
.
.
.
.
.
.
.
.
.
.
.
.
. 315
19.
Source
path
location
for
operating
system
image
on
CD-ROM
.
.
.
.
.
.
.
.
. 326
20.
Source
path
location
for
operating
system
image
.
.
.
.
.
.
.
.
.
.
.
.
.
. 339
21.
Required
roles
for
setting
up
software
package
profiles
.
.
.
.
.
.
.
.
.
. 349
22.
Required
roles
for
setting
software
package
properties
and
viewing
configuration
information
.
.
.
.
.
.
.
.
.
.
.
. 349
23.
Required
roles
to
distribute
software
packages
.
.
.
.
.
.
.
.
.
.
.
.
. 350
©
Copyright
IBM
Corp.
2002,
2003
ix
||
|||
|||
-
x
IBM
Tivoli
Configuration
Manager:
User’s
Guide
for
Software
Distribution
-
Preface
Software
Distribution
provides
a
means
of
managing
and
distributing
software
across
a
multi
platform
network.
For
distributions
that
encompass
wide
area
networks
(WANs),
Software
Distribution
has
a
built-in,
WAN-smart
capability
that
reduces
internetwork
traffic
and
ensures
an
efficient
distribution.
This
guide
explains
the
concepts
and
procedures
necessary
for
you
to
effectively
use
Software
Distribution
to
distribute
software
over
local
area
networks
(LANs)
and
WANs.
Who
Should
Read
This
Guide
This
book
is
intended
for
system
administrators
who
perform
software
package
preparation
and
deployment
operations.
Readers
should
be
familiar
with
the
following
topics:
v
The
UNIX®
and
PC
platforms
v
Shell
programming
v
Concepts
such
as
directories,
files,
and
symbolic
links
v
Operating
systems
running
on
target
machines
to
which
software
is
distributed
What
This
Guide
Contains
This
guide
contains
the
following
sections:
Part
1.
Preparing
Software
Packages
Part
1
contains
the
following
chapters:
v
Chapter
1,
“Overview
of
Software
Distribution,”
on
page
5
Provides
an
introduction
to
the
application
by
describing
the
Software
Distribution
features
and
terminology.
v
Chapter
2,
“Launching
the
Software
Package
Editor,”
on
page
19
Explains
how
to
launch
the
Software
Package
editor
on
endpoints
and
managed
nodes
and
the
tasks
you
can
perform.
v
Chapter
3,
“Creating
Packages
Using
the
Software
Package
Editor,”
on
page
29
Using
the
Appsample
scenario,
describes
the
steps
required
to
create
a
software
package
using
the
Java™-based
Software
Package
Editor
graphical
user
interface
(GUI),
including
setting
software
package
properties
and
adding
software
package
actions.
v
Chapter
4,
“Creating
a
Software
Package
for
Devices,”
on
page
83
Describes
how
to
create
and
distribute
software
packages
for
targets
that
are
pervasive
devices.
v
Chapter
5,
“Using
Software
Distribution
on
OS/400,”
on
page
91
This
chapter
describes
the
Software
Distribution
features
that
are
specific
for
OS/400®
operating
systems.
v
Chapter
6,
“Embedding
Native
Objects
into
a
Software
Package,”
on
page
107
Explains
how
to
embed
native
installation
objects
in
a
Software
Distribution
software
package.
©
Copyright
IBM
Corp.
2002,
2003
xi
-
v
Chapter
7,
“How
Does
AutoPack
Work?,”
on
page
145
Introduces
the
underlying
concepts
of
AutoPack
technology,
including
the
preparation
machine,
AutoPack
system
components,
the
configuration
file,
customizing
the
configuration
file
to
suit
particular
workstation
configurations,
the
snapshot,
the
differencing
phase,
and
what
AutoPack
does
to
support
shared
objects.
v
Chapter
8,
“Generating
a
Software
Package
Using
AutoPack,”
on
page
157
Describes
the
steps
required
to
create
a
software
package
using
AutoPack
from
the
Software
Package
Editor
window.
Using
the
AutoPack
Guided
Process,
a
software
package
is
created
that
installs
the
Tivoli®
desktop
application.
Part
2.
Planning
and
Distributing
Software
Packages
Part
2
contains
the
following
chapters:
v
Chapter
9,
“Preparing
a
Software
Package
for
Distribution,”
on
page
177
Describes
setting
up
the
Software
Distribution
environment,
including
defining
profile
managers
within
a
policy
region
and
associating
target
machines
with
software
package
profiles.
Describes
Tivoli
desktop
functions
such
as
using
the
build
and
unbuild
function,
using
the
import
and
export
functions,
and
performing
change
management
operations.
v
Chapter
10,
“Using
Data
Moving,”
on
page
221
The
Data
Moving
Service
integrates
data
movement
capabilities
into
the
software
package
distribution
process.
v
Chapter
11,
“Configuring
a
Network
Topology,”
on
page
235
Introduces
a
Tivoli
management
region
scenario
to
illustrate
how
to
configure
a
network
topology.
This
chapter
provides
steps
for
setting
up
a
distribution
environment
that
uses
endpoint
gateways,
repeaters,
and
repeater
depots.
It
also
describes
typical
distribution
scenarios.
v
Chapter
12,
“Integrating
the
Tivoli
Enterprise
Console,”
on
page
263
Explains
how
to
install
and
enable
the
Tivoli
Enterprise
Console®
integration
product.
This
chapter
also
provides
a
description
of
the
Software
Distribution
event
configuration
file
and
event
classes.
v
Chapter
13,
“Integrating
Inventory
with
Software
Distribution,”
on
page
271
Explains
how
to
integrate
Software
Distribution
with
Inventory
and
how
to
define
an
Inventory
signature
in
a
software
package.
This
chapter
also
describes
how
to
create
the
INVENTORY_QUERIES
query
library
and
how
to
modify
the
related
queries.
v
Chapter
14,
“Upgrading
Windows
2000
Professional
to
Windows
XP,”
on
page
283
Describes
how
to
upgrade
Windows
2000
Professional
to
Windows
XP.
v
Chapter
15,
“Troubleshooting,”
on
page
289
This
appendix
provides
sources
of
information
that
will
help
you
in
solving
problems
with
Software
Distribution
operations.
Part
3.
Appendixes
Part
3
contains
the
following
appendixes:
v
Appendix
A,
“Accessibility,”
on
page
315
Accessibility
features
help
users
who
have
physical
disabilities,
such
as
restricted
mobility
or
limited
vision,
to
use
software
products
successfully.
Preface
xii
IBM
Tivoli
Configuration
Manager:
User’s
Guide
for
Software
Distribution
-
v
Appendix
B,
“Using
Deployment
Services
with
Software
Distribution,”
on
page
317
This
appendix
outlines
where
you
can
find
information
related
to
the
IBM®
Tivoli
Configuration
Manager,
Version
4.2.1
services,
which
are
the
following:
–
Activity
Planner
–
Change
Manager
–
Web
Interface
–
Resource
Manager
–
Enterprise
Directory
Query
Facility
–
Pristine
Managerv
Appendix
C,
“Pristine
Installations,”
on
page
319
The
pristine
tool
provides
support
for
installing
new
operating
systems
on
Pristine
machines,
and
then
maintaining
the
new
computers
on
the
network.
v
Appendix
D,
“Authorization
Roles,”
on
page
349
Describes
the
roles
required
to
perform
Software
Distribution
tasks.
Publications
This
section
lists
publications
in
the
IBM
Tivoli
Configuration
Manager
library
and
related
documents.
It
also
describes
how
to
access
Tivoli
publications
online
and
how
to
order
Tivoli
publications.
IBM
Tivoli
Configuration
Manager
Library
The
following
documents
are
available
in
the
IBM
Tivoli
Configuration
Manager
library:
v
IBM
Tivoli
Configuration
Manager:
Introducing
IBM
Tivoli
Configuration
Manager,
GC23-4703
Provides
an
overview
of
IBM
Tivoli
Configuration
Manager
and
its
components,
as
well
as
providing
scenarios
to
highlight
various
processes.
v
IBM
Tivoli
Configuration
Manager:
Planning
and
Installation
Guide,
GC23-4702
Explains
how
to
install,
upgrade,
and
uninstall
the
product
and
its
components
in
a
Tivoli
environment.
v
IBM
Tivoli
Configuration
Manager:
User’s
Guide
for
Software
Distribution,
SC23-4711
Explains
the
concepts
and
procedures
necessary
for
you
to
effectively
use
the
Software
Distribution
component
to
distribute
software
over
local
area
networks
(LANs)
and
wide
area
networks
(WANs).
v
IBM
Tivoli
Configuration
Manager:
Reference
Manual
for
Software
Distribution,
SC23-4712
Explains
advanced
features
and
concepts
needed
to
use
and
tailor
the
Software
Distribution
component.
v
IBM
Tivoli
Configuration
Manager:
User’s
Guide
for
Inventory,
SC23-4713
Describes
the
Inventory
component
and
the
management
tasks
that
you
can
perform.
v
IBM
Tivoli
Configuration
Manager:
User’s
Guide
for
Deployment
Services,
SC23-4710
Provides
information
about
the
Deployment
Services
of
the
product.
v
IBM
Tivoli
Configuration
Manager:
Database
Schema
Reference,
SC23-4783
Provides
information
about
the
IBM
Tivoli
Configuration
Manager
repository.
v
IBM
Tivoli
Configuration
Manager:
Messages
and
Codes,
SC23-4706
Details
all
the
error,
warning
messages
and
error
codes
issued
by
the
product.
v
IBM
Tivoli
Configuration
Manager:
Release
Notes,
GI11-0926
Preface
Preface
xiii
-
Contains
late-breaking
information
about
the
product.
Related
Publications
The
following
documents
also
provide
useful
information:
v
IBM
Tivoli
Configuration
Manager:
User’s
Guide
for
Inventory,
SC23-4713
Provides
detailed
information
about
managing
hardware
and
software
using
Inventory.
v
Tivoli
Enterprise:
Installation
Guide,
GC32-0804
Explains
how
to
install
and
upgrade
Tivoli
Enterprise
software
within
your
Tivoli
region
using
the
available
installation
mechanisms
provided
by
Tivoli
Software
Installation
Service
and
Tivoli
Management
Framework.
Tivoli
Enterprise
software
includes
the
Tivoli
server,
managed
nodes,
gateways,
endpoints,
and
RDBMS
Interface
Module
(RIM)
objects.
This
guide
also
provides
information
about
troubleshooting
installation
problems.
v
Tivoli
Management
Framework:
Planning
for
Deployment
Guide,
GC32-0803
Explains
how
to
plan
for
deploying
your
Tivoli
environment.
It
also
describes
Tivoli
Management
Framework
and
its
services.
v
Tivoli
Management
Framework:
Maintenance
and
Troubleshooting
Guide,
GC32-0807
Explains
how
to
maintain
a
Tivoli
environment
and
troubleshoot
problems
that
can
arise
during
normal
operations.
v
Tivoli
Management
Framework:
Reference
Manual,
GC32-0806
Provides
in-depth
information
about
Tivoli
Management
Framework
commands.
This
manual
is
helpful
when
writing
scripts
that
are
later
run
as
Tivoli
tasks.
This
manual
also
documents
default
and
validation
policy
scripts
used
by
Tivoli
Management
Framework.
v
Tivoli
Management
Framework:
User’s
Guide,
GC32-0805
Describes
the
concepts
and
procedures
for
using
Tivoli
Management
Framework
services.
It
provides
instructions
for
performing
tasks
from
the
Tivoli
desktop
and
from
the
command
line.
v
IBM
Tivoli
Enterprise
Console:
User’s
Guide
and
IBM
Tivoli
Enterprise
Console:
Adapters
Guide
Provides
detailed
information
about
integrating
network,
systems,
database,
and
application
management
with
Tivoli
Enterprise
Console.
The
Tivoli
Software
Glossary
includes
definitions
for
many
of
the
technical
terms
related
to
Tivoli
software.
The
Tivoli
Software
Glossary
is
available,
in
English
only,
at
the
following
Tivoli
software
library
Web
site:
http://www.ibm.com/software/tivoli/library/
Access
the
glossary
by
clicking
the
Glossary
link
on
the
left
pane
of
the
Tivoli
software
library
window.
Accessing
Publications
Online
The
documentation
CD
contains
the
publications
that
are
in
the
product
library.
The
format
of
the
publications
is
PDF,
HTML,
or
both.
Refer
to
the
readme
file
on
the
CD
for
instructions
on
how
to
access
the
documentation.
The
product
CD
contains
the
publications
that
are
in
the
product
library.
The
format
of
the
publications
is
PDF,
HTML,
or
both.
To
access
the
publications
using
Preface
xiv
IBM
Tivoli
Configuration
Manager:
User’s
Guide
for
Software
Distribution
http://www.ibm.com/software/tivoli/library/
-
a
Web
browser,
open
the
infocenter.html
file.
The
file
is
in
the
appropriate
publications
directory
on
the
product
CD.
IBM
posts
publications
for
this
and
all
other
Tivoli
products,
as
they
become
available
and
whenever
they
are
updated,
to
the
Tivoli
software
information
center
Web
site.
Access
the
Tivoli
software
information
center
by
first
going
to
the
Tivoli
software
library
at
the
following
Web
address:
http://www.ibm.com/software/tivoli/library/
Scroll
down
and
click
the
Product
manuals
link.
In
the
Tivoli
Technical
Product
Documents
Alphabetical
Listing
window,
click
the
link
to
access
the
product
library
at
the
Tivoli
software
information
center.
Note:
If
you
print
PDF
documents
on
other
than
letter-sized
paper,
set
the
option
in
the
File->
Print
window
that
allows
Adobe
Reader
to
print
letter-sized
pages
on
your
local
paper.
Ordering
Publications
You
can
order
many
Tivoli
publications
online
at
the
following
Web
site:
http://www.elink.ibmlink.ibm.com/public/applications/publications/
cgibin/pbi.cgi
You
can
also
order
by
telephone
by
calling
one
of
these
numbers:
v
In
the
United
States:
800-879-2755
v
In
Canada:
800-426-4968
In
other
countries,
see
the
following
Web
site
for
a
list
of
telephone
numbers:
http://www.ibm.com/software/tivoli/order-lit/
Accessibility
Accessibility
features
help
users
who
have
physical
disabilities,
such
as
restricted
mobility
or
limited
vision,
to
use
software
products
successfully.
With
this
product,
you
can
use
assistive
technologies
to
hear
and
navigate
the
interface.
You
can
also
use
the
keyboard
instead
of
the
mouse
to
operate
all
features
of
the
graphical
user
interface.
For
additional
information,
see
Appendix
A,
“Accessibility,”
on
page
315.
Contacting
Software
Support
If
you
have
a
problem
with
any
Tivoli
product,
refer
to
the
following
IBM
Software
Support
Web
site:
http://www.ibm.com/software/sysmgmt/products/support/
If
you
want
to
contact
software
support,
see
the
IBM
Software
Support
Guide
at
the
following
Web
site:
http://techsupport.services.ibm.com/guides/handbook.html
Preface
Preface
xv
http://www.ibm.com/software/tivoli/library/http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgihttp://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgihttp://www.ibm.com/software/tivoli/order-lit/http://www.ibm.com/software/sysmgmt/products/support/http://techsupport.services.ibm.com/guides/handbook.html
-
The
guide
provides
information
about
how
to
contact
IBM
Software
Support,
depending
on
the
severity
of
your
problem,
and
the
following
information:
v
Registration
and
eligibility
v
Telephone
numbers,
depending
on
the
country
in
which
you
are
located
v
Information
you
must
have
before
contacting
IBM
Software
Support
Conventions
Used
in
This
Guide
This
guide
uses
several
conventions
for
special
terms
and
actions,
and
operating
system-dependent
commands
and
paths.
Typeface
Conventions
This
guide
uses
the
following
typeface
conventions:
Bold
v
Lowercase
commands
and
mixed
case
commands
that
are
otherwise
difficult
to
distinguish
from
surrounding
text
v
Interface
controls
(check
boxes,
push
buttons,
radio
buttons,
spin
buttons,
fields,
folders,
icons,
list
boxes,
items
inside
list
boxes,
multicolumn
lists,
containers,
menu
choices,
menu
names,
tabs,
property
sheets),
labels
(such
as
Tip:,
and
Operating
system
considerations:)
v
Keywords
and
parameters
in
text
Italic
v
Words
defined
in
text
v
Emphasis
of
words
(words
as
words)
v
New
terms
in
text
(except
in
a
definition
list)
v
Variables
and
values
you
must
provide
Monospace
v
Examples
and
code
examples
v
File
names,
programming
keywords,
and
other
elements
that
are
difficult
to
distinguish
from
surrounding
text
v
Message
text
and
prompts
addressed
to
the
user
v
Text
that
the
user
must
type
v
Values
for
arguments
or
command
options
Operating
system-dependent
Variables
and
Paths
This
guide
uses
the
UNIX
convention
for
specifying
environment
variables
and
for
directory
notation.
When
using
the
Windows
command
line,
replace
$variable
with
%
variable%
for
environment
variables
and
replace
each
forward
slash
(/)
with
a
backslash
(\)
in
directory
paths.
The
names
of
environment
variables
are
not
always
the
same
in
Windows
and
UNIX.
For
example,
%TEMP%
in
Windows
is
equivalent
to
$tmp
in
UNIX.
Note:
If
you
are
using
the
bash
shell
on
a
Windows
system,
you
can
use
the
UNIX
conventions.
Preface
xvi
IBM
Tivoli
Configuration
Manager:
User’s
Guide
for
Software
Distribution
-
Software
Distribution
Icons
The
following
icons
represent
the
Software
Distribution
profile
resource
displayed
on
the
Tivoli
desktop
in
different
formats:
Icon
for
software
package
profile
icon
in
built
format.
Icon
for
software
package
profile
icon
in
not-built
format.
Icon
for
empty
software
package
profile.
Software
package
profile
resources
are
created
in
the
context
of
a
profile
manager
and
are
distributed
to
subscribing
systems
or
profile
managers
managed
in
the
Tivoli
environment.
Preface
Preface
xvii
-
Preface
xviii
IBM
Tivoli
Configuration
Manager:
User’s
Guide
for
Software
Distribution
-
Part
1.
Preparing
Software
Packages
Chapter
1.
Overview
of
Software
Distribution
.
. 5
What
Is
New
in
This
Version
.
.
.
.
.
.
.
.
. 5
Software
Distribution
Highlights
.
.
.
.
.
.
.
. 6
Software
Package
Preparation
.
.
.
.
.
.
. 6
Support
for
Previous
Product
Releases
.
.
.
.
. 8
Software
Package
Distributions
and
Operations
.
. 8
Multiplexed
Distributions
.
.
.
.
.
.
.
. 10
The
Software
Distribution
Environment
.
.
.
.
. 11
Source
Host
.
.
.
.
.
.
.
.
.
.
.
.
. 12
Distribution
Targets
.
.
.
.
.
.
.
.
.
.
. 12
Software
Packages
.
.
.
.
.
.
.
.
.
.
.
. 12
Object-related
Actions
.
.
.
.
.
.
.
.
.
. 13
System
Actions
.
.
.
.
.
.
.
.
.
.
.
. 13
Program
Actions
.
.
.
.
.
.
.
.
.
.
.
. 14
Nested
Software
Packages
.
.
.
.
.
.
.
. 15
Software
Package
Formats
.
.
.
.
.
.
.
.
. 15
Software
Package
(.sp)
File
.
.
.
.
.
.
.
. 15
Software
Package
Definition
(.spd)
File
.
.
.
. 16
Software
Package
Block
(.spb)
.
.
.
.
.
.
. 16
Software
Package
Object
.
.
.
.
.
.
.
.
. 16
Choosing
a
Software
Package
Format
.
.
.
.
. 16
Tivoli
Desktop
Operations
.
.
.
.
.
.
.
.
. 17
Software
Distribution
Operations
.
.
.
.
.
.
. 17
Chapter
2.
Launching
the
Software
Package
Editor
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 19
Launching
the
Software
Package
Editor
on
Endpoints
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 19
From
the
Desktop
.
.
.
.
.
.
.
.
.
.
. 19
From
the
Command
Line
.
.
.
.
.
.
.
.
. 20
On
Windows
Endpoints
.
.
.
.
.
.
.
. 20
On
OS/2
Endpoints
.
.
.
.
.
.
.
.
. 21
On
UNIX
Endpoints
.
.
.
.
.
.
.
.
. 21
Launching
the
Software
Package
Editor
on
Managed
Nodes
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 21
Determining
the
Type
of
Package
You
Will
Create
23
Embedding
a
Native
Package
into
a
Software
Package
.
.
.
.
.
.
.
.
.
.
.
.
.
. 23
Creating
a
Software
Package
with
AutoPack
.
. 23
Creating
a
Software
Package
using
a
Template
.
. 23
Customizing
a
Sample
Software
Package
.
.
. 23
Creating
a
Software
Package
for
Mixed
Target
Types
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 24
Working
with
an
Existing
Software
Package
.
. 24
Customizing
the
Software
Package
Editor
GUI
.
. 24
Customizing
the
Welcome
Page
.
.
.
.
.
. 25
Creating
a
New
Software
Package
Sample
.
.
. 26
Creating
a
New
Software
Package
Template
.
. 26
Setting
the
Default
Path
.
.
.
.
.
.
.
.
. 27
Chapter
3.
Creating
Packages
Using
the
Software
Package
Editor
.
.
.
.
.
.
.
.
. 29
Creating
a
Software
Package
.
.
.
.
.
.
.
.
. 29
Creating
the
Appsample
Software
Package
.
.
.
. 29
Naming
the
Appsample
Software
Package
.
.
. 31
Checking
Disk
Space
.
.
.
.
.
.
.
.
.
. 32
Adding
Directories
and
Files
.
.
.
.
.
.
. 34
Adding
Windows
Platform
Actions
to
a
Generic
Container
.
.
.
.
.
.
.
.
.
.
.
.
.
. 37
Adding
Windows
Operating
System
Directories
and
Files
.
.
.
.
.
.
.
.
. 38
Adding
Windows
Registry
Objects
.
.
.
. 42
Adding
Windows
Shell
Objects
.
.
.
.
.
. 45
Adding
Windows
Profile
Objects
.
.
.
.
. 47
Adding
Windows
Services
.
.
.
.
.
.
. 49
Adding
OS/2
Platform
Actions
to
a
Generic
Container
.
.
.
.
.
.
.
.
.
.
.
.
.
. 50
Adding
OS/2
Desktop
Objects
.
.
.
.
.
. 50
Adding
OS/2
Profile
Objects
.
.
.
.
.
. 52
Adding
Text
File
Objects
.
.
.
.
.
.
.
. 53
Adding
an
Execute
CID
Program
Action
.
.
. 56
Adding
an
Execute
Program
Action
.
.
.
.
. 57
Adding
a
Restart
Action
.
.
.
.
.
.
.
.
. 59
The
Appsample
Software
Package
.
.
.
.
.
. 60
Changing
the
Order
of
Objects
in
the
Software
Package
.
.
.
.
.
.
.
.
.
.
.
.
. 61
Setting
Properties
on
the
Package
.
.
.
.
.
.
. 61
General
Properties
.
.
.
.
.
.
.
.
.
.
. 62
The
Dependency
Editor
.
.
.
.
.
.
.
. 64
Server
Options
.
.
.
.
.
.
.
.
.
.
.
. 64
Setting
Server
Options
.
.
.
.
.
.
.
.
. 65
Setting
Advanced
Server
Options
.
.
.
.
. 66
Endpoint
Options
.
.
.
.
.
.
.
.
.
.
. 67
Before
Program
Options
.
.
.
.
.
.
.
. 68
After
Program
Options
.
.
.
.
.
.
.
. 69
Log
File
Properties
.
.
.
.
.
.
.
.
.
.
. 70
Description
.
.
.
.
.
.
.
.
.
.
.
.
. 72
Copyright
.
.
.
.
.
.
.
.
.
.
.
.
.
. 72
Variable
List
.
.
.
.
.
.
.
.
.
.
.
.
. 73
Nested
Packages
.
.
.
.
.
.
.
.
.
.
.
. 73
Editing
Software
Package
Properties
.
.
.
.
.
. 74
Program
Actions
in
the
Software
Package
Editor
.
. 75
The
InstallShield
Program
Action
.
.
.
.
.
. 76
The
Microsoft
Setup
Program
Action
.
.
.
.
. 78
Remove
Actions
.
.
.
.
.
.
.
.
.
.
.
.
. 78
Saving
the
Software
Package
.
.
.
.
.
.
.
. 79
Chapter
4.
Creating
a
Software
Package
for
Devices
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 83
Creating
a
Device
Object
Software
Package
.
.
.
. 83
Adding
Directories
to
Devices
.
.
.
.
.
.
. 84
Adding
Files
to
Devices
.
.
.
.
.
.
.
.
. 86
Running
Programs
on
Devices
.
.
.
.
.
.
. 87
Customizing
Device
Settings
.
.
.
.
.
.
.
. 88
Customizing
Nokia
9200
Communicator
Series
Devices
.
.
.
.
.
.
.
.
.
.
.
.
.
. 88
Customizing
Palm
and
Windows
CE
Devices
89
Distributing
the
Device
Object
Software
Package
to
Targets
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 90
Chapter
5.
Using
Software
Distribution
on
OS/400
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 91
©
Copyright
IBM
Corp.
2002,
2003
1
||
||||||||||||||||||||||||||
|
|
|
|
|
|
|
|
-
Defining
Software
Packages
with
OS/400
Objects
.
. 91
The
OS/400
Native
and
Integrated
File
Systems
.
. 92
Using
the
OS/400
Software
Package
Editor
.
.
.
. 93
Launching
the
OS/400
Software
Package
Editor
93
Adding
OS/400
Libraries
and
Objects
.
.
.
. 94
Adding
OS/400
Objects
.
.
.
.
.
.
.
.
. 96
Removing
OS/400
Libraries
.
.
.
.
.
.
.
. 97
Removing
OS/400
Objects
.
.
.
.
.
.
.
. 98
Adding
OS/400
Licensed
Programs
.
.
.
.
. 99
Removing
OS/400
Licensed
Programs
.
.
.
. 100
Changing
an
OS/400
Sysval
.
.
.
.
.
.
. 101
Using
Non-OS/400-Specific
Functions
.
.
.
.
. 102
Adding
Non-Native
Objects
to
the
OS/400
Native
File
System
.
.
.
.
.
.
.
.
.
. 102
Running
an
OS/400
Executable
Program
.
.
. 104
Saving
an
OS/400
Software
Package
.
.
.
.
.
. 106
Chapter
6.
Embedding
Native
Objects
into
a
Software
Package
.
.
.
.
.
.
.
.
.
.
. 107
Using
the
Software
Package
Editor
to
Embed
Native
Objects
.
.
.
.
.
.
.
.
.
.
.
.
. 107
Benefits
of
Embedding
Native
Objects
.
.
.
.
. 108
Creating
a
Software
Package
that
Embeds
a
Native
Object
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 108
Defining
Supported
Software
Distribution
Operations
in
a
Native
Installation
.
.
.
.
. 109
Using
a
Wizard
.
.
.
.
.
.
.
.
.
.
.
.
. 112
Using
the
Install
MSI
Product
Importer
.
.
.
. 113
Using
the
PDF
Importer
.
.
.
.
.
.
.
.
. 116
Using
Dialogs
.
.
.
.