JavaScript is required to for searching.
跳过导航链接
退出打印视图
Oracle Solaris 11 安装手册页     Oracle Solaris 11 Information Library (简体中文)
search filter icon
search icon

文档信息

前言

系统管理命令

aimanifest(1M)

distro_const(1M)

installadm(1M)

js2ai(1M)

文件格式

installadm

- 管理网络上的自动化安装

用法概要

/usr/bin/installadm [-h|--help]
installadm help [subcommand]
installadm create-service
    [-n|--service svcname]
    [-t|--aliasof existing_service]
    [-p|--publisher prefix=origin]
    [-a|--arch architecture]
    [-s|--source FMRI_or_ISO]
    [-b|--boot-args boot_property=value,...]
    [-i|--ip-start dhcp_ip_start]
    [-c|--ip-count count_of_ipaddr]
    [-B|--bootfile-server server_ipaddr]
    [-d|--imagepath imagepath]
    [-y|--noprompt]
installadm set-service
    -o|--option prop=value svcname
installadm rename-service svcname newsvcname
installadm enable svcname
installadm disable svcname
installadm delete-service
    [-r|--autoremove] [-y|--noprompt] svcname
installadm list
    [-n|--service svcname]
    [-c|--client] [-m|--manifest] [-p|--profile]
installadm create-manifest -n|--service svcname
    -f|--file manifest_or_script_filename
    [-m|--manifest manifest_name]
    [-c|--criteria criteria=value|list|range... |
    -C|--criteria-file criteriafile]
    [-d|--default]
installadm update-manifest -n|--service svcname
    -f|--file manifest_or_script_filename
    [-m|--manifest manifest_name]
installadm delete-manifest
    -m|--manifest manifest_name
    -n|--service svcname
installadm create-profile -n|--service svcname
    -f|--file profile_filename... 
    [-p|--profile profile_name]
    [-c|--criteria criteria=value|list|range... |
    -C|--criteria-file criteriafile]
installadm delete-profile -p|--profile profile_name...
    -n|--service svcname
installadm export -n|--service svcname
    -m|--manifest manifest_name...
    -p|--profile profile_name...
    [-o|--output pathname]
installadm validate -n|--service svcname
    -P|--profile-file profile_filename... |
    -p|--profile profile_name...
installadm set-criteria
    -m|--manifest manifest_name
    -p|--profile profile_name...
    -n|--service svcname
    -c|--criteria criteria=value|list|range... |
    -C|--criteria-file criteriafile |
    -a|--append-criteria criteria=value|list|range...
installadm create-client
    [-b|--boot-args property=value,...]
    -e|--macaddr macaddr -n|--service svcname
installadm delete-client macaddr

描述

自动化安装程序 (Automated Installer, AI) 用于通过网络在一个或多个 SPARC 和 x86 系统上自动完成 Oracle Solaris OS 的安装。

通过网络利用 AI 所需的计算机拓扑需要包含一台安装服务器、一台 DHCP 服务器(这可以是与安装服务器相同的系统),以及安装客户机。在安装服务器上,安装服务设置为包含 AI 引导映像(为客户机提供该映像以便它们通过网络引导)、输入规范(AI 清单和派生的清单脚本,将为客户机选择其中一项)和服务管理工具 (Service Management Facility, SMF) 配置文件(将为客户机选择其中的零项或多项)。

AI 引导映像的内容作为软件包 install-image/solaris-auto-install 发布,并通过 create-service 子命令安装。create-service 子命令还能够接受和解压缩 AI ISO 文件以创建 AI 引导映像。

安装服务是使用缺省 AI 清单创建的,但是可以使用 create-manifest 子命令将定制的清单或派生的清单脚本(以下称“脚本”)添加到安装服务。有关如何创建清单和派生的清单脚本的信息,请参见《安装 Oracle Solaris 11 系统》create-manifest 子命令还允许指定条件,这些条件用于确定应该为安装客户机选择哪个清单或脚本。可以使用 set-criteria 子命令修改已经与清单或脚本关联的条件。

清单可以包括诸如目标设备、分区信息、软件包列表和其他参数之类的信息。脚本包含的命令用于查询正在运行的 AI 客户机系统并基于它找到的信息构建定制清单。使用脚本调用 AI 时,AI 的第一项任务是运行该脚本以生成清单。

在客户机引导时,将启动与客户机的计算机条件匹配的清单或脚本搜索。在找到匹配的清单或脚本时,将根据匹配清单文件中的规范或派生自匹配脚本的清单文件中的规范,在客户机上安装 Oracle Solaris 发行版。每个客户机只能使用一个清单或脚本。

