test

Sun Cluster Geographic Edition Data Replication Guide for Hitachi TrueCopy

Creating, Modifying, Validating, and Deleting a Hitachi TrueCopy 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 datareplicationtype option when you use the geopg command. The geoadm status command shows a state for these protection groups of Degraded.

For more information, see Creating a Protection Group That Does Not Require Data Replication in Sun Cluster Geographic Edition System Administration Guide.

ProcedureHow to Create and Configure a Hitachi TrueCopy Protection Group That Does Not Use Oracle Real Application Clusters

Use the steps in this task to create and configure a Hitachi TrueCopy protection group. If you want to use Oracle Real Application Clusters, see How to Create a Protection Group for Oracle Real Application Clusters.

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 Hitachi TrueCopy Protection Group Configuration to a Secondary Cluster.

  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 in Sun Cluster Geographic Edition System Administration Guide.

  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 partnershipname -o localrole -d truecopy [-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.

    -d truecopy

    Specifies that the protection group data is replicated by the Hitachi TrueCopy software.

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

    • Nodelist – Lists the host names of the machines that can be primary for the replication subsystem.

    • Cluster_dgs – Lists the device groups where the data is written.

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

    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, in Sun Cluster Geographic Edition System Administration Guide.

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

Example 2–2 Creating and Configuring a Hitachi TrueCopy Protection Group

This example creates a Hitachi TrueCopy protection group on cluster-paris, which is set as the primary cluster.


# geopg create -s paris-newyork-ps -o primary -d truecopy \
-p Nodelist=phys-paris-1,phys-paris-2 tcpg
Example 2–3 Creating a Hitachi TrueCopy Protection Group for Application Resource Groups That Are Online

This example creates a Hitachi TrueCopy protection group, tcpg, for an application resource group, resourcegroup1, that is currently online on cluster-newyork.

  1. Create the protection group without the application resource group.


    # geopg create -s paris-newyork-ps -o primary -d truecopy \
 -p nodelist=phys-paris-1,phys-paris-2 tcpg

  2. Activate the protection group.


    # geopg start -e local tcpg

  3. Add the application resource group.


    # geopg add-resource-group resourcegroup1 tcpg

ProcedureHow to Create a Protection Group for Oracle Real Application Clusters

Before You Begin

Before you create a protection group for Oracle Real Application Clusters, ensure that the following conditions are met:

When a cluster and the cluster volume manager software restart, the Oracle Real Application Clusters framework automatically tries to import all cluster volume manager device groups that were imported already before cluster went down. Therefore, the attempt to import the device groups to the original primary fails.

  1. Log in to a cluster node on the primary cluster.

    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 in Sun Cluster Geographic Edition System Administration Guide.

  2. Create a new protection group with a cluster volume manager disk group by using the geopg create command.

    This command creates a protection group on all nodes of the local cluster.


    # geopg create -s partnershipname -o localrole -d truecopy [-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 primary.

    -d truecopy

    Specifies that the protection group data is replicated by the Hitachi TrueCopy software.

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

    • Nodelist – Lists the host names of the machines that can be primary for the replication subsystem.

    • Cluster_dgs – Specifies the cluster volume manager disk group where the data is written.

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

    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, in Sun Cluster Geographic Edition System Administration Guide.

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

  3. Add a Hitachi TrueCopy device group to the protection group. 


    # geopg add-device-group [-p property [-p...]] \
protectiongroupname
    -p propertysetting

    Specifies the properties of the protection group.

    You can specify the Fence_level properties which defines the fence level that is used by the disk device group. The fence level determines the level of consistency among the primary and secondary volumes for that disk device group. You must set this to never.

    Caution – Caution –

    To avoid application failure on the primary cluster, specify a Fence_level of never or async. If the Fence_level parameter is not set to never or async, data replication might not function properly when the secondary site goes down.

    If you specify a Fence_level of never, the data replication roles do not change after you perform a takeover.

    Do not use programs that would prevent the Fence_level parameter from being set to data or status because these values might be required in special circumstances.

    If you have special requirements to use a Fence_level of data or status, consult your Sun representative.

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

    protectiongroupname

    Specifies the name of the protection group.

  4. Add the Oracle Real Application Clusters framework resource group, all Oracle Real Application Clusters server resource groups, and all Oracle Real Application Clusters listener resource groups to the protection group. 


    # geopg add-resource-group resourcegroup protectiongroupname
    resourcegroup

    Specifies a comma-separated list of resource groups to add to or delete from the protection group. The specified resource groups must already be defined.

    The protection group must be online before you add a resource group. The geopg add-resource-group command fails when a protection group is offline and the resource group that is being added is online.

    Note –

    If a protection group has already been started at the time that you add a resource group, the resource group remains unmanaged. You must start the resource group manually by running the geopg start command.

    protectiongroupname

    Specifies the name of the protection group.

Example 2–4 Creating a Protection Group for Oracle Real Application Clusters

This example creates the protection group pg1 which uses Oracle Real Application Clusters and the cluster volume manager.

A cluster volume manager disk group oracle-dg controls the data which is replicated by the Hitachi TrueCopy device group VG01. The nodelist of the Oracle Real Application Clusters framework resource group is set to all nodes of the cluster.

  1. Create the protection group on the primary cluster with the cluster volume manager disk group oracle-dg.


    # geopg create -s pts1 -o PRIMARY -d Truecopy -p cluster_dgs=oracle-dg pg1
Protection group "pg1" successfully created.

  2. Add the Hitachi TrueCopy device group VG01 to protection group pg1. 


    # geopg add-device-group --property fence_level=never VG01 pg1
Device group "VG01" successfully added to the protection group "pg1".

  3. Add the Oracle Real Application Clusters framework resource group rac-framework-rg, all Oracle Real Application Clusters server resource groups, and all Oracle Real Application Clusters listener resource groups to the protection group. 


    # geopg add-resource-group rac-framework-rg,rac-server-rg1,\
rac-listener-rg1,rac-server-rg2,rac-listener-rg2 pg1

How the Data Replication Subsystem Validates the Device Group

Before creating the protection group, the data replication layer validates that the horcmd daemon is running.

The data replication layer validates that the horcmd daemon is running on at least one node that is specified in the Nodelist property. For more information about the horcmd daemon, see the Sun StorEdge SE 9900 V Series Command and Control Interface User and Reference Guide.

If the Cluster_dgs property is specified, then the data replication layer verifies that the device group specified is a valid Sun Cluster device group. The data replication layer also verifies that the device group is of a valid type.

Note –

The device groups that are specified in the Cluster_dgs property must be written to only by applications that belong to the protection group. This property must not specify device groups that receive information from applications outside the protection group.

A Sun Cluster resource group is automatically created when the protection group is created.

This resource in this resource group monitors data replication. The name of the Hitachi TrueCopy data replication resource group is rg-tc-protectiongroupname.

Caution – Caution –

These automatically created replication resource groups are for Sun Cluster Geographic Edition internal implementation purposes only. Use caution when you modify these resource groups by using Sun Cluster commands.

ProcedureHow to Modify a Hitachi TrueCopy Protection Group

Before You Begin

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

  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 in Sun Cluster Geographic Edition System Administration Guide.

  2. Modify the configuration of the protection group.

    This command modifies the properties of a protection group on all nodes of 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 [-p...] \
protectiongroupname
    -p propertysetting

    Specifies the properties of the protection group.

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

    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, in Sun Cluster Geographic Edition System Administration Guide.

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

Example 2–5 Modifying the Configuration of a Protection Group

This example modifies the Timeout property of the protection group that was created in Example 2–2.


# geopg set-prop -p Timeout=400 tcpg

Validating a Hitachi TrueCopy Protection Group

During protection group validation, the Hitachi TrueCopy data replication subsystem validates the following:

When the geoadm status output displays that the Configuration status of a protection group is Error, 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 an 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 run the geopg validate command again.

ProcedureHow to Validate a Hitachi TrueCopy Protection Group

Before You Begin

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.

  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 in Sun Cluster Geographic Edition System Administration Guide.

  2. Validate the configuration of the protection group.

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


    # geopg validate protectiongroupname
    protectiongroupname

    Specifies a unique name that identifies a single protection group

Example 2–6 Validating the Configuration of a Protection Group

This example validates a protection group.


# geopg validate tcpg

ProcedureHow to Delete a Hitachi TrueCopy Protection Group

Before You Begin

If you want to delete the protection group everywhere, you must 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 –

You must remove the application resource groups from the protection group in order to keep the application resource groups online while deleting the protection group. See Example 2–8 and Example 2–10 for examples of this procedure.

  1. Log in to a node on the primary cluster.

    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 in Sun Cluster Geographic Edition System Administration Guide.

  2. Delete the protection group.

    This command deletes the configuration of the protection group from the local cluster. The command also removes the replication resource group for each Hitachi TrueCopy device group in the protection group. This command does not alter the pair state of the Hitachi TrueCopy device group.


    # geopg delete protectiongroupname
    protectiongroupname

    Specifies the name of the protection group

  3. To delete the protection group on the secondary cluster, repeat step 1 and step 2 on cluster-newyork.

Example 2–7 Deleting a Protection Group

This example deletes a protection group from both partner clusters.

cluster-paris is the primary cluster. For a reminder of the sample cluster configuration, see Example Sun Cluster Geographic Edition Cluster Configuration in Sun Cluster Geographic Edition System Administration Guide.


# rlogin phys-paris-1 -l root
phys-paris-1# geopg delete tcpg
# rlogin phys-newyork-1 -l root
phys-newyork-1# geopg delete tcpg
Example 2–8 Deleting a Hitachi TrueCopy Protection Group While Keeping Application Resource Groups Online

This example keeps online two application resource groups, apprg1 and apprg2, while deleting their protection group, tcpg. Remove the application resource groups from the protection group, then delete the protection group. 


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