Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Geographic Edition System Administration Guide Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

## Enabling the Geographic Edition Software

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

For more information about setting up and installing the Geographic Edition software, see the Oracle Solaris Cluster Geographic Edition Installation Guide.

## 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 the Oracle Solaris Cluster software.

- The 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 done during Oracle Solaris Cluster installation.

1. Log in to a cluster node.

   You must be assigned the Geo Operation RBAC rights profile to complete this procedure. For more information about RBAC, see Geographic Edition Software and RBAC.

2. Ensure that the logical hostname, which is the same as the cluster name, is available and defined.

       # cluster list

3. If the cluster name is not the name you want to use, change the cluster name.

   If you must change the name of a cluster that is configured in a partnership, do not perform this step. Instead, follow instructions in Renaming a Cluster That Is in a Partnership.

   Follow cluster naming guidelines as described in Planning Required IP Addresses and Hostnames in Oracle Solaris Cluster Geographic Edition Installation Guide. Cluster names must follow the same requirements as for host names. You cannot rename a cluster that is part of a zone cluster, but you can rename a cluster in a global zone.

       # cluster rename -c newclustername oldclustername

   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.

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

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

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

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

   For a list of the Geographic Edition resource groups, see Geographic Edition Infrastructure Resource Groups.

       # geoadm show
       # clresourcegroup status
       # clresource status

   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 displays that the `geo-failovercontrol`, `geo-hbmonitor`, and `geo-clustername` resources and the `geo-infrastructure` resource groups are online on one node of the cluster.

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

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

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

1. Start the Geographic Edition software 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
       === 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

       # clresource status
       === 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

       geo-servicetag        phys-paris-1   Online_not_monitored Online_not_monitored
                             phys-paris-1   Offline              Offline

Next Steps

For information about creating protection groups, see the Geographic Edition data replication guide that corresponds to the type of data replication software you are using.

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