Sun Cluster Geographic Edition System Administration Guide

ProcedureHow to Create a Partnership

Before You Begin

Ensure that the following conditions are met:

  1. Log in to a cluster node.

    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. Create the partnership.

    # geops create -c remotepartnerclustername[.domainname] [-h heartbeatname] \
    [-p propertysetting [-p…]] partnershipname
    -c remotepartnerclustername[.domainname]

    Specifies the name of the remote cluster that will participate in the partnership. If clusters in the partnership are in different domains, you must also specify the domain name of the remote cluster.

    This name matches the logical hostname used by the Sun Cluster Geographic Edition infrastructure on the remote cluster.

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

    Note –

    A custom heartbeat prevents the default heartbeat from being used during partnership creation. If you want to use the default heartbeat for your partnership, you must delete the custom heartbeat before you run the geops create command.

    -p propertysetting

    Specifies the value of partnership properties with a string of property=value pair statements.

    Specify a description of the partnership with the Description property.

    You can configure heartbeat-loss notification with the Notification_emailaddrs and Notification_actioncmd properties. For more information about configuring heartbeat-loss notification, see Configuring Heartbeat-Loss Notification.

    For more information about the properties you can set, see Appendix A, Standard Sun Cluster Geographic Edition Properties.


    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.

  3. Verify that the partnership was created and the status of the partnership.

    # geoadm status

Example 5–1 Creating a Partnership

This example creates the paris-newyork-ps partnership on the cluster-paris.usa cluster.

# geops create -c cluster-newyork.usa -p Description=Transatlantic \
-p paris-newyork-ps
# geoadm status

See Also

For a complete example of how to configure and join a partnership, see Example 5–4.