Solaris Advanced Installation Guide

Rule Keyword and Rule Value Descriptions

Table 8-2 describes the rule keywords and rule values that you can use in the rules file.

Table 8-2 Rule Keyword and Rule Value Descriptions

Rule Keyword 

Rule Values 

Description 

any

minus sign (-)

Match always succeeds. 

arch

processor_type

Valid values for processor_typeare sparc for the SPARC platform, and i386 for the x86 platform.

Matches a system's processor type. The uname -p command reports the system's processor type.

domainname

domain_name

Matches a system's domain name, which controls how a name service determines information.  

If you have a system already installed, the domainname command reports the system's domain name.

disksize

disk_name size_range

disk_name - A disk name in the form cxtydz, such as c0t3d0, or the special word rootdisk. If rootdisk is used, the disk to be matched is determined in the following order:

  • The disk that contains the pre-installed boot image (new SPARC-based system with factory JumpStart installed)

  • The c0t3d0s0 disk, if it exists

  • The first available disk (searched in kernel probe order)

size_range - The size of the disk, which must be specified as a range of Mbytes (xx-xx).

Matches a system's disk (in Mbytes). 

Example: 


disksize c0t3d0 250-300

The example tries to match a system with a c0t3d0 disk that is between 250 and 300 Mbytes.


Note -

When calculating size_range, remember that a Mbyte equals 1,048,576 bytes. A disk may be advertised as a "535 Mbyte" disk, but it may have only 510 million bytes of disk space. The Solaris installation program will actually view the "535 Mbyte" disk as a 510 Mbyte disk because 535,000,000 / 1,048,576 = 510. So, a "535 Mbyte" disk would not match a size_range equal to 530-550.


hostaddress

IP_address

Matches a system's IP address. 

hostname

host_name

Matches a system's host name.  

If you have a system already installed, the uname -n command reports the system's host name.

installed

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, all of the system's disks will try to be matched (in kernel probe order). If rootdisk is used, the disk to be matched is determined in the following order:

  • The disk that contains the pre-installed boot image (new SPARC-based system with factory JumpStart installed)

  • The c0t3d0s0 disk, if it exists

  • The first available disk (searched in kernel probe order)

version - A version name, Solaris_2.x, or the special words any or upgrade. If any is used, any Solaris or SunOS release is matched. If upgrade is used, any upgradable Solaris 2.1 or greater release is matched.

If the installation program finds a Solaris release but is unable to determine the version, the version returned is SystemV.

Matches a disk that has a root file system corresponding to a particular version of Solaris software. 

Example:  


installed c0t3d0s1 Solaris_2.5

The example tries to match a system that has a Solaris 2.5 root files system on c0t3d0s1.

karch

platform_group

Valid values are: sun4d, sun4c, sun4m, sun4u, i86pc, prep. (See Appendix C, Platform Names and Groups for a detailed list of systems and their corresponding platform group.)

Matches a system's platform group.  

If you have a system already installed, the arch -k command or the uname -m command reports the system's platform group.

memsize

physical_mem

The value must be a range of Mbytes (xx-xx) or a single Mbyte value.

Matches a system's physical memory size (in Mbytes).  

Example: 


memsize 16-32

The example tries to match a system with a physical memory size between 16 and 32 Mbytes. 

If you have a system already installed, the output of the prtconf command (line 2) reports the system's physical memory size.

model

platform_name

Matches a system's platform name. See Appendix C, Platform Names and Groups 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 platform_name contains spaces, you must replace spaces with underscores (_). For example: SUNW,Sun_4_50


network

network_num

Matches a system's network number, which the Solaris installation program determines by performing a logical AND between the system's IP address and the subnet mask.  

Example:  


network 193.144.2.0

The example tries to match a system with a 193.144.2.8 IP address (if the subnet mask were 255.255.255.0). 

osname

Solaris_2.x

Matches a version of Solaris software already installed on a system.  

Example:  


osname Solaris_2.5

The example tries to match a system with Solaris 2.5 already installed. 

totaldisk

size_range

The value must be specified as a range of Mbytes (xx-xx).

Matches the total disk space on a system (in Mbytes). The total disk space includes all the operational disks attached to a system. 

Example:  


totaldisk 300-500

The example tries to match a system with a total disk space between 300 and 500 Mbytes. 


Note -

When calculating size_range, remember that a Mbyte equals 1,048,576 bytes. A disk may be advertised as a "535 Mbyte" disk, but it may have only 510 million bytes of disk space. The Solaris installation program will actually view the "535 Mbyte" disk as a 510 Mbyte disk because 535,000,000 / 1,048,576 = 510. So, a "535 Mbyte" disk would not match a size_range equal to 530-550.