Skip Navigation Links | |
Exit Print View | |
Creating a Custom Oracle Solaris 11 Installation Image Oracle Solaris 11 Information Library |
The full syntax for the distro_const command is as follows:
Syntax: distro_const build [-v] [-r checkpoint_name] [-p checkpoint_name] [-l] manifest
Review the following command options.
Table 3-1 distro_const Command Options
|
Note - You must assume the root role to use the distro_const command.
Before You Begin
Download the distribution-constructor package and select manifest for your image. If needed, customize the manifest and add custom scripts.
# distro_const build manifest
Note - The build subcommand is required.
Replace manifest with the name of the manifest file to be used as the blueprint for your image.
For example, type the following command:
# distro_const build /usr/share/distro_const/dc_livecd.xml
The build output displays the location of log files.
You can use the options provided in the distro_const command to stop and restart the build process at various stages in the image-generation process, in order to check and debug your selection of files, packages, and scripts for the image that is being built. This process uses the checkpointing options that are available in the distro_const command as described in the following basic instructions.
# distro_const build -l manifest.xml
Note - The build subcommand is required.
This command displays the valid checkpoints at which you can pause or resume building an image. Use the checkpoint names provided by this command as valid values for the other checkpointing command options.
For example, the following command confirms which checkpoints are available, given a manifest file named dc_livecd.xml.
# distro_const build -l /usr/share/distro_const/dc_livecd.xml
After the command is run, the valid checkpoints are displayed. For example, checkpoints may include the following.
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 Boot archive initialization ba-config Boot archive configuration ba-arch Boot archive archiving grub-setup Set up the GRUB menu pkg-img-mod Package image area modifications create-iso ISO image creation
Note - In this sample command output, an “X” in the resumable field indicates that you can restart the build from this checkpoint.
# distro_const build -p checkpoint_name manifest
Note - The build subcommand and the checkpoint_name, and manifest fields are required.
For example, the following command starts building an image and pauses the build before ba-arch modifies the image area:
# distro_const build -p ba-arch /usr/share/distro_const/dc_livecd.xml
# distro_const build -r checkpoint_name manifest
Note - The specified checkpoint must be either the checkpoint at which the previous build stopped executing, or an earlier checkpoint. A later checkpoint is not valid. The checkpoint_name and manifest fields and the build subcommand are required.
For example, the following command resumes building the image at the ba-arch stage.
# distro_const build -r ba-arch /usr/share/distro_const/dc_livecd.xml
Note - You can combine the pause and resume options in a build command.
The build output displays the location of log files.