2573N/A.. CDDL HEADER START
2573N/A
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
2573N/A.. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
2573N/A or http://www.opensolaris.org/os/licensing.
2573N/A See the License for the specific language governing permissions
2573N/A and limitations under the License.
2573N/A
2573N/A.. When distributing Covered Code, include this CDDL HEADER in each
2573N/A file and include the License file at usr/src/OPENSOLARIS.LICENSE.
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
2573N/A.. CDDL HEADER END
2573N/A
2573N/A.. Copyright (c) 2011, Oracle and/or its affiliates. All rights reserved.
2525N/A
2525N/APackaging and Delivering Software with the Image Packaging System
2573N/A=================================================================
2573N/AA developer's guide
2573N/A^^^^^^^^^^^^^^^^^^^
2525N/A
2585N/A.. raw:: pdf
2585N/A
2585N/A Spacer 0 100
2585N/A
2585N/A.. class:: figure
2585N/A
2585N/A |logo|
2585N/A
2585N/A.. raw:: pdf
2585N/A
2585N/A SetPageCounter 0 arabic
2585N/A Spacer 0 450
2585N/A
2585N/A.. class:: titletable
2585N/A
2585N/A +--------------------------+--------------------+
2585N/A | | |
2585N/A | |ologo| | |version| |
2585N/A | | |
2585N/A +--------------------------+--------------------+
2585N/A
2585N/A.. header::
2585N/A
2585N/A .. oddeven::
2585N/A
2585N/A .. class:: headertable
2585N/A
2585N/A +-----------------------------------------------+
2585N/A | .. class:: footerright |
2585N/A | |
2585N/A | ###Section### |
2585N/A | |
2585N/A +-----------------------------------------------+
2585N/A
2585N/A
2585N/A .. class:: headertable
2585N/A
2585N/A +-----------------------------------------------+
2585N/A | .. class:: footerleft |
2585N/A | |
2585N/A | ###Section### |
2585N/A | |
2585N/A +-----------------------------------------------+
2585N/A
2585N/A
2585N/A.. footer::
2585N/A
2585N/A .. oddeven::
2585N/A
2585N/A .. class:: footertableright
2585N/A
2585N/A +------------------------------------------------------+
2585N/A | .. class:: pageright |
2585N/A | |
2585N/A | ###Page### |
2585N/A +------------------------------------------------------+
2585N/A
2585N/A .. class:: footertableleft
2585N/A
2585N/A +---------------------+--------------------------------+
2585N/A | .. class:: pageleft | .. class:: footerleft |
2585N/A | | |
2585N/A | ###Page### | ###Title### |
2585N/A +---------------------+--------------------------------+
2585N/A
2585N/A
2585N/A.. raw:: pdf
2585N/A
2585N/A PageBreak oneColumn
2585N/A
2585N/A::
2585N/A
2585N/A Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
2585N/A This document is provided for information purposes only and the
2585N/A contents hereof are subject to change without notice. This document is
2585N/A not warranted to be error-free, nor subject to any other warranties or
2585N/A conditions, whether expressed orally or implied in law, including
2585N/A implied warranties and conditions of merchantability or fitness for a
2585N/A particular purpose. We specifically disclaim any liability with
2585N/A respect to this document and no contractual obligations are formed
2585N/A either directly or indirectly by this document. This document may not
2585N/A be reproduced or transmitted in any form or by any means, electronic
2585N/A or mechanical, for any purpose, without our prior written permission.
2585N/A Oracle and Java are registered trademarks of Oracle and/or its
2585N/A affiliates. Other names may be trademarks of their respective owners.
2585N/A
2585N/A Intel and Intel Xeon are trademarks or registered trademarks of Intel
2585N/A Corporation. All SPARC trademarks are used under license and are
2585N/A trademarks or registered trademarks of SPARC International, Inc. AMD,
2585N/A Opteron, the AMD logo, and the AMD Opteron logo are trademarks or
2585N/A registered trademarks of Advanced Micro Devices. UNIX is a registered
2585N/A trademark licensed through X/Open Company, Ltd. 0611
2585N/A
2525N/APreface
2525N/A-------
2525N/A
2585N/A In Oracle Solaris 11 and onwards, system software is packaged with
2585N/A the Image Packaging System, or IPS. IPS takes care of
2585N/A installing new software and upgrading that software.
2525N/A
2585N/A This manual is for developers and advanced administrators who want
2585N/A to better understand IPS, how to use it to package their own
2585N/A software, and want to understand how Oracle Solaris is packaged with
2585N/A IPS.
2585N/A
2585N/A Special attention is given to the underlying design
2585N/A concepts and design patterns so that readers can more readily
2585N/A understand and utilize the more advanced features of IPS.
2525N/A
2573N/AHow this book is organized
2573N/A--------------------------
2525N/A
2585N/A **Chapter 1** - *Design Goals and Concepts*, outlines the basic
2585N/A design philosophy of IPS and its expression as software
2585N/A patterns.
2525N/A
2585N/A **Chapter 2** - *Package Lifecycle*, provides an overview of the
2525N/A software package lifecycle with IPS.
2525N/A
2585N/A **Chapter 3** - *Basic Terminology*, lays out the basic terminology
2585N/A and describes the various components that form IPS.
2525N/A
2585N/A **Chapter 4** - *Packaging Software with IPS*, gets
2585N/A the new user started constructing their own packages.
2525N/A
2585N/A **Chapter 5** - *Installing, Removing, and Updating Software Packages*,
2585N/A shows basic operation of pkg(1).
2525N/A
2585N/A **Chapter 6** - *Specifying Dependencies*, explains the different types
2585N/A of IPS dependencies and how they can be used to construct working
2585N/A software systems.
2525N/A
2585N/A **Chapter 7** - *Allowing Variations*, explains how variants, facets
2585N/A and mediated links are used to allow software publishers to
2585N/A define multiple installation forms for their packages.
2525N/A
2585N/A **Chapter 8** - *Modifying Package Manifests Programmatically*, explains
2585N/A how package manifests can be machine edited to permit the automated
2585N/A annotation and checking of package manifests.
2525N/A
2585N/A **Chapter 9** - *Causing System Change With SMF*, explains how to
2585N/A use the Service Management Facility to automatically handle
2585N/A any necessary system changes that should occur as a result of
2585N/A package installation.
2525N/A
2585N/A **Chapter 10**, *Advanced Update*, deals with more complex package
2585N/A upgrade issues, and describes several features in IPS designed
2585N/A to simplify these problems.
2525N/A
2585N/A **Chapter 11**, *Signing Packages*, explains how package signing works
2585N/A and how developers and QA organizations can sign either new
2585N/A or existing, already signed packages.
2525N/A
2585N/A **Chapter 12**, *Handling Non-Global Zones*, describes how IPS handles
2585N/A zones and discusses those cases where package developers should be
2585N/A aware of zones.
2525N/A
2585N/A **Chapter 13**, *How IPS Features Are Used When Packaging the Oracle
2585N/A Solaris OS*, describes how the packages for the operating system are
2585N/A constructed and how the various dependency types in IPS are used to
2585N/A define working package sets.
2525N/A
2585N/A **Chapter 14**, *Republishing Packages*, describes how administrators
2585N/A can modify existing packages if needed for local conditions.
2525N/A
2585N/A **Appendix A**: *Classifying Packages*, contains info.classification
2585N/A scheme definitions.
2525N/A
2585N/A **Appendix B**: *Converting SVR4 packages to IPS*, gives an example of
2585N/A converting an SVR4 package to IPS, and highlights some areas that might
2573N/A need special attention.
2573N/A