每个服务都有一个缺省清单或脚本。其他清单或脚本的条件与所安装的系统不匹配时,会使用缺省清单或脚本。可以将任何清单或脚本指定为缺省清单或脚本。与缺省清单或脚本关联的任何条件将变为非活动,且在选择清单或脚本期间不予考虑。如果稍后将其他清单或脚本设为缺省清单或脚本,则之前的缺省清单或脚本的条件重新变为活动。没有与其关联的条件的清单或脚本只能用作缺省清单或脚本。将其他清单或脚本指定为缺省清单或脚本时,没有条件的清单或脚本将变为非活动。

系统配置文件是对清单和脚本的补充,因为它们也包含安装规范。特别是,使用配置文件指定配置信息,如用户名、用户口令、时区、主机名和 IP 地址。配置文件可以包含变量,用于从安装服务器环境或从 create-profile 子命令中指定的条件获取配置参数。这样,单个配置文件可以在不同的客户机上设置不同的配置参数。请参见“示例”部分。

系统配置文件由 smf(5) 处理且符合文档格式 service_bundle(4)。有关系统配置文件的更多信息,请参见 sysconfig(1M) 和《安装 Oracle Solaris 11 系统》。每个客户机可以使用任意数目的系统配置文件。不能为每个客户机系统多次指定某个特定的 SMF 属性。

如果希望特定的客户机使用某个特定的安装服务,可以使用 create-client 子命令将该客户机与该服务关联。也可以使用 create-client 修改现有的客户机。

installadm 实用程序可以用于完成以下任务:

安装服务器配置属性

svc:/system/install/server:default SMF 服务的以下三个属性可用于配置安装服务器。

all_services/networks

要允许或禁用的网络的列表,采用 CIDR 格式(例如 192.168.56.0/24),允许还是禁用具体取决于 all_services/exclude_networks 属性的设置。

使用该网络列表可指定此安装服务器为哪些客户机提供服务。缺省情况下,AI 安装服务器配置为向该服务器连接的所有网络上的安装客户机提供服务(如果该服务器为多宿主服务器)。

all_services/exclude_networks

布尔值。如果为 true,则从此安装服务器提供服务的网络中排除由 all_services/networks 属性指定的网络。如果为 false,将包括由 all_services/networks 属性指定的网络。

all_services/port

指定托管 AI 安装服务 Web 服务器的端口。缺省情况下,在端口 5555 上托管 Web 服务器。

如果要使用与缺省值不同的端口号,则在创建任何安装服务之前定制 port 属性。

选项

installadm 命令具有以下选项:

-h--help

显示用法帮助消息。

子命令

installadm 命令具有下面列出的子命令。另请参见下面的“示例”部分。

help [subcommand]

显示 installadm 实用程序的语法。

subcommand

仅显示指定子命令的语法。

create-service [-n|--service svcname] [-t|--aliasof existing_service] [-p|--publisher prefix=origin] [-a|- -archarchitecture] [-s|- -sourceFMRI_or_ISO] [-b|- -boot-argsboot_property=value,...][-i|--ip-startdhcp_ip_start] [-c|--ip-countcount_of_ipaddr] [-B|--bootfile-serverserver_ipaddr] [-d|--imagepathimagepath] [-y|--noprompt]

该子命令在指定的 imagepath 目录中设置网络引导映像(网络映像),并创建一个安装服务,用于指定如何安装从网络映像引导的客户机。

AI 引导映像内容作为软件包 install-image/solaris-auto-install 发布。如果未指定 -s 选项,则从系统发布者首选项列表中第一个提供该软件包实例的发布者安装该软件包。-s 选项接受 pkg 规范作为映像 ISO 文件的完整 FMRI 或位置。生成的网络映像最终位于 imagepath 中。该网络映像将用于客户机安装。

请注意以下规范:

  • 在安装服务器上创建给定体系结构的第一个安装服务时,会自动创建该服务的别名 default-i386default-sparc。此缺省服务用于具有该体系结构、且未通过 create-client 子命令显式添加到安装服务器的客户机的所有安装。要更改 default-arch 服务用作别名的服务,请使用 set-service 子命令。

    如果将 default-arch 别名更改为新的安装服务且找到了本地 ISC DHCP 配置,则此缺省别名引导文件将设置为该体系结构的缺省 DHCP 服务器范围的引导文件。

  • 如果希望客户机使用与该体系结构的缺省安装服务不同的安装服务,则必须使用 create-client 子命令创建特定于客户机的配置。

  • 如果使用了 -i 选项和 -c 选项,且尚未配置 DHCP 服务器,则会配置 ISC DHCP 服务器。

    如果已配置 ISC DHCP 服务器,将更新该 DHCP 服务器。

    即使提供了 -i-c 参数且配置了 DHCP,在所创建的安装服务和 IP 范围之间也不会存在绑定。传递 -i-c 时,会设置 IP 范围,根据需要创建新的 DHCP 服务器,并且该 DHCP 服务器将保持打开状态并为要使用的所有安装服务和所有客户机运行。为 DHCP 服务器提供的网络信息与所创建的服务没有特定的关系。

  • 如果请求的 IP 范围不在安装服务器与之具有直接连接的子网上且安装服务器是多宿主的,则 -B 选项将用于提供引导文件服务器的地址(通常为此系统上的 IP 地址)。仅当在安装服务器上配置了多个 IP 地址且使用了 DHCP 中继时,才需要使用该选项。在其他所有配置中,软件可以自动确定此情况。

