Go to main content

Customizing Automated Installations With Manifests and Profiles

Exit Print View

Updated: November 2020
 
 

Defining Criteria for Manifests and Profiles

The following commands enable you to define criteria for manifests and profiles:

  • installadm create-manifest

  • installadm create-profile

  • installadm set-criteria

Some criteria keywords accept both individual values or a range of values. To specify no limit to a range, use unbounded as the end limit. For example, a memory definition of 4096-unbounded means 4 MB or greater.

To specify criteria, you use one of two options with the commands:

  • –c criteria

    With this option, you specify the criteria definition in the command line. For example:

    $ installadm create-manifest -c mac="aa:bb:cc:dd:ee:ff" other-options
    $ installadm create-profile -c mem="2048-unbounded" -c zonename="zone1 zone2" \
       other-options
  • –C criteria-file

    With this option, all criteria definitions are in an XML file. In the command, you simply refer to the file. For example:

    $ installadm set-criteria -C /var/tmp/mycriteria.xml other-options

    Use any XML editor to create a file. To specify a value or a series of value for a criterion, use the <value> tag. For a range of values, use the <range> tag.

    The following is an example of a criteria file's contents:

    <?xml version="1.0" encoding="UTF-8"?>
    <ai_criteria_manifest>
       <ai_criteria name="mem">
          <range>2048
          unbounded</range>
       </ai_criteria>
       <ai_criteria name="platform">
          <value>SUNW,SPARC Enterprise</value>
       </ai_criteria>
       <ai_criteria name="cpu">
          <value>sparc</value>
       </ai_criteria>
       <ai_criteria name="hostname">
          <value>host1 host3 host5</value>
       </ai_criteria>
    </ai_criteria_manifest>
    

The following table lists the keywords for defining criteria in an XML file.

Table 2  Criteria Keywords and Criteria Hierarchy
Priority
Criteria Keyword
Description
Command Line and XML File Examples
1
mac
Hexadecimal MAC address with colon (:) separators, or range of MAC addresses
CLI:
-c mac=0:14:4F:20:53:94[-0:14:4F:20:53:A0]
XML:
<ai_criteria name="mac">
    <value>0:14:4F:20:53:97</value>
</ai_criteria>
or
<ai_criteria name="mac">
   <range>
       0:14:4F:20:53:94
       0:14:4F:20:53:A0
   </range>
</ai_criteria>
2
ipv4
IP version 4 network address, or range of IP addresses
CLI:
-c ipv4="192.0.2.5[-192.0.2.10]"
XML:
<ai_criteria name="ipv4">
    <value>192.0.2.5</value>
</ai_criteria>
or
<ai_criteria name="ipv4">
    <range>
        192.0.2.5
        192.0.2.10
    </range>
</ai_criteria>
3
platform
Platform name returned by uname -i for x86 systems and prtconf -b for SPARC systems

    Values include:

  • i86pc

  • SUNW,SPARC-Enterprise for M4000 and M5000 servers

  • ORCL, SPARC-T4-2 for T4 servers

CLI:
-c platform="SUNW,SPARC-Enterprise"
XML:
<ai_criteria name="platform">
    <value>SUNW,SPARC-Enterprise</value>
</ai_criteria>
4
arch
Architecture returned by uname -m
Values: i86pc, sun4u, or sun4v
CLI:
-c arch="i86pc"
XML:
<ai_criteria name="arch">
    <value>i86pc</value>
</ai_criteria>
5
cpu
CPU class returned by uname -p
Values: i386 or sparc
CLI:
-c cpu="sparc"
XML:
<ai_criteria name="cpu">
    <value>sparc</value>
</ai_criteria>
6
network
IP version 4 network number, or a range of network numbers
CLI:
-c network="10.0.0.0[-11.0.0.0]"
XML:
<ai_criteria name="network">
    <value>10.0.0.0</value>
</ai_criteria>
or
<ai_criteria name="network">
   <range>
       10.0.0.0
       11.0.0.0
   </range>
</ai_criteria>
7
mem
Memory size in megabytes returned by prtconf, or a range of memory size
The unbounded keyword indicates no upper limit in a range.
CLI:
-c mem="4096[-unbounded]"
XML:
<ai_criteria name="mem">
     <value>4096</value>
</ai_criteria>
or
<ai_criteria name="mem">
     <range>
        2048
        unbounded
     </range>
</ai_criteria>
8
zonename
Name or list of names of zones as shown by zoneadm list.
CLI:
-c zonename="zoneA[ zoneB zoneC]"
XML:
<ai_criteria name="zonename">
    <value>zoneA[ zoneB zoneC]</value>
</ai_criteria>
9
hostname
Client host name or list of client host names.
CLI:
-c hostname="host1 [host2 host6 ...]"
XML:
<ai_criteria name="hostname">
   <value>host1 [host host6 …]</value>
</ai_criteria>