Sun Cluster Geographic Edition System Administration Guide

Chapter 7 Administering Protection Groups

This chapter contains the procedures for creating and configuring protection groups that do not require data replication. The chapter contains the following sections:

Introduction to Protection Groups

Protection groups enable a set of clusters to tolerate and recover from disaster by managing the resource groups for services. Protection groups can exist only in a partnership. You must create a partnership before you can create a protection group for that partnership. A protection group contains application resource groups and properties for managing data replication for those application resource groups.

You can duplicate the application resource group configuration on partner clusters. The configuration for a protection group is identical on partner clusters, so partner clusters must have the application resource groups of the protection group defined in their configuration. The Sun Cluster Geographic Edition software propagates protection group configurations between partners.

You can specify a data replication type in the protection group to indicate the mechanism that is used for data replication between partner clusters. When a service is protected from disaster by data replication, the protection group also contains replication resource groups. Protection groups link an application in a resource group with the application data that should be replicated. This linkage and replication enable the application to fail over seamlessly from one cluster to another cluster.

For information about how to create a protection group that requires data replication, see the following data replication guides:

Creating a Protection Group That Does Not Require Data Replication

Some protection groups do not require data replication. If you are using the Sun Cluster Geographic Edition software to manage only resource groups, you can create protection groups that do not replicate data. The geoadm status command displays that these protection groups are in the Degraded state. This section describes how to configure your protection group not to use data replication.


Note –

You cannot add device groups to a protection group that does not use data replication.


ProcedureHow to Create a Protection Group That Is Configured Not to Use Data Replication

Before You Begin

Before you create a protection group, ensure that the following conditions are met:


Note –

Protection group names are unique in the global Sun Cluster Geographic Edition namespace. You cannot use the same protection group name in more than one partnership on the same system.


  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 a new protection group by using the geopg create command.

    This command creates a protection group on the local cluster.


    # geopg create -s partnershipname -o localrole \
    [-p property [-p...]] \
    protectiongroupname
    
    -s partnershipname

    Specifies the name of the partnership.

    -o localrole

    Specifies the role of this protection group on the local cluster as either Primary or Secondary.

    -p propertysetting

    Specifies the properties of the protection group.

    You can specify the following properties:

    • Description – Describes the protection group.

    • Timeout – Specifies the timeout period for the protection group in seconds. You can change the timeout period from the default value depending on the complexity of your data replication configuration. For more information on setting the timeout period, see Table A–4.

    • RoleChange_ActionArgs – Specifies a string that follows system-defined arguments at the end of the command line when the role-change callback command runs.

    • RoleChange_ActionCmd – Specifies the path to an executable command. This script is invoked during a switchover or takeover on the new primary cluster when the protection group is started on the new primary cluster. The script is invoked on the new primary cluster after the data replication role changes from secondary to primary and before the application resource groups are brought online. If the data replication role change does not succeed, then the script is not called.

      This path should be valid on all nodes of all partner clusters that can host the protection group.

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

    protectiongroupname

    Specifies the name of the protection group.

    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 geopg command, refer to the geopg(1M) man page.


Example 7–1 Creating and Configuring a Protection Group That Is Configured to Not Use Data Replication

This example creates a protection group that is configured to not use data replication.


# geopg create -s paris-newyork-ps -o primary example-pg

Next Steps

See one of the following guides for information about adding resource groups to a protection group.