-n|--service svcname

可选:使用此安装服务名称而不是系统生成的服务名称。svcname 可以包含字母数字字符、下划线 (_) 和连字符 (-)。svcname 的第一个字符不得为连字符。

如果未指定 -n 选项,则自动生成服务名称。

-t|--aliasof existing_service

可选:此新服务是 existing_service 的替代名称。

-a|--arch architecture

可选:选择特定的变体体系结构。合法值为 i386sparc。如果未指定,则选择与服务器的体系结构相对应的变体。

仅当 -s 参数是 pkg(5) 软件包时,-a 选项才适用。

-p|--publisher prefix=origin

可选:pkg(5) 发布者,格式为 prefix=origin(从其安装客户机映像)。

如果未指定 -p 选项,则使用系统的发布者首选项列表中第一个提供该软件包实例的发布者。

-s|--source FMRI_or_ISO

可选:指定网络映像的数据源。它可以是以下任一项:

  • pkg(5) 软件包的完整 FMRI。

  • AI ISO 映像的路径。

如果未指定 -s,则使用的 install-image/solaris-auto-install 软件包来自以下任一项:

  • 使用 -p 参数指定的发布者。

  • 系统的发布者首选项列表中第一个提供该软件包实例的发布者。

-b|--boot-args boot_property=value,...

可选:仅用于 x86 客户机。在服务映像中特定于服务的 menu.lst 文件中设置属性值。使用此选项可设置特定于此服务的引导属性。此选项可以接受多个逗号分隔的 boot_property=value 对。

-i|--ip-start dhcp_ip_start

可选:指定要添加到本地 DHCP 配置的范围中的起始 IP 地址。IP 地址的数量由 -c 选项提供。如果本地 ISC DHCP 配置不存在,则启动 ISC DHCP 服务器。

-c|--ip-count count_of_ipaddr

可选:设置 DHCP 配置中的 IP 地址总数(等于 count_of_ipaddr 的值)。第一个 IP 地址是 -i 选项提供的 dhcp_ip_start 的值。

-B|--bootfile-server server_ipaddr

可选:用于提供客户机应该从其请求引导文件的引导服务器的 IP 地址。仅当通过其他方法无法确定此 IP 地址时才是必需的。

-d|--imagepath imagepath

可选:指定创建网络映像的路径。如果未指定,则使用缺省位置 /export/auto_install/ svcname。除非还指定了 -y,否则将显示确认提示。

-y|--noprompt

可选:禁止任何确认提示,并使用提供的选项和任何缺省值继续进行服务创建(请参见 -d)。

set-service -o|--option prop=value svcname
-o|--option prop=value

指定要设置的属性和值。

prop=value 可以是:

  • aliasof=existing_service

    使 svcname 成为 existing_service 的别名。

  • default-manifest=manifest_name

    将已向给定服务注册的特定清单或脚本指定为该服务的缺省清单或脚本。使用以下命令可显示向此服务注册的清单和脚本的列表。

    $ installadm list -n svcname -m
svcname

必需:指定要设置其属性的安装服务名称。

rename-service svcname newsvcname

将安装服务 svcname 重命名为 newsvcnamenewsvcname 可以包含字母数字字符、下划线 (_) 和连字符 (-)。newsvcname 的第一个字符不得为连字符。

enable svcname

启用 svcname 安装服务。

disable svcname

禁用 svcname 安装服务。

delete-service [-r|--autoremove ] [-y|--noprompt] svcname

删除安装服务。完成以下操作:

  • 删除此安装服务的清单、配置文件、客户机配置文件和 Web 服务器配置。

  • 删除用于实例化服务的映像。

  • 如果服务为缺省别名且存在本地 ISC DHCP 配置,则从 ISC DHCP 配置中删除与此服务关联的引导文件。

-r|--autoremove

如果已指定,则分配给此服务的任何客户机和作为此服务的别名的任何服务也将被删除。

-y|--noprompt

禁止任何确认提示并继续进行服务删除。

svcname

必需:指定要删除的安装服务名称。

list [-n|--service svcname] [-c|--client] [-m|- -manifest] [-p|--profile]

列出服务器上已启用的所有安装服务。

-n|--service svcname

可选:列出有关本地服务器上特定安装服务的信息。

  • 如果指定了 -c 选项,则列出与安装服务关联的客户机信息。

  • 如果指定了 -m 选项,则列出与安装服务关联的清单和脚本。

  • 如果指定了 -p 选项,则列出与安装服务关联的配置文件。

