Go to main content

Installing Oracle® Solaris 11.3 Systems

Exit Print View

Updated: April 2019
 
 

Creating an IPS Package for the Script and Service

How to Create and Publish the IPS Package

  1. Create the directory hierarchy.

    In this example, the service manifest is installed into /lib/svc/manifest/site, and the first-boot script is installed into /opt/site.

    $ mkdir -p proto/lib/svc/manifest/site
    $ mkdir -p proto/opt/site
    $ cp first-boot-script-svc-manifest.xml proto/lib/svc/manifest/site
    $ cp first-boot-script.sh proto/opt/site
  2. Create the package manifest.

    Create the following file named first-boot-script.p5m.

    set name=pkg.fmri value=first-boot-script@1.0,5.11-0
    set name=pkg.summary value="AI first-boot script"
    set name=pkg.description value="Script that runs at first boot after AI installation"
    set name=info.classification value=\
        "org.opensolaris.category.2008:System/Administration and Configuration"
    file lib/svc/manifest/site/first-boot-script-svc-manifest.xml \
        path=lib/svc/manifest/site/first-boot-script-svc-manifest.xml owner=root \
        group=sys mode=0444
    dir  path=opt/site owner=root group=sys mode=0755
    file opt/site/first-boot-script.sh path=opt/site/first-boot-script.sh \
        owner=root group=sys mode=0555

    Depending on what your first-boot script does, you might need to specify dependencies. If you modify this manifest, verify the new manifest is correct. You can ignore warnings. See Chapter 2, Packaging Software With IPS in Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.3 for information about how to create a package, including information about the pkgdepend, pkgmogrify, and pkglint commands.

  3. Create the repository for the package.

    This example creates the repository in the local directory, with firstboot as the publisher.


    Note - Create the repository in a directory that is accessible by the AI clients at installation time.
    $ pkgrepo create firstbootrepo
    $ pkgrepo -s firstbootrepo add-publisher firstboot
  4. Publish the package.
    $ pkgsend publish -d ./proto -s ./firstbootrepo first-boot-script.p5m
    pkg://firstboot/first-boot-script@1.0,5.11-0:20140114T022508Z 
    PUBLISHED

    Clients can install the package from the firstbootrepo repository. The firstboot publisher with firstbootrepo origin is defined in the AI manifest as shown in the next section.

  5. Verify that the package is available.

    List the package to verify that the package is available.

    $ pkg list -g ./firstbootrepo first-boot-script
    NAME (PUBLISHER)                 VERSION    IFO
    first-boot-script (firstboot)    1.0-0      ---
  6. (Optional) Test installation of the package.

    The –n option indicates not to install the package.

    # pkg set-publisher -g ./firstbootrepo firstboot
    # pkg publisher
    PUBLISHER  TYPE    STATUS P LOCATION
    solaris    origin  online F http://http://pkg.oracle.com/solaris/release/
    firstboot  origin  online F file:///home/user1/firstboot/firstbootrepo/
    # pkg list -af first-boot-script
    NAME (PUBLISHER)                 VERSION    IFO
    first-boot-script (firstboot)    1.0-0      ---
    # pkg install -nv first-boot-script
               Packages to install:        1
         Estimated space available: 50.68 GB
    Estimated space to be consumed: 64.66 MB
           Create boot environment:       No
    Create backup boot environment:       No
              Rebuild boot archive:       No
    
    Changed packages:
    firstboot
      first-boot-script
        None -> 1.0,5.11-0:20140114T022508Z
    Planning linked: 0/2 done; 1 working: zone:z2
    Linked image 'zone:z2' output:
    |      Estimated space available: 50.68 GB
    | Estimated space to be consumed: 62.07 MB
    |           Rebuild boot archive:       No
    `
    Planning linked: 1/2 done; 1 working: zone:z1
    Linked image 'zone:z1' output:
    |      Estimated space available: 50.67 GB
    | Estimated space to be consumed: 62.07 MB
    |           Rebuild boot archive:       No

Next Steps

See Copying and Creating Package Repositories in Oracle Solaris 11.3 for instructions to make the new repository accessible to client systems through either NFS sharing or HTTP.