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.

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

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

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

Skip Navigation Links
Exit Print View
	Oracle Solaris Cluster Geographic Edition Remote Replication Guide for Sun ZFS Storage Appliance Oracle Solaris Cluster 4.1