Go to main content

Creating a Custom Oracle® Solaris 11.4 Image

Exit Print View

Updated: November 2020

Building an Installation Image

You can build an image with or without using checkpoints. With checkpoints, the build process is completed in stages. This section describes the two ways you can build an image.

How to Build an Image

  1. Perform one of the following steps:
    • To build the image without checkpoints, issue the following command:
      $ distro_const build manifest.xml

      If necessary, include the path when specifying the manifest.

    • To build the image in stages:
      1. Display the checkpoints defined in the manifest.

        For example:

        $ distro_const build -l manifest.xml
        Checkpoint            Resumable Description
        --------------        --------- -------------
        transfer-ips-install          X Transfer package contents from IPS
        set-ips-attributes            X Set post-installation IPS attributes
        pre-pkg-img-mod               X Pre-package image modification
        ba-init                       X Boot archive initialization
        ba-config                     X Boot archive configuration
        ba-arch                       X Boot archive archiving
        pkg-img-mod                     Package image area modifications
        create-iso                      ISO image creation
        create-usb                      USB image creation

        In this sample command output, an X in the resumable field indicates that you can restart the build from this checkpoint.

      2. Build the image while pausing at the specified checkpoint.

        The following command starts building an image and pauses the build before ba-arch modifies the image area:

        $ distro_const build -p ba-arch manifest.xml
      3. Resume building the image from a specified checkpoint.

        You can only resume from the checkpoint at which the build process stopped or from an earlier checkpoint. You cannot skip to resume the build at a later checkpoint.

        The following command resumes building the image at the ba-arch stage.

        $ distro_const build -r ba-arch manifest.xml

        Note -  You can combine the pause and resume options in a build command.
  2. (Optional) View the log file for the build process.

    The build output displays the location of log files.