配置文件关键字和值

本部分描述可在配置文件中使用的配置文件关键字和值。有关创建配置文件的详细说明，请参见“创建配置文件”。

配置文件关键字一览

表 28–2提供了一种根据安装方案来快速确定可使用哪些关键字的方法。除非在关键字说明中另有说明，否则该关键字只能用于初始安装选项。

配置文件关键字说明和示例

archive_location 关键字

archive_location retrieval_type location

retrieval_type 和 location 的值取决于 Web Start Flash 归档文件的存储位置。以下各节包含可用于 retrieval_type 和 location 的值以及如何使用 archive_location 关键字的示例。

• “NFS 服务器”

• “HTTP 服务器”

• “FTP 服务器”

• “本地磁带”

• “本地设备”

• “本地文件”

NFS 服务器

如果归档文件存储在 NFS 服务器上，则对 archive_location 关键字使用以下语法。

archive_location nfs server_name:/path/filename retry n

例如：

archive_location nfs golden:/archives/usrarchive



archive_location nfs://golden/archives/usrarchive

HTTP 服务器

如果归档文件存储在 HTTP 服务器上，则对 archive_location 关键字使用以下语法。

archive_location http://server_name:port path/filename optional_keywords

例如：

archive_location http://silver/archives/usrarchive.flar timeout 5 

auth basic user_name password 关键字示例：

archive_location http://silver/archives/usrarchive.flar timeout 5 user1 secret

FTP 服务器

如果归档文件存储在 FTP 服务器上，则对 archive_location 关键字使用以下语法。

archive_location ftp://user_name:password@server_name:port path/filename optional_keywords

例如：

archive_location ftp://user1:secret@silver/archives/usrarchive.flar timeout 5

本地磁带

如果归档文件存储在磁带上，则对 archive_location 关键字使用以下语法。

archive_location local_tape device  position

例如：

archive_location local_tape /dev/rmt/0n 5



archive_location local_tape 0n 5

本地设备

如果将 Web Start Flash 归档文件存储在面向文件系统的、可随机访问的设备（如软盘或 CD-ROM）上，则您可以从本地设备检索 Web Start Flash 归档文件。对于 archive_location 关键字，使用以下语法。

通过使用本地磁带语法，您可以从面向流的设备（如磁带）中检索归档文件。

archive_location local_device device path/filename file_system_type

例如：

要从格式化为 UFS 文件系统的本地硬盘驱动器上检索归档文件，使用以下命令：

archive_location local_device c0t0d0s0 /archives/$HOST

要从含有 HSFS 文件系统的本地 CD-ROM 上检索归档文件，使用以下命令：

archive_location local_device c0t0d0s0 /archives/usrarchive

本地文件

您可以检索作为本地文件存储在从中引导克隆系统的 miniroot 中的归档文件。执行定制 JumpStart 安装时，从 CD-ROM 或基于 NFS 的 miniroot 引导系统。安装软件从该 miniroot 装入和运行。因而，存储在 CD-ROM 或基于 NFS 的 miniroot 中的 Web Start Flash 归档文件可以作为本地文件访问。对于 archive_location 关键字，使用以下语法。

archive_location local_file path/filename 

例如：

archive_location local_file /archives/usrarchive



archive_location local_file /archives/usrarchive

backup_media 配置文件关键字

backup_media type path

当需要进行磁盘空间重新分配时，您只能将 backup_media 用于升级选项。

如果在升级过程中由于磁盘空间不足而需要重新分配磁盘空间，backup_media 定义用于备份文件系统的介质。 如果备份需要多个磁带或软盘，则在升级过程中会提示您插入磁带或软盘。

例如：

backup_media local_tape /dev/rmt/0



backup_media local_diskette /dev/rdiskette1



backup_media local_filesystem /dev/dsk/c0t3d0s4



backup_media local_filesystem /export



backup_media remote_filesystem system1:/export/temp



backup_media remote_system user1@system1:/export/temp

boot_device 配置文件关键字

boot_device device eeprom

boot_device 指定 JumpStart 程序安装根 (/) 文件系统的设备和系统的引导设备。

如果您没有在配置文件中指定 boot_device 关键字，则默认情况下，将在安装过程中指定以下 boot_device 关键字：boot_device any update。

