Installing and Configuring Zones

Installing and configuring Solaris Zones involves the following tasks:

1. Enabling a zone to run in your chosen data service configuration, as explained in the following sections:

   • How to Enable a Zone to Run in Failover Configuration

   • How to Enable a Zone to Run in a Multiple-Masters Configuration

2. Installing and configuring a zone, as explained in:

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

Perform this task for each zone that you are installing and configuring. This section explains only the special requirements for installing Solaris Zones for use with HA for Solaris Containers. For complete information about installing and configuring Solaris Zones, see System Administration Guide: Oracle Solaris Containers-Resource Management and Oracle Solaris Zones.

How to Enable a Zone to Run in Failover Configuration

1. Register the SUNW.HAStoragePlus resource type.

   # clresourcetype register SUNW.HAStoragePlus

2. Create a failover resource group.

   # clresourcegroup create solaris-zone-resource-group

3. Create a resource for the zone`s disk storage.

   This HAStoragePlus resource is for the zonepath. The file system must be a failover file system.

   # clresource create \
   -g solaris-zone-resource-group \
   -t SUNW.HAStoragePlus \
   -p FilesystemMountPoints=solaris-zone-instance-mount-points \
   solaris-zone-has-resource-name

4. (Optional) Create a resource for the zone's logical hostname.

   # clreslogicalhostname create \
   -g solaris-zone-resource-group \
   -h solaris-zone-logical-hostname \
   solaris-zone-logical-hostname-resource-name

5. Enable the failover resource group.

   # clresourcegroup online -M solaris-zone-resource-group

How to Enable a Zone to Run in a Multiple-Masters Configuration

1. Create a scalable resource group.

   # clresourcegroup create \
   -p Maximum_primaries=max-number \
   -p Desired_primaries=desired-number \
   solaris-zone-resource-group

2. Enable the scalable resource group.

   # clresourcegroup online -M solaris-zone-resource-group

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

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

Before You Begin

Consult Configuration Restrictions and then determine the following requirements for the deployment of the zone with Solaris 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 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: Oracle Solaris Containers-Resource Management and Oracle Solaris Zones

• Chapter 18, Planning and Configuring Non-Global Zones (Tasks), in System Administration Guide: Oracle Solaris Containers-Resource Management and Oracle 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' disk storage. Therefore, the zone path must be removed on the next node prior to successfully creating and installing the zone. Otherwise, the next two steps will fail. Only a zone's zone path that is created on the last node will be kept as the final zone path for the HA container. For that reason, perform any configuration and customization within the HA container only after the HA container 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: Oracle Solaris Containers-Resource Management and Oracle 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: Oracle Solaris Containers-Resource Management and Oracle 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:

      # ~.