usr/src/man/zh_CN/ai_manifest.4
changeset 1763 ca9c641c8ec7
equal deleted inserted replaced
1762:c521dff595bc 1763:ca9c641c8ec7
       
     1 '\" te
       
     2 .\" Copyright (c) 2008, 2012, Oracle and/or its affiliates.All rights reserved.
       
     3 .TH ai_manifest 4 "2012 年 6 月 26 日" "SunOS 5.11" "文件格式"
       
     4 .SH 名称
       
     5 ai_manifest \- 自动化安装清单文件格式
       
     6 .SH 用法概要
       
     7 .LP
       
     8 .nf
       
     9 /usr/share/install/ai.dtd.1
       
    10 .fi
       
    11 
       
    12 .SH 描述
       
    13 .sp
       
    14 .LP
       
    15 自动化安装程序 (Automated Installer, AI) 为 Oracle Solaris 提供可定制的无人参与安装机制,并使用基于 XML 的文件格式作为安装参数的说明。此安装参数文件称为 AI 清单。可以通过各种方式(如磁盘布局和要在系统上安装的软件)定制安装。
       
    16 .sp
       
    17 .LP
       
    18 AI 清单具有以下部分:
       
    19 .RS +4
       
    20 .TP
       
    21 .ie t \(bu
       
    22 .el o
       
    23 自动化安装设置。指定在安装期间使用的设置。
       
    24 .RE
       
    25 .RS +4
       
    26 .TP
       
    27 .ie t \(bu
       
    28 .el o
       
    29 磁盘布局。指定安装的磁盘布局。
       
    30 .RE
       
    31 .RS +4
       
    32 .TP
       
    33 .ie t \(bu
       
    34 .el o
       
    35 软件。指定要安装的软件包。
       
    36 .RE
       
    37 .RS +4
       
    38 .TP
       
    39 .ie t \(bu
       
    40 .el o
       
    41 引导配置(仅限 x86)。指定如何配置 GRUB 引导菜单。
       
    42 .RE
       
    43 .RS +4
       
    44 .TP
       
    45 .ie t \(bu
       
    46 .el o
       
    47 其他配置。指定要在系统上安装的其他配置组件。
       
    48 .RE
       
    49 .sp
       
    50 .LP
       
    51 下面将更详细地介绍这些部分。
       
    52 .sp
       
    53 .LP
       
    54 要创建新的 AI 清单,请使用模板副本或来自相关安装服务映像的缺省清单。例如,如果安装服务映像位于 \fIimagepath\fR,则以下文件可用:
       
    55 .sp
       
    56 .ne 2
       
    57 .mk
       
    58 .na
       
    59 \fB\fB\fIimagepath\fR/auto_install/manifest/default.xml\fR\fR
       
    60 .ad
       
    61 .sp .6
       
    62 .RS 4n
       
    63 此安装服务的原始缺省 AI 清单。
       
    64 .RE
       
    65 
       
    66 .sp
       
    67 .ne 2
       
    68 .mk
       
    69 .na
       
    70 \fB\fB\fIimagepath\fR/auto_install/manifest/ai_manifest.xml\fR\fR
       
    71 .ad
       
    72 .sp .6
       
    73 .RS 4n
       
    74 包含示例定制的带注释 AI 清单样例。
       
    75 .RE
       
    76 
       
    77 .sp
       
    78 .LP
       
    79 可以使用 \fBinstalladm export\fR 命令检索安装服务中已存在的任何清单的副本。
       
    80 .sp
       
    81 .LP
       
    82 AI 清单还用于安装非全局区域(使用 \fBzoneadm install\fR 命令)。可以将 AI 清单文件传递给此命令以定制区域安装。在 AI 清单指定的内容中,只有一部分适用于安装非全局区域。下面的各部分中对这些指定内容进行了说明。
       
    83 .sp
       
    84 .LP
       
    85 服务管理工具 (Service Management Facility, SMF) 配置文件对 AI 清单进行了补充。这些配置文件指定已安装系统的系统配置,如主机名、联网以及 root 用户和初始用户的帐户设置。
       
    86 .sp
       
    87 .LP
       
    88 有关安装服务、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)。
       
    89 .SH 自动化安装设置
       
    90 .sp
       
    91 .LP
       
    92 \fBai_instance\fR 元素具有以下属性:
       
    93 .sp
       
    94 .ne 2
       
    95 .mk
       
    96 .na
       
    97 \fB\fBname\fR\fR
       
    98 .ad
       
    99 .sp .6
       
   100 .RS 4n
       
   101 此清单实例的名称。
       
   102 .RE
       
   103 
       
   104 .sp
       
   105 .ne 2
       
   106 .mk
       
   107 .na
       
   108 \fB\fBhttp_proxy\fR\fR
       
   109 .ad
       
   110 .sp .6
       
   111 .RS 4n
       
   112 在安装期间用于访问远程文件的 HTTP 代理。例如,映像包管理系统 (Image Packaging System, IPS) 软件包系统信息库中的软件包即是在安装期间访问的远程文件。\fBhttp_proxy\fR 的值是 HTTP URI,如 \fBhttp://myproxy.mycompany.com:8080/\fR。
       
   113 .sp
       
   114 在安装非全局区域时此属性不适用;如果提供了此属性,它将被忽略。
       
   115 .RE
       
   116 
       
   117 .sp
       
   118 .ne 2
       
   119 .mk
       
   120 .na
       
   121 \fB\fBauto_reboot\fR\fR
       
   122 .ad
       
   123 .sp .6
       
   124 .RS 4n
       
   125 指定在安装后是否自动重新引导的标志。\fBauto_reboot\fR 的缺省值为 \fBfalse\fR。当 \fBauto_reboot\fR 为 \fBfalse\fR 时,安装将等待手动干预以重新引导。
       
   126 .sp
       
   127 当 \fBauto_reboot\fR 为 \fBtrue\fR 时,如果安装成功,则计算机将自动重新引导到新安装的引导环境。
       
   128 .sp
       
   129 在安装非全局区域时此属性不适用;如果提供了此属性,它将被忽略。
       
   130 .RE
       
   131 
       
   132 .sp
       
   133 .LP
       
   134 以下示例演示如何使用 \fBai_instance\fR 元素:
       
   135 .sp
       
   136 .in +2
       
   137 .nf
       
   138 <auto_install>
       
   139   <ai_instance name='default' auto_reboot='true'
       
   140     http_proxy='http://myproxy.mycompany.com:8080/'>
       
   141   <!-- target and software sections -->
       
   142   </ai_instance>
       
   143 </auto_install>
       
   144 .fi
       
   145 .in -2
       
   146 
       
   147 .SH 磁盘布局
       
   148 .sp
       
   149 .LP
       
   150 AI 支持各种磁盘指定方式,从完全自动化选择安装目标到对磁盘布局的细粒度控制。
       
   151 .sp
       
   152 .LP
       
   153 \fBtarget\fR 元素指定磁盘布局。未指定 \fBtarget\fR 元素时缺省磁盘布局具有以下特征:
       
   154 .RS +4
       
   155 .TP
       
   156 .ie t \(bu
       
   157 .el o
       
   158 一个磁盘全部用于安装 Oracle Solaris OS。此磁盘通常为引导磁盘或第一个磁盘。
       
   159 .RE
       
   160 .RS +4
       
   161 .TP
       
   162 .ie t \(bu
       
   163 .el o
       
   164 对于具有 GPT 感知固件的 x86 和 SPARC,将会分配 GPT 分区,该分区使用所有磁盘内容。请参见 \fBzpool\fR(1M) 手册页中 \fBzpool create\fR 命令的 \fB-B\fR 选项。
       
   165 .RE
       
   166 .RS +4
       
   167 .TP
       
   168 .ie t \(bu
       
   169 .el o
       
   170 对于不支持使用 GPT 的 SPARC 系统,将创建一个分片 0,其大小为整个磁盘。
       
   171 .RE
       
   172 .RS +4
       
   173 .TP
       
   174 .ie t \(bu
       
   175 .el o
       
   176 还会创建一个根池,该根池使用整个分片 0 或整个 GPT 分区。
       
   177 .RE
       
   178 .RS +4
       
   179 .TP
       
   180 .ie t \(bu
       
   181 .el o
       
   182 如果空间可用,则会在根池中创建交换卷和转储卷。
       
   183 .RE
       
   184 .sp
       
   185 .LP
       
   186 \fBtarget\fR 元素具有以下结构:
       
   187 .sp
       
   188 .in +2
       
   189 .nf
       
   190 <!-- zero or one target element -->
       
   191 <target>
       
   192   <!-- zero or more disk elements -->
       
   193   <disk ...>
       
   194     <!-- One of the following elements:
       
   195              disk_name
       
   196              disk_prop
       
   197              disk_keyword
       
   198              iscsi
       
   199          Zero or more of the following elements:
       
   200              gpt_partition
       
   201              partition
       
   202              slice
       
   203          gpt_partition can have zero or one size element.
       
   204          partition can have zero or one size element
       
   205              followed by zero or more slice elements.
       
   206          slice can have zero or one size element.
       
   207     -->
       
   208   </disk>
       
   209   <!-- zero or one logical element -->
       
   210   <logical ...>
       
   211     <!-- zero or more zpool elements -->
       
   212     <zpool ...>
       
   213       <!-- zero or more vdev elements -->
       
   214       <vdev ...>
       
   215       </vdev>
       
   216       <!-- zero or more filesystem elements
       
   217            with zero or one options element
       
   218       -->
       
   219       <filesystem>
       
   220         <options>
       
   221           <option .../>
       
   222         </options>
       
   223       <!-- zero or more zvol elements
       
   224            with zero or one options element
       
   225            and one size element
       
   226       -->
       
   227       <zvol ...>
       
   228         <options>
       
   229           <option .../>
       
   230         </options>
       
   231         <size val="..."/>
       
   232       </zvol>
       
   233       <!-- zero or one pool_options element
       
   234            with one or more option elements
       
   235       -->
       
   236       <pool_options>
       
   237         <option .../>
       
   238       </pool_options>
       
   239       <!-- zero or one dataset_options element
       
   240            with one or more option elements
       
   241       -->
       
   242       <dataset_options>
       
   243         <option .../>
       
   244       </dataset_options>
       
   245       <!-- zero or one be element
       
   246            with zero or one options elements
       
   247       -->
       
   248       <be>
       
   249         <options>
       
   250           <option .../>
       
   251         </options>
       
   252       </be>
       
   253     </zpool>
       
   254   </logical>
       
   255 </target>
       
   256 .fi
       
   257 .in -2
       
   258 
       
   259 .sp
       
   260 .LP
       
   261 通过 \fBtarget\fR 元素的子元素可以指定磁盘和逻辑布局。
       
   262 .sp
       
   263 .LP
       
   264 在安装非全局区域时,磁盘的指定不适用;如果指定了磁盘,它们将被忽略。
       
   265 .sp
       
   266 .LP
       
   267 有些磁盘布局元素具有 size 子元素。\fBsize\fR 元素具有以下格式:
       
   268 .sp
       
   269 .in +2
       
   270 .nf
       
   271 <size val="\fIsize\fR" start_sector="\fIstart_sector\fR"/>
       
   272 .fi
       
   273 .in -2
       
   274 
       
   275 .sp
       
   276 .LP
       
   277 \fIstart_sector\fR 值是一个数值,用于指定新分区或分片的所需开始扇区。如果省略了 \fIstart_sector\fR 属性,则安装程序将搜索第一个足以包含指定 \fIsize\fR 的位置。
       
   278 .sp
       
   279 .LP
       
   280 \fIsize\fR 的值是具有以下后缀之一的数值:
       
   281 .RS +4
       
   282 .TP
       
   283 .ie t \(bu
       
   284 .el o
       
   285 \fBs\fR 或 \fBsec\fR:扇区
       
   286 .RE
       
   287 .RS +4
       
   288 .TP
       
   289 .ie t \(bu
       
   290 .el o
       
   291 \fBb\fR:字节
       
   292 .RE
       
   293 .RS +4
       
   294 .TP
       
   295 .ie t \(bu
       
   296 .el o
       
   297 \fBk\fR 或 \fBkb\fR:千字节 (2^10)
       
   298 .RE
       
   299 .RS +4
       
   300 .TP
       
   301 .ie t \(bu
       
   302 .el o
       
   303 \fBm\fR 或 \fBmb\fR:兆字节 (2^20)
       
   304 .RE
       
   305 .RS +4
       
   306 .TP
       
   307 .ie t \(bu
       
   308 .el o
       
   309 \fBg\fR 或 \fBgb\fR:千兆字节 (2^30)
       
   310 .RE
       
   311 .RS +4
       
   312 .TP
       
   313 .ie t \(bu
       
   314 .el o
       
   315 \fBt\fR 或 \fBtb\fR:兆兆字节 (2^40)
       
   316 .RE
       
   317 .RS +4
       
   318 .TP
       
   319 .ie t \(bu
       
   320 .el o
       
   321 \fBp\fR 或 \fBpb\fR:拍字节 (2^50)
       
   322 .RE
       
   323 .RS +4
       
   324 .TP
       
   325 .ie t \(bu
       
   326 .el o
       
   327 \fBe\fR 或 \fBeb\fR:艾字节 (2^60)
       
   328 .RE
       
   329 .RS +4
       
   330 .TP
       
   331 .ie t \(bu
       
   332 .el o
       
   333 \fBz\fR 或 \fBzb\fR:泽字节 (2^70)
       
   334 .RE
       
   335 .sp
       
   336 .LP
       
   337 此部分的其余内容详细介绍了 \fBdisk\fR 和 \fBlogical\fR 元素。
       
   338 .SS "安装位置"
       
   339 .sp
       
   340 .LP
       
   341 如果在客户机上未指定安装 Oracle Solaris OS 的位置,则 AI 将选择该客户机的缺省位置。
       
   342 .sp
       
   343 .LP
       
   344 缺省的安装位置是每个客户机上找到的首个符合大小要求的磁盘。如果磁盘大小大于或等于所需的大小,那么安装程序将选择该磁盘作为安装位置。如果磁盘大小小于所需的大小,安装程序将检查下一磁盘。如果没有找到符合大小要求的磁盘,自动化安装在该客户机上将失败。\fB/system/volatile/install_log\fR 中的安装日志显示了该系统的磁盘选择过程的详细信息。
       
   345 .sp
       
   346 .LP
       
   347 \fBtarget\fR 部分的 \fBdisk\fR 部分指定安装位置。
       
   348 .sp
       
   349 .LP
       
   350 在安装非全局区域时,磁盘的指定不适用;如果指定了磁盘,它们将被忽略。
       
   351 .sp
       
   352 .LP
       
   353 可以使用以下类型的选择条件之一来选择磁盘:
       
   354 .RS +4
       
   355 .TP
       
   356 .ie t \(bu
       
   357 .el o
       
   358 第 1 组:确定性条件,如磁盘名称或 IP 地址。使用下面“目标设备名称”中所述的 \fB<disk_name>\fR 子元素,或者使用下面“ISCSI 目标设备”中所述的 \fB<iscsi>\fR 子元素。
       
   359 .RE
       
   360 .RS +4
       
   361 .TP
       
   362 .ie t \(bu
       
   363 .el o
       
   364 第 2 组:非确定性条件,如磁盘大小或供应商。使用下面“目标设备属性”中所述的 \fB<disk_prop>\fR 子元素。
       
   365 .RE
       
   366 .RS +4
       
   367 .TP
       
   368 .ie t \(bu
       
   369 .el o
       
   370 第 3 组:关键字条件,如 \fBboot_disk\fR 关键字。使用下面“目标设备关键字”中所述的 \fB<disk_keyword>\fR 子元素。
       
   371 .RE
       
   372 .sp
       
   373 .LP
       
   374 只能从以上三组之一指定条件。如果使用第 2 组选择条件,则可以指定多个条件。例如,可以同时指定大小和供应商。如果使用第 1 组选择条件,则只能指定那些条件之一。
       
   375 .SS "目标设备名称"
       
   376 .sp
       
   377 .LP
       
   378 使用 \fBdisk_name\fR 元素可指定非 iSCSI 设备的目标设备名称。\fBdisk_name\fR 元素具有以下属性:
       
   379 .sp
       
   380 .ne 2
       
   381 .mk
       
   382 .na
       
   383 \fB\fBname\fR\fR
       
   384 .ad
       
   385 .sp .6
       
   386 .RS 4n
       
   387 \fBname\fR 属性指定目标设备的名称。
       
   388 .RE
       
   389 
       
   390 .sp
       
   391 .ne 2
       
   392 .mk
       
   393 .na
       
   394 \fB\fBname_type\fR\fR
       
   395 .ad
       
   396 .sp .6
       
   397 .RS 4n
       
   398 \fBname_type\fR 属性指定目标设备名称的类型。\fBname_type\fR 属性可以具有以下值之一:
       
   399 .sp
       
   400 .ne 2
       
   401 .mk
       
   402 .na
       
   403 \fB\fBctd\fR:控制器目标磁盘名称\fR
       
   404 .ad
       
   405 .sp .6
       
   406 .RS 4n
       
   407 这是 CTD 名称,例如 \fBc0t0d0\fR 或 \fBc0t2000002037CD9F72d0\fR。运行 \fBformat\fR(1M) 命令时,通常会看到此类型的名称。
       
   408 .sp
       
   409 .in +2
       
   410 .nf
       
   411 <disk_name name="c0t0d0" name_type="ctd"/>
       
   412 .fi
       
   413 .in -2
       
   414 
       
   415 如果省略 \fBname_type\fR 属性,则这是缺省的目标设备名称类型。
       
   416 .RE
       
   417 
       
   418 .sp
       
   419 .ne 2
       
   420 .mk
       
   421 .na
       
   422 \fB\fBvolid\fR:卷标识符\fR
       
   423 .ad
       
   424 .sp .6
       
   425 .RS 4n
       
   426 这是卷标识符,可以通过 \fBformat \fR(1M) 命令进行设置。
       
   427 .sp
       
   428 .in +2
       
   429 .nf
       
   430 <disk_name name="MY_BOOT_DISK" name_type="volid"/>
       
   431 .fi
       
   432 .in -2
       
   433 
       
   434 .RE
       
   435 
       
   436 .sp
       
   437 .ne 2
       
   438 .mk
       
   439 .na
       
   440 \fB\fBdevpath\fR:设备路径\fR
       
   441 .ad
       
   442 .sp .6
       
   443 .RS 4n
       
   444 这是相对于 \fB/devices\fR 目录的设备路径。
       
   445 .sp
       
   446 .in +2
       
   447 .nf
       
   448 <disk_name
       
   449   name="/devices/pci@0,0/pci10de,375@f/pci108e,286@0/disk@0,0"
       
   450   name_type="devpath"/>
       
   451 .fi
       
   452 .in -2
       
   453 
       
   454 .RE
       
   455 
       
   456 .sp
       
   457 .ne 2
       
   458 .mk
       
   459 .na
       
   460 \fB\fBdevid\fR:设备标识符\fR
       
   461 .ad
       
   462 .sp .6
       
   463 .RS 4n
       
   464 这是设备标识符,可在带有 \fB-iEn\fR 选项的 \fBiostat\fR(1M) 命令的输出的 "Device Id" 中找到。
       
   465 .sp
       
   466 .in +2
       
   467 .nf
       
   468 <disk_name
       
   469   name="id1,sd@TSun_____STK_RAID_INT____F0F0F0"
       
   470   name_type="devid"/>
       
   471 .fi
       
   472 .in -2
       
   473 
       
   474 .RE
       
   475 
       
   476 .sp
       
   477 .ne 2
       
   478 .mk
       
   479 .na
       
   480 \fB\fBreceptacle\fR:插口标识符\fR
       
   481 .ad
       
   482 .sp .6
       
   483 .RS 4n
       
   484 这是 CRO(Chassis, Receptacle, Occupant,机箱、插口和插卡)配置中的插口值,可在带 \fB-ocR\fR 选项的 \fBcroinfo\fR(1M) 命令的输出中找到。
       
   485 .sp
       
   486 .in +2
       
   487 .nf
       
   488 <disk_name name="SYS/1" name_type="receptacle"/>
       
   489 .fi
       
   490 .in -2
       
   491 
       
   492 .RE
       
   493 
       
   494 .RE
       
   495 
       
   496 .SS "ISCSI 目标设备"
       
   497 .sp
       
   498 .LP
       
   499 使用 \fBiscsi\fR 元素可将 iSCSI 磁盘指定为安装目标。\fBiscsi\fR 元素具有以下属性:
       
   500 .sp
       
   501 .ne 2
       
   502 .mk
       
   503 .na
       
   504 \fB\fBsource\fR\fR
       
   505 .ad
       
   506 .sp .6
       
   507 .RS 4n
       
   508 \fBsource\fR 属性指定 iSCSI 配置数据的源。\fBsource\fR 属性可以具有以下值:
       
   509 .sp
       
   510 .ne 2
       
   511 .mk
       
   512 .na
       
   513 \fB\fBmanifest\fR\fR
       
   514 .ad
       
   515 .sp .6
       
   516 .RS 4n
       
   517 此值是指此 AI 清单。如果没有为 \fBsource\fR 属性指定值,则这是缺省值。
       
   518 .sp
       
   519 省略 \fBsource\fR 属性或者 \fBsource\fR 属性的值为 \fBmanifest\fR 时,必须指定 \fBtarget_lun\fR 和 \fBtarget_ip\fR 属性。
       
   520 .RE
       
   521 
       
   522 .sp
       
   523 .ne 2
       
   524 .mk
       
   525 .na
       
   526 \fB\fBdhcp\fR\fR
       
   527 .ad
       
   528 .sp .6
       
   529 .RS 4n
       
   530 此值是指通过在 DHCP \fBrootpath\fR 参数中指定 iSCSI 信息获取该信息时使用 DHCP。
       
   531 .sp
       
   532 当 \fBsource\fR 属性的值为 \fBdhcp\fR 时,不要指定任何其他 \fBiscsi\fR 属性。
       
   533 .sp
       
   534 .in +2
       
   535 .nf
       
   536 <iscsi source="dhcp"/>
       
   537 .fi
       
   538 .in -2
       
   539 
       
   540 .RE
       
   541 
       
   542 .RE
       
   543 
       
   544 .sp
       
   545 .ne 2
       
   546 .mk
       
   547 .na
       
   548 \fB\fBtarget_ip\fR\fR
       
   549 .ad
       
   550 .sp .6
       
   551 .RS 4n
       
   552 此属性的值是 iSCSI 目标的 IP 地址。位于此 IP 地址的目标必须处于联机状态,并且可以从此系统进行访问。此属性是必需的。
       
   553 .sp
       
   554 .in +2
       
   555 .nf
       
   556 <iscsi target_lun="0" target_ip="192.168.1.34"/>
       
   557 .fi
       
   558 .in -2
       
   559 
       
   560 .RE
       
   561 
       
   562 .sp
       
   563 .ne 2
       
   564 .mk
       
   565 .na
       
   566 \fB\fBtarget_lun\fR\fR
       
   567 .ad
       
   568 .sp .6
       
   569 .RS 4n
       
   570 如果 iSCSI 目标提供了多个 LUN,则通过为 \fBtarget_lun\fR 指定一个整数值来指定要使用哪个 LUN。LUN 编号从 0 开始。要指定第一个 LUN,请将 \fBtarget_lun\fR 值指定为 0。
       
   571 .sp
       
   572 如果仅提供了一个 LUN,则可以省略此属性。如果 iSCSI 目标提供了多个 LUN,则需要此属性。
       
   573 .RE
       
   574 
       
   575 .sp
       
   576 .ne 2
       
   577 .mk
       
   578 .na
       
   579 \fB\fBtarget_name\fR\fR
       
   580 .ad
       
   581 .sp .6
       
   582 .RS 4n
       
   583 \fBtarget_name\fR 属性指定 iSCSI 目标的 iSCSI 限定名 (iSCSI Qualified Name, IQN) 或扩展唯一标识符 (Extended Unique Identifier, EUI),如以下示例所示:
       
   584 .sp
       
   585 .in +2
       
   586 .nf
       
   587 iqn.1986-03.com.sun:02:a4a694bc-6de2-ee50-8979-e25ba29acb86
       
   588 .fi
       
   589 .in -2
       
   590 
       
   591 .RE
       
   592 
       
   593 .sp
       
   594 .ne 2
       
   595 .mk
       
   596 .na
       
   597 \fB\fBtarget_port\fR\fR
       
   598 .ad
       
   599 .sp .6
       
   600 .RS 4n
       
   601 如果未指定,则使用 \fBtarget_port\fR 的缺省值 3260(iSCSI 标准端口)。通过此属性可以指定替代端口号。
       
   602 .RE
       
   603 
       
   604 .sp
       
   605 .ne 2
       
   606 .mk
       
   607 .na
       
   608 \fB\fBinitiator_name\fR\fR
       
   609 .ad
       
   610 .sp .6
       
   611 .RS 4n
       
   612 \fBinitiator_name\fR 属性指定 iSCSI 启动器的 IQN 或 EUI。
       
   613 .RE
       
   614 
       
   615 .sp
       
   616 .ne 2
       
   617 .mk
       
   618 .na
       
   619 \fBCHAP 验证\fR
       
   620 .ad
       
   621 .sp .6
       
   622 .RS 4n
       
   623 以下两个属性提供 CHAP(Challenge-Handshake Authentication Protocol,质询握手验证协议)验证:
       
   624 .sp
       
   625 .ne 2
       
   626 .mk
       
   627 .na
       
   628 \fB\fBchap_name\fR\fR
       
   629 .ad
       
   630 .sp .6
       
   631 .RS 4n
       
   632 \fBchap_name\fR 属性指定用于验证的 CHAP 用户名。
       
   633 .RE
       
   634 
       
   635 .sp
       
   636 .ne 2
       
   637 .mk
       
   638 .na
       
   639 \fB\fBchap_password\fR\fR
       
   640 .ad
       
   641 .sp .6
       
   642 .RS 4n
       
   643 \fBchap_password\fR 属性指定用于验证的 CHAP 口令。
       
   644 .RE
       
   645 
       
   646 SPARC 客户机可以在 Open Boot PROM (\fBok\fR) 提示符下选择设置 \fBchap-user\fR 和 \fB chap-password\fR。有关更多信息,请参见 \fBboot\fR(1M) 手册页中的“iSCSI 引导”。
       
   647 .RE
       
   648 
       
   649 .sp
       
   650 .LP
       
   651 \fBiscsi\fR 元素没有 \fBaction\fR 属性。AI 使用 iSCSI 设备,但不直接对其进行操作。
       
   652 .sp
       
   653 .LP
       
   654 如果未提供 \fBtarget_name\fR 属性,则 AI 在 \fBsendtargets\fR 模式下使用 \fBiscsiadm\fR(1M)。
       
   655 .sp
       
   656 .LP
       
   657 如果提供了 \fBtarget_name\fR 属性,则 AI 使用静态搜索。
       
   658 .sp
       
   659 .LP
       
   660 如果给定此信息,则可以安装 iSCSI 设备。
       
   661 .sp
       
   662 .LP
       
   663 由于 iSCSI 设备的网络接口早期已在客户机引导过程中配置,因此对于此次安装,您无需在任何系统配置文件中为此接口配置 \fBnetwork/install\fR 服务。
       
   664 .SS "目标设备属性"
       
   665 .sp
       
   666 .LP
       
   667 使用 \fBdisk_prop\fR 元素可指定目标设备的属性。可以指定多个属性。AI 将尝试基于提供的条件来查找最佳匹配。
       
   668 .sp
       
   669 .LP
       
   670 使用 \fBdisk_prop\fR 元素的属性可指定目标属性。\fBdisk_prop\fR 元素具有以下属性:
       
   671 .sp
       
   672 .ne 2
       
   673 .mk
       
   674 .na
       
   675 \fB\fBdev_type\fR:设备类型\fR
       
   676 .ad
       
   677 .sp .6
       
   678 .RS 4n
       
   679 目标磁盘的类型。可能的值包括 SCSI、ATA 和 USB。此值不区分大小写。
       
   680 .RE
       
   681 
       
   682 .sp
       
   683 .ne 2
       
   684 .mk
       
   685 .na
       
   686 \fB\fBdev_vendor\fR:设备供应商\fR
       
   687 .ad
       
   688 .sp .6
       
   689 .RS 4n
       
   690 由 \fBformat\fR(1M) 命令的 \fBinquiry\fR 菜单选项显示的供应商。
       
   691 .sp
       
   692 .in +2
       
   693 .nf
       
   694 <disk_prop dev_vendor="Sun"/>
       
   695 .fi
       
   696 .in -2
       
   697 
       
   698 .RE
       
   699 
       
   700 .sp
       
   701 .ne 2
       
   702 .mk
       
   703 .na
       
   704 \fB\fBdev_chassis\fR:设备机箱\fR
       
   705 .ad
       
   706 .sp .6
       
   707 .RS 4n
       
   708 CRO(Chassis, Receptacle, Occupant,机箱、插口、插卡)配置中的机箱值,可在带有 \fB-ocA\fR 选项的 \fBcroinfo\fR(1M) 命令的输出中找到。
       
   709 .sp
       
   710 .in +2
       
   711 .nf
       
   712 <disk_prop dev_chassis="SYS"/>
       
   713 .fi
       
   714 .in -2
       
   715 
       
   716 .RE
       
   717 
       
   718 .sp
       
   719 .ne 2
       
   720 .mk
       
   721 .na
       
   722 \fB\fBdev_size\fR:设备大小\fR
       
   723 .ad
       
   724 .sp .6
       
   725 .RS 4n
       
   726 磁盘的最小大小。其值为带有大小单位的数值。
       
   727 .sp
       
   728 .in +2
       
   729 .nf
       
   730 <disk_prop dev_size="100gb"/>
       
   731 .fi
       
   732 .in -2
       
   733 
       
   734 .RE
       
   735 
       
   736 .sp
       
   737 .LP
       
   738 \fBdisk_prop\fR 元素允许同时指定多个属性,以便进一步约束磁盘搜索。以下示例将磁盘选择限制为大小至少为 100 GB 的 Hitachi 驱动器。
       
   739 .sp
       
   740 .in +2
       
   741 .nf
       
   742 <disk_prop dev_vendor="HITACHI" dev_size="100gb"/>
       
   743 .fi
       
   744 .in -2
       
   745 
       
   746 .SS "目标设备关键字"
       
   747 .sp
       
   748 .LP
       
   749 可以使用 \fBdisk_keyword\fR 元素将系统的引导磁盘指定为目标磁盘。
       
   750 .sp
       
   751 .in +2
       
   752 .nf
       
   753 <disk_keyword key="boot_disk"/>
       
   754 .fi
       
   755 .in -2
       
   756 
       
   757 .sp
       
   758 .LP
       
   759 \fBkey\fR 属性支持的唯一值是 \fBboot_disk\fR。
       
   760 .SS "整个磁盘、分区和分片"
       
   761 .sp
       
   762 .LP
       
   763 对磁盘进行布局的最简单方法是,通过将 \fBwhole_disk\fR 属性设置为 \fBtrue\fR 将整个磁盘用于安装。
       
   764 .sp
       
   765 .LP
       
   766 对于更复杂的磁盘布局,可以指定分区(仅限 x86 系统)和分片。
       
   767 .sp
       
   768 .LP
       
   769 \fBdisk\fR 元素具有以下属性:
       
   770 .sp
       
   771 .ne 2
       
   772 .mk
       
   773 .na
       
   774 \fB\fBwhole_disk\fR\fR
       
   775 .ad
       
   776 .sp .6
       
   777 .RS 4n
       
   778 此属性的缺省值为 \fBfalse\fR。当 \fBwhole_disk\fR 为 \fBfalse\fR 时,必须定义分区或分片。除非通过为分区或分片的 \fBaction\fR 属性指定 \fBdelete\fR 值来删除任何现有的分区或分片,否则将保留它们。
       
   779 .sp
       
   780 当 \fBwhole_disk\fR 为 \fBtrue\fR 时,将删除所有的现有分区或分片。
       
   781 .sp
       
   782 以下示例指定将整个磁盘用于安装:
       
   783 .sp
       
   784 .in +2
       
   785 .nf
       
   786 <disk whole_disk="true">
       
   787   <disk_name name="c0t0d0" name_type="ctd"/>
       
   788 </disk>
       
   789 .fi
       
   790 .in -2
       
   791 
       
   792 .RE
       
   793 
       
   794 .sp
       
   795 .ne 2
       
   796 .mk
       
   797 .na
       
   798 \fB\fBin_zpool\fR\fR
       
   799 .ad
       
   800 .sp .6
       
   801 .RS 4n
       
   802 \fBin_zpool\fR 属性将此磁盘链接到在 AI 清单的 \fBlogical\fR 部分中定义的 ZFS 池。\fBin_zpool\fR 属性的值必须与对应 \fBzpool\fR 元素的 \fBname\fR 属性的值匹配。
       
   803 .sp
       
   804 如果在此处指定了 \fBin_zpool\fR 属性,则不要为任何从属分区或分片指定 \fBin_zpool\fR。
       
   805 .RE
       
   806 
       
   807 .sp
       
   808 .ne 2
       
   809 .mk
       
   810 .na
       
   811 \fB\fBin_vdev\fR\fR
       
   812 .ad
       
   813 .sp .6
       
   814 .RS 4n
       
   815 \fBin_vdev\fR 属性将此磁盘链接到在 AI 清单的 \fBlogical\fR 部分中定义的虚拟设备。\fBin_vdev\fR 属性的值必须与对应 \fBvdev\fR 元素的 \fBname\fR 属性的值匹配。
       
   816 .sp
       
   817 如果在此处指定了 \fBin_vdev\fR 属性,则不要为任何从属分区或分片指定 \fBin_vdev\fR。
       
   818 .RE
       
   819 
       
   820 .SS "GPT 分区"
       
   821 .sp
       
   822 .LP
       
   823 GUID 分区表分区是首选的 x86 和 SPARC 分区方法。GPT 分区可供 ZFS 直接使用,而不需要分片。\fBgpt_partition\fR 元素具有以下属性:
       
   824 .sp
       
   825 .ne 2
       
   826 .mk
       
   827 .na
       
   828 \fB\fBname\fR\fR
       
   829 .ad
       
   830 .sp .6
       
   831 .RS 4n
       
   832 \fBname\fR 属性是 GPT 分区编号。Oracle Solaris 中的有效值是 0-7。
       
   833 .sp
       
   834 \fBname\fR 属性是必需的。
       
   835 .RE
       
   836 
       
   837 .sp
       
   838 .ne 2
       
   839 .mk
       
   840 .na
       
   841 \fB\fBaction\fR\fR
       
   842 .ad
       
   843 .sp .6
       
   844 .RS 4n
       
   845 \fBaction\fR 属性可以具有以下值:
       
   846 .sp
       
   847 .ne 2
       
   848 .mk
       
   849 .na
       
   850 \fB\fBcreate\fR\fR
       
   851 .ad
       
   852 .sp .6
       
   853 .RS 4n
       
   854 这是分区的缺省操作。\fBcreate\fR 操作通知安装程序创建具有指定名称的分区。如果已存在同名分区,则首先删除该现有分区。
       
   855 .RE
       
   856 
       
   857 .sp
       
   858 .ne 2
       
   859 .mk
       
   860 .na
       
   861 \fB\fBdelete\fR\fR
       
   862 .ad
       
   863 .sp .6
       
   864 .RS 4n
       
   865 \fBdelete\fR 操作通知安装程序删除指定的分区。如果指定的分区不存在,则跳过 \fBdelete\fR 操作,并输出一条警告消息。
       
   866 .RE
       
   867 
       
   868 .sp
       
   869 .ne 2
       
   870 .mk
       
   871 .na
       
   872 \fB\fBpreserve\fR\fR
       
   873 .ad
       
   874 .sp .6
       
   875 .RS 4n
       
   876 \fBpreserve\fR 操作通知安装程序使指定的分区保持不变。如果在同一磁盘上的其他位置安装了其他操作系统,则通常使用此操作。
       
   877 .RE
       
   878 
       
   879 .RE
       
   880 
       
   881 .sp
       
   882 .ne 2
       
   883 .mk
       
   884 .na
       
   885 \fB\fBpart_type\fR\fR
       
   886 .ad
       
   887 .sp .6
       
   888 .RS 4n
       
   889 \fBpart_type\fR 属性指定 GUID 分区类型。值可以是支持的 GUID 别名(如 \fBsolaris \fR)或明确的 GUID 十六进制字符串值。
       
   890 .sp
       
   891 \fBpart_type\fR 属性是必需的。
       
   892 .RE
       
   893 
       
   894 .sp
       
   895 .ne 2
       
   896 .mk
       
   897 .na
       
   898 \fB\fBin_zpool\fR\fR
       
   899 .ad
       
   900 .sp .6
       
   901 .RS 4n
       
   902 \fBin_zpool\fR 属性将此分区链接到在 AI 清单的 \fBlogical\fR 部分中定义的 ZFS 池。\fBin_zpool\fR 属性的值必须与对应 \fBzpool\fR 元素的 \fBname\fR 属性的值匹配。
       
   903 .sp
       
   904 如果指定了 \fBin_zpool\fR 属性,则不要为关联的 \fBdisk\fR 元素或任何从属的 \fBslice\fR 元素指定 \fBin_zpool\fR。
       
   905 .RE
       
   906 
       
   907 .sp
       
   908 .ne 2
       
   909 .mk
       
   910 .na
       
   911 \fB\fBin_vdev\fR\fR
       
   912 .ad
       
   913 .sp .6
       
   914 .RS 4n
       
   915 \fBin_vdev\fR 属性将此分区链接到在 AI 清单的 \fBlogical\fR 部分中定义的虚拟设备。\fBin_vdev\fR 属性的值必须与对应 \fBvdev\fR 元素的 \fBname\fR 属性的值匹配。
       
   916 .sp
       
   917 如果指定了 \fBin_vdev\fR 属性,则不要为关联的 \fBdisk\fR 元素或任何从属的 \fBslice\fR 元素指定 \fBin_vdev\fR。
       
   918 .RE
       
   919 
       
   920 .sp
       
   921 .LP
       
   922 GPT 分区可以使用 \fBsize\fR 子元素指定分区的大小。有关如何使用 \fBsize\fR 元素的详细信息,请参见“磁盘布局”部分的开头。如果指定了分区的大小,\fBsize\fR 子元素必须优先于 \fBpartition\fR 元素中的任何 \fBslice\fR 子元素。
       
   923 .SS "传统分区"
       
   924 .sp
       
   925 .LP
       
   926 只能在安装到 x86 系统时指定传统 \fBfdisk\fR 分区。如果为 SPARC 系统指定了 \fBfdisk\fR 分区,则安装会失败。\fBpartition\fR 元素用于 \fBfdisk\fR 分区。\fBpartition\fR 元素具有以下属性:
       
   927 .sp
       
   928 .ne 2
       
   929 .mk
       
   930 .na
       
   931 \fB\fBname\fR\fR
       
   932 .ad
       
   933 .sp .6
       
   934 .RS 4n
       
   935 \fBname\fR 属性是 \fBfdisk\fR 分区编号。值 1、2、3 和 4 为主要分区。如果主要分区之一为扩展分区,则可以为逻辑分区指定值 5 到 32。
       
   936 .sp
       
   937 除非指定的 \fBaction\fR 为 \fBuse_existing_solaris2\fR,否则 \fBname\fR 属性是必需的。
       
   938 .RE
       
   939 
       
   940 .sp
       
   941 .ne 2
       
   942 .mk
       
   943 .na
       
   944 \fB\fBaction\fR\fR
       
   945 .ad
       
   946 .sp .6
       
   947 .RS 4n
       
   948 \fBaction\fR 属性可以具有以下值:
       
   949 .sp
       
   950 .ne 2
       
   951 .mk
       
   952 .na
       
   953 \fB\fBcreate\fR\fR
       
   954 .ad
       
   955 .sp .6
       
   956 .RS 4n
       
   957 这是分区的缺省操作。\fBcreate\fR 操作通知安装程序创建具有指定名称的分区。如果已存在同名分区,则首先删除该现有分区。
       
   958 .RE
       
   959 
       
   960 .sp
       
   961 .ne 2
       
   962 .mk
       
   963 .na
       
   964 \fB\fBdelete\fR\fR
       
   965 .ad
       
   966 .sp .6
       
   967 .RS 4n
       
   968 \fBdelete\fR 操作通知安装程序删除指定的分区。如果指定的分区不存在,则跳过 \fBdelete\fR 操作,并输出一条警告消息。
       
   969 .RE
       
   970 
       
   971 .sp
       
   972 .ne 2
       
   973 .mk
       
   974 .na
       
   975 \fB\fBpreserve\fR\fR
       
   976 .ad
       
   977 .sp .6
       
   978 .RS 4n
       
   979 \fBpreserve\fR 操作通知安装程序使指定的分区保持不变。如果在同一磁盘上的其他位置安装了其他操作系统,则通常使用此操作。
       
   980 .RE
       
   981 
       
   982 .sp
       
   983 .ne 2
       
   984 .mk
       
   985 .na
       
   986 \fB\fBuse_existing_solaris2\fR\fR
       
   987 .ad
       
   988 .sp .6
       
   989 .RS 4n
       
   990 \fBuse_existing_solaris2\fR 操作通知安装程序使用现有的 Solaris2 分区。安装程序将搜索现有的 Solaris2 分区。
       
   991 .sp
       
   992 指定了 \fBuse_existing_solaris2\fR 时,会忽略 \fBname\fR 和 \fBpart_type\fR 属性。
       
   993 .RE
       
   994 
       
   995 .RE
       
   996 
       
   997 .sp
       
   998 .ne 2
       
   999 .mk
       
  1000 .na
       
  1001 \fB\fBpart_type\fR\fR
       
  1002 .ad
       
  1003 .sp .6
       
  1004 .RS 4n
       
  1005 \fBpart_type\fR 是 \fBfdisk\fR 分区类型。缺省值为 191,这是 Solaris2 分区的分区类型。有关可能的分区类型的更多信息,请参见 \fBfdisk\fR(1M) 手册页。
       
  1006 .RE
       
  1007 
       
  1008 .sp
       
  1009 .ne 2
       
  1010 .mk
       
  1011 .na
       
  1012 \fB\fBin_zpool\fR\fR
       
  1013 .ad
       
  1014 .sp .6
       
  1015 .RS 4n
       
  1016 \fBin_zpool\fR 属性将此分区链接到在 AI 清单的 \fBlogical\fR 部分中定义的 ZFS 池。\fBin_zpool\fR 属性的值必须与对应 \fBzpool\fR 元素的 \fBname\fR 属性的值匹配。
       
  1017 .sp
       
  1018 如果指定了 \fBin_zpool\fR 属性,则不要为关联的 \fBdisk\fR 元素或任何从属的 \fBslice\fR 元素指定 \fBin_zpool\fR。
       
  1019 .RE
       
  1020 
       
  1021 .sp
       
  1022 .ne 2
       
  1023 .mk
       
  1024 .na
       
  1025 \fB\fBin_vdev\fR\fR
       
  1026 .ad
       
  1027 .sp .6
       
  1028 .RS 4n
       
  1029 \fBin_vdev\fR 属性将此分区链接到在 AI 清单的 \fBlogical\fR 部分中定义的虚拟设备。\fBin_vdev\fR 属性的值必须与对应 \fBvdev\fR 元素的 \fBname\fR 属性的值匹配。
       
  1030 .sp
       
  1031 如果指定了 \fBin_vdev\fR 属性,则不要为关联的 \fBdisk\fR 元素或任何从属的 \fBslice\fR 元素指定 \fBin_vdev\fR。
       
  1032 .RE
       
  1033 
       
  1034 .sp
       
  1035 .LP
       
  1036 分区可以具有 \fBsize\fR 子元素以指定分区的大小。有关如何使用 \fBsize\fR 元素的详细信息,请参见“磁盘布局”部分的开头。如果指定了分区的大小,\fBsize\fR 子元素必须优先于 \fBpartition\fR 元素中的任何 \fBslice\fR 子元素。
       
  1037 .sp
       
  1038 .LP
       
  1039 以下示例使用缺省属性值创建一个 10 GB Solaris2 分区:
       
  1040 .sp
       
  1041 .in +2
       
  1042 .nf
       
  1043 <disk>
       
  1044   <disk_name name="c0t0d0" name_type="ctd"/>
       
  1045   <partition name="1">
       
  1046     <size val="10gb"/>
       
  1047   </partition>
       
  1048 </disk>
       
  1049 .fi
       
  1050 .in -2
       
  1051 
       
  1052 .sp
       
  1053 .LP
       
  1054 如果未指定大小,则使用父元素的大小。
       
  1055 .sp
       
  1056 .LP
       
  1057 \fBpreserve\fR、\fBdelete\fR 和 \fBuse_existing_solaris2\fR 操作不需要指定 \fBsize\fR。
       
  1058 .SS "分片"
       
  1059 .sp
       
  1060 .LP
       
  1061 对于 x86 系统,分片必须包含在分区定义内。
       
  1062 .sp
       
  1063 .LP
       
  1064 \fBslice\fR 元素具有以下属性:
       
  1065 .sp
       
  1066 .ne 2
       
  1067 .mk
       
  1068 .na
       
  1069 \fB\fBname\fR\fR
       
  1070 .ad
       
  1071 .sp .6
       
  1072 .RS 4n
       
  1073 \fBname\fR 属性是分片编号。其值可以为 0 到 7。
       
  1074 .RE
       
  1075 
       
  1076 .sp
       
  1077 .ne 2
       
  1078 .mk
       
  1079 .na
       
  1080 \fB\fBaction\fR\fR
       
  1081 .ad
       
  1082 .sp .6
       
  1083 .RS 4n
       
  1084 \fBaction\fR 属性可以具有以下值:
       
  1085 .sp
       
  1086 .ne 2
       
  1087 .mk
       
  1088 .na
       
  1089 \fB\fBcreate\fR\fR
       
  1090 .ad
       
  1091 .sp .6
       
  1092 .RS 4n
       
  1093 这是分片的缺省操作。\fBcreate\fR 操作通知安装程序创建具有指定名称的分片。如果已存在同名分片,则首先删除该现有分片。
       
  1094 .RE
       
  1095 
       
  1096 .sp
       
  1097 .ne 2
       
  1098 .mk
       
  1099 .na
       
  1100 \fB\fBdelete\fR\fR
       
  1101 .ad
       
  1102 .sp .6
       
  1103 .RS 4n
       
  1104 \fBdelete\fR 操作通知安装程序删除指定的分片。如果指定的分片不存在,则跳过 \fBdelete\fR 操作,并输出一条警告消息。
       
  1105 .RE
       
  1106 
       
  1107 .sp
       
  1108 .ne 2
       
  1109 .mk
       
  1110 .na
       
  1111 \fB\fBpreserve\fR\fR
       
  1112 .ad
       
  1113 .sp .6
       
  1114 .RS 4n
       
  1115 \fBpreserve\fR 操作通知安装程序使指定的分片保持不变。当存在来自以前安装的数据时,通常使用此操作。
       
  1116 .RE
       
  1117 
       
  1118 .RE
       
  1119 
       
  1120 .sp
       
  1121 .ne 2
       
  1122 .mk
       
  1123 .na
       
  1124 \fB\fBis_swap\fR\fR
       
  1125 .ad
       
  1126 .sp .6
       
  1127 .RS 4n
       
  1128 此属性的缺省值为 \fBfalse\fR。当 \fBis_swap\fR 为 \fBfalse\fR 时,安装程序将在根池中创建一个交换卷。
       
  1129 .sp
       
  1130 当 \fBis_swap\fR 为 \fBtrue\fR 时,指定的分片将用作交换设备。当 \fBis_swap\fR 为 \fBtrue\fR 时,不要使用 \fBin_zpool\fR 或 \fBin_vdev\fR 属性。
       
  1131 .RE
       
  1132 
       
  1133 .sp
       
  1134 .ne 2
       
  1135 .mk
       
  1136 .na
       
  1137 \fB\fBforce\fR\fR
       
  1138 .ad
       
  1139 .sp .6
       
  1140 .RS 4n
       
  1141 此属性的缺省值为 \fBfalse\fR。
       
  1142 .sp
       
  1143 当 \fBforce\fR 为 \fBtrue\fR 时,安装程序将忽略可能已在使用中的任何现有分片(例如,在现有的 ZFS 存储池中使用的分片),并继续对指定的分片执行指定的操作。
       
  1144 .RE
       
  1145 
       
  1146 .sp
       
  1147 .ne 2
       
  1148 .mk
       
  1149 .na
       
  1150 \fB\fBin_zpool\fR\fR
       
  1151 .ad
       
  1152 .sp .6
       
  1153 .RS 4n
       
  1154 \fBin_zpool\fR 属性将此分片链接到在 AI 清单的 \fBlogical\fR 部分中定义的 ZFS 池。\fBin_zpool\fR 属性的值必须与对应 \fBzpool\fR 元素的 \fBname\fR 属性的值匹配。
       
  1155 .sp
       
  1156 如果指定了 \fBin_zpool\fR 属性,则不要为关联的 \fBpartition\fR 或 \fBdisk\fR 元素指定 \fBin_zpool\fR。
       
  1157 .RE
       
  1158 
       
  1159 .sp
       
  1160 .ne 2
       
  1161 .mk
       
  1162 .na
       
  1163 \fB\fBin_vdev\fR\fR
       
  1164 .ad
       
  1165 .sp .6
       
  1166 .RS 4n
       
  1167 \fBin_vdev\fR 属性将此分片链接到在 AI 清单的 \fBlogical\fR 部分中定义的虚拟设备。\fBin_vdev\fR 属性的值必须与对应 \fBvdev\fR 元素的 \fBname\fR 属性的值匹配。
       
  1168 .sp
       
  1169 如果指定了 \fBin_vdev\fR 属性,则不要为关联的 \fBpartition\fR 或 \fBdisk\fR 元素指定 \fBin_vdev\fR。
       
  1170 .RE
       
  1171 
       
  1172 .sp
       
  1173 .LP
       
  1174 分片可以具有 \fBsize\fR 子元素以指定分片的大小。有关如何使用 \fBsize\fR 元素的详细信息,请参见“磁盘布局”部分的开头。如果未指定大小,则使用父元素的大小。
       
  1175 .sp
       
  1176 .LP
       
  1177 以下示例为 SPARC 系统创建一个 20 GB 分片(使用缺省属性值)和一个 4 GB 交换分片:
       
  1178 .sp
       
  1179 .in +2
       
  1180 .nf
       
  1181 <disk>
       
  1182   <disk_name name="c0t0d0" name_type="ctd"/>
       
  1183   <slice name="0">
       
  1184     <size val="20gb"/>
       
  1185   </slice>
       
  1186   <slice name="1" is_swap="true">
       
  1187     <size val="4gb"/>
       
  1188   </slice>
       
  1189 </disk>
       
  1190 .fi
       
  1191 .in -2
       
  1192 
       
  1193 .sp
       
  1194 .LP
       
  1195 以下示例是用于 x86 系统的相同示例:
       
  1196 .sp
       
  1197 .in +2
       
  1198 .nf
       
  1199 <disk>
       
  1200   <disk_name name="c0t0d0" name_type="ctd"/>
       
  1201   <partition name="1">
       
  1202     <slice name="0">
       
  1203       <size val="20gb"/>
       
  1204     </slice>
       
  1205     <slice name="1" is_swap="true">
       
  1206       <size val="4gb"/>
       
  1207     </slice>
       
  1208   </partition>
       
  1209 </disk>
       
  1210 .fi
       
  1211 .in -2
       
  1212 
       
  1213 .SS "交换和转储"
       
  1214 .sp
       
  1215 .LP
       
  1216 通过将 \fBslice\fR 元素的 \fBis_swap\fR 属性设置为 \fBtrue\fR,可以显式定义交换分片,如上面的“分片”所示。
       
  1217 .sp
       
  1218 .LP
       
  1219 通过将 \fBzvol\fR 元素的 \fBuse\fR 属性设置为 \fBswap\fR 或 \fBdump\fR,可以将池中的卷显式定义为交换卷或转储卷,如下面的“ZFS 卷”所示。
       
  1220 .sp
       
  1221 .LP
       
  1222 缺省情况下,如果空间可用,则自动创建交换卷和转储卷。
       
  1223 .sp
       
  1224 .LP
       
  1225 在内存较低的系统上,交换分片可能比交换卷更可取,因为卷会导致少量内存开销。
       
  1226 .sp
       
  1227 .LP
       
  1228 如果要显式指定交换或转储但不希望自动创建交换卷或转储卷,请将 \fBlogical\fR 元素的以下属性设置为 \fBtrue\fR:
       
  1229 .sp
       
  1230 .ne 2
       
  1231 .mk
       
  1232 .na
       
  1233 \fB\fBnoswap\fR\fR
       
  1234 .ad
       
  1235 .sp .6
       
  1236 .RS 4n
       
  1237 此属性的缺省值为 \fBfalse\fR。当 \fBnoswap\fR 为 \fBfalse\fR 时,如果空间允许,则安装程序将在根池中自动创建交换卷。
       
  1238 .sp
       
  1239 当 \fBnoswap\fR 为 \fBtrue\fR 时,不会自动创建交换卷。
       
  1240 .RE
       
  1241 
       
  1242 .sp
       
  1243 .ne 2
       
  1244 .mk
       
  1245 .na
       
  1246 \fB\fBnodump\fR\fR
       
  1247 .ad
       
  1248 .sp .6
       
  1249 .RS 4n
       
  1250 此属性的缺省值为 \fBfalse\fR。当 \fBnodump\fR 为 \fBfalse\fR 时,如果空间允许,则安装程序将在根池中自动创建转储卷。
       
  1251 .sp
       
  1252 当 \fBnodump\fR 为 \fBtrue\fR 时,不会自动创建转储卷。
       
  1253 .RE
       
  1254 
       
  1255 .SS "ZFS 存储池"
       
  1256 .sp
       
  1257 .LP
       
  1258 使用 \fBtarget\fR 部分的 \fBlogical\fR 部分可指定任意数目的 ZFS 存储池。
       
  1259 .sp
       
  1260 .LP
       
  1261 通过使用 \fBlogical\fR 元素的 \fBzpool\fR 子元素,可以定义多个池。只有其中的一个池可以是根池。如果定义多个根池,则安装会失败。
       
  1262 .sp
       
  1263 .LP
       
  1264 如果 \fBzpool\fR 元素定义了一个根池,而在 AI 清单中未指定目标磁盘、分区或分片(GPT 或 \fBfdisk\fR),则安装程序将按照上面的“安装位置”中所述选择一个目标。此选择将自动指定给根池。
       
  1265 .sp
       
  1266 .LP
       
  1267 如果在 AI 清单中指定了目标磁盘、分区(GPT 或 \fBfdisk\fR)或分片,则 \fBzpool\fR 必须与其中至少一个磁盘、分区(GPT 或 \fBfdisk\fR)或分片关联。要建立此关联,请使用 \fBdisk\fR 元素、\fBgpt_partition\fR 元素、\fBpartition\fR 元素或 \fBslice\fR 元素的 \fBin_zpool\fR 属性。
       
  1268 .sp
       
  1269 .LP
       
  1270 \fBzpool\fR 元素具有以下属性:
       
  1271 .sp
       
  1272 .ne 2
       
  1273 .mk
       
  1274 .na
       
  1275 \fB\fBname\fR\fR
       
  1276 .ad
       
  1277 .sp .6
       
  1278 .RS 4n
       
  1279 这是新池的名称。此值必须是可以传递给 \fBzpool create\fR 命令的名称。
       
  1280 .sp
       
  1281 此名称可以用作 \fBdisk\fR、\fBgpt_partition\fR、\fBpartition\fR 或 \fBslice\fR 元素的 \fBin_zpool\fR 属性的值,以将该磁盘、GPT 分区、\fBfdisk\fR 分区或分片定义为 \fBzpool\fR 中的成员设备。
       
  1282 .RE
       
  1283 
       
  1284 .sp
       
  1285 .ne 2
       
  1286 .mk
       
  1287 .na
       
  1288 \fB\fBaction\fR\fR
       
  1289 .ad
       
  1290 .sp .6
       
  1291 .RS 4n
       
  1292 \fBaction\fR 属性可以具有以下值:
       
  1293 .sp
       
  1294 .ne 2
       
  1295 .mk
       
  1296 .na
       
  1297 \fB\fBcreate\fR\fR
       
  1298 .ad
       
  1299 .sp .6
       
  1300 .RS 4n
       
  1301 这是 \fBzpool\fR 的缺省操作。\fBcreate\fR 操作通知安装程序创建具有指定名称的池。
       
  1302 .RE
       
  1303 
       
  1304 .sp
       
  1305 .ne 2
       
  1306 .mk
       
  1307 .na
       
  1308 \fB\fBdelete\fR\fR
       
  1309 .ad
       
  1310 .sp .6
       
  1311 .RS 4n
       
  1312 \fBdelete\fR 操作通知安装程序删除指定的池。
       
  1313 .RE
       
  1314 
       
  1315 .sp
       
  1316 .ne 2
       
  1317 .mk
       
  1318 .na
       
  1319 \fB\fBpreserve\fR\fR
       
  1320 .ad
       
  1321 .sp .6
       
  1322 .RS 4n
       
  1323 \fBpreserve\fR 操作通知安装程序使指定的池保持不变。只能为非根池指定此操作。
       
  1324 .sp
       
  1325 .LP
       
  1326 在以下情况下,\fBaction\fR 属性的值必须为 \fBpreserve\fR:
       
  1327 .RS +4
       
  1328 .TP
       
  1329 .ie t \(bu
       
  1330 .el o
       
  1331 任何从属 \fBfilesystem\fR 的 \fBaction\fR 属性值为 \fBpreserve\fR。
       
  1332 .RE
       
  1333 .RS +4
       
  1334 .TP
       
  1335 .ie t \(bu
       
  1336 .el o
       
  1337 任何从属 \fBzvol\fR 的 \fBaction\fR 属性值为 \fBpreserve\fR。
       
  1338 .RE
       
  1339 .RS +4
       
  1340 .TP
       
  1341 .ie t \(bu
       
  1342 .el o
       
  1343 任何从属 \fBzvol\fR 的 \fBaction\fR 属性值为 \fBuse_existing\fR。
       
  1344 .RE
       
  1345 .RE
       
  1346 
       
  1347 .sp
       
  1348 .ne 2
       
  1349 .mk
       
  1350 .na
       
  1351 \fB\fBuse_existing\fR\fR
       
  1352 .ad
       
  1353 .sp .6
       
  1354 .RS 4n
       
  1355 \fBuse_existing\fR 操作通知安装程序安装到现有的根池。将保留任何现有的卷或文件系统(数据集)。
       
  1356 .RE
       
  1357 
       
  1358 .RE
       
  1359 
       
  1360 .sp
       
  1361 .ne 2
       
  1362 .mk
       
  1363 .na
       
  1364 \fB\fBis_root\fR\fR
       
  1365 .ad
       
  1366 .sp .6
       
  1367 .RS 4n
       
  1368 此属性的缺省值为 \fBfalse\fR。当 \fBis_root\fR 为 \fBfalse\fR 时,将定义一个数据池。
       
  1369 .sp
       
  1370 当 \fBis_root\fR 为 \fBtrue\fR 时,将在指定的池中创建新引导环境。
       
  1371 .RE
       
  1372 
       
  1373 .sp
       
  1374 .ne 2
       
  1375 .mk
       
  1376 .na
       
  1377 \fB\fBmountpoint\fR\fR
       
  1378 .ad
       
  1379 .sp .6
       
  1380 .RS 4n
       
  1381 \fBmountpoint\fR 属性指定池的顶层文件系统的挂载点。缺省挂载点为  \fB/\fIpoolname\fR\fR。挂载点必须是绝对路径。
       
  1382 .RE
       
  1383 
       
  1384 .sp
       
  1385 .LP
       
  1386 要对新池设置 ZFS 属性,请使用 \fBpool_options\fR 元素。同样,要对自动创建的 ZFS 数据集设置 ZFS 属性,请使用 \fBdataset_options\fR 元素。\fBpool_options\fR 和 \fBdataset_options\fR 元素都具有 \fBoption\fR 子元素。每个 \fBoption\fR 元素都具有 \fBname\fR 属性和 \fBvalue\fR 属性。使用这些名称/值对设置的属性所受的限制与 \fBzpool\fR(1M) 命令强制实施的限制相同。以下示例显示如何设置这些属性:
       
  1387 .sp
       
  1388 .in +2
       
  1389 .nf
       
  1390 <logical>
       
  1391   <zpool name="rpool" is_root="true">
       
  1392     <pool_options>
       
  1393       <option name="listsnaps" value="on"/>
       
  1394       <option name="delegation" value="off"/>
       
  1395     </pool_options>
       
  1396     <dataset_options>
       
  1397       <option name="atime" value="on"/>
       
  1398       <option name="compression" value="on"/>
       
  1399     </dataset_options>
       
  1400   </zpool>
       
  1401 </logical>
       
  1402 .fi
       
  1403 .in -2
       
  1404 
       
  1405 .sp
       
  1406 .LP
       
  1407 可以为池定义任意数目的虚拟设备冗余组(\fBvdev\fR 元素)、ZFS 数据集(\fBfilesystem\fR 元素)或 ZFS 卷(\fBzvol\fR 元素)。可以为池指定引导环境(\fBbe\fR 元素)。以下部分介绍 \fBvdev\fR、\fBfilesystem\fR、\fBzvol\fR 和 \fBbe\fR 元素。
       
  1408 .SS "虚拟设备冗余组"
       
  1409 .sp
       
  1410 .LP
       
  1411 使用 \fBvdev\fR 元素可定义 \fBzpool\fR 的大小或结构。可以指定多个 \fBvdev\fR 元素,每个元素具有不同的冗余类型。
       
  1412 .sp
       
  1413 .LP
       
  1414 如果 \fBzpool\fR 包含多个 \fBvdev\fR 元素,则必须在使用 \fBin_zpool\fR 属性定义的任何 \fBdisk\fR、\fBgpt_partition\fR、\fBpartition\fR 元素或 \fBslice\fR 元素上使用 \fBin_vdev\fR 属性。
       
  1415 .sp
       
  1416 .LP
       
  1417 如果 \fBvdev\fR 名称在整个 AI 清单中是唯一的,则可以在磁盘、GPT 分区、\fBfdisk\fR 分区或分片上省略 \fBin_zpool\fR 属性。
       
  1418 .sp
       
  1419 .LP
       
  1420 如果 \fBzpool\fR 仅包含一个 \fBvdev\fR 元素,则可以在 \fBdisk\fR、\fBgpt_partition\fR、\fBpartition\fR 或 \fBslice\fR 上省略 \fBin_vdev\fR 属性。
       
  1421 .sp
       
  1422 .LP
       
  1423 \fBvdev\fR 元素具有以下属性:
       
  1424 .sp
       
  1425 .ne 2
       
  1426 .mk
       
  1427 .na
       
  1428 \fB\fBname\fR\fR
       
  1429 .ad
       
  1430 .sp .6
       
  1431 .RS 4n
       
  1432 这是新 \fBvdev\fR 的名称。
       
  1433 .sp
       
  1434 此名称应该用作 \fBdisk\fR、\fBgpt_partition\fR、\fBpartition\fR 或 \fBslice\fR 元素的 \fBin_vdev\fR 属性的值,以将该磁盘、分区(GPT 或 \fBfdisk\fR)或分片定义为 \fB vdev\fR 中的成员设备。
       
  1435 .RE
       
  1436 
       
  1437 .sp
       
  1438 .ne 2
       
  1439 .mk
       
  1440 .na
       
  1441 \fB\fBredundancy\fR\fR
       
  1442 .ad
       
  1443 .sp .6
       
  1444 .RS 4n
       
  1445 \fBredundancy\fR 属性可以具有以下值:
       
  1446 .sp
       
  1447 .ne 2
       
  1448 .mk
       
  1449 .na
       
  1450 \fB\fBmirror\fR\fR
       
  1451 .ad
       
  1452 .sp .6
       
  1453 .RS 4n
       
  1454 这是缺省值。如果 \fBredundancy\fR 为 \fBmirror\fR 或者未指定,则将包含的所有设备视为彼此的镜像。
       
  1455 .RE
       
  1456 
       
  1457 .sp
       
  1458 .ne 2
       
  1459 .mk
       
  1460 .na
       
  1461 \fB\fBraidz\fR、\fBraidz1\fR、\fBraidz2\fR、\fBraidz3\fR\fR
       
  1462 .ad
       
  1463 .sp .6
       
  1464 .RS 4n
       
  1465 组中具有这些值之一的设备用于定义 RAIDZ 分组。
       
  1466 .RE
       
  1467 
       
  1468 .sp
       
  1469 .ne 2
       
  1470 .mk
       
  1471 .na
       
  1472 \fB\fBspare\fR\fR
       
  1473 .ad
       
  1474 .sp .6
       
  1475 .RS 4n
       
  1476 如果发生故障,则将此组中的设备视为热备件。
       
  1477 .RE
       
  1478 
       
  1479 .sp
       
  1480 .ne 2
       
  1481 .mk
       
  1482 .na
       
  1483 \fB\fBcache\fR\fR
       
  1484 .ad
       
  1485 .sp .6
       
  1486 .RS 4n
       
  1487 此组中的设备为池提供缓存。
       
  1488 .RE
       
  1489 
       
  1490 .sp
       
  1491 .ne 2
       
  1492 .mk
       
  1493 .na
       
  1494 \fB\fBlog\fR、\fBlogmirror\fR\fR
       
  1495 .ad
       
  1496 .sp .6
       
  1497 .RS 4n
       
  1498 此组中的设备用于日志记录。如果指定了 \fBlogmirror\fR,则设备为镜像。
       
  1499 .RE
       
  1500 
       
  1501 .sp
       
  1502 .ne 2
       
  1503 .mk
       
  1504 .na
       
  1505 \fB\fBnone\fR\fR
       
  1506 .ad
       
  1507 .sp .6
       
  1508 .RS 4n
       
  1509 当 \fBredundancy\fR 为 \fBnone\fR 时,不定义冗余。如果此组中包括多个设备,则条带化这些设备。
       
  1510 .RE
       
  1511 
       
  1512 可以将根池定义为仅具有以下配置之一:
       
  1513 .RS +4
       
  1514 .TP
       
  1515 .ie t \(bu
       
  1516 .el o
       
  1517 \fBredundancy\fR 类型为 \fBnone\fR,包括一个设备。此配置不支持使用多个设备。
       
  1518 .RE
       
  1519 .RS +4
       
  1520 .TP
       
  1521 .ie t \(bu
       
  1522 .el o
       
  1523 \fBredundancy\fR 类型为 \fBmirror\fR,包括多个设备。
       
  1524 .RE
       
  1525 .RE
       
  1526 
       
  1527 .sp
       
  1528 .LP
       
  1529 要将设备添加到 \fBvdev\fR,请使用 \fBdisk\fR、\fBgpt_partition \fR、\fBpartition\fR 或 \fBslice\fR 元素的 \fBin_zpool\fR 和 \fBin_vdev\fR 属性。以下示例指定一个名为 \fBrpool\fR 的根池,在两个磁盘上进行镜像:
       
  1530 .sp
       
  1531 .in +2
       
  1532 .nf
       
  1533 <disk whole_disk="true" in_zpool="rpool" in_vdev="mirrored">
       
  1534   <disk_name name="c0t0d0" name_type="ctd"/>
       
  1535 </disk>
       
  1536 <disk whole_disk="true" in_zpool="rpool" in_vdev="mirrored">
       
  1537   <disk_name name="c1t0d0" name_type="ctd"/>
       
  1538 </disk>
       
  1539 <logical>
       
  1540   <zpool name="rpool" is_root="true">
       
  1541     <vdev name="mirrored" redundancy="mirror"/>
       
  1542   </zpool>
       
  1543 </logical>
       
  1544 .fi
       
  1545 .in -2
       
  1546 
       
  1547 .sp
       
  1548 .LP
       
  1549 如果 \fBin_zpool\fR 或 \fBin_vdev\fR 属性引用的池或虚拟设备是明确的,则可以省略其中一个属性。
       
  1550 .SS "文件系统(数据集)"
       
  1551 .sp
       
  1552 .LP
       
  1553 使用 \fBfilesystem\fR 元素可定义 ZFS 池内的 ZFS 文件系统或数据集。
       
  1554 .sp
       
  1555 .LP
       
  1556 \fBfilesystem\fR 元素具有以下属性:
       
  1557 .sp
       
  1558 .ne 2
       
  1559 .mk
       
  1560 .na
       
  1561 \fB\fBname\fR\fR
       
  1562 .ad
       
  1563 .sp .6
       
  1564 .RS 4n
       
  1565 这是新 \fBfilesystem\fR(相对于 \fBzpool\fR)的名称。例如,如果在名为 \fBrpool\fR 的 \fBzpool\fR 中将 \fBfilesystem\fR 命名为 \fBexport\fR,则 ZFS 数据集名称为 \fBrpool/export\fR。
       
  1566 .sp
       
  1567 如果 \fBfilesystem\fR 的 \fBin_be\fR 属性设置为 \fBtrue\fR,则此名称相对于引导环境的根数据集。
       
  1568 .RE
       
  1569 
       
  1570 .sp
       
  1571 .ne 2
       
  1572 .mk
       
  1573 .na
       
  1574 \fB\fBaction\fR\fR
       
  1575 .ad
       
  1576 .sp .6
       
  1577 .RS 4n
       
  1578 \fBaction\fR 属性可以具有以下值:
       
  1579 .sp
       
  1580 .ne 2
       
  1581 .mk
       
  1582 .na
       
  1583 \fB\fBcreate\fR\fR
       
  1584 .ad
       
  1585 .sp .6
       
  1586 .RS 4n
       
  1587 这是 \fBfilesystem\fR 的缺省操作。\fBcreate\fR 操作通知安装程序创建具有指定名称的文件系统。
       
  1588 .RE
       
  1589 
       
  1590 .sp
       
  1591 .ne 2
       
  1592 .mk
       
  1593 .na
       
  1594 \fB\fBdelete\fR\fR
       
  1595 .ad
       
  1596 .sp .6
       
  1597 .RS 4n
       
  1598 \fBdelete\fR 操作通知安装程序删除指定的文件系统。
       
  1599 .RE
       
  1600 
       
  1601 .sp
       
  1602 .ne 2
       
  1603 .mk
       
  1604 .na
       
  1605 \fB\fBpreserve\fR\fR
       
  1606 .ad
       
  1607 .sp .6
       
  1608 .RS 4n
       
  1609 \fBpreserve\fR 操作通知安装程序使指定的文件系统保持不变。如果为 \fBfilesystem\fR 指定了 \fBpreserve\fR,则应该为关联的 \fBzpool\fR 指定 \fBpreserve\fR。
       
  1610 .RE
       
  1611 
       
  1612 .RE
       
  1613 
       
  1614 .sp
       
  1615 .ne 2
       
  1616 .mk
       
  1617 .na
       
  1618 \fB\fBmountpoint\fR\fR
       
  1619 .ad
       
  1620 .sp .6
       
  1621 .RS 4n
       
  1622 \fBmountpoint\fR 属性指定新文件系统的挂载点。如果未指定挂载点,则文件系统从其父级继承挂载点。
       
  1623 .RE
       
  1624 
       
  1625 .sp
       
  1626 .ne 2
       
  1627 .mk
       
  1628 .na
       
  1629 \fB\fBin_be\fR\fR
       
  1630 .ad
       
  1631 .sp .6
       
  1632 .RS 4n
       
  1633 此属性的缺省值为 \fBfalse\fR。当 \fBin_be\fR 为 \fBfalse\fR 时,将在所有引导环境之间共享新的数据集。
       
  1634 .sp
       
  1635 当 \fBin_be\fR 为 \fBtrue\fR 时,将在每个引导环境中创建此新数据集的单独副本。如果 \fBin_be\fR 为 \fBtrue\fR,则 \fBname\fR 属性值相对于引导环境的根数据集。
       
  1636 .RE
       
  1637 
       
  1638 .sp
       
  1639 .LP
       
  1640 使用 \fBoptions\fR 子元素可对 \fBfilesystem\fR 设置 ZFS 数据集属性。可以设置任何可编辑的 ZFS 文件系统属性。对 \fBfilesystem\fR 使用 \fBoptions\fR 元素与对 \fBzpool\fR 使用 \fBdataset_options\fR 元素类似,如以下示例所示:
       
  1641 .sp
       
  1642 .in +2
       
  1643 .nf
       
  1644 <logical>
       
  1645   <zpool name="rpool" is_root="true">
       
  1646     <filesystem name="export">
       
  1647       <options>
       
  1648         <option name="compression" value="off"/>
       
  1649         <option name="dedup" value="on"/>
       
  1650       <options>
       
  1651     </filesystem>
       
  1652   </zpool>
       
  1653 </logical>
       
  1654 .fi
       
  1655 .in -2
       
  1656 
       
  1657 .sp
       
  1658 .LP
       
  1659 子 \fBfilesystem\fR 会继承对父 \fBfilesystem\fR 设置的任何属性,除非以不同方式显式设置该属性。这是 ZFS 文件系统的缺省行为。
       
  1660 .SS "ZFS 卷"
       
  1661 .sp
       
  1662 .LP
       
  1663 使用 \fBzvol\fR 元素可定义 ZFS 池内的 ZFS 卷。\fBzvol\fR 通常用于交换或转储设备,但是它可以具有其他用途。
       
  1664 .sp
       
  1665 .LP
       
  1666 \fBzvol\fR 元素具有以下属性:
       
  1667 .sp
       
  1668 .ne 2
       
  1669 .mk
       
  1670 .na
       
  1671 \fB\fBname\fR\fR
       
  1672 .ad
       
  1673 .sp .6
       
  1674 .RS 4n
       
  1675 这是新 ZFS 卷的名称。
       
  1676 .RE
       
  1677 
       
  1678 .sp
       
  1679 .ne 2
       
  1680 .mk
       
  1681 .na
       
  1682 \fB\fBaction\fR\fR
       
  1683 .ad
       
  1684 .sp .6
       
  1685 .RS 4n
       
  1686 \fBaction\fR 属性可以具有以下值:
       
  1687 .sp
       
  1688 .ne 2
       
  1689 .mk
       
  1690 .na
       
  1691 \fB\fBcreate\fR\fR
       
  1692 .ad
       
  1693 .sp .6
       
  1694 .RS 4n
       
  1695 这是 \fBzvol\fR 的缺省操作。\fBcreate\fR 操作通知安装程序创建具有指定名称的 ZFS 卷。
       
  1696 .RE
       
  1697 
       
  1698 .sp
       
  1699 .ne 2
       
  1700 .mk
       
  1701 .na
       
  1702 \fB\fBdelete\fR\fR
       
  1703 .ad
       
  1704 .sp .6
       
  1705 .RS 4n
       
  1706 \fBdelete\fR 操作通知安装程序删除指定的卷。
       
  1707 .RE
       
  1708 
       
  1709 .sp
       
  1710 .ne 2
       
  1711 .mk
       
  1712 .na
       
  1713 \fB\fBpreserve\fR\fR
       
  1714 .ad
       
  1715 .sp .6
       
  1716 .RS 4n
       
  1717 \fBpreserve\fR 操作通知安装程序使指定的 \fBzvol\fR 保持不变。如果为 \fBzvol\fR 指定了 \fBpreserve\fR,则应该为关联的 \fBzpool\fR 指定 \fBpreserve\fR。
       
  1718 .RE
       
  1719 
       
  1720 .sp
       
  1721 .ne 2
       
  1722 .mk
       
  1723 .na
       
  1724 \fB\fBuse_existing\fR\fR
       
  1725 .ad
       
  1726 .sp .6
       
  1727 .RS 4n
       
  1728 如果为交换或转储设备指定了此值,则会重用现有的卷。如果为 \fBzvol\fR 指定了 \fBuse_existing\fR,则应该为关联的 \fBzpool\fR 指定 \fBpreserve\fR。
       
  1729 .RE
       
  1730 
       
  1731 .RE
       
  1732 
       
  1733 .sp
       
  1734 .ne 2
       
  1735 .mk
       
  1736 .na
       
  1737 \fB\fBuse\fR\fR
       
  1738 .ad
       
  1739 .sp .6
       
  1740 .RS 4n
       
  1741 \fBuse\fR 属性可以具有以下值:
       
  1742 .sp
       
  1743 .ne 2
       
  1744 .mk
       
  1745 .na
       
  1746 \fB\fBnone\fR\fR
       
  1747 .ad
       
  1748 .sp .6
       
  1749 .RS 4n
       
  1750 这是缺省值。当 \fBuse\fR 为 \fBnone\fR 时,在安装期间将创建 \fBzvol\fR 但不使用它。
       
  1751 .RE
       
  1752 
       
  1753 .sp
       
  1754 .ne 2
       
  1755 .mk
       
  1756 .na
       
  1757 \fB\fBswap\fR\fR
       
  1758 .ad
       
  1759 .sp .6
       
  1760 .RS 4n
       
  1761 当 \fBuse\fR 为 \fBswap\fR 时,将创建 \fBzvol\fR 并将其用作交换设备。在安装期间 \fBzvol\fR 也用作交换设备。\fBzvol\fR 元素的 \fBsize\fR 子元素可以具有 \fBmax\fR 值。如果指定了 \fBmax\fR 关键字,卷大小将为创建卷的池的空闲空间的 90%。一个池中只有一个卷可以指定 \fBmax\fR 大小。
       
  1762 .RE
       
  1763 
       
  1764 .sp
       
  1765 .ne 2
       
  1766 .mk
       
  1767 .na
       
  1768 \fB\fBdump\fR\fR
       
  1769 .ad
       
  1770 .sp .6
       
  1771 .RS 4n
       
  1772 当 \fBuse\fR 为 \fBdump\fR 时,将创建 \fBzvol\fR 并将其用作转储设备。在安装期间 \fBzvol\fR 也用作转储设备。
       
  1773 .RE
       
  1774 
       
  1775 .RE
       
  1776 
       
  1777 .sp
       
  1778 .LP
       
  1779 使用 \fBsize\fR 子元素指定卷大小。有关如何使用 \fBsize\fR 元素的详细信息,请参见“磁盘布局”部分的开头。如果指定了卷的大小,\fBsize\fR 子元素必须跟在 \fBzvol\fR 元素中的任何 \fB options\fR 子元素之后,如下例所示:
       
  1780 .sp
       
  1781 .LP
       
  1782 使用 \fBoptions\fR 子元素可对 \fBzvol\fR 设置 ZFS 卷选项。对 \fBzvol\fR 使用 \fBoptions\fR 元素与对 \fBzpool\fR 使用 \fBdataset_options\fR 元素类似,如以下示例所示:
       
  1783 .sp
       
  1784 .in +2
       
  1785 .nf
       
  1786 <logical>
       
  1787   <zpool name="rpool" is_root="true">
       
  1788     <zvol name="swap">
       
  1789       <options>
       
  1790         <option name="compression" value="off"/>
       
  1791       <options>
       
  1792       <size val="8gb"/>
       
  1793     </zvol>
       
  1794   </zpool>
       
  1795 </logical>
       
  1796 .fi
       
  1797 .in -2
       
  1798 
       
  1799 .SS "引导环境"
       
  1800 .sp
       
  1801 .LP
       
  1802 使用 \fBbe\fR 元素可指定在安装期间创建引导环境的方式。
       
  1803 .sp
       
  1804 .LP
       
  1805 \fBbe\fR 元素具有一个属性:
       
  1806 .sp
       
  1807 .ne 2
       
  1808 .mk
       
  1809 .na
       
  1810 \fB\fBname\fR\fR
       
  1811 .ad
       
  1812 .RS 8n
       
  1813 .rt  
       
  1814 这是由安装程序创建的新引导环境的名称。如果未指定 \fBbe\fR 元素,则此引导环境的缺省名称是 \fBsolaris\fR。
       
  1815 .RE
       
  1816 
       
  1817 .sp
       
  1818 .LP
       
  1819 安装程序利用由引导环境子系统提供的自动命名功能。在安装到现有的目标区域中时(例如,在安装区域时),具有由 \fBbe\fR 元素 \fBname\fR 属性指定的名称的引导环境可能已存在。如果指定的引导环境名称已存在,则此名称将用作生成新名称的基础。例如,如果未指定 \fBbe\fR,且名为 \fBsolaris\fR 的引导环境已存在,则将新的引导环境命名为 \fBsolaris-\fIn\fR\fR,其中 \fIn\fR 是构成尚不存在的引导环境名称的、按计数顺序的第一个整数。
       
  1820 .sp
       
  1821 .LP
       
  1822 引导环境将被创建为 ZFS 数据集,并且可以对其设置 ZFS 属性。使用 \fBoptions\fR 子元素可对引导环境设置 ZFS 属性,如以下示例所示:
       
  1823 .sp
       
  1824 .in +2
       
  1825 .nf
       
  1826 <logical>
       
  1827   <zpool name="rpool" is_root="true">
       
  1828     <be name="installed_be">
       
  1829       <options>
       
  1830         <option name="compression" value="on"/>
       
  1831         <option name="dedup" value="on"/>
       
  1832       <options>
       
  1833     </be>
       
  1834   </zpool>
       
  1835 </logical>
       
  1836 .fi
       
  1837 .in -2
       
  1838 
       
  1839 .SH 软件
       
  1840 .sp
       
  1841 .LP
       
  1842 \fBsoftware\fR 元素指定要安装的软件。\fBsoftware\fR 部分指定以下信息:
       
  1843 .RS +4
       
  1844 .TP
       
  1845 .ie t \(bu
       
  1846 .el o
       
  1847 软件源的类型
       
  1848 .RE
       
  1849 .RS +4
       
  1850 .TP
       
  1851 .ie t \(bu
       
  1852 .el o
       
  1853 源的位置
       
  1854 .RE
       
  1855 .RS +4
       
  1856 .TP
       
  1857 .ie t \(bu
       
  1858 .el o
       
  1859 要安装或卸载的软件包的名称
       
  1860 .RE
       
  1861 .RS +4
       
  1862 .TP
       
  1863 .ie t \(bu
       
  1864 .el o
       
  1865 要安装的可选软件组件
       
  1866 .RE
       
  1867 .RS +4
       
  1868 .TP
       
  1869 .ie t \(bu
       
  1870 .el o
       
  1871 映像属性
       
  1872 .RE
       
  1873 .RS +4
       
  1874 .TP
       
  1875 .ie t \(bu
       
  1876 .el o
       
  1877 访问 IPS 系统信息库所需的 SSL 密钥和证书
       
  1878 .RE
       
  1879 .sp
       
  1880 .LP
       
  1881 \fBsoftware\fR 元素具有以下属性:
       
  1882 .sp
       
  1883 .ne 2
       
  1884 .mk
       
  1885 .na
       
  1886 \fB\fBname\fR\fR
       
  1887 .ad
       
  1888 .RS 8n
       
  1889 .rt  
       
  1890 这是 \fBsoftware\fR 实例的名称。此名称在此 AI 清单中的所有 \fBsoftware\fR 实例之间必须唯一。
       
  1891 .RE
       
  1892 
       
  1893 .sp
       
  1894 .ne 2
       
  1895 .mk
       
  1896 .na
       
  1897 \fB\fBtype\fR\fR
       
  1898 .ad
       
  1899 .RS 8n
       
  1900 .rt  
       
  1901 这是软件源的类型。
       
  1902 .sp
       
  1903 .LP
       
  1904 \fBtype\fR 属性可以具有以下值之一。如果未指定 \fBtype\fR,则缺省值为 \fBIPS\fR。
       
  1905 .RS +4
       
  1906 .TP
       
  1907 .ie t \(bu
       
  1908 .el o
       
  1909 \fBIPS\fR:IPS 软件包系统信息库
       
  1910 .RE
       
  1911 .RS +4
       
  1912 .TP
       
  1913 .ie t \(bu
       
  1914 .el o
       
  1915 \fBP5I\fR:IPS 软件包文件
       
  1916 .RE
       
  1917 .RS +4
       
  1918 .TP
       
  1919 .ie t \(bu
       
  1920 .el o
       
  1921 \fBSVR4\fR:SVR4 软件包
       
  1922 .RE
       
  1923 .RS +4
       
  1924 .TP
       
  1925 .ie t \(bu
       
  1926 .el o
       
  1927 \fBCPIO\fR:\fBcpio\fR 归档文件
       
  1928 .RE
       
  1929 .RE
       
  1930 
       
  1931 .sp
       
  1932 .LP
       
  1933 \fBsoftware\fR 元素具有以下结构:
       
  1934 .sp
       
  1935 .in +2
       
  1936 .nf
       
  1937 <!-- one or more software elements -->
       
  1938 <software>
       
  1939   <!-- zero or one destination element
       
  1940        Only used when type is IPS or P5I.
       
  1941   -->
       
  1942   <destination>
       
  1943     <!-- image properties and
       
  1944          optional software components
       
  1945     -->
       
  1946   </destination>
       
  1947   <!-- zero or one source element -->
       
  1948   <source>
       
  1949     <!-- one or more publisher or dir elements
       
  1950          IPS, P5I, and SVR4 types:
       
  1951              one or more publisher/origin elements
       
  1952          CPIO types: one or more dir elements
       
  1953         -->
       
  1954   </source>
       
  1955   <!-- zero or more software_data elements
       
  1956        At least one software_data element must have
       
  1957            an action of install.
       
  1958        P5I type: zero software_data elements
       
  1959   -->
       
  1960   <software_data>
       
  1961     <!-- one or more name elements -->
       
  1962     <name>...</name>
       
  1963   </software_data>
       
  1964 </software>
       
  1965 .fi
       
  1966 .in -2
       
  1967 
       
  1968 .SS "IPS 安装"
       
  1969 .sp
       
  1970 .LP
       
  1971 如果未指定 \fBtype\fR 属性,则缺省安装类型为 \fBIPS\fR。
       
  1972 .sp
       
  1973 .LP
       
  1974 使用 \fBsource\fR 元素可指定要用于安装软件包的发布者。在 \fBpublisher\fR 元素中,\fBname\fR 属性是必需的,并且需要至少有一个 \fBorigin\fR 子元素。
       
  1975 .sp
       
  1976 .LP
       
  1977 可以在一个 \fBsource\fR 元素中指定多个发布者。每个发布者必须具有至少一个源。每个发布者可以具有多个源和镜像。
       
  1978 .sp
       
  1979 .LP
       
  1980 在发布者中搜索要安装的 IPS 软件包的顺序以及在已安装系统中设置发布者的顺序与在 AI 清单中定义发布者的顺序相同。
       
  1981 .sp
       
  1982 .LP
       
  1983 安装非全局区域时,系统信息库由该区域使用。在 AI 清单中指定的任何发布者将按它们在 AI 清单中出现的顺序添加,在系统信息库提供的发布者之后。有关系统信息库的更多信息,请参见 \fBpkg\fR(1) 和 \fBpkg.sysrepo\fR(1M) 手册页。
       
  1984 .sp
       
  1985 .LP
       
  1986 以下示例指定多个发布者,其中一个发布者具有镜像以及源:
       
  1987 .sp
       
  1988 .in +2
       
  1989 .nf
       
  1990 <software type="IPS">
       
  1991   <source>
       
  1992     <publisher name="solaris">
       
  1993       <origin name="http://pkg.oracle.com/solaris/release"/>
       
  1994       <mirror name="http://localpkg.mycompany.com/solaris"/>
       
  1995     </publisher>
       
  1996     <publisher name="internal-software">
       
  1997       <origin name="http://internalsoft.mycompany.com/"/>
       
  1998     </publisher>
       
  1999   </source>
       
  2000 </software>
       
  2001 .fi
       
  2002 .in -2
       
  2003 
       
  2004 .sp
       
  2005 .LP
       
  2006 使用 \fBsoftware_data\fR 元素可指定要安装、拒绝、避免、包括或卸载的软件包。\fBsoftware_data\fR 元素的 \fBaction\fR 属性可以具有以下值之一:
       
  2007 .sp
       
  2008 .ne 2
       
  2009 .mk
       
  2010 .na
       
  2011 \fB\fBinstall\fR\fR
       
  2012 .ad
       
  2013 .sp .6
       
  2014 .RS 4n
       
  2015 安装在 \fBname\fR 子元素中指定的 IPS 软件包。如果未指定 \fBaction\fR 属性,这将是缺省值。必须至少有一个 \fBsoftware_data\fR 元素的 \fBaction\fR 为 \fBinstall\fR。
       
  2016 .sp
       
  2017 缺省情况下,将安装指定源提供的且与映像中其他软件包兼容的最新版指定软件包。要安装软件包的其他版本,请在软件包 FMRI 中使用版本字符串。例如,\fBpkg:/[email protected]\fR 比 \fBpkg:/mypkg\fR 更精确。如果指定的版本与映像中的其他软件包不兼容,安装会失败。如果指定的版本不在任何指定源中,安装会失败。使用关键字 \fBlatest\fR(例如,\fBpkg:/mypkg@latest\fR)可安装指定源中与映像中的其他软件包兼容的最新版本。
       
  2018 .sp
       
  2019 \fBname\fR 子元素中指定的软件包可能会安装其他未显式指定的软件包。如果这些软件包中有您不想安装的软件包,您可以在 \fBreject\fR 子元素中指定不想安装的软件包的名称。
       
  2020 .sp
       
  2021 \fBreject\fR 子元素仅应用于出现该 \fBreject\fR 子元素的 \fBinstall\fR 部分。如果在一个 \fBinstall\fR 部分中将某个软件包作为 \fBreject\fR 子元素的值,但该软件包仅在另一个 \fBinstall\fR 部分中安装,则将安装该软件包而不会拒绝它。
       
  2022 .sp
       
  2023 作为组依赖性目标的被拒绝软件包将放置在避免列表中。请参见下文的 \fBavoid\fR 操作。
       
  2024 .RE
       
  2025 
       
  2026 .sp
       
  2027 .ne 2
       
  2028 .mk
       
  2029 .na
       
  2030 \fB\fBavoid\fR\fR
       
  2031 .ad
       
  2032 .sp .6
       
  2033 .RS 4n
       
  2034 将 \fBname\fR 子元素中的 IPS 软件包添加到避免列表中。
       
  2035 .sp
       
  2036 如果避免列表上的软件包是组依赖性目标,则不会安装这些软件包。
       
  2037 .sp
       
  2038 如果避免列表上的软件包是 require 依赖性的目标,则会安装这些软件包。如果删除了该 require 依赖性(例如,卸载了包含 require 依赖性的软件包),则会卸载避免安装的软件包。
       
  2039 .sp
       
  2040 只能避免安装当前尚未安装的软件包。因此,\fBavoid\fR 部分必须位于对要避免安装的软件包有依赖性的软件包的 \fBinstall\fR 部分之前。
       
  2041 .RE
       
  2042 
       
  2043 .sp
       
  2044 .ne 2
       
  2045 .mk
       
  2046 .na
       
  2047 \fB\fBunavoid\fR\fR
       
  2048 .ad
       
  2049 .sp .6
       
  2050 .RS 4n
       
  2051 从避免列表中删除在 \fBname\fR 子元素中指定的 IPS 软件包。
       
  2052 .RE
       
  2053 
       
  2054 .sp
       
  2055 .ne 2
       
  2056 .mk
       
  2057 .na
       
  2058 \fB\fBuninstall\fR\fR
       
  2059 .ad
       
  2060 .sp .6
       
  2061 .RS 4n
       
  2062 删除在 \fBname\fR 子元素中指定的 IPS 软件包。作为组依赖性目标的卸载软件包将放置在避免列表中。请参见上面的 \fBavoid\fR 操作。
       
  2063 .RE
       
  2064 
       
  2065 .sp
       
  2066 .LP
       
  2067 安装过程中创建的所有避免列表将在安装后的映像中继续存在。
       
  2068 .sp
       
  2069 .LP
       
  2070 以下示例说明了在类型为 IPS 的 \fBsoftware\fR 部分中如何使用具有不同 \fBaction\fR 值的 \fBsoftware_data\fR 部分。
       
  2071 .sp
       
  2072 .in +2
       
  2073 .nf
       
  2074 <software_data action="avoid">
       
  2075   <name>pkg:/to/avoid</name>
       
  2076 </software_data>
       
  2077 <software_data action="install">
       
  2078   <name>pkg:/to/install</name>
       
  2079   <reject>pkg:/to/reject</reject>
       
  2080 </software_data>
       
  2081 <software_data action="uninstall">
       
  2082   <name>pkg:/unwanted/pkg</name>
       
  2083 </software_data>
       
  2084 .fi
       
  2085 .in -2
       
  2086 
       
  2087 .SS "P5I 安装"
       
  2088 .sp
       
  2089 .LP
       
  2090 \fB\&.p5i\fR 文件是描述 IPS 发布者、软件包,还可能描述镜像的文件。
       
  2091 .sp
       
  2092 .LP
       
  2093 要指定将处理的一个或多个 \fB\&.p5i\fR 文件,请将这些文件作为 \fBpublisher\fR 元素中的源提供,如以下示例所示:
       
  2094 .sp
       
  2095 .in +2
       
  2096 .nf
       
  2097 <software type="P5I">
       
  2098   <source>
       
  2099     <publisher>
       
  2100       <origin name="/somewhere/image1.p5i"/>
       
  2101       <origin name="/somewhere/image2.p5i"/>
       
  2102     </publisher>
       
  2103   </source>
       
  2104 </software>
       
  2105 .fi
       
  2106 .in -2
       
  2107 
       
  2108 .sp
       
  2109 .LP
       
  2110 如果此 AI 清单也没有 IPS 类型的软件部分,请确保 \fB\&.p5i\fR 文件指定了源。
       
  2111 .sp
       
  2112 .LP
       
  2113 P5I 安装不支持指定要安装的软件包。因此,在 \fBP5I\fR 类型的 \fBsoftware\fR 元素中不支持 \fBsoftware_data\fR 元素。
       
  2114 .SS "SVR4 安装"
       
  2115 .sp
       
  2116 .LP
       
  2117 对于 SVR4 传输,必须使用文件目录路径或 FILE URI 指定一个包含 SVR4 软件包子目录的目录或 SVR4 软件包数据流文件。也可以使用 HTTP URI 指定 SVR4 软件包数据流文件。 
       
  2118 .sp
       
  2119 .in +2
       
  2120 .nf
       
  2121 <software type="SVR4">
       
  2122   <source>
       
  2123     <publisher>
       
  2124       <origin name="/somedir"/>
       
  2125     </publisher>
       
  2126   </source>
       
  2127 </software>
       
  2128 .fi
       
  2129 .in -2
       
  2130 
       
  2131 .sp
       
  2132 .LP
       
  2133 \fBsoftware_data\fR 元素用于指定要执行的操作。\fBaction\fR 属性可以具有以下两个值之一:
       
  2134 .sp
       
  2135 .ne 2
       
  2136 .mk
       
  2137 .na
       
  2138 \fB\fBinstall\fR\fR
       
  2139 .ad
       
  2140 .sp .6
       
  2141 .RS 4n
       
  2142 将文件从源复制到新的引导环境。如果未指定 \fBaction\fR 属性,这将是缺省值。至少一个 \fBsoftware_data\fR 元素必须具有安装操作。
       
  2143 .RE
       
  2144 
       
  2145 .sp
       
  2146 .ne 2
       
  2147 .mk
       
  2148 .na
       
  2149 \fB\fBuninstall\fR\fR
       
  2150 .ad
       
  2151 .sp .6
       
  2152 .RS 4n
       
  2153 从新的引导环境中删除文件。
       
  2154 .RE
       
  2155 
       
  2156 .sp
       
  2157 .LP
       
  2158 对于其中的每个操作,可以在 \fBname\fR 元素中指定一个或多个软件包,如以下示例所示:
       
  2159 .sp
       
  2160 .in +2
       
  2161 .nf
       
  2162 <software type="SVR4">
       
  2163   <source>
       
  2164     <publisher>
       
  2165       <origin name="/somedir"/>
       
  2166     </publisher>
       
  2167   </source>
       
  2168   <software_data> <!-- defaults to install action -->
       
  2169     <name>ORGpackage1</name>
       
  2170     <name>ORGpackage2</name>
       
  2171   </software_data>
       
  2172   <software_data action="uninstall">
       
  2173     <name>ORGpackage8</name>
       
  2174   </software_data>
       
  2175 </software>
       
  2176 .fi
       
  2177 .in -2
       
  2178 
       
  2179 .SS "CPIO 安装"
       
  2180 .sp
       
  2181 .LP
       
  2182 对于 CPIO 传输,必须指定源目录。在安装期间目标目录被设置为新引导环境的挂载点。
       
  2183 .sp
       
  2184 .in +2
       
  2185 .nf
       
  2186 <software type="CPIO">
       
  2187   <source>
       
  2188     <dir path="/somedir"/>
       
  2189   </source>
       
  2190 </software>
       
  2191 .fi
       
  2192 .in -2
       
  2193 
       
  2194 .sp
       
  2195 .LP
       
  2196 \fBsoftware_data\fR 元素用于指定要执行的操作。\fBaction\fR 属性可以具有以下值之一:
       
  2197 .sp
       
  2198 .ne 2
       
  2199 .mk
       
  2200 .na
       
  2201 \fB\fBinstall\fR\fR
       
  2202 .ad
       
  2203 .sp .6
       
  2204 .RS 4n
       
  2205 将文件从源复制到新的引导环境。如果未指定 \fBaction\fR 属性,这将是缺省值。至少一个 \fBsoftware_data\fR 元素必须具有安装操作。
       
  2206 .sp
       
  2207 使用 \fBname\fR 元素可指定要复制的文件或目录。在 \fBname\fR 元素中指定的路径相对于源。
       
  2208 .sp
       
  2209 .in +2
       
  2210 .nf
       
  2211 <software_data>
       
  2212   <!-- defaults to install action -->
       
  2213   <name>path/relative/to/source</name>
       
  2214   <name>another/path/relative/to/source</name>
       
  2215 </software_data>
       
  2216 .fi
       
  2217 .in -2
       
  2218 
       
  2219 .RE
       
  2220 
       
  2221 .sp
       
  2222 .ne 2
       
  2223 .mk
       
  2224 .na
       
  2225 \fB\fBuninstall\fR\fR
       
  2226 .ad
       
  2227 .sp .6
       
  2228 .RS 4n
       
  2229 从新的引导环境中删除文件。
       
  2230 .sp
       
  2231 使用 \fBname\fR 元素可指定要删除的文件或目录。在 \fBname\fR 元素中指定的路径相对于目标。
       
  2232 .sp
       
  2233 .in +2
       
  2234 .nf
       
  2235 <software_data action="uninstall">
       
  2236   <name>path/relative/to/destination</name>
       
  2237 </software_data>
       
  2238 .fi
       
  2239 .in -2
       
  2240 
       
  2241 .RE
       
  2242 
       
  2243 .SS "可选软件组件和映像属性"
       
  2244 .sp
       
  2245 .LP
       
  2246 使用 \fBdestination\fR 元素和 \fBimage\fR 子元素可指定以下信息:
       
  2247 .RS +4
       
  2248 .TP
       
  2249 .ie t \(bu
       
  2250 .el o
       
  2251 要安装的可选软件组件
       
  2252 .RE
       
  2253 .RS +4
       
  2254 .TP
       
  2255 .ie t \(bu
       
  2256 .el o
       
  2257 映像属性
       
  2258 .RE
       
  2259 .RS +4
       
  2260 .TP
       
  2261 .ie t \(bu
       
  2262 .el o
       
  2263 SSL 密钥和证书
       
  2264 .RE
       
  2265 .sp
       
  2266 .LP
       
  2267 \fBdestination\fR 部分仅适用于 IPS 和 P5I 安装类型。\fBdestination\fR 元素只能具有一个 \fBimage\fR 子元素。
       
  2268 .SS "SSL 密钥和证书"
       
  2269 .sp
       
  2270 .LP
       
  2271 使用 \fBimage\fR 元素的属性可指定使用客户机 SSL 验证的发布者所需的 SSL 密钥和证书。此处指定的密钥和证书适用于在此 AI 清单中定义的第一个发布者。
       
  2272 .sp
       
  2273 .ne 2
       
  2274 .mk
       
  2275 .na
       
  2276 \fB\fBssl_key\fR\fR
       
  2277 .ad
       
  2278 .sp .6
       
  2279 .RS 4n
       
  2280 此属性映射到以下 \fBpkg\fR 命令:
       
  2281 .sp
       
  2282 .in +2
       
  2283 .nf
       
  2284 pkg set-publisher -k \fIssl_key\fR
       
  2285 .fi
       
  2286 .in -2
       
  2287 
       
  2288 \fBssl_key\fR 属性的值为 \fIssl_key\fR。有关 \fBpkg set-publisher\fR 命令的更多信息,请参见 \fBpkg\fR(1) 手册页。
       
  2289 .RE
       
  2290 
       
  2291 .sp
       
  2292 .ne 2
       
  2293 .mk
       
  2294 .na
       
  2295 \fB\fBssl_cert\fR\fR
       
  2296 .ad
       
  2297 .sp .6
       
  2298 .RS 4n
       
  2299 此属性映射到以下 \fBpkg\fR 命令:
       
  2300 .sp
       
  2301 .in +2
       
  2302 .nf
       
  2303 pkg set-publisher -c \fIssl_cert\fR
       
  2304 .fi
       
  2305 .in -2
       
  2306 
       
  2307 \fBssl_cert\fR 属性的值为 \fIssl_cert\fR。
       
  2308 .RE
       
  2309 
       
  2310 .SS "可选软件组件"
       
  2311 .sp
       
  2312 .LP
       
  2313 使用 \fBimage\fR 元素的 \fBfacet\fR 子元素可指定要安装的可选软件组件。侧面不是单独的软件包,而是任何给定软件包(如语言环境)、文档和开发文件(如包含调试信息的文件)的可选组件。例如,可通过指定仅要安装一种或两种语言来节省空间。有关 IPS 侧面的更多信息,请参见 \fBpkg\fR(1) 手册页。
       
  2314 .sp
       
  2315 .LP
       
  2316 \fBfacet\fR 元素具有一个布尔型 \fBset\fR 属性和一个为 IPS 侧面名称的值。
       
  2317 .sp
       
  2318 .in +2
       
  2319 .nf
       
  2320 <facet set="true|false">\fIfacet_name\fR</facet>
       
  2321 .fi
       
  2322 .in -2
       
  2323 
       
  2324 .sp
       
  2325 .LP
       
  2326 以下示例指定仅应安装软件包的德语和英语侧面。该示例首先指定不应安装任何语言环境,然后指定应该安装德语和英语语言环境。
       
  2327 .sp
       
  2328 .in +2
       
  2329 .nf
       
  2330 <destination>
       
  2331   <image>
       
  2332     <!-- de-select all locales -->
       
  2333     <facet set="false">facet.locale.*</facet>
       
  2334     <!-- specify specific locales to install -->
       
  2335     <!-- install German and English only -->
       
  2336     <facet set="true">facet.locale.de</facet>
       
  2337     <facet set="true">facet.locale.de_DE</facet>
       
  2338     <facet set="true">facet.locale.en</facet>
       
  2339     <facet set="true">facet.locale.en_US</facet>
       
  2340   </image>
       
  2341 </destination>
       
  2342 .fi
       
  2343 .in -2
       
  2344 
       
  2345 .SS "映像属性"
       
  2346 .sp
       
  2347 .LP
       
  2348 使用 \fBimage\fR 元素的 \fBproperty\fR 子元素,可以为此安装创建的新映像指定 IPS 映像属性。
       
  2349 .sp
       
  2350 .LP
       
  2351 \fBproperty\fR 元素具有一个布尔型 \fBval\fR 属性和一个为属性名称的值。
       
  2352 .sp
       
  2353 .in +2
       
  2354 .nf
       
  2355 <property val="true|false">\fIproperty_name\fR</property>
       
  2356 .fi
       
  2357 .in -2
       
  2358 
       
  2359 .sp
       
  2360 .LP
       
  2361 有关可以设置哪些属性的信息,请参见 \fBpkg\fR(1) 手册页的“映像属性”部分。
       
  2362 .SH 引导配置(仅限 X86)
       
  2363 .sp
       
  2364 .LP
       
  2365 可以使用 AI 清单修改在已安装的系统上配置 GRUB 引导菜单的方式。
       
  2366 .sp
       
  2367 .LP
       
  2368 此部分不适用于区域安装,在安装非全局区域时将被忽略。
       
  2369 .sp
       
  2370 .LP
       
  2371 使用 \fBboot_mods\fR 元素和 \fBboot_entry\fR 子元素可修改 GRUB 引导菜单。
       
  2372 .sp
       
  2373 .LP
       
  2374 \fBboot_mods\fR 元素具有以下属性:
       
  2375 .sp
       
  2376 .ne 2
       
  2377 .mk
       
  2378 .na
       
  2379 \fB\fBtitle\fR\fR
       
  2380 .ad
       
  2381 .sp .6
       
  2382 .RS 4n
       
  2383 \fBtitle\fR 属性的值是由此 \fBboot_mods\fR 元素的 \fBboot_entry\fR 子元素指定的引导条目的基本标题。此属性值将覆盖从 \fB/etc/release\fR 的第一行或安装介质自动生成的名称。
       
  2384 .RE
       
  2385 
       
  2386 .sp
       
  2387 .ne 2
       
  2388 .mk
       
  2389 .na
       
  2390 \fB\fBtimeout\fR\fR
       
  2391 .ad
       
  2392 .sp .6
       
  2393 .RS 4n
       
  2394 \fBtimeout\fR 属性的值是选择此 \fBboot_mods\fR 元素的缺省 \fBboot_entry\fR 之前等待的秒数。
       
  2395 .RE
       
  2396 
       
  2397 .sp
       
  2398 .LP
       
  2399 在 SPARC 系统上只能设置 \fBtitle\fR 属性。对于 SPARC 系统,将忽略此部分中的所有其他设置。
       
  2400 .sp
       
  2401 .LP
       
  2402 使用 \fBboot_entry\fR 子元素可将一个或多个菜单项添加到引导菜单。这些菜单项是对安装程序自动生成的任何菜单项的补充。
       
  2403 .sp
       
  2404 .LP
       
  2405 \fBboot_entry\fR 元素具有以下属性:
       
  2406 .sp
       
  2407 .ne 2
       
  2408 .mk
       
  2409 .na
       
  2410 \fB\fBdefault_entry\fR\fR
       
  2411 .ad
       
  2412 .sp .6
       
  2413 .RS 4n
       
  2414 如果将此布尔值设置为 \fBtrue\fR,则此菜单项是引导时选定的缺省选项。此属性的缺省值为 \fBfalse\fR。
       
  2415 .sp
       
  2416 如果多个 \fBboot_entry\fR 元素已将 \fBdefault_entry\fR 设置为 \fBtrue\fR,则最后一个此类条目是引导时选定的缺省选项。
       
  2417 .RE
       
  2418 
       
  2419 .sp
       
  2420 .ne 2
       
  2421 .mk
       
  2422 .na
       
  2423 \fB\fBinsert_at\fR\fR
       
  2424 .ad
       
  2425 .sp .6
       
  2426 .RS 4n
       
  2427 可以将此属性设置为以下两个值之一:
       
  2428 .sp
       
  2429 .ne 2
       
  2430 .mk
       
  2431 .na
       
  2432 \fB\fBend\fR\fR
       
  2433 .ad
       
  2434 .RS 9n
       
  2435 .rt  
       
  2436 将条目放置在生成的引导菜单的结尾。这是缺省放置。
       
  2437 .RE
       
  2438 
       
  2439 .sp
       
  2440 .ne 2
       
  2441 .mk
       
  2442 .na
       
  2443 \fB\fBstart\fR\fR
       
  2444 .ad
       
  2445 .RS 9n
       
  2446 .rt  
       
  2447 将条目放置在生成的引导菜单的开头。
       
  2448 .RE
       
  2449 
       
  2450 .RE
       
  2451 
       
  2452 .sp
       
  2453 .LP
       
  2454 然后由以下子元素定义 \fBboot_entry\fR 菜单项:
       
  2455 .sp
       
  2456 .ne 2
       
  2457 .mk
       
  2458 .na
       
  2459 \fB\fBtitle_suffix\fR\fR
       
  2460 .ad
       
  2461 .sp .6
       
  2462 .RS 4n
       
  2463 此元素是必需的。此元素定义要添加到在 \fBboot_mods\fR 元素中指定的标题结尾的文本。
       
  2464 .RE
       
  2465 
       
  2466 .sp
       
  2467 .ne 2
       
  2468 .mk
       
  2469 .na
       
  2470 \fB\fBkernel_args\fR\fR
       
  2471 .ad
       
  2472 .sp .6
       
  2473 .RS 4n
       
  2474 此元素是可选的。此元素是由引导装载程序传递到内核的一串值。
       
  2475 .RE
       
  2476 
       
  2477 .sp
       
  2478 .LP
       
  2479 以下示例指定一个名为 "Boot Testing Default Boot Entry"(引导测试缺省引导项)的引导菜单项,该项是菜单上的最后一项,在 20 秒后将自动选定该项:
       
  2480 .sp
       
  2481 .in +2
       
  2482 .nf
       
  2483 <boot_mods title="Boot Testing" timeout="20">
       
  2484   <boot_entry default_entry="true">
       
  2485     <title_suffix>Default Boot Entry</title_suffix>
       
  2486   </boot_entry>
       
  2487 </boot_mods>
       
  2488 .fi
       
  2489 .in -2
       
  2490 
       
  2491 .SH 其他配置
       
  2492 .sp
       
  2493 .LP
       
  2494 \fBconfiguration\fR 元素支持非全局区域配置。在安装全局区域系统时,会使用在 AI 清单中指定的区域配置在安装全局区域后将非全局区域安装到系统上。
       
  2495 .sp
       
  2496 .LP
       
  2497 \fBconfiguration\fR 元素具有以下属性:
       
  2498 .sp
       
  2499 .ne 2
       
  2500 .mk
       
  2501 .na
       
  2502 \fB\fBtype\fR\fR
       
  2503 .ad
       
  2504 .RS 10n
       
  2505 .rt  
       
  2506 要安装的配置的类型。AI 支持的唯一类型为 \fBzone\fR。
       
  2507 .RE
       
  2508 
       
  2509 .sp
       
  2510 .ne 2
       
  2511 .mk
       
  2512 .na
       
  2513 \fB\fBname\fR\fR
       
  2514 .ad
       
  2515 .RS 10n
       
  2516 .rt  
       
  2517 为配置提供的名称。此名称在 AI 清单中的所有配置元素之间必须唯一。对于 \fBzone\fR 类型的配置,此名称还用作区域的 \fBzonename\fR。
       
  2518 .RE
       
  2519 
       
  2520 .sp
       
  2521 .ne 2
       
  2522 .mk
       
  2523 .na
       
  2524 \fB\fBsource\fR\fR
       
  2525 .ad
       
  2526 .RS 10n
       
  2527 .rt  
       
  2528 AI 从中下载此配置元素的配置文件的位置。值可以为指定的 HTTP 或 FILE URI。对于 \fBzone\fR 类型的配置,此值应该指向从 \fBzonecfg export\fR 命令生成的区域配置文件。
       
  2529 .RE
       
  2530 
       
  2531 .sp
       
  2532 .LP
       
  2533 指定以下内容可在安装客户机上安装 \fBzone1\fR:
       
  2534 .sp
       
  2535 .in +2
       
  2536 .nf
       
  2537 <configuration type="zone" name="zone1"
       
  2538   source="http://myserver.com/configs/zone1/config"/>
       
  2539 .fi
       
  2540 .in -2
       
  2541 
       
  2542 .sp
       
  2543 .LP
       
  2544 有关配置和安装区域的更多信息,请参见Chapter 12, \fI"Installing and Configuring Zones,"\fR in \fI《Installing Oracle Solaris 11.1 Systems》\fR。
       
  2545 .SH 文件
       
  2546 .sp
       
  2547 .ne 2
       
  2548 .mk
       
  2549 .na
       
  2550 \fB\fB/usr/share/auto_install/manifest/default.xml\fR\fR
       
  2551 .ad
       
  2552 .sp .6
       
  2553 .RS 4n
       
  2554 指定缺省的系统安装,不进行定制。在系统上提供的此 AI 清单仅供参考。要创建新的 AI 清单,请从相关的安装服务映像使用此文件的副本。有关从安装服务复制此文件的信息,请参见“描述”部分。
       
  2555 .RE
       
  2556 
       
  2557 .sp
       
  2558 .ne 2
       
  2559 .mk
       
  2560 .na
       
  2561 \fB\fB/usr/share/auto_install/manifest/zone_default.xml\fR\fR
       
  2562 .ad
       
  2563 .sp .6
       
  2564 .RS 4n
       
  2565 缺省区域安装,不进行定制。此文件由 \fBzoneadm install\fR 命令用作缺省清单以安装非全局区域。
       
  2566 .RE
       
  2567 
       
  2568 .sp
       
  2569 .ne 2
       
  2570 .mk
       
  2571 .na
       
  2572 \fB\fB/usr/share/auto_install/manifest/ai_manifest.xml\fR\fR
       
  2573 .ad
       
  2574 .sp .6
       
  2575 .RS 4n
       
  2576 模板 AI 清单,已注释掉详细信息。此文件提供可以执行的一些定制的示例。在系统上提供的此文件仅供参考。要创建新的 AI 清单,请从相关的安装服务映像使用此文件的副本。有关从安装服务复制此文件的信息,请参见“描述”部分。
       
  2577 .RE
       
  2578 
       
  2579 .SH 属性
       
  2580 .sp
       
  2581 .LP
       
  2582 有关下列属性的说明,请参见 \fBattributes\fR(5):
       
  2583 .sp
       
  2584 
       
  2585 .sp
       
  2586 .TS
       
  2587 tab() box;
       
  2588 cw(1.38i) |cw(4.13i) 
       
  2589 lw(1.38i) |lw(4.13i) 
       
  2590 .
       
  2591 属性类型属性值
       
  2592 _
       
  2593 可用性T{
       
  2594 \fBsystem/install/auto-install/auto-install-common\fR
       
  2595 T}
       
  2596 _
       
  2597 接口稳定性Uncommitted(未确定)
       
  2598 .TE
       
  2599 
       
  2600 .SH 另请参见
       
  2601 .sp
       
  2602 .LP
       
  2603 \fBpkg\fR(1)、\fBbeadm\fR(1M)、\fBboot\fR(1M)、\fBcroinfo\fR(1M)、\fBfdisk\fR(1M)、\fBformat\fR(1M)、\fBinstalladm\fR(1M)、\fBiostat\fR(1M)、\fBiscsiadm\fR(1M)、\fBpkg.sysrepo\fR(1M)、\fBprtconf\fR(1M)、\fBzfs\fR(1M)、\fBzoneadm\fR(1M)、\fBzonecfg\fR(1M)、\fBzpool\fR(1M)、\fBgrub\fR(5)、\fBsmf\fR(5)
       
  2604 .sp
       
  2605 .LP
       
  2606 Part\ III, \fI"Installing Using an Install Server,"\fR in \fI《Installing Oracle Solaris 11.1 Systems》\fR