device – 使用以下值之一。

• cw txdy sz 或 cxdy sz – JumpStart 程序放置根 (/) 文件系统的磁盘片，例如 c0t0d0s0。

• existing – JumpStart 程序将根 (/) 文件系统放在系统的现有引导设备上。

• any – JumpStart 程序选择放置根 (/) 文件系统的位置。JumpStart 程序尝试使用系统的现有引导设备。如有必要，JumpStart 程序可能选择一个不同的引导设备。

eeprom – 选择更新或保存系统的 EEPROM。

选择您是希望将系统的 EEPROM 更新到指定的引导设备，还是要保存到指定的引导设备。

• update – JumpStart 程序将系统的 EEPROM 更新到指定的引导设备，以便已安装的系统自动从中引导。

• preserve – 系统 EEPROM 中的引导设备值不更改。 如果您指定了新的引导设备而没有更改系统的 EEPROM，则您需要手动更改系统的 EEPROM 以便它能够从新的引导设备自动引导。

如果您更改了系统的当前引导设备，eeprom 值还允许您更新系统的 EEPROM。通过更新系统的 EEPROM，系统可以从新的引导设备自动引导。

例如：

boot_device c0t0d0s2 update

boot_device 必须匹配任何指定根 (/) 文件系统的 filesys 关键字和 root_device 关键字（如果指定的话）。

client_arch 配置文件关键字

client_arch karch_value ...

client_arch 指定操作系统服务器将支持与该服务器所用平台组不同的平台组。如果不在配置文件中指定 client_arch，则任何使用操作系统服务器的无盘客户机必须包含与服务器相同的平台组。必须指定您希望操作系统服务器支持的每个平台组。

karch_value 的有效值是 sun4m 和 sun4u。 有关平台名称和各种系统的详细列表，请参见《Solaris 9 Sun Hardware Guide》。

只有当 system_type 被指定为 server 时，才可以使用 client_arch。

client_root 配置文件关键字

client_root root_size

client_root 定义要为每个客户机分配的根空间数量 root_size（以 MB 为单位）。如果不在服务器的配置文件中指定 client_root，则安装软件将为每个客户机分配 15 MB 的根空间。客户机根区域的大小和 num_clients 关键字组合使用以确定要为 /export/root 文件系统保留多大的空间。

只有当 system_type 被指定为 server 时，才可以使用 client_root。

client_swap 配置文件关键字

client_swap swap_size

client_swap 定义要为每个无盘客户机分配的交换空间数量 swap_size（以 MB 为单位）。如果不在配置文件中指定 client_swap，则缺省情况下，将分配 32 MB 的交换空间。

例如：

client_swap 64

该示例指定每个无盘客户机将具有 64 MB 的交换空间。

只有当 system_type 被指定为 server 时，才可以使用 client_swap。

确定 swap 大小的方式

如果配置文件不指定 swap 的大小，则 JumpStart 程序将根据系统的物理内存来确定交换空间的大小。表 28–5 显示在定制 JumpStart 安装过程中如何确定 swap 的大小。

JumpStart 程序使 swap 的大小不超过 swap 所在磁盘的百分之二十，除非该磁盘在安排了其它文件系统以后仍包含空闲空间。如果存在空闲空间，JumpStart 程序将空闲空间分配给 swap，并且如果可能，分配表 28–5 中显示的数量。

物理内存和交换空间的总和必须最少为 32 MB。

cluster 配置文件关键字（添加软件组）

cluster group_name

cluster 指定要添加到系统的软件组。每个软件组的 group_name 列于下表中。

您只能在一个配置文件中指定一个软件组。软件组必须在其它 cluster 和 package 项之前指定。如果不在配置文件中使用 cluster 指定软件组，则最终用户软件组 SUNWCuser 被安装于系统上。

cluster 配置文件关键字（添加或删除群集）

cluster cluster_name add_delete_switch

cluster（添加或删除群集）可以与初始安装和升级选项一起使用。

cluster 指定是否在要安装到系统上的软件组中添加或删除群集。

cluster_name 的形式必须是 SUNWCname。要查看有关群集及其名称的详细信息，请在已安装的系统上启动 Admintool 并从“浏览”菜单中选择“软件”。