-c|--client

可选:列出本地服务器上安装服务的客户机。

-m|--manifest

可选:列出本地服务器上与安装服务关联的清单和脚本。

如果未指定 -n,则显示每个服务的简化列表。这包括缺省清单和脚本以及具有与之关联的条件的所有非缺省清单和脚本。不列出条件。

如果指定了 -n,则使用包括每个清单的条件的更完整列表格式,显示给定服务的所有清单和脚本。没有关联的条件且未指定为缺省清单的非活动清单会进行相应的标记。与缺省清单关联的条件被标记为非活动。

-p|--profile

可选:列出本地服务器上与安装服务关联的配置文件。

如果未指定 -n,则显示每个服务的简写列表,其中包括配置文件名称。

如果指定了 -n,则显示所请求的服务的配置文件及其条件。

create-manifest -n|--service svcname-f|--filemanifest_or_script_filename [-m|--manifestmanifest_name ] [-c|--criteriacriteria =value|list| range...| -C|--criteria-file criteriafile] [-d|--default]

为特定的服务创建清单或脚本,从而使该清单或脚本在网络上可用,该操作独立于创建服务。非缺省清单或脚本在没有关联的条件时才可以使用(可以处于活动状态)。可以在命令行上输入条件 (-c),也可以通过条件 XML 文件输入条件 (-C)。在清单或脚本不再指定为缺省值之前,暂时忽略指定的任何条件以及 -d 选项。

按以下顺序确定清单的名称:

  1. -m 选项指定的 manifest_name(如果存在)。

  2. ai_instancename 属性的值(如果在清单中存在)。

  3. 清单或脚本文件名的基名。

-n|--service svcname

必需:指定此清单或脚本要与之关联的安装服务名称。

-f|--file manifest_or_script_filename

必需:指定要添加的清单或脚本的路径名称。

-m|--manifest manifest_name

可选:指定清单或脚本的 AI 实例名称。将清单的 ai_instance 元素的 name 属性设置为 manifest_name。在后续的 installadm 命令和 installadm list 输出中,清单或脚本由 manifest_name 引用。

-c|--criteria criteria=value|list| range...

可选:指定要与添加的清单或脚本关联的条件。请参见下面的“条件”部分。发布缺省清单时,会注册条件,但在清单或脚本不再指定为缺省清单或脚本之前使其保持非活动状态。可以多次指定 -c 选项。

-C|--criteria-file criteriafile

可选:指定包含要与添加的清单或脚本关联的条件的条件 XML 文件的路径名称。发布缺省清单或脚本时,会注册条件,但在清单或脚本不再指定为缺省清单或脚本之前使其保持非活动状态。

-d|--default

可选:指定此清单或脚本是服务的新缺省清单或脚本。在清单或脚本不再是缺省值之前,将忽略指定的任何条件。

update-manifest -n|--service svcname -f|--file manifest_or_script_filename [-m|--manifest manifest_name ]

更新与特定的安装服务关联的特定清单或脚本。在对清单或脚本进行更新时,任何条件或缺省状态都保持不变。

按以下顺序确定清单的名称:

  1. -m 选项指定的 manifest_name(如果存在)。

  2. ai_instancename 属性的值(如果在更改后的清单中存在,且它与现有清单的 ai_instancename 值匹配)。

  3. 清单或脚本文件名的基名(如果它与现有清单中的 ai_instancename 属性值匹配)或由 installadm list 提供的名称(如果它与现有脚本的名称匹配)。

供替换的清单或脚本由 manifest_or_script_filename 提供。

-n|--service svcname

必需:指定此清单或脚本要与之关联的安装服务名称。

-f|--file manifest_or_script_filename

必需:指定供替换的清单或脚本的路径名称。

-m|--manifest manifest_name

可选:指定供替换的清单或脚本的 AI 实例名称。

delete-manifest -m|--manifest manifest_name -n|--service svcname

删除通过特定的安装服务发布的清单或脚本。不能删除缺省清单或脚本。

-m|--manifest manifest_name

必需:使用 -n 选项将清单或脚本的 AI 实例名称指定为 installadm list 的输出。

-n|--service svcname

必需:指定此清单与之关联的安装服务名称。

create-profile -n|--service svcname-f|--fileprofile_filename ...[-p|--profileprofile_name ] [-c|--criteriacriteria =value|list| range...| -C|--criteria-file criteriafile]

为特定的安装服务创建配置文件。通过在命令行 (-c) 上或者通过条件 XML 文件 (-C) 输入条件,可以根据需要使这些条件与配置文件关联。在没有条件的情况下创建的配置文件与服务的所有客户机关联。

按以下顺序确定配置文件的名称:

  1. -p 选项指定的 profile_name(如果存在)。

  2. 配置文件名称的基名。

