Sun Cluster Geographic Edition System Administration Guide

Joining an Existing Partnership

When you define and configure a partnership, the partnership specifies a second cluster to be a member of that partnership. Then, you must configure this second cluster to join the partnership.

ProcedureHow to Join a Partnership

Before You Begin

Ensure that the following conditions are met:

  1. Log in to a node of the cluster that is joining the partnership.

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

  2. Confirm that the remote cluster that originally created the partnership, cluster-paris, can be reached at its logical hostname.

    # ping lh-paris-1

    For information about the logical hostname of the cluster, see How to Enable Sun Cluster Geographic Edition Software.

  3. Join the partnership.

    # geops join-partnership [-h heartbeatname] remoteclustername partnershipname
    -h heartbeatname

    Specifies a custom heartbeat to use in the partnership to monitor the availability of the partner cluster.

    If you omit this option, the default Sun Cluster Geographic Edition heartbeat is used.

    Custom heartbeats are provided for special circumstances and require careful configuration. Consult your Sun specialist for assistance if your system requires the use of custom heartbeats. For more information about configuring custom heartbeats, see Chapter 6, Administering Heartbeats.

    If you create a custom heartbeat, you must add at least one plug-in to prevent the partnership from remaining in degraded mode.

    You must configure the custom heartbeat that you provide in this option before you run the geops command.


    Specifies the name of a cluster that is currently a member of the partnership that is being joined. This cluster is used to retrieve the partnership configuration information.


    Specifies the name of the partnership.

    For information about the names and values that are supported by Sun Cluster Geographic Edition software, see Appendix B, Legal Names and Values of Sun Cluster Geographic Edition Entities.

    For more information about the geops command, refer to the geops(1M) man page.

  4. Verify that the cluster was added to the partnership and that the partnership properties were defined correctly.

    # geops list
    # geoadm status

Example 5–3 Joining a Partnership

This example joins the cluster-newyork cluster in the partnership that was created on cluster-paris in Example 5–1.

# geops join-partnership cluster-paris paris-newyork-ps
# geops list
# geoadm status

Example 5–4 Creating and Joining a Partnership With a Remote Cluster in a Different Domain

This example creates and configures the paris-newyork-ps partnership between clusters cluster-paris.france and cluster-newyork.usa.

  1. On one node of cluster-paris.france, configure trust for the partnership.

    phys-paris-1# geops add-trust -c cluster-newyork.usa
    phys-paris-2# geops add-trust -c cluster-newyork.usa
  2. On one node of cluster-newyork.usa, configure trust for the partnership.

    phys-newyork-1# geops add-trust -c cluster-paris.france
    phys-newyork-2# geops add-trust -c cluster-paris.france
  3. On cluster-newyork.usa, verify that trust has been set up properly.

    cluster-newyork# geops verify-trust -c cluster-newyork.usa
  4. On cluster-paris.france, create the partnership paris-newyork-ps.

    cluster-paris# geops create -c cluster-newyork.usa -p Description=Transatlantic \
    -p paris-newyork-ps
  5. On cluster-newyork.usa, join the partnership paris-newyork-ps.

    cluster-newyork# geops join-partnership cluster-paris.france paris-newyork-ps
  6. Verify that the partnership has been created successfully.

    # geops list
    # geoadm status