| 跳过导航链接 | |
| 退出打印视图 | |
|
安装 Oracle Solaris 11.1 系统 Oracle Solaris 11.1 Information Library (简体中文) |
| 跳过导航链接 | |
| 退出打印视图 | |
|
|
安装 Oracle Solaris 11.1 系统 Oracle Solaris 11.1 Information Library (简体中文) |
在安装客户机之前创建定制 AI 清单的一种替代方法是编写一个脚本，在安装客户机时为每个客户机动态创建 AI 清单。该脚本可以查询环境变量和其他客户机配置信息，以便为每个客户机创建定制 AI 清单。由于该清单基于安装时搜索到的各个客户机的属性，因此称为派生清单。
当大量系统可按几乎完全相同的方式进行安装，从而使这些系统的 AI 清单之间的差异相对较小时，派生清单尤为有用。创建一个指定本组系统通用的安装参数的 AI 清单。使用该通用清单作为基础，在安装每个客户机时，创建一个派生清单脚本，将因客户机而异的参数添加到通用清单中。例如，派生清单脚本可以检测连接到各个客户机系统的磁盘的数目和大小，并且可以在客户机安装时修改 AI 清单，以指定每个客户机的定制磁盘布局。
确定用作要修改的基础清单的现有 AI 清单。
要开发和测试脚本，可以使用本地副本。在安装时，使用该派生清单脚本的每个客户机必须都可以访问该基础清单。
编写一个脚本，在安装时根据要安装的客户机的属性动态修改基础清单。
将派生的清单脚本添加到相应的 AI 安装服务，并指定条件以定义应当在安装时使用该脚本创建其安装指令的客户机。如果您不希望指定客户机选择条件，可以添加此脚本作为服务的缺省 AI 清单。
AI 在客户机安装时执行该脚本，以生成 AI 清单实例。AI 会从语法上验证生成的清单。
注 - 如果未创建清单或派生的清单未进行验证，则客户机安装将中止。要查明验证失败的原因，请参见客户机上的 /system/volatile/install_log。
如果客户机安装成功，则派生的清单会复制到客户机上的 /var/log/install/derived/manifest.xml 中，且用于派生清单的脚本将复制到 /var/log/install/derived/manifest_script 中。
通常，派生的清单脚本会从客户机检索信息，并且利用该信息修改基础 AI 清单，以便只为该客户机创建定制 AI 清单。派生的清单脚本还可以组合多个部分 AI 清单。最终的派生清单必须是通过验证的完整清单。
派生的清单脚本可以是该映像中支持的任何类型的脚本。例如，缺省情况下，映像中包括 ksh93 和 python。如果要使用其他类型的脚本，请确保映像中具有所需的支持。
派生的清单脚本可以运行命令来读取系统属性。AI 以 aiuser 角色运行该脚本。aiuser 角色具有非特权用户具有的所有特权以及以下附加特权：
solaris.network.autoconf.read solaris.smf.read.*
aiuser 角色是非特权用户，只不过相比于其他非特权用户，它可以从系统中读取更多信息。aiuser 角色无法更改系统。
有关角色、配置文件和特权的信息，请参见《Oracle Solaris 11.1 管理：安全服务》中的第 III 部分, "角色、权限配置文件和特权"。
除使用命令读取系统属性之外，也可通过下表中显示的环境变量获取客户机属性。
表 10-1 客户机属性环境变量
|
要在 AI 清单中添加或修改 XML 元素，请使用 /usr/bin/aimanifest 命令。
要通过 aimanifest 修改的文件至少必须包含以下片段：
对某个 DTD 的 !DOCTYPE 引用，该引用对于所开发的 XML 清单应该有效。
该 DTD 的根元素。
以下示例显示了 AI 清单的最小基础清单文件，其中包括为要添加该派生清单脚本的安装服务指定 AI DTD 文件的操作：
<!DOCTYPE auto_install SYSTEM "file:///imagepath/auto_install/ai.dtd.#"> <auto_install/>
# 是一个整数，例如 1。imagepath 参数的值是以下命令返回的路径，其中 svcname 是将添加该派生清单脚本的安装服务的名称：
$ installadm list -n svcname
在执行派生清单脚本中的任何其他 aimanifest 调用之前，请使用 aimanifest 命令的 load 子命令装入基础清单。在安装客户机时，客户机必须可以访问装入的任何文件。例如，可以从目标安装服务中的 imagepath/auto_install/manifest/ 装入清单。
本章中的示例装入文件 /usr/share/auto_install/manifest/default.xml。/usr/share/auto_install/manifest/ 中的清单样例可能与目标安装服务中的清单有所不同。在生产工作中，不应从 /usr/share/auto_install/manifest/ 装入清单。
load 子命令还可用于装入或插入部分清单。
使用 add 子命令添加新元素。使用 set 子命令添加元素属性，或者更改元素或属性值。有关详细信息，请参见 aimanifest(1M) 手册页。手册页和下面的示例脚本提供了使用 aimanifest 命令的示例。
注 - 如果 aimanifest 命令中指定的某个值包含以下字符之一，则必须将该值括在单引号或双引号中，以防止将该字符解释为 XML 路径名称的一部分：
/'"@[]=
根据所用 Shell 的规则，可能需要通过在前面加一个反斜杠 (\) 对引号进行转义，这样 Shell 就不会删除或解释引号。
以下示例返回包含软件包名称 pkg:/entire 的 software_data 元素的操作。在本示例中，pkg:/entire 周围需要使用引号，因为正斜杠是一个特殊字符。如果在 Shell 脚本（如 ksh93 脚本）中调用该命令，则需要使用反斜杠来转义引号。
/usr/bin/aimanifest get software_data[name=\"pkg:/entire\"]@action
提示 - 最佳做法是设置陷阱，以便在遇到错误时停止。
以下部分脚本是一个很好的派生清单脚本模型：
#!/bin/ksh93
SCRIPT_SUCCESS=0
SCRIPT_FAILURE=1
function handler
{
exit $SCRIPT_FAILURE
}
trap handler ERR
/usr/bin/aimanifest load baseAImanifest.xml
# Customize AI manifest. For example:
/usr/bin/aimanifest load -i manifest_fragment.xml
/usr/bin/aimanifest set origin@name file:///net/myserver/myrepo/repo.redist
exit $SCRIPT_SUCCESS
本节介绍如何编写派生清单脚本以确定客户机属性，并使用该信息定制 AI 清单。这些示例并不一定包括生成有效 AI 清单所需的全部信息。
要尝试使用这些示例，请执行以下设置步骤：
将 AIM_MANIFEST 环境变量设置为脚本将开发 AI 清单的位置。
针对修改 $AIM_MANIFEST 文件的每个 aimanifest 命令，重新写入该文件。每次在带有 load、add 或 set 子命令的情况下调用 aimanifest 时，都会打开、修改和保存 AIM_MANIFEST 文件。如果未设置 AIM_MANIFEST，aimanifest 命令将失败。
将 AIM_LOGFILE 环境变量设置为脚本可以写入详细信息和错误消息的位置。
aimanifest 命令将子命令名称、参数值以及每个 aimanifest 调用的返回状态记录到屏幕和 $AIM_MANIFEST_LOG 文件（如果设置）。
确保 aimanifest 命令在运行脚本的系统上可用。如果 aimanifest 命令不可用，请安装 auto-install-common 软件包。
设置环境变量。这些示例说明了如何使用环境变量来检索客户机相关信息。要尝试使用这些示例，必须为这些环境变量设置值。
使用 AI 安装系统时，表 10-1 中显示的环境变量具有值，并且可供派生清单脚本使用。
示例 10-1 根据磁盘大小指定磁盘分区
本示例对 AI 清单进行了定制，以便在磁盘大小超过 1 TB 时，仅将目标磁盘的一半用于 Oracle Solaris fdisk 分区。尝试将 SI_DISKSIZE_1 设置为小于 1 TB，然后在该脚本的不同运行中设置为大于 1 TB。此外，需先设置 SI_NUMDISKS 和 SI_DISKNAME_1，然后运行脚本。请注意，该脚本仅用于 x86 客户机，因为指定的分区仅适用于 x86 客户机。
#!/bin/ksh93
SCRIPT_SUCCESS=0
SCRIPT_FAILURE=1
function handler
{
exit $SCRIPT_FAILURE
}
trap handler ERR
/usr/bin/aimanifest load /usr/share/auto_install/manifest/default.xml
# Check that there is only one disk on the system.
if [[ $SI_NUMDISKS -gt "1" ]] ; then
print -u2 "System has too many disks for this script."
exit $SCRIPT_FAILURE
fi
/usr/bin/aimanifest add \
/auto_install/ai_instance/target/disk/disk_name@name $SI_DISKNAME_1
if [[ $SI_DISKSIZE_1 -gt "1048576" ]] ; then
typeset -i PARTN_SIZE=$SI_DISKSIZE_1/2
# Default action is to create.
/usr/bin/aimanifest add \
/auto_install/ai_instance/target/disk[disk_name@name=\"$SI_DISKNAME_1\"]/partition@name 1
/usr/bin/aimanifest add \
/auto_install/ai_instance/target/disk/partition[@name=1]/size@val \
${PARTN_SIZE}mb
else
/usr/bin/aimanifest add \
/auto_install/ai_instance/target/disk[disk_name@name=\"$SI_DISKNAME_1\"]/partition@action \
use_existing_solaris2
fi
exit $SCRIPT_SUCCESS
对于 SI_DISKSIZE_1 的值小于或等于 1048576 的客户机，会将以下元素添加到 $AIM_MANIFEST：
<target>
<disk>
<disk_name name="/dev/dsk/c0t0d0s0"/>
<partition action="use_existing_solaris2"/>
</disk>
<!-- <logical> section -->
</target>
对于 SI_DISKSIZE_1 的值大于 1048576 的客户机，会将类似如下的元素添加到 $AIM_MANIFEST，具体取决于 SI_DISKSIZE_1 的值：
<target>
<disk>
<disk_name name="/dev/dsk/c0t0d0s0"/>
<partition name="1">
<size val="524288mb"/>
</partition>
</disk>
<!-- <logical> section -->
</target>
该命令指定了 disk_name 来添加分区，以避免为分区创建单独的磁盘指定。本示例中的脚本指定该分区位于 $SI_DISKNAME_1 磁盘，而非其他磁盘。如果本示例中的相应行替换为以下行，将无法获得预期的结果：
/usr/bin/aimanifest add \
/auto_install/ai_instance/target/disk/partition@name 1
/usr/bin/aimanifest add \
/auto_install/ai_instance/target/disk/partition[@name=1]/size@val \
${PARTN_SIZE}mb
else
/usr/bin/aimanifest add \
/auto_install/ai_instance/target/disk/partition@action \
use_existing_solaris2
该脚本将向您提供以下错误输出，而不是上面显示的输出：
<target>
<disk>
<disk_name name="c0t0d0s0"/>
</disk>
<disk>
<partition name="1">
<size val="524288mb"/>
</partition>
</disk>
</target>示例 10-2 根据附加磁盘的存在情况指定根池布局
本示例对 AI 清单进行了定制，以便在存在第二个磁盘时配置根池的镜像，并在存在第三个磁盘时配置三重镜像。先设置 SI_NUMDISKS 和 SI_DISKNAME_1，然后运行脚本。根据需要设置 SI_DISKNAME_2、SI_DISKNAME_3 以及其他任何变量，具体取决于为 SI_NUMDISKS 设置的值。在 AI 安装期间，将设置这些环境变量并将其用于派生清单脚本。
本示例说明了如何使用 aimanifest 返回路径（-r 选项）。有关返回路径的更多信息，请参见 aimanifest(1M) 手册页。
#!/bin/ksh93
SCRIPT_SUCCESS=0
SCRIPT_FAILURE=1
function handler
{
exit $SCRIPT_FAILURE
}
trap handler ERR
/usr/bin/aimanifest load /usr/share/auto_install/manifest/default.xml
# Use the default if there is only one disk.
if [[ $SI_NUMDISKS -ge 2 ]] ; then
typeset -i disk_num
# Turn on mirroring. Assumes a root zpool is already set up.
vdev=$(/usr/bin/aimanifest add -r \
target/logical/zpool[@name=rpool]/vdev@name mirror_vdev)
/usr/bin/aimanifest set ${vdev}@redundancy mirror
for ((disk_num = 1; disk_num <= $SI_NUMDISKS; disk_num++)) ; do
eval curr_disk="$"SI_DISKNAME_${disk_num}
disk=$(/usr/bin/aimanifest add -r target/disk@in_vdev mirror_vdev)
/usr/bin/aimanifest set ${disk}@in_zpool rpool
/usr/bin/aimanifest set ${disk}@whole_disk true
disk_name=$(/usr/bin/aimanifest add -r \
${disk}/disk_name@name $curr_disk)
/usr/bin/aimanifest set ${disk_name}@name_type ctd
done
fi
exit $SCRIPT_SUCCESS
对于具有名为 c0t0d0 和 c0t1d0 的两个磁盘的系统，本示例会输出以下 XML 元素：
<target>
<disk in_vdev="mirror_vdev" in_zpool="rpool" whole_disk="true">
<disk_name name="c0t0d0" name_type="ctd"/>
</disk>
<disk in_vdev="mirror_vdev" in_zpool="rpool" whole_disk="true">
<disk_name name="c0t1d0" name_type="ctd"/>
</disk>
<logical>
<zpool name="rpool" is_root="true">
<vdev name="mirror_vdev" redundancy="mirror"/>
<filesystem name="export" mountpoint="/export"/>
<filesystem name="export/home"/>
<be name="solaris"/>
</zpool>
</logical>
</target>示例 10-3 在至少存在两个指定大小的磁盘时指定镜像配置
本示例对 AI 清单进行了定制，以便在系统至少有两个 200 GB 的磁盘时指定镜像配置。使用发现的前两个至少为 200 GB 的磁盘。先在测试环境中设置 SI_NUMDISKS、SI_DISKNAME_1 和 SI_DISKSIZE_1，然后运行脚本。此外，根据需要设置 SI_DISKNAME_2、SI_DISKSIZE_2 以及其他任何变量，具体取决于为 SI_NUMDISKS 设置的值。在 AI 安装期间，将设置这些环境变量并将其用于派生清单脚本。
本示例说明了如何在存在多个具有相同路径的节点时修改节点。Shell 实现使用 aimanifest 的返回路径 (-r) 选项将路径返回到特定节点，然后使用该路径对同一节点做出其他修改。Python 实现说明了如何使用子路径（使用节点路径中的 []）对同一节点进行其他修改。
#!/bin/ksh93
SCRIPT_SUCCESS=0
SCRIPT_FAILURE=1
function handler
{
exit $SCRIPT_FAILURE
}
trap handler ERR
# Find the disks first.
typeset found_1
typeset found_2
typeset -i disk_num
for ((disk_num = 1; disk_num <= $SI_NUMDISKS; disk_num++)) ; do
eval curr_disk="$"SI_DISKNAME_${disk_num}
eval curr_disk_size="$"SI_DISKSIZE_${disk_num}
if [[ $curr_disk_size -ge "204800" ]] ; then
if [ -z $found_1 ] ; then
found_1=$curr_disk
else
found_2=$curr_disk
break
fi
fi
done
# Now, install them into the manifest.
# Let the installer take the default action if two large disks are not found.
/usr/bin/aimanifest load /usr/share/auto_install/manifest/default.xml
if [[ -n $found_2 ]] ; then
# Turn on mirroring.
vdev=$(/usr/bin/aimanifest add -r \
/auto_install/ai_instance/target/logical/zpool/vdev@redundancy mirror)
/usr/bin/aimanifest set ${vdev}@name mirror_vdev
disk=$(/usr/bin/aimanifest add -r \
/auto_install/ai_instance/target/disk@in_vdev mirror_vdev)
disk_name=$(/usr/bin/aimanifest add -r ${disk}/disk_name@name $found_1)
/usr/bin/aimanifest set ${disk_name}@name_type ctd
disk=$(/usr/bin/aimanifest add -r \
/auto_install/ai_instance/target/disk@in_vdev mirror_vdev)
disk_name=$(/usr/bin/aimanifest add -r ${disk}/disk_name@name $found_2)
/usr/bin/aimanifest set ${disk_name}@name_type ctd
fi
exit $SCRIPT_SUCCESS
以下脚本是前面 Korn shell 版本的 Python 版本。
#!/usr/bin/python2.6
import os
import sys
from subprocess import check_call, CalledProcessError
SCRIPT_SUCCESS = 0
SCRIPT_FAILURE = 1
def main():
# Find the disks first.
found_1 = ""
found_2 = ""
si_numdisks = int(os.environ["SI_NUMDISKS"])
for disk_num in range(1, si_numdisks + 1):
curr_disk_var = "SI_DISKNAME_" + str(disk_num)
curr_disk = os.environ[curr_disk_var]
curr_disk_size_var = "SI_DISKSIZE_" + str(disk_num)
curr_disk_size = os.environ[curr_disk_size_var]
if curr_disk_size >= "204800":
if not len(found_1):
found_1 = curr_disk
else:
found_2 = curr_disk
break
# Now, write the disk specifications into the manifest.
# Let the installer take the default action if two large disks are not found.
try:
check_call(["/usr/bin/aimanifest", "load",
"/usr/share/auto_install/manifest/default.xml"])
except CalledProcessError as err:
sys.exit(err.returncode)
if len(found_2):
try:
check_call(["/usr/bin/aimanifest", "add",
"target/logical/zpool[@name=rpool]/vdev@redundancy", "mirror"])
check_call(["/usr/bin/aimanifest", "set",
"target/logical/zpool/vdev[@redundancy='mirror']@name", "mirror_vdev"])
check_call(["/usr/bin/aimanifest", "add",
"target/disk/disk_name@name", found_1])
check_call(["/usr/bin/aimanifest", "set",
"target/disk/disk_name[@name='" + found_1 + "']" + "@name_type", "ctd"])
check_call(["/usr/bin/aimanifest", "set",
"target/disk[disk_name@name='" + found_1 + "']" + "@in_vdev", "mirror_vdev"])
check_call(["/usr/bin/aimanifest", "add",
"target/disk/disk_name@name", found_2])
check_call(["/usr/bin/aimanifest", "set",
"target/disk/disk_name[@name='" + found_2 + "']" + "@name_type", "ctd"])
check_call(["/usr/bin/aimanifest", "set",
"target/disk[disk_name@name='" + found_2 + "']" + "@in_vdev", "mirror_vdev"])
except CalledProcessError as err:
sys.exit(err.returncode)
sys.exit(SCRIPT_SUCCESS)
if __name__ == "__main__":
main()示例 10-4 根据 IP 地址指定要安装的软件包
本示例对 AI 清单进行了定制，以便在客户机 IP 地址位于指定范围中时安装一个软件包，以及在客户机 IP 地址在其他范围中时安装不同的软件包。先在测试环境中设置 SI_HOSTADDRESS，然后运行脚本。在 AI 安装期间，将设置该环境变量并将其用于派生清单脚本。
#!/bin/ksh93
SCRIPT_SUCCESS=0
SCRIPT_FAILURE=1
function handler
{
exit $SCRIPT_FAILURE
}
trap handler ERR
/usr/bin/aimanifest load /usr/share/auto_install/manifest/default.xml
# First determine which range the host IP address of the client is in.
echo $SI_HOSTADDRESS | sed 's/\./ /g' | read a b c d
# Assume all systems are on the same class A and B subnets.
# If the system is on class C subnet = 100, then install the /pkg100 package.
# If the system is on class C subnet = 101, then install the /pkg101 package.
# Otherwise, do not install any other additional package.
if ((c == 100)) ; then
/usr/bin/aimanifest add \
software/software_data[@action='install']/name pkg:/pkg100
fi
if ((c == 101)) ; then
/usr/bin/aimanifest add \
software/software_data[@action='install']/name pkg:/pkg101
fi
exit $SCRIPT_SUCCESS示例 10-5 指定目标磁盘必须至少为特定大小
本示例对 AI 清单进行了定制，以便只在至少为 50 GB 的磁盘上进行安装。忽略更小的磁盘。先在测试环境中设置 SI_NUMDISKS、SI_DISKNAME_1 和 SI_DISKSIZE_1，然后运行脚本。此外，根据需要设置 SI_DISKNAME_2、SI_DISKSIZE_2 以及其他任何变量，具体取决于为 SI_NUMDISKS 设置的值。在 AI 安装期间，将设置这些环境变量并将其用于派生清单脚本。
#!/bin/ksh93
SCRIPT_SUCCESS=0
SCRIPT_FAILURE=1
function handler
{
exit $SCRIPT_FAILURE
}
trap handler ERR
/usr/bin/aimanifest load /usr/share/auto_install/manifest/default.xml
typeset found
typeset -i disk_num
for ((disk_num = 1; disk_num <= $SI_NUMDISKS; disk_num++)) ; do
eval curr_disk="$"SI_DISKNAME_${disk_num}
eval curr_disk_size="$"SI_DISKSIZE_${disk_num}
if [[ $curr_disk_size -ge "512000" ]] ; then
found=$curr_disk
/usr/bin/aimanifest add \
/auto_install/ai_instance/target/disk/disk_name@name $found
break
fi
done
if [[ -z $found ]] ; then
exit $SCRIPT_FAILURE
fi
exit $SCRIPT_SUCCESS示例 10-6 清单规范错误的脚本
本示例中的脚本有错误。
#!/bin/ksh93
SCRIPT_SUCCESS=0
SCRIPT_FAILURE=1
function handler
{
exit $SCRIPT_FAILURE
}
trap handler ERR
/usr/bin/aimanifest load /usr/share/auto_install/manifest/default.xml
/usr/bin/aimanifest set \
software[@type="IPS"]/software_data/name pkg:/driver/pcmcia
/usr/bin/aimanifest set \
software/software_data[@name=pkg:/driver/pcmcia]@action uninstall
return $SCRIPT_SUCCESS
本示例在写入 $AIM_MANIFEST 时存在三个问题。
aimanifest 的 set 子命令可以更改现有元素或属性的值，或创建新属性。set 子命令无法创建新元素。第一个 set 子命令尝试修改清单中的现有软件包名称，而不是创建新的软件包名称。如果清单中已存在多个软件包名称，则会造成多义性错误，因为无法确定要修改哪个软件包。本示例中的第一个 set 子命令本应是 add 子命令。
在本示例的第二个 set 子命令中，以前置的 @ 符号指定值为 pkg:/driver/pcmcia 的元素 name。尽管属性值使用前置的 @ 符号指定，但这对元素值并不适用。
值 pkg:/driver/pcmcia 应括在引号中。带斜杠或其他特殊字符的值必须用引号括起来。
在本示例中，以下行应替换两个 set 行：
/usr/bin/aimanifest add \
software[@type="IPS"]/software_data@action uninstall
/usr/bin/aimanifest add \
software/software_data[@action=uninstall]/name pkg:/driver/pcmcia
以上两个 add 子命令将以下行添加到正在编写的清单的 software 部分的末尾：
<software_data action="uninstall"> <name>pkg:/driver/pcmcia</name> </software_data>
要测试派生清单脚本，请在类似于 AI 安装环境的环境中运行此脚本。
为要修改的脚本设置基础 AI 清单。
确保脚本中的第一个 aimanifest 命令是 aimanifest load 命令。确保装入的文件中包含 <!DOCTYPE> 定义，该定义指定了对目标安装服务进行 AI 清单验证时使用的相应 DTD。以下示例显示了 AI 清单的最小基础清单文件，其中包括为要添加该派生清单脚本的安装服务指定 AI DTD 文件的操作：
<!DOCTYPE auto_install SYSTEM "file:///imagepath/auto_install/ai.dtd.#"> <auto_install/>
# 是一个整数，例如 1。imagepath 参数的值是以下命令返回的路径，其中 svcname 是将添加该派生清单脚本的安装服务的名称：
$ installadm list -n svcname
将 AIM_MANIFEST 设置为脚本将开发 AI 清单的位置。该位置必须可由非特权用户 aiuser 写入。
注 - 在 AI 执行安装时，无需设置 AIM_MANIFEST。AI 设置了一个缺省值。
将 AIM_LOGFILE 设置为脚本可以写入详细信息和错误消息的位置。该位置必须可由非特权用户 aiuser 写入。
注 - 在 AI 执行安装时，无需设置 AIM_LOGFILE。该日志信息是更大的安装日志 /system/volatile/install_log 的一部分。
确保 aimanifest 命令在测试脚本的系统上可用。如果 aimanifest 命令不可用，请安装 auto-install-common 软件包。
确保您可以承担 root 角色。通过 root 角色，您可以在不指定口令的情况下承担 aiuser 角色。
$ su Password: # su aiuser -c ./script #
AI 以 aiuser 角色执行派生清单脚本。要模拟 AI 安装环境，请承担 aiuser 角色以运行脚本。如果以具有与 aiuser 角色不同的特权的用户身份运行脚本，则脚本中的某些操作可能会得到不同的结果。
在测试环境中为环境变量设置值，这些值表示将使用该派生清单脚本安装的客户机系统。样例文件 /usr/share/auto_install/derived_manifest_test_env.sh 可用作模板。根据需要更改值。
在 AI 执行安装时，表 10-1 中显示的环境变量具有值，并且可供派生清单脚本使用。
预定的客户机系统可能与可在其中测试派生清单脚本的安装服务器或其他系统大为不同。在脚本中调用的命令可能不可用，或是具有不同行为的不同版本。系统可能是不同的体系结构，或具有不同数目和大小的磁盘。按照所述在测试环境中设置环境变量，可处理其中的一些不同之处。
此过程介绍如何在其中一个预定客户机系统中测试派生清单脚本。
以“文本安装程序和命令行”模式，在该客户机系统中引导 AI 映像。
使用 wget 或 sftp 从 AI 安装服务器复制脚本。
使用以下方法之一调试脚本：
使用以下命令在测试模式中运行 AI：
$ auto-install -m script -i
检查 AI 日志文件 /system/volatile/install_log。日志文件应包含以下行以指示脚本验证：
Derived Manifest Module: XML validation completed successfully
如果进行了更改，请将脚本复制回安装服务器。
以将 XML 清单添加到安装服务的相同方式将脚本添加到 AI 安装服务。使用相同选项指定条件，选择哪些客户机将使用该脚本为其安装创建清单。可以像更新 XML 清单那样更新脚本。可将脚本设置为服务的缺省清单。列出与服务关联的清单时会显示脚本。可以像导出 XML 清单那样导出脚本内容。
将 XML 清单添加到安装服务时，该清单已经过验证。将脚本添加到安装服务时，该脚本未经过验证。
先验证派生的 AI 清单，然后再将脚本添加到安装服务。
在类似于预定客户机系统的环境中运行脚本。
对生成的清单使用 validate 子命令。
$ /usr/bin/aimanifest validate
仅当验证失败时才显示消息。
将脚本添加到适当的 AI 安装服务，指定用于定义哪些客户机应使用这些安装指令的条件。如果您不希望指定客户机选择条件，则可以使用 -d 选项添加此脚本以作为服务的缺省 AI 清单。
$ pfexec installadm create-manifest -n solaris11_1-i386 -f ./mac1.ksh -m mac1 \ -c mac=BB:AA:AA:AA:AA:AA
可以指定多个 -c 选项或一个 -C 文件。另请参见 set-criteria 子命令。有关指定客户机条件的信息，请参见第 9 章。
有关 installadm、list、export、create-manifest、set-criteria、update-manifest 和 set-service 子命令的信息，请参见维护安装服务器。
|