# HG changeset patch # User Ethan Quach # Date 1336431157 25200 # Node ID 5889a0b7b4d69e182174f21af2802531544c662d # Parent ed1483d8def9da4d61dd61e1f787b0554b6d947f 7163807 Need to sync up manpages in the slim_source gate diff -r ed1483d8def9 -r 5889a0b7b4d6 usr/src/man/ai_manifest.4 --- a/usr/src/man/ai_manifest.4 Tue May 08 00:28:51 2012 +0100 +++ b/usr/src/man/ai_manifest.4 Mon May 07 15:52:37 2012 -0700 @@ -1,7 +1,7 @@ '\" te -.\" Copyright (c) 2008, 2012, Oracle and/or its affiliates. -.\" All rights reserved. -.TH ai_manifest 4 "22 Feb 2012" "SunOS 5.11" "File Formats" +.\" Copyright (c) 2008, 2012, Oracle and/or its +.\" affiliates. All rights reserved. +.TH ai_manifest 4 "03 May 2012" "SunOS 5.11" "File Formats" .SH NAME ai_manifest \- Automated installation manifest file format .SH SYNOPSIS @@ -162,19 +162,19 @@ .TP .ie t \(bu .el o -For x86, an \fBfdisk\fR partition is allocated that consumes the full disk contents. See the \fBfdisk\fR(1M) man page for more information about \fBfdisk\fR partitions. +For x86 and SPARC with GPT aware firmware, a GPT partition is allocated that consumes the full disk contents. See the \fB-B\fR option of the \fBzpool create\fR command in the \fBzpool\fR(1M) man page. .RE .RS +4 .TP .ie t \(bu .el o -A single slice 0 is allocated that is the full size of the disk for SPARC or the full size of the \fBfdisk\fR partition for x86. +For SPARC systems that are not capable of using GPT, a single slice 0 that is the full size of the disk is created. .RE .RS +4 .TP .ie t \(bu .el o -A single root pool is created that uses the complete slice 0. +A single root pool is created that uses either the complete slice 0 or the complete GPT partition. .RE .RS +4 .TP @@ -350,7 +350,7 @@ .ad .sp .6 .RS 4n -This is a CTD name such as \fBc0t0d0\fR or an MPXIO name such as \fBc0t2000002037CD9F72d0\fR. This type of name is commonly seen when running the \fBformat\fR(1M) command. +This is a CTD name such as \fBc0t0d0\fR or \fBc0t2000002037CD9F72d0\fR. This type of name is commonly seen when running the \fBformat\fR(1M) command. .sp .in +2 .nf @@ -449,7 +449,7 @@ .na \fB\fBsource\fR\fR .ad -.RS 15n +.RS 23n .rt The \fBsource\fR attribute specifies the source of the iSCSI configuration data. The \fBsource\fR attribute can have the following values: .sp @@ -491,19 +491,11 @@ .ne 2 .mk .na -\fB\fBtarget_name\fR\fR +\fB\fBtarget_ip\fR\fR .ad -.RS 15n +.RS 23n .rt -The \fBtarget_name\fR attribute specifies the iSCSI Qualified Name (IQN) or the Extended Unique Identifier (EUI) of the iSCSI target, as shown in the following example: -.sp -.in +2 -.nf -iqn.1986-03.com.sun:02:a4a694bc-6de2-ee50-8979-e25ba29acb86 -.fi -.in -2 - -If the \fBtarget_name\fR attribute is not provided, AI uses \fBiscsiadm\fR(1M) in \fBsendtargets\fR mode. +The value of this attribute is the IP address of the iSCSI target. The target at this IP address must be online and accessible from this system. This attribute is required. .sp .in +2 .nf @@ -511,15 +503,6 @@ .fi .in -2 -If the \fBtarget_name\fR attribute is provided, AI uses static discovery. -.sp -.in +2 -.nf - -.fi -.in -2 - .RE .sp @@ -528,11 +511,29 @@ .na \fB\fBtarget_lun\fR\fR .ad -.RS 15n +.RS 23n .rt If an iSCSI target provides more than one LUN, specify which LUN to use by specifying an integer value for \fBtarget_lun\fR. LUN numbers are indexed from 0. To specify the first LUN, specify a \fBtarget_lun\fR value of 0. .sp -If only one LUN is provided, this attribute can be omitted. +If only one LUN is provided, this attribute can be omitted. If more than one LUN is provided by the iSCSI target, then this attribute is required. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBtarget_name\fR\fR +.ad +.RS 23n +.rt +The \fBtarget_name\fR attribute specifies the iSCSI Qualified Name (IQN) or the Extended Unique Identifier (EUI) of the iSCSI target, as shown in the following example: +.sp +.in +2 +.nf +iqn.1986-03.com.sun:02:a4a694bc-6de2-ee50-8979-e25ba29acb86 +.fi +.in -2 + .RE .sp @@ -541,7 +542,7 @@ .na \fB\fBtarget_port\fR\fR .ad -.RS 15n +.RS 23n .rt If not specified, the default \fBtarget_port\fR of 3260 (the iSCSI standard port) is used. This attribute enables you to specify an alternative port number. .RE @@ -550,20 +551,59 @@ .ne 2 .mk .na -\fB\fBtarget_ip\fR\fR +\fB\fBinitiator_name\fR\fR .ad -.RS 15n +.RS 23n .rt -The value of this attribute is the IP address of the server. +The \fBinitiator_name\fR attribute specifies the IQN or the EUI of the iSCSI initiator. +.RE + .sp -.in +2 -.nf - -.fi -.in -2 - +.ne 2 +.mk +.na +\fBCHAP authentication\fR +.ad +.RS 23n +.rt +The following two attributes provide CHAP (Challenge-Handshake Authentication Protocol) authentication: +.sp +.ne 2 +.mk +.na +\fB\fBchap_name\fR\fR +.ad +.RS 17n +.rt +The \fBchap_name\fR attribute specifies the CHAP username to be used for authentication. .RE +.sp +.ne 2 +.mk +.na +\fB\fBchap_password\fR\fR +.ad +.RS 17n +.rt +The \fBchap_password\fR attribute specifies the CHAP password to be used for authentication. +.RE + +SPARC clients can optionally set \fBchap-user\fR and \fBchap-password\fR at the Open Boot PROM (\fBok\fR) prompt. For more information, see "iSCSI Boot" in \fBboot\fR(1M). +.RE + +.sp +.LP +The \fBiscsi\fR element does not have an \fBaction\fR attribute. AI uses iSCSI devices but does not operate directly on them. +.sp +.LP +If the \fBtarget_name\fR attribute is not provided, AI uses \fBiscsiadm\fR(1M) in \fBsendtargets\fR mode. +.sp +.LP +If the \fBtarget_name\fR attribute is provided, AI uses static discovery. +.sp +.LP +Given this information, the iSCSI device is made available for installation. .SS "Target Device Properties" .sp .LP @@ -720,10 +760,113 @@ If the \fBin_vdev\fR attribute is specified here, then do not specify \fBin_vdev\fR for any subordinate partitions or slices. .RE -.SS "Partitions" +.SS "GPT Partitions" .sp .LP -Partitions can only be specified when installing to an x86 system. If partitions are specified for a SPARC system, the installation fails. The \fBpartition\fR element has the following attributes: +GUID Partition Table partitions are the preferred x86 and SPARC partitioning method. GPT partitions are usable directly by ZFS without requiring slices. The \fBgpt_partition\fR element has the following attributes: +.sp +.ne 2 +.mk +.na +\fB\fBname\fR\fR +.ad +.RS 13n +.rt +The \fBname\fR attribute is the GPT partition number. Values 0-7 are valid for Oracle Solaris. +.sp +The \fBname\fR attribute is required. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBaction\fR\fR +.ad +.RS 13n +.rt +The \fBaction\fR attribute can have the following values: +.sp +.ne 2 +.mk +.na +\fB\fBcreate\fR\fR +.ad +.sp .6 +.RS 4n +This is the default action for a partition. The \fBcreate\fR action tells the installer to create a partition with the specified name. If a partition with the same name already exists, that existing partition is deleted first. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBdelete\fR\fR +.ad +.sp .6 +.RS 4n +The \fBdelete\fR action tells the installer to delete the named partition. If the named partition does not exist, the \fBdelete\fR action is skipped and a warning message is output. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBpreserve\fR\fR +.ad +.sp .6 +.RS 4n +The \fBpreserve\fR action tells the installer to leave the named partition untouched. This action is commonly used if another operating system is installed at another location on the same disk. +.RE + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBpart_type\fR\fR +.ad +.RS 13n +.rt +The \fBpart_type\fR attribute specifies the GUID partition type. The value can be a supported GUID alias, such as \fBsolaris\fR, or an explicit GUID hexadecimal string value. +.sp +The \fBpart_type\fR attribute is required. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBin_zpool\fR\fR +.ad +.RS 13n +.rt +The \fBin_zpool\fR attribute links this partition to a ZFS pool defined in the \fBlogical\fR section of the AI manifest. The value of the \fBin_zpool\fR attribute must match the value of the \fBname\fR attribute of the corresponding \fBzpool\fR element. +.sp +If the \fBin_zpool\fR attribute is specified, then do not specify \fBin_zpool\fR for the associated \fBdisk\fR element or any subordinate \fBslice\fR elements. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBin_vdev\fR\fR +.ad +.RS 13n +.rt +The \fBin_vdev\fR attribute links this partition to a virtual device defined in the \fBlogical\fR section of the AI manifest. The value of the \fBin_vdev\fR attribute must match the value of the \fBname\fR attribute of the corresponding \fBvdev\fR element. +.sp +If the \fBin_vdev\fR attribute is specified, then do not specify \fBin_vdev\fR for the associated \fBdisk\fR element or any subordinate \fBslice\fR elements. +.RE + +.sp +.LP +GPT partitions can have a \fBsize\fR sub-element to specify the size of the partition. See the beginning of the "Disk Layout" section for details about how to use the \fBsize\fR element. +.SS "Legacy Partitions" +.sp +.LP +Legacy \fBfdisk\fR partitions can only be specified when installing to an x86 system. If \fBfdisk\fR partitions are specified for a SPARC system, the installation fails. The \fBpartition\fR element is used for \fBfdisk\fR partitions. The \fBpartition\fR element has the following attributes: .sp .ne 2 .mk @@ -1061,10 +1204,10 @@ Multiple pools can be defined by using the \fBzpool\fR sub-element of the \fBlogical\fR element. Only one of these pools can be the root pool. The installation fails if multiple root pools are defined. .sp .LP -If a \fBzpool\fR element defines a root pool, and no target disks, partitions, or slices are specified in the AI manifest, then the installer selects a target as described in "Installation Location" above. This selection is automatically assigned to the root pool. +If a \fBzpool\fR element defines a root pool, and no target disks, partitions (GPT or \fBfdisk\fR), or slices are specified in the AI manifest, then the installer selects a target as described in "Installation Location" above. This selection is automatically assigned to the root pool. .sp .LP -If target disks, partitions, or slices are specified in the AI manifest, then the \fBzpool\fR must be associated with at least one of these disks, partitions, or slices. To make this association, use the \fBin_zpool\fR attribute of the \fBdisk\fR element, the \fBpartition\fR element, or the \fBslice\fR element. +If target disks, partitions (GPT or \fBfdisk\fR), or slices are specified in the AI manifest, then the \fBzpool\fR must be associated with at least one of these disks, partitions (GPT or \fBfdisk\fR), or slices. To make this association, use the \fBin_zpool\fR attribute of the \fBdisk\fR element, the \fBgpt_partition\fR element, the \fBpartition\fR element, or the \fBslice\fR element. .sp .LP The \fBzpool\fR element has the following attributes: @@ -1078,7 +1221,7 @@ .rt This is the name of the new pool. This value must be a name that can be passed to the \fBzpool create\fR command. .sp -This name could be used as the value of an \fBin_zpool\fR attribute of a \fBdisk\fR, \fBpartition\fR, or \fBslice\fR element to define that disk, partition, or slice as a constituent device in the \fBzpool\fR. +This name could be used as the value of an \fBin_zpool\fR attribute of a \fBdisk\fR, \fBgpt_partition\fR, \fBpartition\fR, or \fBslice\fR element to define that disk, GPT partition, \fBfdisk\fR partition, or slice as a constituent device in the \fBzpool\fR. .RE .sp @@ -1211,13 +1354,13 @@ Use the \fBvdev\fR element to define the size or structure of a \fBzpool\fR. You can specify multiple \fBvdev\fR elements, each with a different redundancy type. .sp .LP -If a \fBzpool\fR contains more than one \fBvdev\fR element, then you must use the \fBin_vdev\fR attribute on any \fBdisk\fR, \fBpartition\fR, or \fBslice\fR elements that are defined with \fBin_zpool\fR attributes. +If a \fBzpool\fR contains more than one \fBvdev\fR element, then you must use the \fBin_vdev\fR attribute on any \fBdisk\fR, \fBgpt_partition\fR, \fBpartition\fR, or \fBslice\fR elements that are defined with \fBin_zpool\fR attributes. .sp .LP -You can omit the \fBin_zpool\fR attribute on a disk, partition, or slice if the \fBvdev\fR name is unique throughout the AI manifest. +You can omit the \fBin_zpool\fR attribute on a disk, GPT partition, \fBfdisk\fR partition, or slice if the \fBvdev\fR name is unique throughout the AI manifest. .sp .LP -If a \fBzpool\fR contains only one \fBvdev\fR element, you can omit the \fBin_vdev\fR attribute on a \fBdisk\fR, \fBpartition\fR, or \fBslice\fR. +If a \fBzpool\fR contains only one \fBvdev\fR element, you can omit the \fBin_vdev\fR attribute on a \fBdisk\fR, \fBgpt_partition\fR, \fBpartition\fR, or \fBslice\fR. .sp .LP The \fBvdev\fR element has the following attributes: @@ -1231,7 +1374,7 @@ .rt This is the name of the new \fBvdev\fR. .sp -This name should be used as the value of an \fBin_vdev\fR attribute of a \fBdisk\fR, \fBpartition\fR, or \fBslice\fR element to define that disk, partition, or slice as a constituent device in the \fBvdev\fR +This name should be used as the value of an \fBin_vdev\fR attribute of a \fBdisk\fR, \fBgpt_partition\fR, \fBpartition\fR, or \fBslice\fR element to define that disk, partition (GPT or \fBfdisk\fR), or slice as a constituent device in the \fBvdev\fR .RE .sp @@ -1326,7 +1469,7 @@ .sp .LP -To add a device to a \fBvdev\fR, use the \fBin_zpool\fR and \fBin_vdev\fR attributes of a \fBdisk\fR, \fBpartition\fR, or \fBslice\fR element. The following example specifies a root pool named \fBrpool\fR that is mirrored over two disks: +To add a device to a \fBvdev\fR, use the \fBin_zpool\fR and \fBin_vdev\fR attributes of a \fBdisk\fR, \fBgpt_partition\fR, \fBpartition\fR, or \fBslice\fR element. The following example specifies a root pool named \fBrpool\fR that is mirrored over two disks: .sp .in +2 .nf @@ -1558,7 +1701,7 @@ .ad .RS 8n .rt -When \fBuse\fR is \fBswap\fR, the \fBzvol\fR is created and used as a swap device. The \fBzvol\fR is also used as a swap device during the installation. +When \fBuse\fR is \fBswap\fR, the \fBzvol\fR is created and used as a swap device. The \fBzvol\fR is also used as a swap device during the installation. The \fBsize\fR sub-element of the \fBzvol\fR element can have the value \fBmax\fR. When the \fBmax\fR keyword is specified, the size of the volume will be 90% of the free space on the pool on which the volume is created. Only one volume on a pool can specify a size of \fBmax\fR. .RE .sp @@ -1576,7 +1719,7 @@ .sp .LP -Use the \fBsize\fR sub-element to specify the size of the \fBzvol\fR See the beginning of the "Disk Layout" section for details about how to use the \fBsize\fR element. +Use the \fBsize\fR sub-element to specify the size of the \fBzvol\fR. See the beginning of the "Disk Layout" section for details about how to use the \fBsize\fR element. .sp .LP Use the \fBoptions\fR sub-element to set ZFS volume options on a \fBzvol\fR. Use of the \fBoptions\fR element for a \fBzvol\fR is similar to the use of the \fBdataset_options\fR element for a \fBzpool\fR, as shown in the following example: @@ -1743,9 +1886,7 @@ optional software components --> - + + + pkg:/to/avoid + + pkg:/entire pkg:/group/system/solaris-large-server + pkg:/to/reject pkg:/unwanted/pkg @@ -1916,9 +2092,6 @@ .sp .LP -Other values of the \fBaction\fR attribute are not supported for SVR4 installations. -.sp -.LP For each of these actions, one or more packages can be specified in the \fBname\fR element, as shown in the following example: .sp .in +2 diff -r ed1483d8def9 -r 5889a0b7b4d6 usr/src/man/aimanifest.1m --- a/usr/src/man/aimanifest.1m Tue May 08 00:28:51 2012 +0100 +++ b/usr/src/man/aimanifest.1m Mon May 07 15:52:37 2012 -0700 @@ -1,7 +1,7 @@ '\" te -.\" Copyright (c) 2011, Oracle and/or its affiliates. -.\" All rights reserved. -.TH aimanifest 1M "22 Jul 2011" "SunOS 5.11" "System Administration Commands" +.\" Copyright (c) 2011, 2012, Oracle and/or its +.\" affiliates. All rights reserved. +.TH aimanifest 1M "04 May 2012" "SunOS 5.11" "System Administration Commands" .SH NAME aimanifest \- Modify an XML file used by Automated Installer (AI) .SH SYNOPSIS @@ -676,33 +676,33 @@ \fBExample 3 \fRAdd a Publisher by Using Values Paths .sp .LP -The package repository in this example is a file repository at \fBfile:///net/host2/export/extras_repo\fR. The publisher is \fBextras\fR. +The package repository in this example is a file repository at \fBfile:///net/host2/export/extras_repo\fR. The publisher is \fBextras\fR. Since a \fBsoftware\fR element can have only one \fBsource\fR element, this example adds the new \fBpublisher\fR element to the \fBsource\fR element that contains the \fBsolaris\fR publisher. .sp .in +2 .nf $ \fBaimanifest add \e\fR -> \fBsoftware/source/publisher@name extras\fR +> \fBsoftware[@type=IPS]/source[publisher@name=solaris]/publisher@name \e\fR +\fBextras\fR $ \fBaimanifest add \e\fR -> \fBsoftware/source/publisher[@name=extras]/origin@name \e\fR +> \fBpublisher[@name=extras]/origin@name \e\fR > \fBfile:///net/host2/export/extras_repo\fR -$ \fBaimanifest set \e\fR -> \fBsoftware[source/publisher@name=extras]@name extras\fR -$ \fBaimanifest set \e\fR -> \fBsoftware[source/publisher@name=extras]@type IPS\fR .fi .in -2 .sp .sp .LP -These \fBaimanifest\fR commands result in the following AI manifest entries. The \fBsoftware\fR element is the first element in the \fIpath\fR where same-tagged siblings are allowed, so this section of XML code follows the last \fBsoftware\fR section that is already in the output file. +These \fBaimanifest\fR commands result in the following AI manifest entries if you started with the \fBdefault.xml\fR AI manifest. The \fBdestination\fR and \fBsoftware_data\fR elements are omitted for brevity. .sp .in +2 .nf - + + + + @@ -720,12 +720,13 @@ .sp .in +2 .nf -$ \fBSW_PATH=$(aimanifest add -r \e\fR -> \fB/auto_install/ai_instance/software@name extras)\fR -$ \fBaimanifest set ${SW_PATH}@type IPS\fR -$ \fBPUB_PATH=$(aimanifest add ${SW_PATH}/source/publisher@name extras)\fR -$ \fBaimanifest add \e\fR -\fB${PUB_PATH}/origin@name file:///net/host2/export/extras_repo)\fR +$ \fBNEW_PUB=$(aimanifest add -r \e\fR +> \fBsoftware[@type=IPS]/source[publisher@name=solaris]/publisher@name \e\fR +\fBextras)\fR +$ \fBecho $NEW_PUB\fR +/auto_install[1]/ai_instance[1]/software[1]/source[1]/publisher[2] +$ \fBaimanifest add ${NEW_PUB}/origin@name \e\fR +\fBfile:///net/host2/export/extras_repo\fR .fi .in -2 .sp @@ -734,7 +735,7 @@ \fBExample 5 \fRAdd a Publisher By Adding a Manifest Fragment .sp .LP -This example is the same as the previous example but uses a third method to achieve the same result. +This example adds the \fBextras\fR publisher by loading a file that contains a partial AI manifest. In this case, the result is a separate, additional \fBsoftware\fR element of type IPS with the \fBextras\fR publisher defined. This new \fBsoftware\fR element is inserted after the original IPS \fBsoftware\fR element that defines the \fBsolaris\fR publisher. Packages named in \fBsoftware_data\fR elements within this new \fBsoftware\fR element are only searched for from the \fBextras\fR publisher or other publishers defined in this new \fBsoftware\fR element. This manifest fragment also defines a package to install, since a \fBsoftware\fR element with no software to install is not useful. .sp .LP @@ -745,12 +746,15 @@ .nf - + + + pkg:/package/from/extras_repo + @@ -759,7 +763,7 @@ .sp .LP -Even though you only want the software section, you must include the \fBauto_install\fR and \fBai_instance\fR elements as well. You must include everything that would be required in the \fIpath\fR operand. If the loaded file specifies attributes for the \fBauto_install\fR or \fBai_instance\fR elements, then those attribute values replace existing values or are added. +Even though you only want the \fBsoftware\fR section, you must include the \fBauto_install\fR and \fBai_instance\fR elements as well. If the loaded file specifies attributes for the \fBauto_install\fR or \fBai_instance\fR elements, then those attribute values replace existing values or are added. .sp .LP @@ -777,13 +781,13 @@ \fBExample 6 \fRAdd a Package by Using a Values Path .sp .LP -This example adds a package to the \fBsoftware\fR element that has a \fBpublisher\fR element with name \fBextras\fR from the previous example by specifying the publisher name as a value in the path. The example also shows using a relative path specification. +This example adds a package to the \fBsoftware\fR element that has a \fBpublisher\fR element with name \fBsolaris\fR by specifying the publisher name as a value in the path. .sp .in +2 .nf $ \fBaimanifest add \e\fR -> \fBsoftware[source/publisher@name=extras]/software_data/name \e\fR +> \fBsoftware[source/publisher@name=solaris]/software_data/name \e\fR > \fBpkg:/system/utils\fR .fi .in -2 @@ -791,21 +795,18 @@ .sp .LP -This \fBaimanifest\fR command adds the following \fBsoftware_data\fR section. +This \fBaimanifest\fR command adds the second \fBsoftware_data\fR element shown below if you started with the \fBdefault.xml\fR AI manifest. .sp .in +2 .nf - - - - - - - - pkg:/system/utils - - + + pkg:/entire@latest + pkg:/group/system/solaris-large-server + + + pkg:/system/utils + .fi .in -2 @@ -813,18 +814,64 @@ \fBExample 7 \fRAdd a Package by Using a Returned Path .sp .LP -This example is the same as the previous example but uses a different method to achieve the same result. Instead of specifying the name of the publisher as a value in the path, this example uses the path to the \fBsoftware\fR element that was saved in \fBSW_PATH\fR in the example "Add a Publisher by Using Returned Paths." +This example is the same as the previous example but uses a different method to achieve the same result. This example uses the \fBget\fR subcommand with the returned path option to add the package to the \fBsoftware\fR element where the \fBsolaris\fR publisher is defined. .sp .in +2 .nf -$ \fBaimanifest add ${SW_PATH}/software_data/name pkg:/system/utils\fR +$ \fBNEW_PKG=$(aimanifest get -r \e\fR +\fBsoftware[source/publisher@name=solaris] | awk '{print $2 }')\fR +$ \fBecho $NEW_PKG\fR +/auto_install[1]/ai_instance[1]/software[1] +$ \fBaimanifest add ${NEW_PKG}/software_data/name \e\fR +\fBpkg:/system/utils\fR .fi .in -2 .sp .LP -\fBExample 8 \fRValidate a Manifest +\fBExample 8 \fRAdd a Package By Adding a Manifest Fragment +.sp +.LP +This example adds the package by loading a file that contains a partial AI manifest. In this case, the result is a separate, additional \fBsoftware\fR element of type IPS inserted after the original IPS \fBsoftware\fR element. This new \fBsoftware\fR element contains only a \fBsoftware_data\fR element; no \fBsource\fR element is specified. Packages named in \fBsoftware_data\fR elements within this new \fBsoftware\fR element are searched for from publishers defined in the preceding \fBsoftware\fR element. + +.sp +.LP +Create a file named \fBnewpkg.xml\fR with the following content: + +.sp +.in +2 +.nf + + + + + pkg:/system/utils + + + + +.fi +.in -2 + +.sp +.LP +Even though you only want the \fBsoftware\fR section, you must include the \fBauto_install\fR and \fBai_instance\fR elements as well. If the loaded file specifies attributes for the \fBauto_install\fR or \fBai_instance\fR elements, then those attribute values replace existing values or are added. + +.sp +.LP +Use the following command to add this \fBsoftware\fR section to the \fBAIM_MANIFEST\fR manifest: + +.sp +.in +2 +.nf +$ \fBaimanifest load -i newpkg.xml\fR +.fi +.in -2 +.sp + +.LP +\fBExample 9 \fRValidate a Manifest .sp .LP Validate the \fBAIM_MANIFEST\fR manifest. diff -r ed1483d8def9 -r 5889a0b7b4d6 usr/src/man/installadm.1m --- a/usr/src/man/installadm.1m Tue May 08 00:28:51 2012 +0100 +++ b/usr/src/man/installadm.1m Mon May 07 15:52:37 2012 -0700 @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 2008, 2012, Oracle and/or its .\" affiliates. All rights reserved. -.TH installadm 1M "14 Mar 2012" "SunOS 5.11" "System Administration Commands" +.TH installadm 1M "20 Apr 2012" "SunOS 5.11" "System Administration Commands" .SH NAME installadm \- Manages automated installations on a network .SH SYNOPSIS .LP .nf -/usr/bin/installadm [-h|--help] +/usr/sbin/installadm [-h|--help] .fi .LP @@ -785,11 +785,11 @@ .ad .sp .6 .RS 4n -Optional: Lists the manifests and scripts associated with the install services on a local server. +Optional: Lists the manifests and scripts associated with the install services on a local server, including criteria for each manifest. Criteria associated with the default manifest for the service are labeled as ignored. Inactive manifests are labeled. Inactive manifests have no associated criteria and are not the default manifest for that service. .sp -When \fB-n\fR is not specified, displays an abbreviated listing per service. This includes the default manifest or script, and all non-default manifests and scripts that have criteria associated with them. Criteria are not listed. +When \fB-n\fR is not specified, displays all manifests and scripts for all services. .sp -When \fB-n\fR is specified, displays all manifests and scripts for the given service, using a more complete listing format that includes criteria for each manifest. Inactive manifests, which have no associated criteria and are not designated as the default, are so marked. Criteria associated with a default manifest are marked as inactive. +When \fB-n\fR is specified, displays all manifests and scripts for the given service. .RE .sp @@ -800,11 +800,11 @@ .ad .sp .6 .RS 4n -Optional: Lists the profiles associated with the install services on a local server. +Optional: Lists the profiles associated with the install services on a local server, including criteria for each profile. .sp -When \fB-n\fR is not specified, displays an abbreviated listing per service that includes the profile names. +When \fB-n\fR is not specified, displays all profiles for all services. .sp -When \fB-n\fR is specified, displays the profiles for the requested service along with their criteria. +When \fB-n\fR is specified, displays the profiles for the given service. .RE .RE @@ -899,7 +899,7 @@ .ad .sp .6 .RS 4n -Optional: Specifies that this manifest or script is the new default manifest or script for the service. Any criteria specified are ignored until the manifest or script is no longer the default. +Optional: Specifies that this manifest or script is the new default manifest or script for the service. Any criteria specified are stored, but these criteria are ignored until a different manifest or script is made the default. .RE .RE @@ -1441,7 +1441,7 @@ CriteriaDescription \fBarch\fRArchitecture per \fBuname -m\fR. \fBcpu\fRCPU class per \fBuname -p\fR. -\fBhostname\fRAssigned hostname. +\fBhostname\fRAssigned host name. \fBipv4\fRIP version 4 network address. \fBmac\fRT{ Hexadecimal MAC address with colon (:) separators. @@ -1742,14 +1742,16 @@ .in +2 .nf $ \fBinstalladm list -p\fR -Service Name Profile ------------- ------- -sparc2 myprofile.xml - myprofile2.xml -svc0817 profile3 -svc0819 profile4.xml - newprofile - foo.xml +Service/Profile Name Criteria +-------------------- -------- +default-i386 + sc_sample.xml None + +default-sparc + newprofile-1 ipv4 = 10.0.2.100 - 10.0.2.199 + mem = 1024 MB - unbounded + network = 10.0.0.0 + newprofile-2 None .fi .in -2 .sp @@ -1777,9 +1779,9 @@ .in +2 .nf # \fBinstalladm list -m -n svc1\fR -Manifest Criteria --------- -------- -my_manifest mac = AA:BB:CC:DD:EE:FF +Manifest Status Criteria +-------- ------ -------- +my_manifest mac = AA:BB:CC:DD:EE:FF .fi .in -2 .sp @@ -1808,9 +1810,9 @@ .in +2 .nf # \fBinstalladm list -m -n svc1\fR -Manifest Criteria --------- -------- -chosen_name ipv4 = 10.0.2.100 - 10.0.2.199 +Manifest Status Criteria +-------- ------ -------- +chosen_name ipv4 = 10.0.2.100 - 10.0.2.199 .fi .in -2 .sp @@ -1847,10 +1849,10 @@ .in +2 .nf # \fBinstalladm list -m -n svc1\fR -Manifest Criteria --------- -------- -my_name arch = i86pc - mem = 2048 MB - unbounded +Manifest Status Criteria +-------- ------ -------- +my_name arch = i86pc + mem = 2048 MB - unbounded .fi .in -2 .sp