add_delete_switch 代表选项 add 或 delete。 使用 add_delete_switch 指示是要添加，还是要删除指定的群集。如果不指定 add_delete_switch，则缺省使用 add。

在升级过程中使用 cluster（添加或删除群集）时，以下情况适用：

• 系统上已有的所有群集被自动升级。

• 如果指定 cluster_name add，并且 cluster_name 未安装在系统上，则安装该群集。

• 如果指定 cluster_name delete，并且 cluster_name 已经安装在系统上，则在升级开始之前删除该软件包。

dontuse 配置文件关键字

dontuse disk_name ...

缺省情况下，当指定 partitioning default 时，JumpStart 程序使用系统上的所有可操作磁盘。dontuse 指定您不希望 JumpStart 程序使用的一个或多个磁盘。disk_name 必须以 cxt ydz 形式指定，例如 c0t0d0。

您不能在同一配置文件中同时指定 dontuse 关键字和 usedisk 关键字。

filesys 配置文件关键字（安装远程文件系统）

filesys server:path server_address mount_pt_name [[mount_options]]

通过将 filesys 和所列的值一起使用，JumpStart 程序将已安装的系统设置为在系统引导时自动安装远程文件系统。您可以多次指定 filesys。

例如：

filesys sherlock:/export/home/user2 - /home

server: – 远程文件系统所在的服务器的名称，后跟一个冒号。

path – 远程文件系统的安装点名称。例如，/usr 或 /export/home。

server_address – 在 server: path 中指定的服务器的 IP 地址。如果网络上未运行名称服务，则可以使用 server_address 值在 /etc/hosts 文件中填充服务器的主机名和 IP 地址。如果没有指定服务器的 IP 地址，则必须指定一个减号 (-)。例如，如果网络上有正在运行的名称服务，则不需要指定服务器的 IP 地址。

mount_pt_name – 要安装远程文件系统的安装点的名称。

mount_options – 一个或多个安装选项，与 mount(1M) 命令的 -o 选项相同。安装选项被添加到指定的 mount_pt_name 的 /etc/vfstab 项。

如果需要指定多个安装选项，则安装选项必须用逗号隔开并且不留空格（例如，ro,quota）。

filesys 配置文件关键字（创建本地文件系统）

filesys slice size [[file_system optional_parameters]]

通过将 filesys 和所列的值一起使用，JumpStart 程序在安装过程中创建本地文件系统。您可以多次指定 filesys。

slice – 使用以下值之一：

• any – JumpStart 程序将文件系统放置于任意磁盘。

  ---

  注意：

  当 size 的值为 existing、all、free、start:size 或 ignore 时，不能指定 any 选项。

  ---

• cw txdy sz – JumpStart 程序放置文件系统的磁盘片，例如 c0t0d0s0 或 c0d0s0。

• rootdisk.sn – 包含系统根磁盘（它由 JumpStart 程序确定，如“如何确定系统的根磁盘”中所述）的值的变量。sn 后缀指示磁盘上的特定片。

size – 使用以下值之一：

• num – 文件系统的大小设置为 num（以 MB 为单位）。

• existing – 使用现有文件系统的当前大小。

  ---

  注意：

  在使用 existing 值时，您可以通过将 file_system 指定为不同的 mount_pt_name 来更改现有片的名称。

  ---

• auto – 根据所选的软件，自动确定文件系统的大小。

• all – 指定的 slice 将整个磁盘用于该文件系统。当您指定 all 值时，不能将其它文件系统放置于指定的磁盘上。

• free – 将磁盘上剩余的未用空间用于该文件系统。

  ---

  注意：

  如果将 free 用作 filesys 的值，则 filesys 项必须是该配置文件中的最后一项。

  ---

• start:size – 文件系统被明确分区。start 是片的起始柱面。size 是片的柱面个数。

file_system – file_system 值是可选的，并且在 slice 被指定为 any 或 c wtxd ysz 时使用。 如果未指定 file_system，则按缺省情况设置 unnamed。如果设置了 unnamed，则不能指定 optional_parameters 值。使用以下值之一：

• mount_pt_name – 文件系统的安装点的名称，例如 /var。

• swap – 将指定的 slice 用作 swap。

