Table 8–1 describes the keywords and values that you can use in the rules file. For detailed instructions to create a rules file, see Creating the rules File.
Table 8–1 Descriptions of Rule Keywords and Values
Keyword |
Value |
Matches |
||
---|---|---|---|---|
minus sign (-) |
Anything. The any keyword always succeeds. |
|||
processor_type Valid values for processor_type are the following:
|
A system's processor type. The uname -p command reports the system's processor type. |
|||
actual_disk_name size_range actual_disk_name – A disk name in the form cxtydz, such as c0t3d0 or c0d0, or the special word rootdisk. If rootdisk is used, the disk to be matched is determined in the following order:
size_range – The size of the disk, which must be specified as a range of Mbytes (x-x). Note – When calculating size_range, remember that a Mbyte equals 1,048,576 bytes. A disk might be advertised as a “535–Mbyte” disk, but the disk might contain only 510 million bytes of disk space. The JumpStart program views the “535–Mbyte” disk as a 510–Mbyte disk because 535,000,000 / 1,048,576 = 510. A “535–Mbyte” disk does not match a size_range equal to 530–550. |
The name and size of a system's disk in Mbytes. Example:
In the example, the JumpStart program attempts to match a system disk that is named c0t3d0. The disk can hold between 250 and 300 Mbytes of information. Example:
In the example, the JumpStart program attempts to match a disk in the following order:
|
|||
actual_domain_name |
A system's domain name, which controls how a naming service determines information. If you have a system already installed, the domainname command reports the system's domain name. |
|||
actual_IP_address |
A system's IP address. |
|||
actual_host_name |
A system's host name. If you have a system that is already installed, the uname -n command reports the system's host name. |
|||
slice version slice – A disk slice name in the form cwtxdysz, such as c0t3d0s5, or the special words any or rootdisk. If any is used, the JumpStart program attempts to match all of the system's disks in kernel probe order. If rootdisk is used, the disk to be matched is determined in the following order:
version – A version name or the special words any or upgrade. If any is used, any Solaris or SunOS release is matched. If upgrade is used, any Solaris release that is supported and can be upgraded is matched. If the JumpStart program finds a Solaris release but is unable to determine the version, the version that is returned is SystemV. |
A disk that has a root (/) file system that corresponds to a particular version of Solaris software. Example:
In the example, the JumpStart program attempts to match a system that has a Solaris root (/) file system on c0t3d0s1. |
|||
actual_platform_group Valid values are sun4u, i86pc, and prep. A list of systems and their corresponding platform group is presented in the Solaris Sun Hardware Platform Guide at http://docs.sun.com. |
A system's platform group. If you have a system that is already installed, the arch -k command or the uname -m command reports the system's platform group. |
|||
physical_mem The value must be a range of Mbytes, x-x, or a single Mbyte value. |
A system's physical memory size in Mbytes. Example:
The example tries to match a system with a physical memory size between 64 and 128 Mbytes. If you have a system that is already installed, the output of the prtconf command, line 2, reports the system's physical memory size. |
|||
actual_platform_name |
A system's platform name. See the Solaris Sun Hardware Platform Guide at http://docs.sun.com for a list of valid platform names. To find the platform name of an installed system, use the uname -i command or the output of the prtconf command, line 5. Note – If the actual_platform_name contains spaces, you must replace spaces with underscores (_). Example: SUNW,Sun_4_50 |
|||
network_num |
A system's network number, which the JumpStart program determines by performing a logical AND between the system's IP address and the subnet mask. Example:
The example tries to match a system with a 192.168.2.8 IP address, if the subnet mask is 255.255.255.0. |
|||
Solaris_x |
A version of Solaris software that is already installed on a system. Example:
In the example, the JumpStart program attempts to match a system with the Solaris 10 10/09 OS already installed. |
|||
probe_keyword |
A valid probe keyword or a valid custom probe keyword. Example:
The example returns the size of a system's disks in Mbytes and in kernel probe order, for example, c0t3d0s1, c0t4d0s0, on a SPARC based system. The JumpStart program sets the SI_DISKLIST, SI_DISKSIZES, SI_NUMDISKS, and SI_TOTALDISK environment variables. Note – The probe keyword is unique in that the keyword does not attempt to match an attribute and run a profile. The probe keyword returns a value. Consequently, you cannot specify begin scripts, profiles, and finish scripts with the probe rule keyword. Probe keywords are described in Chapter 5, Creating Custom Rule and Probe Keywords (Tasks). |
|||
size_range The value must be specified as a range of Mbytes (x-x). Note – When calculating size_range, remember that one Mbyte equals 1,048,576 bytes. A disk might be advertised as a “535–Mbyte” disk, but the disk might have only 510 million bytes of disk space. The JumpStart program views the “535–Mbyte” disk as a 510–Mbyte disk because 535,000,000 / 1,048,576 = 510. A “535–Mbyte” disk does not match a size_range equal to 530–550. |
The total disk space on a system in Mbytes. The total disk space includes all the operational disks that are attached to a system. Example:
In the example, the JumpStart program tries to match a system with a total disk space between 300 and 500 Mbytes. |