JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris Cluster Geographic Edition Remote Replication Guide for Sun ZFS Storage Appliance     Oracle Solaris Cluster 4.1
search filter icon
search icon

Document Information

Preface

1.  Configuring and Administering Sun ZFS Storage Appliance Protection Groups

Overview of Configuring and Administering Remote Replication in a Sun ZFS Storage Appliance Protection Group

Planning and Configuring Remote Replication With Sun ZFS Storage Appliance Software

Guidelines for Remote Replication With Sun ZFS Storage Appliance Software

Overview of the Sun ZFS Storage Appliance Configuration File

Geographic Edition Properties to Set for Sun ZFS Storage Appliance Replication

Remote Replication Layer Process for Validating the Application Resource Groups and Remote Replication Entities

Creating, Modifying, Validating, and Deleting a Sun ZFS Storage Appliance Protection Group

Strategies for Creating Sun ZFS Storage Appliance Protection Groups

Configuring Remote Replication With Sun ZFS Storage Appliance Software

How to Create a Role and Associated User for the Primary and Secondary Appliances

How to Create a Project and Enable Replication for the Project

How to Configure Oracle Solaris Cluster Resources on the Primary Cluster

How to Configure Oracle Solaris Cluster Resources on the Secondary Cluster

How to Create and Configure a Sun ZFS Storage Appliance Protection Group

How to Modify a Sun ZFS Storage Appliance Protection Group

Validating a Sun ZFS Storage Appliance Protection Group

How to Validate a Sun ZFS Storage Appliance Protection Group

Debugging a Sun ZFS Storage Appliance Protection Group

How to Delete a Sun ZFS Storage Appliance Protection Group

Administering Sun ZFS Storage Appliance Data-Replicated Components

How to Add a Remote Replication Component to a Sun ZFS Storage Appliance Protection Group

Remote Replication Subsystem Process for Verifying the Replicated Component

How to Modify a Sun ZFS Storage Appliance Data-Replicated Component

How to Remove a Data-Replicated Component From a Sun ZFS Storage Appliance Protection Group

Administering Sun ZFS Storage Appliance Application Resource Groups

How to Add an Application Resource Group to a Sun ZFS Storage Appliance Protection Group

How to Delete an Application Resource Group From a Sun ZFS Storage Appliance Protection Group

Replicating a Sun ZFS Storage Appliance Protection Group Configuration to a Partner Cluster

How to Replicate the Sun ZFS Storage Appliance Protection Group Configuration to a Partner Cluster

Activating and Deactivating a Sun ZFS Storage Appliance Protection Group

How to Activate a Sun ZFS Storage Appliance Protection Group

How to Deactivate a Sun ZFS Storage Appliance Protection Group

Resynchronizing a Sun ZFS Storage Appliance Protection Group

How to Resynchronize a Sun ZFS Storage Appliance Protection Group

Checking the Runtime Status of Sun ZFS Storage Appliance Remote Replication

Overview of Displaying a Sun ZFS Storage Appliance Runtime Status

How to Check the Runtime Status of Sun ZFS Storage Appliance Replication

Sun ZFS Storage Appliance Replication Resource Group Runtime Status and Status Messages

2.  Migrating Services That Use Sun ZFS Storage Appliance Remote Replication

Index

Administering Sun ZFS Storage Appliance Application Resource Groups

To make an application highly available, the application must be managed as a resource in an application resource group.

The initial registration of the protection group is performed with the zfssa_geo_register script. This section explains how to manage the application resource groups on their own.

All the entities you configure for the application resource group on the primary cluster, such as application data resources, application configuration files, and the resource groups, must be replicated manually on the secondary cluster. The resource group names must be identical on both clusters. Also, the data that the application resource uses must be replicated on the secondary cluster.

This section contains information about the following tasks:

How to Add an Application Resource Group to a Sun ZFS Storage Appliance Protection Group

Perform this procedure to add an existing resource group to the list of application resource groups for a protection group.


Note - When the protection is initially created, any resource groups that are specified in the zfssa_geo_config configuration file are automatically created as well. Thus, you do not need to perform this procedure to add the resource groups specified in the zfssa_geo_config file at the time the protection group was created.


The protection group can be activated or deactivated and the resource group can be either online or unmanaged.

Before You Begin

