Sun Cluster Geographic Edition System Administration Guide

Enabling the Sun Cluster Geographic Edition Software

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

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

ProcedureHow to Enable Sun Cluster Geographic Edition Software

Before You Begin

Before you enable Sun Cluster Geographic Edition software on a cluster, ensure that the following conditions are met:

Steps
  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 Sun Cluster Geographic Edition Software and RBAC.

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


    # scconf -p | grep -i "cluster name"
    

    If the cluster name is not the name you want to use, you can change the cluster name with the following command:


    # scconf -c -C cluster=cluster-name
    

    For more information, see the scconf(1M) 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 a logical hostname that matches the cluster name is available and defined in the local host files.

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

    Confirm that the logical hostname is also defined in the network namespace database, for example, NIS.

  4. On one node of the cluster, create the Sun Cluster Geographic Edition infrastructure resource groups and enable the Sun Cluster Geographic Edition control module.


    # geoadm start
    

    The geoadm start command enables the Sun Cluster Geographic Edition control module 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.

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


    # geoadm show
    # scstat -g
    

    The output for the geoadm show command should state that the Sun Cluster Geographic Edition infrastructure is active from a particular node in the cluster.

    The output for the scstat -g command should state 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 scstat(1M) man page.


Example 3–1 Enabling a Cluster

The following example illustrates how to enable Sun Cluster Geographic Edition software on cluster-paris.

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


    phys-paris-1# geoadm start
  2. Determine whether 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# scstat -g  
    -- Resource Groups and Resources --
          Group Name              Resources
          -----------	      --------- 
    Resources: geo-clusterstate    - 
    Resources: geo-infrastructure geo-clustername geo-hbmonitor geo-failovercontrol
     
    -- Resource Groups --
         Group Name            Node Name       State
         -----------           ---------       -----
    Group: geo-clusterstate   phys-paris-1    Online
    Group: geo-clusterstate   phys-paris-2    Online
    Group: geo-infrastructure phys-paris-1    Online
    Group:geo-infrastructure  phys-paris-2    Offline
    
    -- Resources --    
    Resource Name                 Resources    State   Status Message
    -------------                 ---------    -----   --------------
    Resource: geo-clustername     phys-paris-1 Online  Online - LogicalHostname online
    Resource: geo-clustername     phys-paris-2 Offline Offline
    Resource: geo-hbmonitor       phys-paris-1 Online  Online- Daemon OK
    Resource: geo-hbmonitor       phys-paris-2 Offline Offline
    Resource: geo-failovercontrol phys-paris-1 Online  Online
    Resource: geo-failovercontrol phys-paris-2 Offline Offline

Next Steps

See Chapter 6, Replicating Data With Sun StorEdge Availability Suite 3.2.1 Software or Chapter 10, Administering Hitachi TrueCopy Protection Groups for information on creating protection groups.