Solaris 10 5/09 Installation Guide: Custom JumpStart and Advanced Installations

JumpStart Keywords for a ZFS Root (/) File System (Reference)

This section provides descriptions of some of the ZFS specific keywords that you can use in a JumpStart profile. The usage of the keywords in this section is either different from their usage in a UFS profile or used only in a ZFS profile.

bootenv Profile Keyword (ZFS and UFS)

The bootenv keyword identifies boot environment characteristics. A boot environment is created by default during installation with the pool keyword. If you use the bootenv keyword with the installbe option, you can name the new boot environment and create a /var dataset within the boot environment.

This keyword can be used in a profile for installing a UFS file system or a ZFS root pool.


Changes the characteristics of the default boot environment that is created during the installation.


Specifies the name of the new boot environment to be created, new_BE_name. The name can be no longer than 30 characters, can contain only alphanumeric characters, and can contain no multibyte characters. The name must be unique on the system.

dataset mount-point

Use the optional dataset keyword to identify a /var dataset that is separate from the ROOT dataset. The mount-point value is limited to /var. For example, a bootenv syntax line for separate /var dataset would be similar to the following:

bootenv installbe bename zfsroot dataset /var

For more information about upgrading and activating a boot environment, see Chapter 11, Solaris Live Upgrade and ZFS (Overview), in Solaris 10 5/09 Installation Guide: Solaris Live Upgrade and Upgrade Planning.

install_type Keyword (ZFS and UFS)

The install_type keyword is required in every profile. For a UFS installation, Several options are available. The only option available for a ZFS installation is the initial_install keyword. This option installs a new Solaris OS on a system. The profile syntax is the following:

install_type initial_install

Note –

The following UFS options are not available for a ZFS installation.

pool Profile Keyword (ZFS Only)

The pool keyword defines the new root pool to be created. The pool is then installed with a software group specified with the cluster keyword. The poolsize, swapsize, dumpsize, and vdevlist options are needed for creating a new root pool.

pool poolname poolsize swapsize dumpsize vdevlist

Specifies the name of the new pool to be created. A new pool is created with the specified size and with the specified devices, vdevlist.


Size of the new pool to be created. If you denote the amount of space, the size is assumed to be in Mbytes, unless specified by g (Gbytes). You can also use the auto option.


Allocates the largest possible pool size given the constraints, such as size of the disks and preserved slices.

Note –

The meaning of auto for the poolsize keyword is different from the filesys keyword use of auto in a UFS file system. In ZFS, the size of the disk is checked to verify that the minimum size can be accommodated. If the minimize size is available, the largest possible pool size is allocated given the constraints, such as size of the disks and preserved slices.


Size of the swap volume (zvol) to be created within a new root pool. The options are either auto or size.


The swap area is automatically sized. The default size is 1/2 the size of physical memory, but no less than 512 Mbytes and no greater than 2 Gbytes. You can set the size outside this range by using the size option.


Can be used to specify an amount. Size is assumed to be in Mbytes, unless specified by g (Gbytes).


Size of the dump volume to be created within a new pool.


Uses the default swap size.


Can be used to specify an amount. Size is assumed to be in Mbytes, unless specified by g (Gbytes).


One or more devices used to create the pool.

Devices in the vdevlist must be slices for the root pool. vdevlist can be either a single-device-name in the form cwtxdysz or mirror or any option.

Note –

The format of the vdevlist is the same as the format of the zpool create command.


A disk slice in the form or cwtxdysz, such as c0t0d0s0.

mirror [device-names|any]

Specifies the mirroring of the disk.

At this time, only mirrored configurations are supported when multiple devices are specified. You can mirror as many as disks you like, but the size of the pool created is determined by the smallest of the specified disks. For more information about creating mirrored storage pools, see Mirrored Storage Pool Configuration in Solaris ZFS Administration Guide.

  • device-names lists the devices to be mirrored. The names are in the form of cwtxdysz, for example c0t0d0s0 and c0t0d1s5.

  • The any option enables the installer to choose the devices.


Enables the installer to select a suitable device.

root_device Profile Keyword (ZFS and UFS)

root_device cwtxdysz

root_device specifies the device to be used for the root pool. The root_device keyword determines where the operating system is installed. This keyword is used the same in both ZFS and a UFS file system with some limitations. For the ZFS root pool, the root device is limited to a single system. This keyword is not useful for mirrored pools.


Identifies the root disk where the operating system is installed.