配置文件名称对于 AI 服务必须是唯一的。如果使用了多个 -f 选项来创建具有相同条件的多个配置文件,则 -p 选项无效,且配置文件的名称派生自其文件名。

-n|--service svcname

必需:指定要更新的配置文件的安装服务名称。

-f|--file profile_filename...

必需:指定添加配置文件所使用的文件的路径名称。可以指定多个配置文件。

-p|--profile profile_name

可选:指定要创建的配置文件的名称。仅对单个配置文件的创建有效。

-c|--criteria criteria=value|list| range...

可选:指定要与配置文件关联的条件。请参见下面的“条件”部分。可以指定多个 -c 选项。

-C|--criteria-file criteriafile

可选:指定条件 XML 文件的路径名称,该文件包含与指定配置文件相关联的条件。

delete-profile -p|--profile profile_name... -n|--service svcname

svcname 安装服务中删除 profile_name 配置文件。

-p|--profile profile_name...

必需:指定要删除的配置文件的名称。可以指定多个 -p 选项。

-n|--service svcname

必需:指定要删除的配置文件的安装服务名称。

export -n|--service svcname -m|--manifest manifest_name... -p|--profile profile_name... [-o|--output pathname]

显示(导出)属于服务的指定清单/脚本和/或配置文件。必须至少指定一个清单/脚本或配置文件。除非 -o 选项重定向到文件或目录,否则显示转到 stdout

-n|--service svcname

必需:指定与要导出的清单或配置文件关联的安装服务。

-m|--manifest manifest_name...

指定要导出的清单或脚本的 AI 实例名称。可以指定多个 -m 选项:

-p|--profile profile_name...

指定要导出的配置文件的名称。可以指定多个 -p 选项。

-o|--output pathname

可选:重定向输出。如果请求多个清单、脚本和/或配置文件,则 pathname 必须是目录。如果仅请求一个清单、脚本或配置文件,则 pathname 可以是文件。

validate -n|--service svcname-P|--profile-file profile_filename...| -p|--profile profile_name...

验证指定的配置文件。validate 子命令可以用于验证数据库中的配置文件 (-p),或者对正在开发、尚未进入数据库的配置文件进行验证 (-P)。

-n|--service svcname

必需:指定配置文件与之关联的服务。

-P|--profile-file profile_filename...

指定要验证的外部配置文件。

-p|--profile profile_name...

指定要验证的配置文件的名称。

set-criteria -m|--manifest manifest_name -p|--profile profile_name... -n|--service svcname -c|--criteria criteria=value|list| range... | -C|--criteria-file criteriafile | -a|--append-criteria criteria=value|list| range...

更新已发布的清单/脚本和/或配置文件的条件。可以通过命令行或者通过条件 XML 文件指定条件。必须使用互斥选项 -a-c-C 之一指定条件。

create-manifest 子命令下对有效条件进行了说明。

-m|--manifest manifest_name

指定清单或脚本的 AI 实例名称。

-p|--profile profile_name...

指定配置文件的名称。可以指定任意数目的配置文件。

-n|--service svcname

必需:指定与此清单/脚本或配置文件关联的安装服务名称。

-c|--criteria criteria=value|list| range...

指定用于替换清单/脚本或配置文件的所有现有条件的条件。请参见下面的“条件”部分。

-C|--criteria-file criteriafile

指定一个条件 XML 文件的路径名称,该文件包含用于替换清单/脚本或配置文件的所有现有条件的条件。

-a|--append-criteria criteria=value|list| range...

指定要附加到清单/脚本或配置文件的现有条件的条件。请参见下面的“条件”部分。如果指定的 criteria 已存在,则该条件的 value|list|range 将由指定的 value |list|range 替换。

create-client [-b|--boot-args property=value,...] - e|--macaddr macaddr -n |--service svcname

完成指定客户机的可选设置任务,以便提供与 create-service 子命令使用的缺省设置不同的定制客户机设置。使用户可以指定客户机的非缺省服务名称和引导参数。也可以用于修改现有的客户机。

如果客户机是 x86 系统且存在本地 ISC DHCP 配置,则将在 ISC DHCP 配置中配置客户机。

-b|--boot-args property=value,...

可选:仅用于 x86 客户机。在 /etc/netboot 中特定于客户机的 menu.lst 文件中设置属性值。使用此选项可设置特定于此客户机的引导属性。此选项可以接受多个 property=value 对。

-e|--macaddr macaddr

必需:指定客户机的 MAC 地址。

-n|--service svcname

必需:指定客户机安装的安装服务。

delete-client macaddr

删除现有客户机的具体服务信息,这些信息是以前使用 create-client 子命令设置的。

如果客户机是 x86 系统且存在本地 ISC DHCP 配置,则将在 ISC DHCP 配置中取消配置客户机。

macaddr

