distro_const(1M)

名称

distro_const - 用于创建 Oracle Solaris 映像和介质的实用程序

用法概要

/usr/bin/distro_const -h

/usr/bin/distro_const build [-v] [-r checkpoint_name]
    [-p checkpoint_name] [-l] manifest

描述

distro_const 命令允许用户将指定的清单文件用作映像的蓝图来创建映像。

您可以创建以下任一映像：

• 可以用来在 x86 系统或 SPARC 系统上安装 Oracle Solaris 操作系统的文本安装程序映像。

• 与包含 Oracle Solaris 操作系统的 Live DVD 映像相当的 ISO 映像。

• 可以用来在 SPARC 客户机上进行 Oracle Solaris 操作系统的网络安装的 SPARC AI ISO 映像，或者是可以用来在 x86 客户机上进行 Oracle Solaris 操作系统的网络安装的 x86 AI ISO 映像。

• 定制的 ISO 映像。

不带选项的 distro_const build 命令只需一步即可创建完整的映像。

这些选项允许您在各个检查点处暂停和继续执行映像创建过程，这使得您可以您在每个阶段查看映像的状态并检查错误。检查点在构建期间通过允许您跳过至少已执行过一次的冗繁步骤来节省时间。

使用分发构造器时，在 SPARC 系统上只能创建 SPARC 映像，在 x86 系统上只能创建 x86 映像。此外，您的系统上的操作系统发行版本必须与您构建的映像的发行版本相同。

选项

–h

–-help

显示用法消息。

子命令

distro_const 命令具有以下列出的子命令和选项。另请参见“示例”部分。

build [–v] [–r resume_checkpoint] [–p pause_checkpoint ] [–l] manifest

未指定选项时，将使用指定的清单文件作为该映像的蓝图来创建一个完整映像。

–v

–-verbose

显示详细的输出。

–l

–-list

列出您可以在其上选择暂停或继续构建映像的所有有效检查点。此选项查询 manifest 清单文件来获取有效的检查点。使用此选项提供的名称作为其他检查点选项的有效值。

–p pause_checkpoint

–-pause pause_checkpoint

构建一个映像，并在指定的检查点名称处暂停。使用 –l 选项查找有效的检查点名称。可以将 –p 与 –r 选项结合使用。

–r resume_checkpoint

–-resume resume_checkpoint

从指定的检查点名称继续构建映像。指定的检查点名称必须是之前的构建停止执行的那一刻的检查点，或者是一个更早的检查点。后期的检查点无效。使用 –l 选项来确定哪些检查点是可继续的。可以将 –r 与 –p 选项结合使用。

示例

示例 1 使用检查点选项创建映像。

1. 检查哪些检查点可用。

   # distro_const build -l /usr/share/distro_const/dc_text_x86.xml
   
   Checkpoint           Resumable Description
   -----------          --------- -----------------------
   transfer-ips-install X         Transfer pkg contents from IPS
   set-ips-attributes   X         Set post-install 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 archival
   boot-setup           X         Set up GRUB menu
   pkg-img-mod          X         Pkg image area modification
   create-iso                     ISO media creation
   create-usb                     USB media creation

2. 开始构建映像并在 ba-init 检查点处暂停。

   # distro_const build -p ba-init /usr/share/distro_const/dc_text_x86.xml
   

3. 从 ba-init 检查点重新开始构建。完成映像创建。

   # distro_const build -r ba-init /usr/share/distro_const/dc_text_x86.xml
   

示例 2 一步式创建映像

要运行完整的映像构建而不暂停，请在不指定选项的情况下使用 distro_const 命令。

# distro_const build /usr/share/distro_const/dc_text_x86.xml

属性

有关下列属性的说明，请参见 attributes(5)：

属性类型 属性值 可用性 install/distribution-constructor 接口稳定性 Uncommitted（未确定）

另请参见

dc_manifest(4)

创建定制 Oracle Solaris 11.2 安装映像