How to Create and Configure an Oracle ZFS Storage Appliance Protection Group

Language:

Perform this procedure from a node of the primary cluster.

Note - You can also accomplish this procedure by using the Oracle Solaris Cluster Manager GUI. Click Partnerships, click the partnership name, and in the Protection Groups section click Create. Use data replication type Sbp. For more information about Oracle Solaris Cluster Manager, see Chapter 13, Using the Oracle Solaris Cluster GUI in Oracle Solaris Cluster System Administration Guide.

Before You Begin

Ensure that the following conditions are met:

The Geographic Edition software is installed on the primary and secondary storage appliances.
You have reviewed the information in Planning and Configuring Remote Replication With Oracle ZFS Storage Appliance Software.
You have created a remote replication role and user on each appliance. See How to Create a Role and Associated User for the Primary and Secondary Appliances.
You have created the projects you need. See How to Create a Project and Enable Replication for the Project.
The local cluster is a member of a partnership.
The protection group you are creating does not already exist on either partner cluster.

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.
Copy the default zfssa_geo_config file to another location.
The /var/tmp/ directory is used as an example location in this step and the next step.
```
# cp /opt/ORCLscgrepzfssa/etc/zfssa_geo_config /var/tmp/
```
On all nodes of both clusters, create or update an /etc/opt/SUNWscgrepsbp/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 example, assuming that the nodes of cluster cluster-newyork are phys-newyork-1 and phys-newyork-2, on each node of cluster cluster-newyork, you would issue the following commands:
```
phys-newyork-N# mkdir /etc/opt/SUNWscgrepsbp
phys-newyork-N# echo "trancos|any|phys-newyork-1,phys-newyork-2" > /etc/opt/SUNWscgrepsbp/configuration
```
Assuming that the nodes of cluster paris are phys-paris-3 and phys-paris-4, on each node of cluster paris, you would issue the following commands:
```
phys-paris-N# mkdir /etc/opt/SUNWscgrepsbp
phys-paris-N# echo "trancos|any|phys-paris-3,phys-paris-4" > /etc/opt/SUNWscgrepsbp/configuration
```
For more information about configuration files, see configuration_file Property in Oracle Solaris Cluster Geographic Edition System Administration Guide.
Specify the configuration values in the temporary /var/tmp/zfssa_geo_config file.
The following list uses sample values:
```
PS=zfssa-partnership
PG=zfssa-pg
REPCOMP=trancos
REPRS=zfssa-replication-resource
REPRG=zfssa-replication-resource-group
DESC="ZFS Storage Appliance replication protection group"
APPRG=usa-rg
CONFIGFILE=/etc/opt/SUNWscgrepsbp/configuration
LOCAL_CONNECT_STRING=user@local-appliance.example.com
REMOTE_CONNECT_STRING=user@remote-appliance.example.com
CLUSTER_DGS=
```
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.

For more information about the zfssa_geo_config file, see Overview of the Oracle ZFS Storage Appliance Configuration File.

Execute the zfssa_geo_register script on the primary cluster.

For example:

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

Replicate the protection group to the partner cluster.
The final messages of the registration script outline the required geopg get command. You must log in to one node of the partner cluster and execute that exact command.

For example, where zfssa-partnership is the partnership name and zfssa-protection-group is the protection group name:
```
phys-paris-1# geopg get --partnership zfssa-partnership zfssa-protection-group
```
Verify the protection group configuration.
```
phys-newyork-1# geoadm status
phys-newyork-1# clresource status zfssa-replication-resource
```
zfssa-replication-resource

Specifies the name of the replication resource.
Verify that you can switch over from one cluster to the other.
See How to Switch Over Replication From the Primary Cluster to the Secondary Cluster in Oracle Solaris Cluster Geographic Edition System Administration Guide.

Troubleshooting

If you experience failures while performing this procedure, enable debugging. See Debugging an Oracle ZFS Storage Appliance Protection Group.