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.

• For a quick reference of both UFS and ZFS profile keywords, see Profile Keywords Quick Reference.

• The following list of keywords can be used in a ZFS profile. The usage is the same for both UFS and ZFS profiles. For descriptions of these keywords, see Profile Keyword Descriptions and Examples.

  • boot_device

  • cluster

  • dontuse

  • fdisk

  • filesys (mounting remote file systems)

  • geo

  • locale

  • package

  • usedisk

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.

• In a UFS file system, this keyword is used for creating an empty boot environment for the future installation of a Solaris Flash archive. For the complete description of the bootenv keyword for UFS, see bootenv Profile Keyword (UFS and ZFS).

• For a ZFS root pool, the bootenv keyword changes the characteristics of the default boot environment that is created at install time. This boot environment is a copy of the root file system that you are installing.

  The bootenv keyword can be used with the installbe, bename and dataset options. These options name the boot environment and create a separate /var dataset.

  bootenv installbe bename new-BE-name [dataset mount-point]

installbe

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

bename

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

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

• upgrade - You must use Solaris Live Upgrade to upgrade ZFS root pool. See Chapter 11, Solaris Live Upgrade and ZFS (Overview), in Solaris 10 5/09 Installation Guide: Solaris Live Upgrade and Upgrade Planning.

• flash_install - A Solaris Flash archive cannot be installed.

• flash_update - A Solaris Flash archive cannot be installed.

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

poolname

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.

poolsize

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.

auto

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.

---

swapsize

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

auto

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.

size

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

dumpsize

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

auto

Uses the default swap size.

size

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

vdevlist

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.

---

single-device-name

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.

any

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.

cwtxdysz

Identifies the root disk where the operating system is installed.