| Title and Copyright Information |
| About This Manual |
| Audience |
| New and Changed Features |
| Organization |
| Related Documentation |
| Reader's Comments |
| Conventions |
| 1 | Introducing Product Kits |
| 1.1 | Overview |
| 1.2 | Product Types |
| 1.3 | Kit Formats |
| 1.4 | Kit-Building Process |
| 2 | Creating Kit Directories |
| 2.1 | Obtaining a Unique Product Code |
| 2.2 | Creating a Kit Building Directory Structure |
| 2.3 | Populating the Source Directory |
| 2.3.1 | Using Standard Directory Structures |
| 2.3.2 | Placing Files in the Kit Source Directory |
| 2.3.3 | Setting Up the Sample Product Kit Source Directory |
| 2.3.4 | Using Context-Dependent Symbolic Links |
| 2.3.4.1 | Knowing When to Use CDSLs |
| 2.3.4.2 | Identifying CDSLs |
| 2.3.4.3 | Creating CDSLs |
| 2.3.4.4 | Restrictions |
| 3 | Creating Subsets |
| 3.1 | Grouping Files into Subsets |
| 3.2 | Creating the Master Inventory File |
| 3.3 | Creating the Key File |
| 3.4 | Creating Subset Control Programs |
| 3.4.1 | Creating SCP Source Files |
| 3.4.2 | Setting Up Initial SCP Processing |
| 3.4.2.1 | Including Library Routines |
| 3.4.2.2 | Setting Global Variables |
| 3.4.3 | Working in a Cluster Environment |
| 3.4.4 | Working in a Dataless Environment |
| 3.4.5 | Associating SCP Tasks with setld Utility Phases |
| 3.4.5.1 | Displaying the Subset Menu (M Phase) |
| 3.4.5.2 | Before Loading the Subset (PRE_L Phase) |
| 3.4.5.3 | After Loading the Subset (POST_L Phase) |
| 3.4.5.4 | After Securing the Subset (C INSTALL Phase) |
| 3.4.5.5 | Before Deleting a Subset (C DELETE Phase) |
| 3.4.5.6 | Before Deleting a Subset (PRE_D Phase) |
| 3.4.5.7 | After Deleting a Subset (POST_D Phase) |
| 3.4.5.8 | Verifying the Subset (V Phase) |
| 3.4.6 | Stopping the Installation |
| 3.4.7 | Creating SCPs for Different Product Kit Types |
| 3.4.7.1 | User Product Kit SCPs |
| 3.4.7.2 | Kernel Product Kit SCPs |
| 3.4.7.3 | Hardware Product Kit SCPs |
| 3.5 | Producing Subsets |
| 3.5.1 | Compression Flag File |
| 3.5.2 | Image Data File |
| 3.5.3 | Subset Control Files |
| 3.5.4 | Subset Inventory File |
| 3.6 | Testing Subsets |
| 3.6.1 | Loading All Subsets |
| 3.6.2 | Repeating Subset Load |
| 3.6.3 | Removing All Subsets |
| 3.6.4 | Loading Mandatory Subsets Only |
| 3.6.5 | Testing in a Cluster |
| 3.6.5.1 | Loading the Kit onto a Cluster |
| 3.6.5.2 | Deleting the Kit from a Cluster |
| 3.7 | Updating Inventory After Creating Subsets |
| 4 | Producing User Product Kits |
| 4.1 | Overview |
| 4.2 | Producing Distribution Media |
| 4.2.1 | Editing the /etc/kitcap File |
| 4.2.1.1 | Disk Media Descriptor |
| 4.2.1.2 | Tape Media Descriptor |
| 4.2.2 | Building a User Product Kit on Disk Media |
| 4.2.3 | Building a User Product Kit on Magnetic Tape |
| 4.3 | Testing the Distribution Media |
| 5 | Producing Kernel Product Kits |
| 5.1 | Overview |
| 5.2 | Creating Additional Installation Files |
| 5.2.1 | The files File Fragment |
| 5.2.2 | The sysconfigtab File Fragment |
| 5.2.3 | The Object Module File |
| 5.2.4 | The Source and Header Files |
| 5.2.5 | The Method Files |
| 5.3 | Producing Distribution Media |
| 5.3.1 | Editing the /etc/kitcap File |
| 5.3.1.1 | Disk Media Descriptor |
| 5.3.1.2 | Tape Media Descriptor |
| 5.3.2 | Building a Kernel Product Kit on Disk Media |
| 5.3.3 | Building a Kernel Product Kit on Magnetic Tape |
| 5.4 | Testing the Distribution Media |
| 5.4.1 | Testing a Kernel Product Kit with the setld Utility |
| 5.4.2 | Testing a Kernel Product Kit in a RIS Area |
| 6 | Producing Hardware Product Kits |
| 6.1 | Overview |
| 6.2 | Creating Additional Installation Files |
| 6.2.1 | The files File Fragment |
| 6.2.2 | The sysconfigtab File Fragment |
| 6.2.3 | The Object Module File |
| 6.2.4 | The Source and Header Files |
| 6.2.5 | The Method Files |
| 6.2.6 | The name.kit Files |
| 6.2.7 | The database.nhd File |
| 6.2.8 | The .root File |
| 6.2.9 | The kitname.kk File |
| 6.3 | Producing Distribution Media |
| 6.3.1 | Editing the /etc/kitcap File |
| 6.3.2 | Building a Hardware Product Kit on Disk Media |
| 6.4 | Testing the Distribution Media |
| 6.4.1 | Testing a Hardware Product Kit with the setld Utility |
| 6.4.2 | Testing a Hardware Product Kit on a Running System |
| 6.4.3 | Using the hw_check Utility to Test a Hardware Product Kit |
| 6.4.4 | Testing a Hardware Product Kit in a RIS Area |
| 6.4.5 | Registering a RIS Client and Installing a Hardware Product Kit |
| A | Creating a Consolidated Firmware CD-ROM |
| A.1 | Build Instructions |
| A.1.1 | Prepare for the Build Session |
| A.1.2 | Build the Consolidated Firmware CD-ROM |
| A.2 | Sample Build Session |
| A.2.1 | Preparing for the Build Session |
| A.2.2 | Building the Consolidated Firmware CD-ROM |
| Glossary |
| Examples |
| 2-1 | Creating the Kit-Building Directories |
| 3-1 | Sample ODB Kit Master Inventory File |
| 3-2 | Sample ODB Kit Key File |
| 3-3 | Sample setld Installation Menu |
| 3-4 | Sample Test for Alpha Processor During M Phase |
| 3-5 | Sample Backup of Existing Files During PRE_L Phase |
| 3-6 | Sample Backward Link Creation During POST_L Phase |
| 3-7 | Sample Message Output During C INSTALL Phase |
| 3-8 | Sample C DELETE Phase |
| 3-9 | Sample PRE_D Phase Reversal of POST_L Phase Actions |
| 3-10 | Sample File Restoration During POST_D Phase |
| 3-11 | Sample ODB User Product SCP |
| 3-12 | Sample ODB Kernel Product SCP |
| 3-13 | Sample ODB Hardware Product SCP |
| 3-14 | Sample Image Data File |
| 3-15 | Sample Subset Control File |
| 3-16 | Sample Subset Inventory File |
| 4-1 | Sample Disk Media Descriptor for User Product |
| 4-2 | Sample Tape Media Descriptor |
| 4-3 | Sample gendisk Command |
| 4-4 | Sample gentapes Command |
| 5-1 | Sample Disk Media Descriptor for Kernel Product |
| 5-2 | Sample Tape Media Descriptor |
| 5-3 | Sample gendisk Command |
| 5-4 | Sample gentapes Command |
| 6-1 | Sample Installed name.kit File |
| 6-2 | Sample database.nhd File |
| 6-3 | Sample Disk Media Descriptor |
| 6-4 | Sample Disk Media Descriptor for Multiple Hardware Product Kits |
| Figures |
| 1-1 | Using This Manual |
| 1-2 | Steps in the Kit-Building Process |
| 1-3 | Kit Directory Hierarchies |
| 2-1 | Kit Directory Hierarchies |
| 2-2 | Sample Product Kit Source Directory |
| 3-1 | ODB Kit Subsets and Files |
| 3-2 | Time Lines for setld Utility Phases |
| 3-3 | ODB output Directory |
| 4-1 | User Product Kit File Formats |
| 5-1 | Kernel Product Source Directory |
| 5-2 | Editing the files File Fragment |
| 5-3 | Editing the sysconfigtab File Fragment |
| 5-4 | Kernel Product Kit File Formats |
| 5-5 | Static Configuration of a Driver |
| 6-1 | Hardware Product Source Directory |
| 6-2 | Editing the files File Fragment |
| 6-3 | Editing the sysconfigtab File Fragment |
| 6-4 | Using the Distribution name.kit File During Installation |
| 6-5 | Bootlinking with a Hardware Product Kit |
| Tables |
| 2-1 | File Locations in Kit Directories |
| 3-1 | Master Inventory File |
| 3-2 | Key File Product Attributes |
| 3-3 | Key File Subset Descriptors |
| 3-4 | Available SCP Library Routines |
| 3-5 | Available Library Installation Routines |
| 3-6 | Available Installed Software Database Library Routines |
| 3-7 | STL_ScpInit Global Variables |
| 3-8 | SCP Operations on a Cluster |
| 3-9 | Installation Control Files in the instctrl Directory |
| 3-10 | Image Data File Field Descriptions |
| 3-11 | Subset Control File Field Descriptions |
| 3-12 | Subset Inventory File Field Descriptions |
| Index |