• overlap – 将指定的 slice 定义为磁盘区域表示。VTOC 值是 V_BACKUP。缺省情况下，片 2 是重叠片，它表示整个磁盘。

  ---

  注意：

  仅当 size 是 existing、all 或 start:size 时才能指定 overlap。

  ---

• unnamed – 指定的 slice 被定义为原始片，因而 slice 没有安装点名称。如果不指定 file_system，则按照缺省情况使用 unnamed。

• ignore – 指定的 slice 不由 JumpStart 程序使用或识别。您可以使用此选项指定希望在安装过程中忽略磁盘上的一个文件系统。JumpStart 程序在同一磁盘上创建一个新的同名的文件系统。只有在指定了 partitioning existing 时，才可以使用 ignore。

optional_parameters – 使用以下值之一：

• preserve – 指定的 slice 上的文件系统被保留。

  ---

  注意：

  只有当 size 是 existing 并且 slice 是 cwt xdys z 时，才可指定 preserve。

  ---

• mount_options – 一个或多个安装选项，与 mount(1M) 命令的 -o 选项相同。安装选项被添加到指定的 mount_pt_name 的 /etc/vfstab 项。

  ---

  注意：

  如果需要指定多个安装选项，安装选项必须用逗号隔开并且不留空格（例如，ro,quota）。

  ---

geo 配置文件关键字

geo locale

您可以将 geo 用于初始安装和升级选项。

geo 指定要在系统上安装或要在升级系统时添加的一个或多个地区性语言环境。您可以为 locale 指定的值列于下表中。

在第 40 章，语言环境值（参考）中描述了组成以上列出的每个区域性语言环境的语言环境组件值的完整列表。

您可以为需要添加到系统的每个语言环境指定一个 geo 关键字。

install_type 配置文件关键字

install_type initial_upgrade_flash_swith

install_type 定义是在系统上清除然后安装新的 Solaris 操作环境、更新系统上的现有 Solaris 环境，还是在系统上安装 Web Start Flash 归档文件。

您必须在配置文件中指定 install_type，并且 install_type 在每个配置文件中必须是第一个配置文件关键字。

对于 initial_upgrade_flash_switch ，必须使用以下选项之一：

• initial_install – 指定执行 Solaris 操作环境的初始安装。

• upgrade – 指定执行 Solaris 操作环境的升级。

• flash_install – 指定安装 Web Start Flash 归档文件。

某些配置文件关键字只能用于 initial_install 选项。某些配置文件关键字只能用于 upgrade 选项。某些配置文件关键字只能用于 flash_install 选项。

isa_bits 配置文件关键字

isa_bits bit_switch

isa_bits 指定是要安装 64 位，还是要安装 32 位 Solaris 9 软件包。

bit_switch 代表选项 64 或 32，它用于指示是要安装 64 位，还是要安装 32 位 Solaris 9 软件包。如果不在配置文件中设置该关键字，则 JumpStart 程序按以下方式安装系统：

• 在 UltraSPARC^TM 系统上安装 64 位软件包

• 在所有其它系统上安装 32 位软件包

如果使用 isa_bits 关键字，则您还必须使用最新的 check 脚本，它位于 Solaris 9 Software 1 (1 of 2) CD 或 Solaris 9 DVD 上的 solaris_9/Misc/jumpstart_sample 目录中。

layout_constraint 配置文件关键字

layout_constraint slice constraint [[minimum_size]]

只有在进行升级时需要重新分配磁盘空间的情况下，才需将 layout_constraint 用于升级选项。

layout_constraint 指定当自动布局在升级过程中由于空间问题而需要重新分配空间时，自动布局对文件系统指定的约束条件。

如果不指定 layout_constraint 关键字，则 JumpStart 程序按以下方式安排磁盘：

• 将需要更多升级空间的文件系统标记为可更改的。

• 将与需要更多空间的文件系统位于同一磁盘上以及通过 /etc/vfstab 文件安装的文件系统标记为可更改的。

• 将剩余的文件系统标记为固定的，原因是自动布局不能更改这些文件系统。

如果指定一个或多个 layout_constraint 关键字，则 JumpStart 程序按以下方式安排磁盘：