必需:指定要删除的客户机的 MAC 地址。

条件

清单、脚本和配置文件可以用于根据某些特征或条件以不同方式配置 AI 客户机。只有一个清单或脚本可以与特定的客户机关联。任意数目的配置文件可以与特定的客户机关联。

条件值由 AI 客户机在启动期间确定。

除非另有说明,否则可以同时为清单/脚本和配置文件指定以下 AI 客户机系统条件。

请参见“示例”部分以了解如何在命令行上指定条件。有关创建条件文件的信息,请参见《安装 Oracle Solaris 11 系统》

条件
说明
arch
每个 uname -m 的体系结构。
cpu
每个 uname -p 的 CPU 类
hostname
已指定主机名。只能用于配置文件,而不能用于清单。
ipv4
IP 版本 4 网络地址。
mac
含有冒号 (:) 分隔符的十六进制 MAC 地址。
mem
每个 prtconf(1M) 的内存大小 (MB)。
network
IP 版本 4 网络编号。
platform
每个 uname -i 的平台名称。
zonename
每个 zones(5) 的区域名称。

ipv4macmemnetwork 规范可以表示为由连字符 (-) 分隔的范围值。要指定对范围的一端没有限制,请使用 unbounded

不能指定为范围的任何条件都可以指定为空格分隔值列表。

示例

示例 1 从 ISO 文件设置新的 x86 安装服务

首次设置安装服务器和 x86 安装服务。命令包括起始 IP 地址和 IP 地址的总计数,以便配置 DHCP 服务器。

# installadm create-service -n sol-11-i386-svc \
-s /export/isos/sol-11-i386.iso \
-i 172.0.0.10 -c 10 -d /export/images/soli386

AI ISO 映像位于 /export/isos/sol-11-i386.iso。命令在基于 AI ISO 映像的 /export/images/soli386 处设置网络映像和安装服务。此网络映像将用于客户机安装。

起始 IP 地址 172.0.0.10 和十个 IP 地址将添加到本地 ISC DHCP 配置。如果本地 ISC DHCP 配置不存在,则启动 ISC DHCP 服务器。

由于这是创建的第一个 i386 服务,因此会自动创建 default-i386 服务并将其作为此服务的别名。default-i386 别名是可操作的,通过 PXE 引导的客户机将从 default-i386 服务引导和安装。

示例 2 从 ISO 文件设置新的 SPARC 安装服务

首次设置 SPARC 安装服务。

# installadm create-service -n sol-11-sparc-svc \
-s /export/isos/sol-11-sparc.iso \
-d /export/images/solsparc

AI ISO 映像位于 /export/isos/sol-11-sparc.iso。命令在基于 AI ISO 映像的 /export/images/solsparc 处设置网络映像和安装服务。此网络映像将用于客户机安装。

由于这是创建的第一个 SPARC 服务,因此会自动创建 default-sparc 服务并将其作为此服务的别名。default-sparc 别名是可操作的,SPARC 客户机将从 default-sparc 服务引导和安装。

示例 3 从软件包系统信息库设置 i386 安装服务

# installadm create-service -y -n mysvc

在 i386 安装服务器上,此命令在缺省映像位置 /export/auto_install/mysvc 设置 i386 网络映像和名为 mysvc 的安装服务。-y 选项提供对缺省位置可接受的确认。由于未指定体系结构,因此创建的服务具有与安装服务器相同的体系结构。此命令假定安装服务器的 pkg publisher 列表上的软件包系统信息库包含 install-image/solaris-auto-install 软件包。

要指定在此服务器上创建 SPARC 服务,请使用 -a 选项。

要指定 solaris-auto-install 软件包的源,请使用 -p 选项。例如,使用以下命令可将位于 http://example.company.com:4281ai-image 系统信息库指定为 solaris-auto-install 软件包的源:

# installadm create-service -y -n mysvc \
-p ai-image=http://example.company.com:4281

示例 4 将客户机与安装服务关联

使用以下样例命令可将客户机与特定的安装服务关联。安装服务必须已存在。

# installadm create-client -b "console=ttya" \
-e 0:e0:81:5d:bf:e0 -n my-i386-service

在此示例中,该命令为 MAC 地址为 0:e0:81:5d:bf:e0 的系统创建了一个特定于客户机的设置。此客户机将使用以前设置的、名为 my-i386-service 的安装服务以及该服务的关联网络映像。此命令将在 /etc/netboot 中特定于客户机的 menu.lst 文件中设置引导属性 console=ttya

示例 5 在不修改缺省服务的情况下添加新安装服务

使用以下样例命令可添加名为 my-sparc-service 的新服务、保留现有的服务并使现有的缺省服务保持不变。

# installadm create-service -n my-sparc-service \
-s /export/isos/mysparc.iso \
-d /export/ai/mysparc-image

示例 6 添加新的安装服务并更新缺省服务

