Sun Cluster Geographic Edition Installation Guide

Enabling the Sun Cluster Geographic Edition Infrastructure

When Sun Cluster 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 Sun Cluster Geographic Edition, see Chapter 3, Administering the Sun Cluster Geographic Edition Infrastructure, in Sun Cluster Geographic Edition System Administration Guide.

To use the geoadm command to enable the local cluster for partnership membership, you must have superuser access.

ProcedureHow to Enable Sun Cluster Geographic Edition Software

This procedure enables the Sun Cluster 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:

  1. Become superuser on a cluster node.

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


    # cluster list
    

    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 Sun Cluster 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 Sun Cluster Geographic Edition infrastructure.


    # geoadm start
    

    The geoadm start command enables the Sun Cluster 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 Sun Cluster 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 Sun Cluster 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 Sun Cluster Geographic Edition Infrastructure on a Cluster

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

  1. Start the Sun Cluster Geographic Edition infrastructure on cluster-paris.


    phys-paris-1# geoadm start
    
  2. Ensure that the Sun Cluster Geographic Edition infrastructure was successfully enabled.


    phys-paris-1# geoadm show
    
    --- CLUSTER LEVEL INFORMATION ---
    Sun 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 Sun Cluster 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

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