2573N/A.. The contents of this file are subject to the terms of the
2573N/A Common Development and Distribution License (the "License").
2573N/A You may not use this file except in compliance with the License.
2573N/A See the License for the specific language governing permissions
2573N/A and limitations under the License.
2573N/A.. When distributing Covered Code, include this CDDL HEADER in each
2573N/A If applicable, add the following below this CDDL HEADER, with the
2573N/A fields enclosed by brackets "[]" replaced with your own identifying
2573N/A information: Portions Copyright [yyyy] [name of copyright owner]
2573N/A.. Copyright (c) 2011, Oracle
and/or its affiliates. All rights reserved.
2525N/APackaging and Delivering Software with the Image Packaging System
2573N/A=================================================================
2525N/A In Solaris 11 and onwards, system software is packaged with
2525N/A the Image Packaging System, or IPS. IPS takes care of
2525N/A installing new software and upgrading that software. This
2525N/A manual is for engineers and advanced administrators who wish
2525N/A to better understand IPS, how to use it to package their own
2573N/A software, and wish to understand how Solaris is packaged with
2525N/A IPS. Special attention is given to the underlying design
2525N/A concepts and design patterns so that readers can more readily
2525N/A understand and utilize the more advanced features of IPS.
2573N/A **Chapter 1** - IPS Design Goals & Patterns, outlines the basic
2573N/A design philosophy of IPS and its expression as software
2573N/A **Chapter 2** - Package lifecycle, provides an overview of the
2525N/A software package lifecycle with IPS.
2573N/A **Chapter 3** - IPS Core Concepts, lays out the basic terminology
2525N/A and describes the various components that form IPS.
2573N/A **Chapter 4** - Creating simple packages with IPS, gets
2525N/A the new user started constructing their own packages.
2573N/A **Chapter 5** - Basic operation of pkg(1).
2573N/A **Chapter 6** - Dependencies, explains the different types of IPS
2525N/A dependencies and how they can be used to construct working
2573N/A **Chapter 7** - Handling variations, explains how variants, facets
2525N/A and mediated links are used to allow software publisher to
2525N/A define multiple installation forms for their packages.
2573N/A **Chapter 8** - Transmogrifications, explains how package manifests
2525N/A can be machine edited to permit the automated annotation and
2525N/A checking of package manifests.
2573N/A **Chapter 9** - Using SMF to generate side effects, explains how to
2525N/A use the Service Management Framework to automatically handle
2525N/A any necessary side effects of package installation.
2573N/A **Chapter 10**, Advanced Upgrade, deals with more complex package
2525N/A upgrade issues, and describe several features in IPS designed
2525N/A to simplify these problems.
2573N/A **Chapter 11**, Package Signing, explains how package signing works
2525N/A and how developers and QA organizations can sign either new
2525N/A or existing, already signed packages.
2573N/A **Chapter 12**, Dealing with Zones, describes how IPS handles zones
2525N/A and discusses those cases where package developers should be
2573N/A **Chapter 13**, Solaris and IPS, describes how Oracle use IPS to
2525N/A package Solaris, and how the various dependency types are used
2525N/A to define working package sets for Solaris.
2573N/A **Chapter 14**, Package Republication, describes how administrators
2525N/A can modify existing packages if needed for local conditions.
2573N/A **Appendix 2**: Converting SVR4 packages to IPS, gives an example of
2573N/A converting an SVR4 package to IPS, and highlights some areas that may