使用以下两个样例命令可添加名为 my-sparc-service 的新服务、保留现有的服务并使新服务成为 SPARC 客户机的缺省服务。

# installadm create-service -n my-sparc-service \
-s /export/isos/mysparc.iso \
-d /export/ai/mysparc-image
# installadm set-service \
-o aliasof=my-sparc-service default-sparc

示例 7 将定制的缺省 AI 清单添加到安装服务

使用以下样例命令可将新清单添加到 service_092910 安装服务,并使其成为服务的缺省清单。清单数据在 my_manifest.xml 中。将来的 installadm 命令会将此清单作为 my_manifest 进行引用。

# installadm create-manifest -d -f my_manifest.xml \
-m my_manifest -n service_092910

示例 8 将派生的清单脚本添加到安装服务

使用以下样例命令可将名为 my_script 的派生清单脚本添加到名为 service_092910 的现有安装服务。脚本的添加方式与清单相同。

# installadm create-manifest -f my_script.py \
-m my_script -n service_092910

有关如何创建派生的清单脚本的信息,请参见《安装 Oracle Solaris 11 系统》

示例 9 替换安装服务的缺省 AI 清单

使用以下样例命令可将现有安装服务 service_092910 的缺省清单替换为已作为 my_manifest 添加到服务的定制清单。通过为 create-manifest 子命令指定 -m my_manifest,将此清单添加到了服务。

# installadm set-service -o default-manifest=my_manifest \
service_092910

示例 10 列出安装服务

使用以下样例命令可列出本地服务器上的安装服务。

$ installadm list
Service Name     Alias Of         Status  Arch  Image Path 
------------     --------         ------  ----  ---------- 
default-i386     sol-11-i386-svc  on      x86   /export/images/soli386
default-sparc    sol-11-sparc-svc on      Sparc /export/images/solsparc
sol-11-i386-svc  -                on      x86   /export/images/soli386
sol-11-sparc-svc -                on      Sparc /export/images/solsparc

示例 11 列出与安装服务关联的客户机

使用以下样例命令可列出本地服务器上特定安装服务的客户机。

$ installadm list -c -n my-x86-service
Service Name   Client Address    Arch  Image Path 
------------   --------------    ----  ---------- 
my-x86-service 01:C2:52:E6:4B:E1 i386  /export/images/myimage

示例 12 列出与安装服务关联的清单

使用以下样例命令可列出与本地服务器上的特定安装服务关联的清单和脚本。

$ installadm list -m -n my-x86-service
Manifest      Status    Criteria 
--------      ------    -------- 
manifest2               arch = i86pc
                        mem  = 4096 MB - unbounded

sparc_setup             arch = sun4v

new_default   Default   (Ignored: mem = 2048 MB - 4095 MB)

orig_default  Inactive  None

此示例显示以下输出:

示例 13 列出配置文件

使用以下样例命令可列出本地服务器上的配置文件。

$ installadm list -p
Service Name Profile
------------ -------
sparc2       myprofile.xml
             myprofile2.xml
svc0817      profile3
svc0819      profile4.xml
             newprofile
             foo.xml

示例 14 将没有名称的定制 AI 清单添加到安装服务

使用以下样例命令可将 /export/my_manifest.xml 中的清单添加到 svc1(具有 MAC 地址等于 aa:bb:cc:dd:ee:ff 的条件)。

# installadm create-manifest -f /export/my_manifest.xml \
-n svc1 -c MAC="aa:bb:cc:dd:ee:ff"

在此示例中,清单不包含名称属性,因此清单名称取自文件名。

$ installadm list -m -n svc1
Manifest       Criteria
--------       --------
my_manifest    mac  = AA:BB:CC:DD:EE:FF

示例 15 将具有定制名称的定制 AI 清单添加到安装服务

使用以下样例命令可将 /export/my_manifest.xml 中的清单添加到 svc1(具有 IPv4 范围从 10.0.2.100 到 10.0.2.199 的条件)。

# installadm create-manifest -f /export/my_manifest.xml \
-n svc1 -m chosen_name \
-c IPV4="10.0.2.100-10.0.2.199"

在此示例中,清单名称取自 -m 选项。

$ installadm list -m -n svc1
Manifest       Criteria
--------       --------
chosen_name    ipv4 = 10.0.2.100 - 10.0.2.199

示例 16 添加具有在清单中指定的名称的定制 AI 清单

使用以下样例命令可将 /export/manifest3.xml 中的清单添加到 svc1(具有内存为 2048 MB 或更大且体系结构为 i86pc 的条件)。

# installadm create-manifest -f /export/manifest3.xml \
-n svc1 -c MEM="2048-unbounded" -c ARCH=i86pc

在此示例中,清单名称取自清单中 ai_instance 元素的 name 属性,如以下部分清单所示:

<auto_install>
    <ai_instance name="my_name" />
