Building an Installation Image

Language:

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

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.

(Optional) View the log file for the build process.
The build output displays the location of log files.