Enabling the Geographic Edition Framework

Language:

When the Geographic Edition framework 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 Framework in Oracle Solaris Cluster 4.3 Geographic Edition System Administration Guide.

How to Enable the Geographic Edition Framework

This procedure enables the Geographic Edition framework 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.
If you want to use the Oracle Solaris Cluster Manager browser interface to administer Geographic Edition components, ensure that all cluster nodes have the same root password.
The Oracle Solaris Cluster management-agent container for Oracle Solaris Cluster Manager is running.
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.

Assume the root role on a cluster node.
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 new-cluster-name cluster-name
```
-c new-cluster-name

Specifies the new cluster name.

cluster-name

The cluster whose name you are changing.

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

Note - After you have enabled the Geographic Edition framework, you must not change the cluster name while the framework is enabled.
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.
On a node of the cluster, start the Geographic Edition framework.
```
# geoadm start
```
The geoadm start command enables the Geographic Edition framework on the local cluster only. For more information, see the geoadm (1M) man page.
Verify that you have enabled the framework 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 indicates that the Geographic Edition framework 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 are 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 1 Enabling the Geographic Edition Framework on a Cluster

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

Start the Geographic Edition framework on cluster-paris.
```
phys-paris-1# geoadm start
```

Ensure that the Geographic Edition framework 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#

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.