How to Install a Zone and Perform the Initial Internal Zone Configuration

Perform this task on each node that is to host the zone.

For complete information about installing a zone, see System Administration Guide: Solaris Containers-Resource Management and Solaris Zones.

Before You Begin

Determine the following requirements for the deployment of the zone with Sun Cluster:

• The number of Solaris Zone instances that are to be deployed.

• The cluster file system that is to be used by each Solaris Zone instance.

Ensure that the zone is configured.

If the zone that you are installing is to run in a failover configuration, configure the zone's zone path to specify a highly available local file system. The file system must be managed by the SUNW.HAStoragePlus resource that you created in How to Enable a Zone to Run in a Failover Configuration.

For detailed information about configuring a zone before installation of the zone, see the following documentation:

• Chapter 17, Non-Global Zone Configuration (Overview), in System Administration Guide: Solaris Containers-Resource Management and Solaris Zones

• Chapter 18, Planning and Configuring Non-Global Zones (Tasks), in System Administration Guide: Solaris Containers-Resource Management and Solaris Zones

1. If the zone is to run in a failover configuration, ensure that the zone's zone path can be created on the zone's disk storage.

   If the zone is to run in a multiple-masters configuration, omit this step.

   1. On the node where you are installing the zone, bring online the resource group that contains the resource for the zone's disk storage.

      # clresourcegroup switch -n node solaris-zone-resource-group

   2. If the zone's zone path already exists on the zone's disk storage, remove the zone path.

      The zone's zone path already exists on the zone's disk storage if you have previously installed the zone on another node.

      ---

      Caution –

      If the zone is to run in a failover configuration, each node being able to host that zone must have the exact same zone configuration for that zone. After installing the zone on the first node, the zone's zone path already exists on the zones's disk storage. Therefore it must get removed on the next node prior to successfully create and install the zone. Otherwise the next two steps will fail. Only the zone's zone path created on the last node will be kept as the final zone path for the failover zone. For that reason any configuration and customization within the failover zone should get performed after the failover zone is known to all nodes that should be able to host it.

      ---

2. Create the zone.

   # zonecfg -z zone

   For more detailed information about creating a zone, see Configuring, Verifying, and Committing a Zone in System Administration Guide: Solaris Containers-Resource Management and Solaris Zones.

3. Install the zone.

   # zoneadm -z zone install

   For more detailed information about installing a zone, see How to Install a Configured Zone in System Administration Guide: Solaris Containers-Resource Management and Solaris Zones.

4. Perform the initial internal zone configuration. If the zone is to run in a failover configuration, perform this step on the last node.

   1. Log in to the zone's console.

      # zlogin -C zone

      You are prompted to configure the zone.

   2. Follow the prompts to configure the zone.

   3. Disconnect from the zone's console.

      Use the escape sequence that you defined for the zone. If you did not define an escape sequence, use the default escape sequence as follows:

      # ~.