Adding an Application Resource Group to an Oracle Solaris ZFS snapshot Protection Group

Language:

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

Use the zfs_snap_geo_registerscript to create protection group, add replication components, and application resource groups to the protection group in one complete setup procedure. You must ensure that the parameters are filled in the configuration file before you run the register script. However, you can use the procedure in this section to add any application resource groups whose replication setup already exists in the protection group.

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.

How to Add an Application Resource Group to an Oracle Solaris ZFS Snapshot Protection Group

Perform this procedure to add an existing resource group to the list of application resource groups in a protection group. If you specify any existing application resource groups in the zfs_snap_geo_config configuration file and execute the zfs_snap_geo_register script, such application resource groups are automatically added to the protection group and the replication configuration for such resource groups is also created in the protection group. This setup procedure is completed automatically and you are not required to add the application resource groups again to the protection group.

If the ZFS dataset corresponding to the application resource group that you want to add to the protection group has not been added to the protection group, use the zfs_snap_geo_register script.

However, if the ZFS dataset of the application resource group is already in the protection group, and you only want to add the application resource group to the protection group, then perform this procedure.

Note - You can also accomplish this procedure by using the Oracle Solaris Cluster Manager browser interface. Click Partnerships, click the partnership name, click the protection group name, and in the Resource Groups section click Add Resource Groups. For more information about Oracle Solaris Cluster Manager, see Chapter 13, Using the Oracle Solaris Cluster Manager Browser Interface in Oracle Solaris Cluster 4.3 System Administration Guide.

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

If the resource group is unmanaged and the protection group is activated after the configuration of the protection group has changed, the local state of the protection group becomes Error.
If the resource group to add is online and the protection group is deactivated, the request is rejected.

Before You Begin

Ensure that the following conditions are met:

The protection group is defined.
The resource group to be added already exists on both clusters and is in an appropriate state.

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 4.3 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 Solaris ZFS snapshot software.
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 app-group
```
If necessary, change the property value to False.
```
# clresourcegroup set -p Auto_start_on_new_cluster=False app-group
```
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_dependency_allowed property of the protection group is set to TRUE.
```
# geopg show protection-group | grep -i external_dependency_allowed
```
If necessary, change the property value to True.
```
# geopg set-prop -p external_dependency_allowed=TRUE protection-group
```
(Optional) If the protection group is deactivated, bring the application resource group to unmanaged state.
The application resource group must be in unmanaged state to be added to a deactivated protection group.
```
# clresourcegroup offline resource-group
# clresource disable -g resource-group +
# clresourcegroup unmanage resource-group
```
Add the application resource group to the protection group.
```
# geopg add-resource-group application-resource-group protection-group
```
application-resource-group

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

protection-group

Specifies the name of the protection group.

The geopg add-resource-group command adds an application resource group to a protection group on the local cluster. 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 Legal Names and Values of Geographic Edition Entities in Oracle Solaris Cluster 4.3 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.
If necessary, bring online the application resource group.
```
# clresourcegroup online application-resource-group
```

Example 1 Adding an Application Resource Group to an Oracle Solaris ZFS Snapshot Protection Group

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

# geopg add-resource-group apprg1,apprg2 zfssnap-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.