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

Language:

Perform this procedure to add a remote replication component to an existing Oracle 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 remote replication components to existing Oracle ZFS Storage Appliance protection groups.

Before You Begin

Before you add a remote 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 Securing Geographic Edition Software in Oracle Solaris Cluster Geographic Edition Installation and Configuration 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 Oracle 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 remote 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 remote replication 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 remote replication 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 remote replication 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 remote replication 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 remote 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 remote replication component is performed during the scripted registration, an example is not provided here.

Troubleshooting

If you have difficulties adding the remote replication component to the protection group, see Debugging an Oracle ZFS Storage Appliance Protection Group.