</auto_install>
$ installadm list -m -n svc1
Manifest    Criteria
--------    --------
my_name     arch = i86pc
            mem  = 2048 MB - unbounded

示例 17 将系统配置文件添加到安装服务

使用以下样例命令可将 /export/profile4.xml 中的配置文件添加到 svc1(具有为 myhost1host3host6 中任一主机名的条件)。

# installadm create-profile -f /export/profile4.xml \
-n svc1 -p profile4 -c hostname="myhost1 host3 host6"
$ installadm list -p -n svc1
Profile          Criteria
-------          --------
profile4         hostname = myhost1 host3 host6

示例 18 添加所有客户机的系统配置文件

如果未指定条件,则配置文件将由使用指定安装服务的所有客户机使用。在以下示例中,创建的配置文件由使用 svc1 服务的所有客户机使用。

# installadm create-profile -f /export/locale.xml -n svc1
$ installadm list -p -n svc1
Profile          Criteria
-------          --------
profile4         hostname = myhost1 host3 host6
locale

示例 19 添加具有替换标记的系统配置文件

配置文件可以使用替换标记,这些标记充当来自用户环境(请参见 environ(4))或来自 create-profile 子命令的 -c 选项中指定的条件的定制客户机配置信息的占位符。使用替换标记可对任意数目的不同系统重用配置文件。在以下示例中,每个配置文件将与取自 -c 条件选项的 hostname 值一起存储:

# installadm create-profile -p myhost1_hostname \
-f /export/hostname.xml -n svc1 -c hostname=myhost1
# installadm create-profile -p myhost2_hostname \
-f /export/hostname.xml -n svc1 -c hostname=myhost2
$ installadm list -p -n svc1
Profile               Criteria
-------               --------
myhost1_hostname      hostname = myhost1
myhost2_hostname      hostname = myhost2

hostname.xml 文件包含以下行:

<propval name="nodename" value="{{AI_HOSTNAME}}"/>

create-profile 命令进行替换,以便 myhost1_hostname 配置文件包含以下行:

<propval name="nodename" value="myhost1"/>

使用相同的 hostname.xml 输入文件,myhost2_hostname 配置文件包含以下行:

<propval name="nodename" value="myhost2"/>

替换标记 {{AI_HOSTNAME}} 已替换为每个 create-profile 调用的不同值,因为使用了 hostname 条件并将其替换到了配置文件中。有关将替换标记与配置文件一起使用的更多信息,请参见《安装 Oracle Solaris 11 系统》

示例 20 将条件添加到现有清单

使用以下样例命令可将内存为 4096 MB 或更大的条件附加到 svc1manifest2 的条件。

# installadm set-criteria -m manifest2 -n svc1 \
-a MEM="4096-unbounded"

示例 21 替换现有清单的条件

使用以下样例命令可将 svc1manifest2 的条件替换为在文件 /tmp/criteria.xml 中指定的条件。

# installadm set-criteria -m manifest2 -n svc1 \
-C /tmp/criteria.xml

有关条件 XML 文件的内容的信息,请参见《安装 Oracle Solaris 11 系统》

示例 22 验证正在开发的配置文件

使用以下样例命令可验证存储在文件 myprofdir/myprofile.xmlherprofdir/herprofile.xml 中、正在开发的配置文件。

# installadm validate -P myprofdir/myprofile.xml \
-P herprofdir/herprofile.xml -n svc1

示例 23 导出配置文件的内容

使用以下样例命令可导出 svc1 服务中的配置文件 myprofile.xml

$ installadm export -p myprofile -n svc1

示例 24 替换现有 AI 清单的内容

使用以下样例命令可用文件 /home/admin/new_spec.xml 中清单的内容更新服务 svc2 中具有清单名称或 AI 实例名称 spec 的清单。

# installadm update-manifest -n svc2 \
-f /home/admin/new_spec.xml -m spec

示例 25 导出并更新现有的 AI 清单

使用以下样例命令可导出服务 svc2 中名为 spec 的现有清单的数据,然后用修改后的内容更新清单。

$ installadm export -n svc2 -m spec -o /home/admin/spec.xml

/home/admin/spec.xml 进行更改。

# installadm update-manifest -n svc2 \
-f /home/admin/spec.xml -m spec

退出状态

将返回以下退出值:

0

该命令已成功处理。

0

出现错误。

属性

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

属性类型
属性值
可用性
install/installadm
接口稳定性
Uncommitted(未确定)

另请参见

aimanifest(1M)sysconfig(1M)dhcp(5)dhcpd(8)、smf(5)service_bundle(4)ai_manifest(4)、environ(5)

《安装 Oracle Solaris 11 系统》中的第 III 部分, "使用安装服务器安装"

《从 Oracle Solaris 10 JumpStart 转换至 Oracle Solaris 11 自动化安装程序》