JumpStart Keywords for ZFS

The following keywords are permitted in a ZFS specific profile:

auto

Automatically specifies the size of the slices for the pool, swap volume, or dump volume. The size of the disk is checked to verify that the minimum size can be accommodated. If the minimum size can be accommodated, the largest possible pool size is allocated, given the constraints, such as the size of the disks, preserved slices, and so on.

For example, if you specify c0t0d0s0, the root pool slice is created as large as possible if you specify either the all or auto keywords. Or, you can specify a particular size for the slice, swap volume, or dump volume.

The auto keyword works similarly to the all keyword when used with a ZFS root pool because pools don't have unused disk space.

bootenv

Identifies the boot environment characteristics.

Use the following bootenv keyword syntax to create a bootable ZFS root environment:

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

installbe

Creates a new BE that is identified by the bename option and BE-name entry and installs it.

bename BE-name

Identifies the BE-name to install.

If bename is not used with the pool keyword, then a default BE is created.

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 currently limited to /var. For example, a bootenv syntax line for a separate /var dataset would be similar to the following:

bootenv installbe bename zfsroot dataset /var

pool

Defines the new root pool to be created. The following keyword syntax must be provided:

pool poolname poolsize swapsize dumpsize vdevlist

poolname

Identifies the name of the pool to be created. The pool is created with the specified pool size and with the specified physical devices (vdevs). The poolname value should not identify the name of an existing pool or the existing pool is overwritten.

poolsize

Specifies the size of the pool to be created. The value can be auto or existing. The auto value allocates the largest possible pool size, given the constraints, such as size of the disks, preserved slices, and so on. The existing value means the boundaries of existing slices by that name are preserved and not overwritten. The size is assumed to be in MB, unless specified by g (GB).

swapsize

Specifies the size of the swap volume to be created. The autovalue means that the default swap size is used. You can specify a size with a size value. The size is in MB, unless specified by g (GB).

dumpsize

Specifies the size of the dump volume to be created. The auto value means that the default swap size is used. You can specify a size with a sizevalue. The size is assumed to be in MB, unless specified by g (GB).

vdevlist

Specifies one or more devices that are used to create the pool. The format of vdevlist is the same as the format of the zpool create command. At this time, only mirrored configurations are supported when multiple devices are specified. Devices in vdevlist must be slices for the root pool. The any value means that the installation software selects a suitable device.

You can mirror as many disks as you like, but the size of the pool that is created is determined by the smallest of the specified disks. For more information about creating mirrored storage pools, see Mirrored Storage Pool Configuration.