Ensure that the following conditions are met:

  1. Assume the root role or assume a role that is assigned the Geo Management RBAC rights profile.

    For more information about RBAC, see Geographic Edition Software and RBAC in Oracle Solaris Cluster Geographic Edition System Administration Guide.


    Note - If you use a role with Geo Management RBAC rights, ensure that the /var/cluster/geo ACLs are correct on each node of both partner clusters. If necessary, assume the root role on the cluster node and set the correct ACLs.

    # chmod A+user:username:rwx:allow /var/cluster/geo

    The /var/cluster/geo directory must have the correct access control lists (ACL) applied for compatibility between the Geo Management RBAC rights profile and Sun ZFS Storage Appliance software.


  2. Ensure that the Auto_start_on_new_cluster property of the resource group is set to False.
    # clresourcegroup show -p Auto_start_on_new_cluster resource-group

    If necessary, change the property value to True.

    # clresourcegroup set -p Auto_start_on_new_cluster=True resource-group
  3. If the application resource group must have dependencies on resource groups and resources that are not managed by this protection group, ensure that the External_dependencies_allowed property of the protection group is set to TRUE.
    # geopg list protection-group | grep -i external_dependencies_allowed

    If necessary, change the property value to True.

    # geopg set-prop -p External_dependencies_allowed=TRUE protection-group
  4. (Optional) If the protection group is offline, take offline the application resource group.

    If the protection group is offline, the application resource group must also be offline before it can successfully be added to the protection group.

    # clresourcegroup offline resource-group
  5. Add an application resource group to the protection group.
    # geopg add-resource-group app-resource-group pg-name [-p external_dependencies_allowed=TRUE]
    app-resource-group

    Specifies the name of an application resource group. You can specify more than one resource group in a comma-separated list.

    pg-name

    Specifies the name of the protection group.

    -p external_dependencies_allowed=TRUE

    Permits the application resource group to have dependencies on resource groups and resources that are outside of the protection group.

    The command adds an application resource group to a protection group on the local cluster. Then, if the partner cluster contains a protection group of the same name, the command propagates the new configuration information to the partner cluster.

    For information about the names and values that are supported by Geographic Edition software, see Appendix B, Legal Names and Values of Geographic Edition Entities, in Oracle Solaris Cluster Geographic Edition System Administration Guide.

    After the application resource group is added to the protection group, the application resource group is managed as an entity of the protection group. The application resource group is now affected by protection group operations such as start, stop, switchover, and takeover.

  6. If necessary, bring online the application resource group.
    # clresourcegroup online app-resource-group

Example 1-7 Adding an Application Resource Group to a Sun ZFS Storage Appliance Protection Group

The following example adds two application resource groups, apprg1 and apprg2, to the zfssa-pg protection group.

# geopg add-resource-group apprg1,apprg2 zfssa-pg

Troubleshooting

If the add operation 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 add operation is unsuccessful on the partner cluster, the configuration status is set to Error on the partner cluster.

How to Delete an Application Resource Group From a Sun ZFS Storage Appliance Protection Group

You can remove an application resource group from a protection group without altering the state or contents of an application resource group.

Before You Begin

Ensure that the following conditions are met:

  1. Assume the root role or assume a role that is assigned the Geo Management RBAC rights profile.

    For more information about RBAC, see Geographic Edition Software and RBAC in Oracle Solaris Cluster Geographic Edition System Administration Guide.


    Note - If you use a role with Geo Management RBAC rights, ensure that the /var/cluster/geo ACLs are correct on each node of both partner clusters. If necessary, assume the root role on the cluster node and set the correct ACLs.

    # chmod A+user:username:rwx:allow /var/cluster/geo

    The /var/cluster/geo directory must have the correct access control lists (ACL) applied for compatibility between the Geo Management RBAC rights profile and Sun ZFS Storage Appliance software.


  2. Remove the application resource group from the protection group.
    # geopg remove-resource-group app-resource-group pg-name
    app-resource-group

    Specifies the name of an application resource group. You can specify more than one resource group in a comma-separated list.

    pg-name

    Specifies the name of the protection group.

    The command removes an application resource group from a protection group on the local cluster. If the partner cluster contains a protection group of the same name, the command also removes the application resource group from the protection group on the partner cluster.

Example 1-8 Deleting a Sun ZFS Storage Appliance Application Resource Group From a Protection Group

The following example removes two application resource groups, apprg1 and apprg2, from the zfssa-pg protection group.

# geopg remove-resource-group apprg1,apprg2 zfssa-pg

Troubleshooting

If the remove operation 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 remove operation is unsuccessful on the partner cluster, the configuration status is set to Error on the partner cluster.