• 将需要更多升级空间的文件系统标记为可更改的。

• 指定了 layout_constraint 关键字的文件系统使用指定的约束进行标记。

• 将剩余的文件系统标记为固定的。

您不能更改需要更多升级空间的文件系统上的约束，因为这些文件系统必须标记为可更改的。您可以使用 layout_constraint 关键字更改需要更多升级空间的文件系统上的 minimum_size 值。

要帮助自动布局重新分配空间，请将更多文件选择为可更改的或可移动的，尤其是那些与需要更多升级空间的文件系统位于同一磁盘上的文件系统。

slice – slice 指定要对其指定约束的文件系统的磁盘片。必须以 cwtxd ysz 形式指定系统的磁盘片。

constraint – 对指定的文件系统使用以下约束之一：

• changeable – 自动布局可将文件系统移动到另一个位置并且它可以更改文件系统的大小。 changeable 约束只能在通过 /etc/vfstab 文件安装的文件系统上指定。可以通过指定 minimum_size 值来更改文件系统的大小。

  在将一个文件系统标记为可更改的并且未指定 minimum_size 时，文件系统的最小值被设置为比所需的最小值大百分之十。例如，如果文件系统的最小值是 100 MB，则更改的大小是 110 MB。如果指定了 minimum_size，则将任何剩余的空闲空间（原始大小减去最小值）用于其它文件系统。

• movable – 自动布局可以将该文件系统移动到同一磁盘或不同磁盘上的另一个片中。文件系统的大小保持不变。

• available – 自动布局可以使用文件系统上的所有空间来重新分配空间。文件系统中的所有数据将丢失。available 约束只能在不是通过 /etc/vfstab 文件安装的文件系统上指定。

• collapse – 自动布局将指定的文件系统移动和折叠到父文件系统中。作为升级的一部分，您可以使用 collapse 选项来减少系统上文件系统的数目。例如，如果系统具有 /usr 和 /usr/share 文件系统，则在折叠 /usr/share 文件系统时会将其移动到父文件系统 /usr 中。您只能在通过 /etc/vfstab 文件安装的文件系统上指定 collapse 约束。

minimum_size – 指定在自动布局重新分配空间后文件系统的大小。minimum_size 选项使您能够更改文件系统的大小。如果将未分配的空间添加到文件系统中，则文件系统的大小可能会更大。但是，大小永远不会小于您指定的值。minimum_size 值是可选的。仅在已将文件系统标记为可更改时使用此值，并且最小值不能小于文件系统需要用于现有文件系统内容的大小。

例如：

layout_constraint c0t3d0s1 changeable 200



layout_constraint c0t3d0s4 movable



layout_constraint c0t3d1s3 available



layout_constraint c0t2d0s1 collapse

locale 配置文件关键字

locale locale_name

您可以将 locale 用于初始安装和升级选项。

locale 指定在升级时想要安装或添加的由 locale_name 标识的语言环境软件包。locale_name 值与那些用于 $LANG 环境变量的值相同。第 40 章，语言环境值（参考）包含有效语言环境值的列表。

当使用 local 关键字时，请考虑以下情况：

• 如果您已经预先配置了一个缺省语言环境，则自动安装该语言环境。缺省情况下，安装英语语言软件包。

• 可以为每个需要添加到系统中的语言环境指定 locale 关键字。

num_clients 配置文件关键字

num_clients client_num

当安装了服务器时，为每个无盘客户机的根 (/) 和 swap 文件系统分配空间。num_clients 定义服务器支持的无盘客户机的数目 client_num。如果不在配置文件中指定 num_clients，则按照缺省情况分配五个无盘客户机。

只有当 system_type 被指定为 server 时，才可以使用 num_clients。

package 配置文件关键字

package package_name [[add_delete_switch]]

您可以将 package 用于初始安装和升级选项。

package 指定是要在准备安装到系统中的软件组中添加，还是要从中删除软件包。

必须以 SUNWname 形式指定 package_name。要查看有关软件包及其名称的详细信息，请在已安装的系统上使用 pkginfo -l 命令。

add_delete_switch 代表选项 add 或 delete，它用于指示是要添加还是要删除指定的软件包。如果不指定 add_delete_switch，则按照缺省情况使用 add。

