test

Sun Cluster Geographic Edition System Administration Guide

Creating, Modifying, Validating, and Deleting a Sun StorEdge Availability Suite 3.2.1 Protection Group

This section contains procedures for the following tasks:

Note –

You can create protection groups that are not configured to use data replication. To create a protection group that does not use a data replication subsystem, omit the -d data-replication-type option when you use the geopg command. The geoadm status command shows a state for data replication of NONE.

ProcedureHow to Create and Configure a Sun StorEdge Availability Suite 3.2.1 Protection Group

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 two partnerships on the same system.

You can also replicate the existing configuration of a protection group from a remote cluster to the local cluster. For more information, see Replicating the Sun StorEdge Availability Suite 3.2.1 Protection Group Configuration to a Partner Cluster

Steps

  1. Log in to one of the cluster nodes.

    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 all nodes of the local cluster.


    # geopg create -s partnership-name -d avs \
-o local-role [-p property-settings [-p...]] \
protection-group-name
    -s partnership-name

    Specifies the name of the partnership

    -d avs

    Specifies that the protection group data is replicated by Sun StorEdge Availability Suite 3.2.1

    -o local-role

    Specifies the role of this protection group on the local cluster as either primary or secondary

    -p property-setting

    Sets the properties of the protection group

    The properties you can set are the following:

    • Description – describes the protection group

    • Timeout – specifies the timeout period for the protection group in seconds

    • Enable_volume_set – when set to true, specifies that the volume set will be automatically enabled at protection group creation time

      For more information about automatically enabling a volume set, see Enabling a Sun StorEdge Availability Suite 3.2.1 Volume Set.

    • Nodelist – Lists the host names of the machines that can be primary for the device group in the protection group.

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

    protection-group-name

    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.

    Before creating the protection group, the data replication layer validates that the configuration is correct.

    If the validation is successful, the local Configuration status is set to OK and the Synchronization status is set to Error.

    If the validation is unsuccessful, the protection group is not created.

Example 7–2 Creating and Configuring a Protection Group

The following example illustrates how to create a Sun StorEdge Availability Suite 3.2.1 protection group on cluster-paris, which is set as the primary cluster:


phys-paris-1# geopg create -s paris-newyork-ps -d avs -o primary \
-p Nodelist=phys-paris-1,phys-paris-2 avspg

ProcedureHow to Modify a Sun StorEdge Availability Suite 3.2.1 Protection Group

Before You Begin

Before modifying the configuration of your protection group, ensure that the protection group you want to modify exists locally.

Steps

  1. Log in to one of the cluster nodes.

    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. Modify the configuration of the protection group.

    This command modifies the properties of a protection group on the local cluster. If the partner cluster contains a protection group of the same name, this command also propagates the new configuration information to the partner cluster.


    # geopg set-prop -p property-settings[-p...] protection-group-name
    -p property-setting

    Sets the properties of the protection group

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

    protection-group-name

    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–3 Modifying the Configuration of a Protection Group

The following example illustrates how to modify the timeout property of the protection group that was created in Example 7–2:


# geopg set-prop -p Timeout=300 avspg
How the Data Replication Subsystem Validates the Modified Protection Group

When you launch the geopg set-prop command, the data replication subsystem revalidates the protection group with the new configuration information. If the validation is unsuccessful on the local cluster, the configuration of the protection group is not modified. Otherwise, the Configuration status is set to OK on the local cluster.

If the Configuration status is OK on the local cluster, but the validation is in unsuccessful on the partner cluster, the Configuration status is set to Error on the partner cluster.

ProcedureHow to Validate a Sun StorEdge Availability Suite 3.2.1 Protection Group

Before You Begin

When the Configuration status of a protection group is displayed as Error in the geoadm status output, you can validate the configuration by using the geopg validate command. This command checks the current state of the protection group and its entities.

If the protection group and its entities are valid, then the Configuration status of the protection groups is set to OK. If the geopg validate command finds error in the configuration files, then the command displays a message about the error and the configuration remains in the error state. In such a case, you can fix the error in the configuration, and issue thegeopg validate command again.

This command validates the configuration of the protection group on the local cluster only. To validate the protection group configuration on the partner cluster, issue the command again on the partner cluster.

Before validating the configuration of a protection group, ensure that the protection group you want to validate exists locally and that the common agent container is online on all nodes of both clusters in the partnership.

Steps

  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. Validate the configuration of the protection group.

    This command validates the configuration of the protection group on the local cluster only. 


    # geopg validate protection-group-name
    protection-group-name

    Specifies a unique name that identifies a single protection group.

Example 7–4 Validating the Configuration of a Protection Group

The following example illustrates how to validate a protection group:


# geopg validate avspg

How the Data Replication Layer Validates the Application Resource Groups and Data Replication Entities

During protection group validation, the Sun StorEdge Availability Suite 3.2.1 data replication layer validates the application resource groups and the data replication entities as follows:

If the Enable_volume_set property of a successfully validated device group is set to True, then volume sets defined in the /var/cluster/geo/avs/avsdg-volset.ini file are enabled. Other volume sets for the device group are disabled. If you want to enable the other volume sets, you can add the volume sets to the /var/cluster/geo/avs/avsdg-volset.ini file or set the Enable_volume_set property to False.

When validation is complete, the Sun Cluster Geographic Edition software creates the lightweight resource group, the replication resource group, and the resources for this replication resource group, if nonexistent, and brings them online. If a resource group or resource of the same name already exists, the Sun Cluster Geographic Edition operations may modify their properties. Sun Cluster Geographic Edition software cannot create a new resource group or resource of the same name if one already exists.

The Configuration status is set to OK after successful validation. If validation is not successful, the Configuration status is set to Error.

ProcedureHow to Delete a Sun StorEdge Availability Suite 3.2.1 Protection Group

Before You Begin

To delete the protection group on every cluster, run the geopg delete command on each cluster where the protection group exists.

Before deleting a protection group, ensure that the following conditions are met.

Note –

To keep the application resource groups online while deleting a protection group, you must remove the application resource groups from the protection group.

Steps

  1. Log in to one of the nodes on the cluster where you want to delete the protection group, for example cluster-paris.

    The cluster-paris is the primary cluster. See Figure 2–1 for For a a sample cluster configuration.

    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. Delete the protection group.

    This command deletes the configuration of the protection group from the local cluster. The command also removes the lightweight resource group and the replication resource group for each device group in the protection group. 


    # geopg delete protection-group-name
    protection-group-name

    Specifies the name of the protection group

    If the deletion is unsuccessful, the Configuration status is set to Error. Fix the cause of the error and reissue the geopg delete command.

Example 7–5 Deleting a Protection Group

The following example illustrates how to delete a protection group from both partner clusters. 


# rlogin cluster-paris -l root
cluster-paris# geopg delete avspg
# rlogin cluster-newyork -l root
cluster-newyork# geopg delete avspg
Example 7–6 Deleting a Protection Group While Keeping Application Resource Groups Online

The following example illustrates how to keep two application resource groups (apprg1 and apprg2) online while deleting their protection group, avspg. Remove the application resource groups from the protection group, then delete the protection group. 


# geopg remove-resource-group apprg1,apprg2 avspg 
# geopg stop -e global avspg
# geopg delete avspg