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 Scope:

- This Document
- Entire Library

## Administering Sun ZFS Storage Appliance Data-Replicated Components

A protection group is the container for the application resource groups and replication components, which contain data for services that are protected from disaster. The Geographic Edition software protects the data by replicating it from the primary cluster to the secondary cluster. By adding a data-replicated component to a protection group, the software monitors the replication status of an appliance project. The software also controls the role and state of the project during protection group operations such as start, stop, switchover, and takeover.

This section provides the following information for administering data-replicated components in a Sun ZFS Storage Appliance protection group:

- 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

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

Perform this procedure to add a replication component to an existing Sun ZFS Storage Appliance protection group.

Note - When the protection group is initially created, any remote replication components that are specified in the `zfssa_geo_config` configuration file are added to the protection group. Thus, you only need to run this procedure to add more replication components to existing Sun ZFS Storage Appliance protection groups.

Before You Begin

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

- The protection group is defined on the local cluster.

- The protection group is offline on the local cluster and the partner cluster, if the partner cluster can be reached.

- The underlying project exists on the appliance that is connected to the local cluster.

- The replication action must exist.

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. On all nodes of both clusters, create or update a `/var/tmp/zfssa_geo_eval_rules` configuration file to contain the script-based plug-in evaluation rules.

   Update the file so that it contains one line that contains the rule information for the replication component.

       project-name|any|nodelist

   project-name

     Name of the project.

   nodelist

     The name of one or more cluster nodes where the plug-in is to validate the configuration.

   For more information about configuration files, see configuration_file Property in Oracle Solaris Cluster Geographic Edition System Administration Guide.

3. Update the appliance configuration files with information for the new data-replicated component.
   1. Make a copy of the default `/opt/ORCLscgrepzfssa/etc/zfssa_geo_config` file to a different location, such as `/var/tmp/`.

          # cp /opt/ORCLscgrepzfssa/etc/zfssa_geo_config /var/tmp/zfssa_geo_config

   2. Edit the copy of the `zfssa_geo_config` file with updates for the new component.

      Define the following key=value pairs as shown:

          PS=partnership
          PG=protection-group
          REPCOMP=project
          REPRS=resource
          REPRG=resource-group
          CONFIGFILE=eval-rules-configuration-file
          LOCAL_CONNECT_STRING=user@source-appliance
          REMOTE_CONNECT_STRING=user@target-appliance

      `PS=partnership`

        Specifies the name of the existing partnership.

      `PG=protection-group`

        Specifies the name of the protection group that you are adding the component to.

      `REPRS=resource`

        Specifies the name of a resource other than the existing resource.

      `REPRG=resource-group`

        Specified an existing resource group that contains the remote replication resources for this protection group.

      `CONFIGFILE=eval-rules-configuration-file`

        Specifies the edited copy of the `zfssa_geo_eval_rules` file that you created in Step 2.

      `LOCAL_CONNECT_STRING=user@local-appliance`

        Specifies the source user and hostname.

      `REMOTE_CONNECT_STRING=user@remote-appliance`

        Specifies the target user and hostname.

      Note - For the `LOCAL_CONNECT_STRING` and `REMOTE_CONNECT_STRING` variables, provide the user that you created in Step 3 of How to Create a Role and Associated User for the Primary and Secondary Appliances.

4. Add a data-replicated component to the protection group.

   Use the `zfssa_geo_register` script with a new configuration file.

       phys-newyork-1# /opt/ORCLscgrepzfssa/util/zfssa_geo_register -f /var/tmp/zfssa_geo_config

   The command adds a replication component to a protection group on the local cluster. If the partner cluster contains a protection group with the same name, the command also propagates the new configuration to the partner cluster.

   Note - Because the add operation for the replication component is performed during the scripted registration, an example is not provided here.

Troubleshooting

If you have difficulties adding the component to the protection group, see Debugging a Sun ZFS Storage Appliance Protection Group.

### Remote Replication Subsystem Process for Verifying the Replicated Component

During protection group validation, the Sun ZFS Storage Appliance remote replication layer validates the application resource groups and the replication entities by verifying that an application resource group in the protection group has its `Auto_start_on_new_cluster` property set to `False`.

When you bring a protection group online on the primary cluster, bring the application resources groups participating in that protection group online only on the same primary cluster. Setting the `Auto_start_on_new_cluster` property to `false` prevents the Oracle Solaris Cluster Resource Group Manager (RGM) from automatically starting the application resource groups. In this case, the startup of resource groups is reserved for the Geographic Edition software.

Application resource groups must be online only on the primary cluster when the protection group is activated.

The appliance `geocontrol` module supplies a script that is used by the script-based plug-in module. The script entry points require the same set of arguments. These arguments are validated for semantics and completeness. The following validation checks are performed:

- Are all of the mandatory arguments defined?

- Is the replicated component configuration file for the script-based plug-in evaluation rules defined?

- Is the specified replication resource configured with a correct start command, if the resource exists already?

When the Sun ZFS Storage Appliance replication component is added to a protection group, the data replication layer makes the following validations:

- Only one replication action is defined at the primary appliance, if the protection group role is `PRIMARY`.

- Only one replication package exists on the secondary appliance, if the protection group role is `SECONDARY`.

- The replication mode is set to `continuous`.

- The ZFS storage appliance can be reached. When an Sun ZFS Storage Appliance replication component is added to a protection group, an Oracle Solaris Cluster data replication resource as defined by the property `REPRS` in the configuration file is created by this command. This resource monitors the data replication state.

| Caution - Do not change, remove, or take offline these resources or resource groups. Use only Geographic Edition commands to administer replication resource groups and resources that are internal entities managed by Geographic Edition software. Altering the configuration or state of these entities directly with Oracle Solaris Cluster commands might result in unrecoverable failure.

When the validation is complete, the Geographic Edition software adds the application resource group to the protection group.

Note - Every entry point of the underlying script-based plug-in has a validation method. In the case of Sun ZFS Storage Appliance remote replication, all the validation methods are the same.

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

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. Modify the replication component.

   The following command modifies the properties of a remote replication component 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 with the same name.

       # geopg modify-replication-component -p  property [-p…] zfssa-rep-cmp zfssa-pg

   `-p` property

     Specifies the properties of the data-replicated component.

   zfssa-rep-cmp

     Specifies the name of the data-replicated component.

   zfssa-pg

     Specifies the name of the protection group that will contain the new data-replicated component.

Example 1-5 Modifying the Properties of a Sun ZFS Storage Appliance Remote Replication Component

The following example modifies the `Timeout` property of remote replication component `trancos` that is part of the appliance protection group, `zfssa-pg`.

    # geopg modify-replication-component -p Timeout=215 trancos zfssa-pg

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

Before You Begin

Ensure that the following conditions are met:

- The protection group is defined on the local cluster.

- The protection group is offline on the local cluster and the partner cluster, if the partner cluster can be reached.

- The remote replication component is managed by the protection group.

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

       # geopg remove-replication-component zfssa-rep-cmp zfssa-pg

   zfssa-rep-cmp

     Specifies the name of the data-replicated component.

   zfssa-pg

     Specifies the name of the protection group.

Example 1-6 Removing a Replicated Component From a Sun ZFS Storage Appliance Protection Group

In the following example, the data-replicated component `trancos` is removed from the appliance protection group, `zfssa-pg`.

    # geopg remove-replication-component trancos zfssa-pg

Copyright © 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices |