Solaris 9 9/04 安装指南

Solaris Flash 关键字

Solaris Flash 关键字与定制 JumpStart 关键字类似。它们定义安装的元素。每个关键字都是一个命令，分别控制 Solaris Flash 软件在克隆系统上安装软件的各个方面。

请遵循以下原则格式化关键字及其值：

关键字和值由单个等号分隔，每行只有一对
关键字不区分大小写
各个行可以为任意长度

一般关键字

每个 Solaris Flash 归档文件段都由 section_begin 和 section_end 关键字定义。例如，Archive Files 段包含 section_begin 关键字，但具有不同的值。 User-Defined 归档文件段由 section_begin 和 section_end 关键字以及适合各段的值限定。下表说明了 section_begin 和 section_end 关键字的值。

表 23–2 section_begin 和 section_end 关键字的值


归档文件段	`section_begin` 和 `section_end` 关键字的值
Archive Cookie	`cookie` — 该段不受 `section_begin` 和 `section_end` 关键字的限制。
Archive Identification	`identification`
User-Defined 段	`section_name`，`section_name` 关键字的实例有 X-user_section_1。
Archive Files	`archive`

Archive Identification 段的关键字

以下各表说明了 Archive Identification 段使用的关键字以及可以为它们定义的值。

每个段使用表 23–3 中的关键字限定各段的范围。

表 23–3 Archive Identification 段的关键字：一般关键字


关键字	值定义	值	必需
`section_begin` `section_end`	这些关键字用于限定归档文件中的段，而不是仅用于 Archive Identification 段。有关这些关键字的说明，请参见一般关键字。	文本	是

以下关键字用在 Archive Identification 段中，用于说明 Archive Files 段的内容。

表 23–4 Archive Identification 段的关键字： Archive Files 段的内容


关键字	值定义	值	必需
`archive_id`（可选）	该关键字唯一说明了归档文件的内容。在归档文件安装过程中，安装软件使用该值来验证归档文件的内容。如果该关键字不存在，则不执行完整性检查。例如，`archive_id` 关键字可以是 `FlAsH-ARcHive-2.0`。	文本	否
`files_archived_method`	该关键字说明了在 Archive Files 段中使用的归档方法。如果该关键字存在，它的值为 `cpio`。如果该关键字不存在，Archive Files 段将采用带有 ASCII 标题的 CPIO 格式。该格式是 `cpio` `-c` 选项。如果 `files_compressed_method` 存在，则将压缩方法应用到由归档方法创建的归档文件中。	文本	否
`files_archived_size`	该关键字的值表示 Archived Files 段的大小（以字节为单位）。	数字	否
`files_compress_method`	该关键字说明了 Archive Files 段中使用的压缩算法。如果该关键字存在，它可以具有以下值： `none` – 不压缩 Archive Files 段 `compress` – 使用 `compress` 命令压缩 Archive Files 段如果该关键字不存在，则认为 Archive Files 段未被压缩。该关键字给出的压缩方法适用于由 `files_archived_method` 关键字指定的归档方法创建的归档文件。	文本	否
`files_unarchived_size`	该关键字定义已提取的归档文件的累计大小（以字节为单位）。该值用于文件系统大小验证。	数字	否

以下关键字提供有关整个归档文件的说明信息。这些关键字通常用于帮助您选择和管理归档文件。它们都是可选的，用于帮助您区分各个归档文件。使用 flar create 命令的选项可以包含这些关键字。有关实例，请参见实例 21–12。

表 23–5 Archive Identification 段的关键字：用户描述归档文件


关键字	值定义	值	必需
`creation_date`	该关键字的值是一个文本型时间戳，表示您创建归档文件的时间。可以使用 `flar create` 命令的 `-i` 选项创建日期。如果没有使用 `flar create` 命令指定创建日期，就按格林威治标准时间 (GMT) 设置缺省日期。该值必须采用不带有时间定义符的 ISO-8601 完整基本日历格式 (ISO-8601,§5.4.1(a))。格式为 `CCYYMMDDhhmmss`。例如，20000131221409 代表 2000 年 1 月 31 日下午 10:14:09。	文本	否
`creation_master`	该关键字的值是您用于创建归档文件的主系统的名称。可以使用 `flar create` `-m` 选项创建该值。如果您没有指定该值，它将使用由 `uname -n` 命令给定的名称。	文本	否
`content_name`	该关键字标识归档文件。该值由 `flar create` `-n` 选项生成。创建该值时请遵循以下原则：说明性名称不能超过 256 个字符。说明中应该包含归档文件的功能和目的。	文本	是
`content_type`	该关键字的值指定归档文件的类别。可以使用 `flar create` `-T` 选项生成该值。	文本	否
`content_description`	该关键字的值说明归档文件的内容。该关键字的值没有长度限制。可以使用 `flar create` `-E` 选项创建该值。	文本	否
`content_author`	该关键字的值标识归档文件的创建者。可以使用 `flar create-a` 选项创建该值。建议的值包括创建者的全名和创建者的电子邮件地址。	文本	否
`content_architectures`	该关键字的值是归档文件所支持的内核体系结构的逗号分隔列表。如果该关键字存在，安装软件将根据归档文件所支持的体系结构列表来验证克隆系统的内核体系结构。如果归档文件不支持克隆系统的内核体系结构，安装就会失败。如果该关键字不存在，安装软件将不验证克隆系统的体系结构。	文本列表	否

以下关键字也说明整个归档文件。缺省情况下，创建 Flash 归档文件时用 uname 填充它们的值。如果您创建的 Flash 归档文件的根目录不是 /，归档软件就会将字符串 UNKNOWN 作为关键字的值。但 creation_node、creation_release 和 creation_os_name 关键字例外。

对于 creation_node，软件使用 nodename 文件的内容作为其值。
而对于 creation_release 和 creation_os_name，软件尝试使用 root 目录 /var/sadm/system/admin/INST_RELEASE 的内容作为其值。如果软件未能成功读取此文件，它将指定值 UNKNOWN。

无论它们的来源如何，您都不能覆盖这些关键字的值。

表 23–6 Archive Identification 段的关键字：软件描述归档文件


关键字	值
`creation_node`	从 `uname` `-n` 返回的值
`creation_hardware_class`	从 `uname` `-m` 返回的值
`creation_platform`	从 `uname` `-i` 返回的值
`creation_processor`	从 `uname` `-p` 返回的值
`creation_release`	从 `uname` `-r` 返回的值
`creation_os_name`	从 `uname` `-s` 返回的值
`creation_os_version`	从 `uname` `-v` 返回的值

User-Defined 段的关键字

除了由 Solaris Flash 归档文件定义的关键字之外，您还可以定义其它关键字。 Solaris Flash 归档文件忽略用户自定义的关键字，但您可以提供处理 Archive Identification 段和使用用户自定义关键字的脚本和程序。创建用户自定义关键字时请遵循以下格式：

关键字的名称必须以 X 开头。
创建的关键字可以包含除换行符、等号和空字符以外的任何字符。
建议的用户自定义关键字命名惯例包括使用下划线限定说明方法来预定义关键字。另一个惯例是与 Java 软件包命名类似的联盟惯例。

例如，X-department 是有效的用户自定义关键字的名称。

有关使用选项将用户自定义关键字包含在 Archive Identification 段中的实例，请参见实例 21–12。