How to Enable Geographic Edition Software

Language:

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.
If you want to use the Oracle Solaris Cluster Manager GUI 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 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.
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 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.
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 2-1 Enabling the Geographic Edition Infrastructure on a Cluster

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

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

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#

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.