Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Geographic Edition Installation Guide

Search Scope:

- This Document
- Entire Library

## Enabling the Geographic Edition Infrastructure

When Geographic Edition software is enabled, the cluster is ready to enter a partnership with another enabled cluster. You can use the CLI or the GUI to create a cluster partnership.

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 superuser access.

## 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.

- 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.

  However, when you upgrade to Oracle Solaris Cluster 3.3 5/11 software, you must copy the security certificates manually from one node of the cluster to the other nodes of the cluster. This action restores identical security certificates on all nodes. For more information about copying the security files for the common agent container, see the procedures in How to Finish Upgrade to Oracle Solaris Cluster 3.3 5/11 Software in Oracle Solaris Cluster Upgrade Guide.

1. Become superuser 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.

Copyright © 2004, 2011, Oracle and/or its affiliates. All rights reserved. Legal Notices |