OpenSolaris Managing Boot Environments
Previous Next

Zones Naming Conventions

The beadm utility automatically handles all zones naming tasks related to the beadm processes. Just for your reference, this section describes the zones naming conventions that are automatically used by the beadm utility.

A zone root dataset name is stated in the following format:

<zonepath dataset>/ROOT/<zone root>

For example:


When a zone is copied from one boot environment to another boot environment, only the datasets that are under the zone's root dataset are copied.

A dataset can be shared between zone boot environments. A shared dataset is identified by using the following format:

<zonepath dataset>/export

For example:


A shared dataset must be explicitly added during zones configuration. A shared dataset is not cloned when the zone dataset is cloned.

Example 3-1 Non-Global Zones Example

This example shows the zones impact of the beadm create command when cloning a boot environment that contains two non-global zones.

  • The original boot environment is named opensolaris with the dataset at rpool/ROOT/opensolaris.

  • A zone named z1 exists that uses the dataset, rpool/zones/z1, as its zonepath. The boot environment has a copy of rpool/zones/z1. The copy is rpool/zones/z1/ROOT/zbe.

Perform the following command to clone the boot environment and name the new boot environment opensolaris-1:

beadm create opensolaris-1

The root dataset for the new boot environment is at rpool/ROOT/opensolaris-1. The copy of zone z1 for the new boot environment has its root dataset at rpool/zones/z1/ROOT/zbe-1.

Note - ZFS properties for each dataset track the relationships between original and cloned datasets, and track the relationships between non-global zones and their parent boot environments.

Previous Next