test

Sun Cluster Geographic Edition System Administration Guide

Administering Sun StorEdge Availability Suite 3.2.1 Data Replication Device Groups

This section describes the following tasks for administering data replication device groups in a Sun StorEdge Availability Suite 3.2.1 protection group:

For details about configuring a Sun StorEdge Availability Suite 3.2.1 protection group, see How to Create and Configure a Sun StorEdge Availability Suite 3.2.1 Protection Group.

ProcedureHow to Add a Data Replication Device Group to a Sun StorEdge Availability Suite 3.2.1 Protection Group

Before You Begin

A protection group is the container for the application resource groups, which contain data for services that are protected from disaster. Sun Cluster Geographic Edition software protects the data by replicating it from the primary cluster to the secondary cluster. By adding a Sun Cluster device group to a protection group, Sun Cluster Geographic Edition software monitors the replication status of all volumes in the device group that belong to a Sun StorEdge Availability Suite 3.2.1 volume set. Sun Cluster Geographic Edition software also controls the role and state of the volume set during protection group operations like start, stop, switchover, and takeover.

Before you add a device group to a protection group, ensure that the following conditions are met:

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. Add a data replication device group to the protection group.

    This command adds a device group to a protection group on the local cluster and propagates the new configuration to the partner cluster if the partner cluster contains a protection group of the same name.


    # geopg add-device-group -p property-settings [-p...] \
AVS-device-group-name protection-group-name
    -p property-settings

    Sets the properties of the data replication device group

    The Sun StorEdge Availability Suite 3.2.1 specific properties you can set are the following:

    • Local_logical_host – Specifies the name of the local logical host that is used to replicate the device group

    • Remote_logical_host – Specifies the name of the remote logical host that is used to replicate the device group

    • Enable_volume_set – Specifies whether the volume sets that are given in the file will be automatically enabled. Set to either True or False

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

    AVS-device-group-name

    Specifies the name of the new data replication device group

    protection-group-name

    Specifies the name of the protection group that will contain the new data replication device 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–10 Adding a Data Replication Device Group to a Sun StorEdge Availability Suite 3.2.1 Protection Group

The following example illustrates how to create a Sun StorEdge Availability Suite 3.2.1 data replication device group in the avspg protection group:


# geopg add-device-group -p Local_logical_host=lh-paris-1 \
-p Remote_logical_host=lh-newyork-1 avsdg avspg

How the Data Replication Subsystem Verifies the Device Group

When the device group controlled by Sun StorEdge Availability Suite 3.2.1 is added to a protection group, the data replication layer verifies that the device group exists and that the value of its Nodelist property contains the same entries in the same order as the Nodelist property of the protection group.

When the geopg add-device-group command runs, a lightweight resource group for the device group is created and brought online. The lightweight resource group contains the following resources:

For more information about lightweight resource groups and their resources, see Sun StorEdge Availability Suite 3.2.1 Lightweight Resource Groups.

When you run the geopg add-device-group command, a replication resource of the type GeoCtlAVS is created in the replication resource group of each device group in the protection group and brought online. For information about the format of the replication resource group, see Sun StorEdge Availability Suite 3.2.1 Replication Resource Groups.

The Nodelist property of the lightweight resource group and replication resource group contains the same entries in the same order as the Nodelist property of the protection group.

If a resource or resource group of the same name is already configured on the local cluster, Sun Cluster Geographic Edition verifies the configuration and sets the Configuration to Error if the configuration is not correct.

If the Enable_volume_set property of this device group is set to True, then volume sets that are defined in the /var/cluster/geo/avs/AVS-devicegroup-volset.ini file are enabled. Otherwise, Sun Cluster Geographic Edition software controls and monitors all volume sets that you enable manually by using the Sun StorEdge Availability Suite 3.2.1 commands.

If the geopg add-device-group command is unsuccessful, the configuration of the protection group is not modified.

If the geopg add-device-group command is successful and the Configuration status on the local cluster is set to OK, then the new configuration is propagated to the partner cluster. This propagation causes the whole protection group configuration to be revalidated on the partner cluster. During revalidation, the same entities are created on the partner cluster, including the lightweight resource group and the replication resource group. Volume sets are also enabled on the partner clusters if the /var/cluster/geo/avs/AVS-devicegroup-volset.ini file exists on the partner cluster and contains correctly defined volume sets. If the validation is unsuccessful, then the Configuration status on the partner cluster is set to Error on the partner cluster.

Caution – Caution –

Do not change, remove, or bring offline these resources or resource groups. Lightweight resource groups, replication resource groups, and their resources are internal entities managed by Sun Cluster Geographic Edition software and should be administered by using only the Sun Cluster Geographic Edition commands. Altering the configuration or state of these entities directly with Sun Cluster commands could result in unrecoverable failure.

Conditionally, if the validation of the device group on the partner cluster is successful, the volume sets defined in the /var/cluster/geo/avs/AVS-devicegroup-volset.ini file are enabled on the partner cluster. The Enable_volume_set property of this device group must be set to true. Other volume sets of the device group are disabled.

After the device group has been added to the protection group, you can enable or disable the volume sets of the device group directly by using the Sun StorEdge Availability Suite 3.2.1 commands. The /var/cluster/geo/avs/AVS-devicegroup-volset.ini file is only consulted when the protection group that contains the device group is successfully validated for the first time.

ProcedureHow to Modify a Sun StorEdge Availability Suite 3.2.1 Data Replication Device Group

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

    This command modifies the properties of a device group in a protection group on the local cluster. Then the command propagates the new configuration to the partner cluster if the partner cluster contains a protection group of the same name.


    # geopg modify-device-group -p property-settings [-p...] \
AVS-device-group-name protection-group-name
    -p property-settings

    Sets the properties of the data replication device group

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

    AVS-device-group-name

    Specifies the name of the new data replication device group

    protection-group-name

    Specifies the name of the protection group that will contain the new data replication device group

ProcedureHow to Delete a Data Replication Device Group From a Sun StorEdge Availability Suite 3.2.1 Protection Group

Before You Begin

You might need to delete a data replication device group from a protection group if you added a data replication device group to a protection group. Normally, after an application is configured to write to a set of disks, you would not change the disks.

Before you remove a data replication device group, ensure that the following conditions are met:

For information about deleting protection groups, refer to How to Delete a Sun StorEdge Availability Suite 3.2.1 Protection Group.

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. Remove the device group.

    This command removes a device group from a protection group on the local cluster. Then the command propagates the new configuration to the partner cluster if the partner cluster contains a protection group of the same name.

    This command removes the device group from the protection group. This command also disables all volume sets associated with the device group and deletes the lightweight resource group and replication resource group for this device group.


    # geopg remove-device-group AVS-device-group-name protection-group-name
    AVS-device-group-name

    Specifies the name of the data replication device group

    protection-group-name

    Specifies the name of the protection group

Example 7–11 Deleting a Replication Device Group From a Sun StorEdge Availability Suite 3.2.1 Protection Group

The following example illustrates how to delete a data replication device group from a Sun StorEdge Availability Suite 3.2.1 protection group:


# geopg remove avsdg avspg