'\" te

.\" Copyright (c) 2008, 2012, Oracle and/or its affiliates.All rights reserved.

.TH ai_manifest 4 "2012 年 6 月 26 日" "SunOS 5.11" "文件格式"

.SH 名称

ai_manifest \- 自动化安装清单文件格式

.SH 用法概要

.LP

.nf

/usr/share/install/ai.dtd.1

.fi

.SH 描述

.sp

.LP

自动化安装程序 (Automated Installer, AI) 为 Oracle Solaris 提供可定制的无人参与安装机制，并使用基于 XML 的文件格式作为安装参数的说明。此安装参数文件称为 AI 清单。可以通过各种方式（如磁盘布局和要在系统上安装的软件）定制安装。

.sp

.LP

AI 清单具有以下部分：

.RS +4

.TP

.ie t \(bu

.el o

自动化安装设置。指定在安装期间使用的设置。

.RE

.RS +4

.TP

.ie t \(bu

.el o

磁盘布局。指定安装的磁盘布局。

.RE

.RS +4

.TP

.ie t \(bu

.el o

软件。指定要安装的软件包。

.RE

.RS +4

.TP

.ie t \(bu

.el o

引导配置（仅限 x86）。指定如何配置 GRUB 引导菜单。

.RE

.RS +4

.TP

.ie t \(bu

.el o

其他配置。指定要在系统上安装的其他配置组件。

.RE

.sp

.LP

下面将更详细地介绍这些部分。

.sp

.LP

要创建新的 AI 清单，请使用模板副本或来自相关安装服务映像的缺省清单。例如，如果安装服务映像位于 \fIimagepath\fR，则以下文件可用：

.sp

.ne 2

.mk

.na

\fB\fB\fIimagepath\fR/auto_install/manifest/default.xml\fR\fR

.ad

.sp .6

.RS 4n

此安装服务的原始缺省 AI 清单。

.RE

.sp

.ne 2

.mk

.na

\fB\fB\fIimagepath\fR/auto_install/manifest/ai_manifest.xml\fR\fR

.ad

.sp .6

.RS 4n

包含示例定制的带注释 AI 清单样例。

.RE

.sp

.LP

可以使用 \fBinstalladm export\fR 命令检索安装服务中已存在的任何清单的副本。

.sp

.LP

AI 清单还用于安装非全局区域（使用 \fBzoneadm install\fR 命令）。可以将 AI 清单文件传递给此命令以定制区域安装。在 AI 清单指定的内容中，只有一部分适用于安装非全局区域。下面的各部分中对这些指定内容进行了说明。

.sp

.LP

服务管理工具 (Service Management Facility, SMF) 配置文件对 AI 清单进行了补充。这些配置文件指定已安装系统的系统配置，如主机名、联网以及 root 用户和初始用户的帐户设置。

.sp

.LP

有关安装服务、AI 清单和配置文件的更多信息，请参见 \fBinstalladm\fR(1M) 手册页和Part\ III, \fI"Installing Using an Install Server,"\fR in \fI《Installing Oracle Solaris 11.1 Systems》\fR。有关配置文件格式的信息，请参见 \fBsmf\fR(5)。

.SH 自动化安装设置

.sp

.LP

\fBai_instance\fR 元素具有以下属性：

.sp

.ne 2

.mk

.na

\fB\fBname\fR\fR

.ad

.sp .6

.RS 4n

此清单实例的名称。

.RE

.sp

.ne 2

.mk

.na

\fB\fBhttp_proxy\fR\fR

.ad

.sp .6

.RS 4n

在安装期间用于访问远程文件的 HTTP 代理。例如，映像包管理系统 (Image Packaging System, IPS) 软件包系统信息库中的软件包即是在安装期间访问的远程文件。\fBhttp_proxy\fR 的值是 HTTP URI，如 \fBhttp://myproxy.mycompany.com:8080/\fR。

.sp

在安装非全局区域时此属性不适用；如果提供了此属性，它将被忽略。

.RE

.sp

.ne 2

.mk

.na

\fB\fBauto_reboot\fR\fR

.ad

.sp .6

.RS 4n

指定在安装后是否自动重新引导的标志。\fBauto_reboot\fR 的缺省值为 \fBfalse\fR。当 \fBauto_reboot\fR 为 \fBfalse\fR 时，安装将等待手动干预以重新引导。

.sp

当 \fBauto_reboot\fR 为 \fBtrue\fR 时，如果安装成功，则计算机将自动重新引导到新安装的引导环境。

.sp

在安装非全局区域时此属性不适用；如果提供了此属性，它将被忽略。

.RE

.sp

.LP

以下示例演示如何使用 \fBai_instance\fR 元素：

.sp

.in +2

.nf

<auto_install>

  <ai_instance name='default' auto_reboot='true'

    http_proxy='http://myproxy.mycompany.com:8080/'>

  <!-- target and software sections -->

  </ai_instance>

</auto_install>

.fi

.in -2

.SH 磁盘布局

.sp

.LP

AI 支持各种磁盘指定方式，从完全自动化选择安装目标到对磁盘布局的细粒度控制。

.sp

.LP

\fBtarget\fR 元素指定磁盘布局。未指定 \fBtarget\fR 元素时缺省磁盘布局具有以下特征：

.RS +4

.TP

.ie t \(bu

.el o

一个磁盘全部用于安装 Oracle Solaris OS。此磁盘通常为引导磁盘或第一个磁盘。

.RE

.RS +4

.TP

.ie t \(bu

.el o

对于具有 GPT 感知固件的 x86 和 SPARC，将会分配 GPT 分区，该分区使用所有磁盘内容。请参见 \fBzpool\fR(1M) 手册页中 \fBzpool create\fR 命令的 \fB-B\fR 选项。

.RE

.RS +4

.TP

.ie t \(bu

.el o

对于不支持使用 GPT 的 SPARC 系统，将创建一个分片 0，其大小为整个磁盘。

.RE

.RS +4

.TP

.ie t \(bu

.el o

还会创建一个根池，该根池使用整个分片 0 或整个 GPT 分区。

.RE

.RS +4

.TP

.ie t \(bu

.el o

如果空间可用，则会在根池中创建交换卷和转储卷。

.RE

.sp

.LP

\fBtarget\fR 元素具有以下结构：

.sp

.in +2

.nf

<!-- zero or one target element -->

<target>

  <!-- zero or more disk elements -->

  <disk ...>

    <!-- One of the following elements:

             disk_name

             disk_prop

             disk_keyword

             iscsi

         Zero or more of the following elements:

             gpt_partition

             partition

             slice

         gpt_partition can have zero or one size element.

         partition can have zero or one size element

             followed by zero or more slice elements.

         slice can have zero or one size element.

    -->

  </disk>

  <!-- zero or one logical element -->

  <logical ...>

    <!-- zero or more zpool elements -->

    <zpool ...>

      <!-- zero or more vdev elements -->

      <vdev ...>

      </vdev>

      <!-- zero or more filesystem elements

           with zero or one options element

      -->

      <filesystem>

        <options>

          <option .../>

        </options>

      <!-- zero or more zvol elements

           with zero or one options element

           and one size element

      -->

      <zvol ...>

        <options>

          <option .../>

        </options>

        <size val="..."/>

      </zvol>

      <!-- zero or one pool_options element

           with one or more option elements

      -->

      <pool_options>

        <option .../>

      </pool_options>

      <!-- zero or one dataset_options element

           with one or more option elements

      -->

      <dataset_options>

        <option .../>

      </dataset_options>

      <!-- zero or one be element

           with zero or one options elements

      -->

      <be>

        <options>

          <option .../>

        </options>

      </be>

    </zpool>

  </logical>

</target>

.fi

.in -2

.sp

.LP

通过 \fBtarget\fR 元素的子元素可以指定磁盘和逻辑布局。

.sp

.LP

在安装非全局区域时，磁盘的指定不适用；如果指定了磁盘，它们将被忽略。

.sp

.LP

有些磁盘布局元素具有 size 子元素。\fBsize\fR 元素具有以下格式：

.sp

.in +2

.nf

<size val="\fIsize\fR" start_sector="\fIstart_sector\fR"/>

.fi

.in -2

.sp

.LP

\fIstart_sector\fR 值是一个数值，用于指定新分区或分片的所需开始扇区。如果省略了 \fIstart_sector\fR 属性，则安装程序将搜索第一个足以包含指定 \fIsize\fR 的位置。

.sp

.LP

\fIsize\fR 的值是具有以下后缀之一的数值：

.RS +4

.TP

.ie t \(bu

.el o

\fBs\fR 或 \fBsec\fR：扇区

.RE

.RS +4

.TP

.ie t \(bu

.el o

\fBb\fR：字节

.RE

.RS +4

.TP

.ie t \(bu

.el o

\fBk\fR 或 \fBkb\fR：千字节 (2^10)

.RE

.RS +4

.TP

.ie t \(bu

.el o

\fBm\fR 或 \fBmb\fR：兆字节 (2^20)

.RE

.RS +4

.TP

.ie t \(bu

.el o

\fBg\fR 或 \fBgb\fR：千兆字节 (2^30)

.RE

.RS +4

.TP

.ie t \(bu

.el o

\fBt\fR 或 \fBtb\fR：兆兆字节 (2^40)

.RE

.RS +4

.TP

.ie t \(bu

.el o

\fBp\fR 或 \fBpb\fR：拍字节 (2^50)

.RE

.RS +4

.TP

.ie t \(bu

.el o

\fBe\fR 或 \fBeb\fR：艾字节 (2^60)

.RE

.RS +4

.TP

.ie t \(bu

.el o

\fBz\fR 或 \fBzb\fR：泽字节 (2^70)

.RE

.sp

.LP

此部分的其余内容详细介绍了 \fBdisk\fR 和 \fBlogical\fR 元素。

.SS "安装位置"

.sp

.LP

如果在客户机上未指定安装 Oracle Solaris OS 的位置，则 AI 将选择该客户机的缺省位置。

.sp

.LP

缺省的安装位置是每个客户机上找到的首个符合大小要求的磁盘。如果磁盘大小大于或等于所需的大小，那么安装程序将选择该磁盘作为安装位置。如果磁盘大小小于所需的大小，安装程序将检查下一磁盘。如果没有找到符合大小要求的磁盘，自动化安装在该客户机上将失败。\fB/system/volatile/install_log\fR 中的安装日志显示了该系统的磁盘选择过程的详细信息。

.sp

.LP

\fBtarget\fR 部分的 \fBdisk\fR 部分指定安装位置。

.sp

.LP

在安装非全局区域时，磁盘的指定不适用；如果指定了磁盘，它们将被忽略。

.sp

.LP

可以使用以下类型的选择条件之一来选择磁盘：

.RS +4

.TP

.ie t \(bu

.el o

第 1 组：确定性条件，如磁盘名称或 IP 地址。使用下面“目标设备名称”中所述的 \fB<disk_name>\fR 子元素，或者使用下面“ISCSI 目标设备”中所述的 \fB<iscsi>\fR 子元素。

.RE

.RS +4

.TP

.ie t \(bu

.el o

第 2 组：非确定性条件，如磁盘大小或供应商。使用下面“目标设备属性”中所述的 \fB<disk_prop>\fR 子元素。

.RE

.RS +4

.TP

.ie t \(bu

.el o

第 3 组：关键字条件，如 \fBboot_disk\fR 关键字。使用下面“目标设备关键字”中所述的 \fB<disk_keyword>\fR 子元素。

.RE

.sp

.LP

只能从以上三组之一指定条件。如果使用第 2 组选择条件，则可以指定多个条件。例如，可以同时指定大小和供应商。如果使用第 1 组选择条件，则只能指定那些条件之一。

.SS "目标设备名称"

.sp

.LP

使用 \fBdisk_name\fR 元素可指定非 iSCSI 设备的目标设备名称。\fBdisk_name\fR 元素具有以下属性：

.sp

.ne 2

.mk

.na

\fB\fBname\fR\fR

.ad

.sp .6

.RS 4n

\fBname\fR 属性指定目标设备的名称。

.RE

.sp

.ne 2

.mk

.na

\fB\fBname_type\fR\fR

.ad

.sp .6

.RS 4n

\fBname_type\fR 属性指定目标设备名称的类型。\fBname_type\fR 属性可以具有以下值之一：

.sp

.ne 2

.mk

.na

\fB\fBctd\fR：控制器目标磁盘名称\fR

.ad

.sp .6

.RS 4n

这是 CTD 名称，例如 \fBc0t0d0\fR 或 \fBc0t2000002037CD9F72d0\fR。运行 \fBformat\fR(1M) 命令时，通常会看到此类型的名称。

.sp

.in +2

.nf

<disk_name name="c0t0d0" name_type="ctd"/>

.fi

.in -2

如果省略 \fBname_type\fR 属性，则这是缺省的目标设备名称类型。

.RE

.sp

.ne 2

.mk

.na

\fB\fBvolid\fR：卷标识符\fR

.ad

.sp .6

.RS 4n

这是卷标识符，可以通过 \fBformat \fR(1M) 命令进行设置。

.sp

.in +2

.nf

<disk_name name="MY_BOOT_DISK" name_type="volid"/>

.fi

.in -2

.RE

.sp

.ne 2

.mk

.na

\fB\fBdevpath\fR：设备路径\fR

.ad

.sp .6

.RS 4n

这是相对于 \fB/devices\fR 目录的设备路径。

.sp

.in +2

.nf

<disk_name

  name="/devices/pci@0,0/pci10de,375@f/pci108e,286@0/disk@0,0"

  name_type="devpath"/>

.fi

.in -2

.RE

.sp

.ne 2

.mk

.na

\fB\fBdevid\fR：设备标识符\fR

.ad

.sp .6

.RS 4n

这是设备标识符，可在带有 \fB-iEn\fR 选项的 \fBiostat\fR(1M) 命令的输出的 "Device Id" 中找到。

.sp

.in +2

.nf

<disk_name

  name="id1,sd@TSun_____STK_RAID_INT____F0F0F0"

  name_type="devid"/>

.fi

.in -2

.RE

.sp

.ne 2

.mk

.na

\fB\fBreceptacle\fR：插口标识符\fR

.ad

.sp .6

.RS 4n

这是 CRO（Chassis, Receptacle, Occupant，机箱、插口和插卡）配置中的插口值，可在带 \fB-ocR\fR 选项的 \fBcroinfo\fR(1M) 命令的输出中找到。

.sp

.in +2

.nf

<disk_name name="SYS/1" name_type="receptacle"/>

.fi

.in -2

.RE

.RE

.SS "ISCSI 目标设备"

.sp

.LP

使用 \fBiscsi\fR 元素可将 iSCSI 磁盘指定为安装目标。\fBiscsi\fR 元素具有以下属性：

.sp

.ne 2

.mk

.na

\fB\fBsource\fR\fR

.ad

.sp .6

.RS 4n

\fBsource\fR 属性指定 iSCSI 配置数据的源。\fBsource\fR 属性可以具有以下值：

.sp

.ne 2

.mk

.na

\fB\fBmanifest\fR\fR

.ad

.sp .6

.RS 4n

此值是指此 AI 清单。如果没有为 \fBsource\fR 属性指定值，则这是缺省值。

.sp

省略 \fBsource\fR 属性或者 \fBsource\fR 属性的值为 \fBmanifest\fR 时，必须指定 \fBtarget_lun\fR 和 \fBtarget_ip\fR 属性。

.RE

.sp

.ne 2

.mk

.na

\fB\fBdhcp\fR\fR

.ad

.sp .6

.RS 4n