Enabling the Geographic Edition Infrastructure

When Geographic Edition software is enabled, the cluster is ready to enter a partnership with another enabled cluster.

For more information about setting up and installing Geographic Edition, see Chapter 3, Administering the Geographic Edition Infrastructure, in Oracle Solaris Cluster Geographic Edition System Administration Guide.

To use the geoadm command to enable the local cluster for partnership membership, you must have assume the root role.

How to Enable Geographic Edition Software

This procedure enables the Geographic Edition infrastructure on the local cluster only. Repeat this procedure on all the clusters of your geographically separated cluster.

Before You Begin

Ensure that the following conditions are met:

• The cluster is running the Oracle Solaris Operating System and Oracle Solaris Cluster software.

• Geographic Edition software is installed.

• The cluster has been configured for secure cluster communication by using security certificates, that is, nodes within the same cluster must share the same security certificates. This is configured during Oracle Solaris Cluster installation.

1. Assume the root role on a global-cluster node.
2. Ensure that the logical hostname, which is the same as the cluster name, is available and defined.

   # cluster list

   For global clusters, if the cluster name is not the name that you want to use, change the cluster name with the following command:

   # cluster rename -c newclustername clustername

   -c newclustername

   Specifies the new cluster name.

   clustername

   The cluster whose name you are changing.

   For more information, see the cluster(1CL) man page.

   ---

   Note - After you have enabled the Geographic Edition infrastructure, you must not change the cluster name while the infrastructure is enabled.

   ---

3. Confirm that the naming service and the local hosts files contain a host entry that matches the cluster name.

   The local hosts file, hosts, is located in the /etc/inet directory.

4. On a node of the cluster, start the Geographic Edition infrastructure.

   # geoadm start

   The geoadm start command enables the Geographic Edition infrastructure on the local cluster only. For more information, see the geoadm(1M) man page.

5. Verify that you have enabled the infrastructure and that the Geographic Edition resource groups are online.

   # geoadm show
   # clresourcegroup status geo-clusterstate geo-infrastructure
   # clresource status -g geo-clusterstate,geo-infrastructure

   The output for the geoadm show command displays that the Geographic Edition infrastructure is active from a particular node in the cluster.

   The output for the clresourcegroup status and clresource status commands display that the geo-failovercontrol, geo-hbmonitor, and geo-clustername resources and the geo-infrastructure resource group is online on one node of the cluster. The geo-clusterstate resource group is online on both nodes.

   For more information, see the clresourcegroup(1CL) and clresource(1CL) man pages.

Example 3-1 Enabling the Geographic Edition Infrastructure on a Cluster

This example enables Geographic Edition software on the cluster-paris cluster.

1. Start the Geographic Edition infrastructure on cluster-paris.

   phys-paris-1# geoadm start

2. Ensure that the Geographic Edition infrastructure was successfully enabled.

   phys-paris-1# geoadm show
   
   --- CLUSTER LEVEL INFORMATION ---
   Oracle Solaris Cluster Geographic Edition is active on cluster-paris from node phys-paris-1
   Command execution successful
   phys-paris-1#

3. Verify the status of the Geographic Edition resource groups and resources.

   phys-paris-1# clresourcegroup status geo-clusterstate geo-infrastructure
   
   === Cluster Resource Groups ===
   
   Group Name                      Node Name              Suspended            Status
   ----------                      ---------              ---------            ------
   geo-clusterstate                phys-paris-1           No                   Online
                                   phys-paris-2           No                   Online
   
   geo-infrastructure              phys-paris-1           No                   Online
                                   phys-paris-2           No                   Offline
   
   phys-paris-1# clresource status -g geo-clusterstate,geo-infrastructure
   
   === Cluster Resources ===
   
   Resource Name           Node Name       State         Status Message
   -------------           ---------       -----         --------------
   geo-clustername         phys-paris-1    Online        Online - LogicalHostname online.
                           phys-paris-2    Offline       Offline
   
   geo-hbmonitor           phys-paris-1    Online        Online - Daemon OK
                           phys-paris-2    Offline       Offline
   
   geo-failovercontrol     phys-paris-1    Online        Online - Service is online.
                           phys-paris-2    Offline       Offline

Next Steps

Configure trust between partner clusters. Go to How to Configure Trust Between Two Clusters.