JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris 10 1/13 Installation Guide: JumpStart Installations     Oracle Solaris 10 1/13 Information Library
search filter icon
search icon

Document Information

Preface

1.  Where to Find Oracle Solaris Installation Planning Information

2.  JumpStart (Overview)

3.  Preparing JumpStart Installations (Tasks)

4.  Using Optional JumpStart Features (Tasks)

5.  Creating Custom Rule and Probe Keywords (Tasks)

6.  Performing a JumpStart Installation (Tasks)

7.  Installing With JumpStart (Examples)

8.  JumpStart Keyword Reference

Rule Keywords and Values

Profile Keywords and Values

Profile Keywords Quick Reference

Profile Keyword Descriptions and Examples

archive_location Keyword

Archive Stored on an NFS Server

Archive Stored on an HTTP or HTTPS Server

Archive Stored on an FTP Server

Archive Stored on a Local Tape

Archive Stored on a Local Device

Archive Stored on a Local File

backup_media Profile Keyword

boot_device Profile Keyword (UFS and ZFS)

bootenv Profile Keyword (UFS and ZFS)

client_arch Profile Keyword

client_root Profile Keyword

client_swap Profile Keyword

How the Size of swap Is Determined

cluster Profile Keyword (Adding Software Groups) (UFS and ZFS)

cluster Profile Keyword (Adding or Deleting Clusters) (UFS and ZFS)

dontuse Profile Keyword (UFS and ZFS)

x86: fdisk Profile Keyword (UFS and ZFS)

filesys Profile Keyword (Mounting Remote File Systems) (UFS and ZFS)

filesys Profile Keyword (Creating Local File Systems)

filesys Profile Keyword (Creating RAID-1 Volumes)

forced_deployment Profile Keyword (Installing Flash Archive Differential Archives)

geo Profile Keyword (UFS and ZFS)

install_type Profile Keyword (UFS and ZFS)

layout_constraint Profile Keyword

local_customization Profile Keyword (Installing Flash Archives)

locale Profile Keyword (UFS and ZFS)

metadb Profile Keyword (Creating State Database Replicas)

no_content_check Profile Keyword (Installing Flash Archives)

no_master_check Profile Keyword (Installing Flash Archives)

num_clients Profile Keyword

iSCSI Profile Keyword

package Profile Keyword (UFS and ZFS)

Packages Stored on an NFS Server

Packages Stored on an HTTP Server

Packages Stored on a Local Device

Packages Stored on a Local File

Limitations When Using the package Keyword

Upgrade Behavior When Using the package Keyword

partitioning Profile Keyword

patch Profile Keyword

Patches Stored on an NFS Server

Patches Stored on an HTTP Server

Patches Stored on a Local Device

Patches Stored on a Local File

Limitations When Using the patch Keyword

pool Profile Keyword (ZFS Only)

root_device Profile Keyword (UFS and ZFS)

How the System's Root Disk Is Determined

system_type Profile Keyword

usedisk Profile Keyword (UFS and ZFS)

JumpStart Environment Variables

Probe Keywords and Values

9.  Installing a ZFS Root Pool With JumpStart

Glossary

Index

Rule Keywords and Values

The following table 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
any
minus sign (-)
Anything. The any keyword always succeeds.
arch
processor-type

Valid values for processor-type are as follows:

  • SPARC: sparc

  • x86: i386

A system's processor type.

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

disksize
disk-name size-range

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:

  • SPARC: The disk that contains the preinstalled boot image, which is a new SPARC based system with factory JumpStart installed

  • The c0t3d0s0 disk, if the disk exists

  • The first available disk that is searched in kernel probe 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 MB equals 1,048,576 bytes. A disk might be advertised as a 535 MB disk, but the disk might contain only 510 million bytes of disk space. The JumpStart program views the 535 MB disk as a 510 MB disk because 535,000,000 / 1,048,576 = 510. A 535 MB disk does not match a size-range equal to 530–550.


The name and size of a system's disk in MB.

For example:

disksize c0t3d0 250-300

In the example, the JumpStart program attempts to match a system disk that is named c0t3d0. The disk can hold between 250 and 300 MB of information.

For example:

disksize rootdisk 750-1000

In the example, the JumpStart program attempts to match a disk in the following order:

  1. A system disk that contains a preinstalled boot image

  2. The c0t3d0s0 disk, if the disk exists

  3. The first available disk that can hold between 750 MB and 1 GB of information

domainname
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.

hostaddress
IP-address
A system's IP address.
hostname
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.

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, 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:

  • SPARC: The disk that contains the preinstalled boot image, which is a new SPARC based system with factory JumpStart installed

  • The c0t3d0s0 disk, if the disk exists

  • The first available disk that is searched in kernel probe order

version – A version name or the special words any or upgrade. If any is used, any Oracle Solaris release is matched. If upgrade is used, any Oracle Solaris release that is supported and can be upgraded is matched.

If the JumpStart program finds an Oracle 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 Oracle Solaris software.

For example:

installed c0t3d0s1 Solaris 10

In the example, the JumpStart program attempts to match a system that has an Oracle Solaris root (/) file system on c0t3d0s1.

karch
platform-group

Valid values are sun4u, i86pc, and prep. For a list of systems and their corresponding platform groups, see Oracle Solaris Sun Hardware Platform Guide at http://www.oracle.com/technetwork/indexes/documentation/index.html.

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.

memsize
physical-mem

The value must be a range of MB, x-x, or a single MB value.

A system's physical memory size in MB.

Example:

memsize 64-128

The example tries to match a system with a physical memory size between 64 and 128 MB.

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

model
platform-name
A system's platform name. See the Oracle Solaris Sun Hardware Platform Guide at http://www.oracle.com/technetwork/indexes/documentation/index.html 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 platform-name contains spaces, you must replace spaces with underscores (_).

For example:

SUNW, Sun_4_50


network
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:

network 192.168.2.0

The example tries to match a system with a 192.168.2.8 IP address, if the subnet mask is 255.255.255.0.

osname
Solaris_x
A version of Oracle Solaris software that is already installed on a system.

For example:

osname Solaris 10

In the example, the JumpStart program attempts to match a system with the Oracle Solaris 10 8/11 OS already installed.

probe
probe-keyword
A valid probe keyword or a valid custom probe keyword.

For example:

probe disks

The example returns the size of a system's disks in MB 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).

totaldisk
size-range

The value must be specified as a range of MB (x-x).


Note - When calculating size-range, remember that one MB equals 1,048,576 bytes. A disk might be advertised as a 535 MB disk, but the disk might have only 510 million bytes of disk space. The JumpStart program views the 535 MB disk as a 510 MB disk because 535,000,000 / 1,048,576 = 510. A 535 MB disk does not match a size-range equal to 530–550.


The total disk space on a system in MB. The total disk space includes all the operational disks that are attached to a system.

For example:

totaldisk 300-500

In the example, the JumpStart program tries to match a system with a total disk space between 300 and 500 MB.