某些软件包是必需的并且不能删除。您不能使用 package 配置文件关键字来单个地添加或删除本地化软件包。要添加本地化软件包，请使用 locale 配置文件关键字。

当为升级使用 package 时，JumpStart 程序执行以下操作：

• 自动升级系统上已有的所有软件包。

• 如果指定 package_name add，并且 package_name 未安装在系统上，则安装该软件包。

• 如果指定 package_name delete，并且 package_name 已安装在系统上，则在升级开始之前 删除该软件包。

• 当指定 package_name delete 并且 package_name 未安装在系统上时，如果该软件包是指定要安装的群集的一部分，则不安装该软件包。

partitioning 配置文件关键字

partitioning type

partitioning 定义在安装过程中如何将磁盘划分为文件系统片。

type – 使用以下值之一：

• default – JumpStart 程序选择磁盘并创建要安装指定软件的文件系统（任何由 filesys 关键字指定的文件系统除外）。首先选择 rootdisk。如果指定的软件不适合 rootdisk，则 JumpStart 程序使用其它磁盘。

• existing – JumpStart 使用系统磁盘上的现有文件系统。保留除 /、/usr、/usr/openwin、 /opt 和 /var 以外的所有文件系统。JumpStart 程序使用文件系统超级块中的上一个安装点字段来确定片所代表的文件系统安装点。

  ---

  注意：

  当同时使用 filesys 和 partitioning existing 配置文件关键字时，必须将大小 size 设置为 existing。

  ---

• explicit – JumpStart 使用磁盘并创建由 filesys 关键字指定的文件系统。如果只使用 filesys 关键字指定根 (/) 文件系统，则所有 Solaris 软件都被安装在根 (/) 文件系统中。

  ---

  注意：

  如果使用 explicit 配置文件值，则必须使用 filesys 关键字指定要使用的磁盘和要创建的文件系统。

  ---

如果不在配置文件中指定 partitioning，则按照缺省情况使用 default 类型的分区。

root_device 配置文件关键字

root_device slice

您可以将 root_device 用于初始安装和升级选项。

root_device 指定系统的根磁盘。“如何确定系统的根磁盘”包含附加信息。

升级系统时，root_device 指定要升级的根 (/) 文件系统和通过其 /etc/vfstab 文件安装的文件系统。如果可以在系统上升级多个根 (/) 文件系统，则必须指定 root_device。必须以 cw txdy sz 形式指定 slice。

例如：

root_device c0t0d0s2

当使用 root_device 关键字时，请考虑以下情况：

• 如果在只有一个磁盘的系统上指定 root_device， root_device 和磁盘必须匹配。而且，任何指定根 (/) 文件系统的 filesys 关键字必须与 root_device 相匹配。

• 如果您正在升级镜像，则为 root_device 指定的值应该是该镜像的一个面。该镜像的另一面自动升级。

如何确定系统的根磁盘

系统的根磁盘是系统上包含根 (/) 文件系统的磁盘。 在配置文件中，您可以使用 rootdisk 变量来代替磁盘名，JumpStart 程序将其设置为系统的根磁盘。表 28–6描述 JumpStart 程序如何为安装确定系统的根磁盘。

JumpStart 程序只在初始安装过程中确定系统的根磁盘大小。您不能在升级过程中更改系统的根磁盘大小。

system_type 配置文件关键字

system_type type_switch

system_type 定义要安装 Solaris 环境的系统类型。

type_switch 代表选项 standalone 或 server，它用于指示要安装 Solaris 软件的系统类型。如果没有在配置文件中指定 system_type，则按缺省情况使用 standalone。

usedisk 配置文件关键字

usedisk disk_name ...

缺省情况下，当指定了 partitioning default 时，JumpStart 程序将使用系统上的所有可操作磁盘。usedisk 配置文件关键字指定希望 JumpStart 程序使用的一个或多个磁盘。必须以 cxtydz 或 cydz 形式指定 disk_name，例如 c0t0d0 或 c0d0s0。

如果在配置文件中指定 usedisk，则 JumpStart 程序只使用在 usedisk 关键字之后指定的磁盘。

您不能在同一配置文件中同时指定 dontuse 关键字和 usedisk 关键字。