How to Assign Manifests to a Client

If you want to create new AI manifests and SC manifests, you need to assign the manifests for use with a particular client. Use the following basic procedure:

1. Create your AI manifest. You can copy and use the default manifest that is provided in How to Create New AI Manifests. Or, you can copy and use the sample manifest that uses all parameters in A Complete AI Manifest.

   Save your AI manifest in a file named ai_manifest1.xml.

2. Create an SC manifest by copying and modifying the example in Modifying the 2009.06 SC Manifest.

   Save your SC manifest in a file named sc_mainfest1.xml.

3. Create a criteria manifest based on the specifications of the client. You can use the example in Criteria Based on the Client IP Address as the first draft for a new criteria manifest. Then see the other examples below to modify your draft.

   The criteria manifest file is the bridge that connects the AI manifest file and the SC manifest file with a client. Use the criteria manifest file to add the manifests to an install service. The client sends its hardware characteristics to the install service and gets the manifest file that you assigned to the service.

   The criteria manifest includes the file location of your AI manifest and your SC manifest inside the criteria manifest. See the criteria manifest examples below that refer to the AI manifest, ai_manifest1.xml, and the SC manifest, sc_mainfest1.xml.

4. Add the criteria manifest to the install service by running the following command:

   # installadm add -m manifest.xml -n svcname

   Where manifest.xml file is the name of your criteria manifest, and that manifest is being assigned to the install service named svcname.

Criteria Manifest Examples

The following examples show options for creating a criteria manifest. Each example below is a complete criteria manifest.

• Criteria Based on the Client IP Address

• Criteria Based on the Client MAC Address

• Criteria Based on the Client IP Address Range

• Criteria Based on the Client MAC Address Range

• Criteria Based on the Client Memory Size

• Criteria Based on the Client Architecture

Criteria Based on the Client IP Address

You can use this example as the first draft of a new criteria manifest. Use the other examples to modify your draft.

The following example assigns ai_manifest1 and sc_manifest1 to the client with IP address, 10.6.68.127.

<ai_criteria_manifest>
    <ai_criteria name="IPV4">
        <value>10.6.68.127</value>
    </ai_criteria>
    <ai_manifest_file URI="./ai_manifest1.xml"/>
    <sc_manifest_file name="AI" URI="./sc_manifest1.xml"/>
</ai_criteria_manifest>

---

Note - In criteria manifests, include the full path for any manifest file names that are referenced. In the examples in this section, the referenced manifest files reside in the current directory. The path for a manifest file in the current directory uses the format, ./ai_manifest1.xml.

---

Criteria Based on the Client MAC Address

The following example assigns ai_manifest1 and sc_manifest1 to the client with MAC address 0:14:4f:20:53:94.

<ai_criteria_manifest>
    <ai_criteria name="MAC">
        <value>0:14:4F:20:53:94</value>
    </ai_criteria>
    <ai_manifest_file URI="./ai_manifest1.xml"/>
    <sc_manifest_file name="AI" URI="./sc_manifest1.xml"/>
</ai_criteria_manifest> 

Criteria Based on the Client IP Address Range

The following example assigns ai_manifest1 and sc_manifest1 to clients in the IP address range, 10.6.68.1 to 10.6.68.200. Since there is more than 1 value, the tag, <range>, should be used.

<ai_criteria_manifest>
    <ai_criteria name="IPV4">
        <range>
            10.6.88.1
            10.6.68.200
        </range>
    </ai_criteria>
    <ai_manifest_file URI="./ai_manifest1.xml"/>
    <sc_manifest_file name="AI" URI="./sc_manifest1.xml"/>
</ai_criteria_manifest>

Criteria Based on the Client MAC Address Range

The following example assigns ai_manifest1 and sc_manifest1 to clients in the MAC address range, 0:14:4F:20:53:94 to 0:14:4F:20:53:A0. Since there is more than 1 value, the tag, <range>, should be used.

<ai_criteria_manifest>
   <ai_criteria name="MAC">
       <range>
           0:14:4F:20:53:94
           0:14:4F:20:53:A0
       </range>
   </ai_criteria>
   <ai_manifest_file URI="./ai_manifest1.xml"/>
   <sc_manifest_file name="AI" URI="./sc_manifest1.xml"/>
</ai_criteria_manifest> 

Criteria Based on the Client Memory Size

The following example assigns ai_manifest1 and sc_manifest1 to clients that have at least 2 Gbytes memory. The None keyword is used to express no bounding value. The value in the <range> tag is expressed in megabytes, in this case, 2048 MB.

<ai_criteria_manifest>
    <ai_criteria name="MEM">
         <range>
            2048
            unbounded
         </range>
    </ai_criteria>
    <ai_manifest_file URI="./ai_manifest1.xml"/>
    <sc_manifest_file name="AI" URI="./sc_manifest1.xml"/>
</ai_criteria_manifest>

Criteria Based on the Client Architecture

The following example assigns ai_manifest1 and sc_manifest1 to clients with an architecture of i86pc.

<ai_criteria_manifest>
    <ai_criteria name="ARCH">
        <value>i86pc</value>
    </ai_criteria>
    <ai_manifest_file URI="./ai_manifest1.xml"/>
    <sc_manifest_file name="AI" URI="./sc_manifest1.xml"/>
</ai_criteria_manifest>