Oracle® Solaris Cluster Geographic Edition System Administration Guide

Exit Print View

Updated: July 2014, E39667-01
 
 

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 Securing Geographic Edition Software in Oracle Solaris Cluster Geographic Edition Installation and Configuration Guide .

  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 and Configuration 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 new-cluster-name old-cluster-name

    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
    # clresource-group 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 clresource-group status and clresource status commands displays that the geo-failovercontrol, geo-hbmonitor, and geo-cluster-name 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# clresource-group 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-cluster-name       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.