Adding a Replication Component to an Oracle GoldenGate Protection Group

Language:

A protection group is the container for the application resource groups, 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 replication component to a protection group, the software monitors the replication status of Oracle GoldenGate. The software also controls the role and state of the Oracle GoldenGate extract and replicat processes during protection group operations such as start, stop, switchover, and takeover.

How to Add a Replication Component to an Oracle GoldenGate Protection Group

Perform this procedure to add an existing Oracle GoldenGate configuration to the list of Oracle GoldenGate configurations in a protection group. At protection group creation time, the Oracle GoldenGate configuration that you specified in the goldengate_geo_config file was added when you executed the goldengate_geo_register script.

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 underlying Oracle GoldenGate resources exist on both the local cluster and the partner cluster.
You must be assigned the Geo Management RBAC rights profile to complete this procedure. For more information, see Securing Geographic Edition Software in Oracle Solaris Cluster 4.3 Geographic Edition Installation and Configuration Guide .

Log in to a cluster node.
Add a replication component to the protection group.
The following command adds a replication component to a protection group on the local cluster and propagates the new configuration to the partner cluster if the partner cluster contains a protection group with the same name.
```
# geopg add-replication-component \
-p property [-p…] goldengate-replicated-component protection-group
```
In this syntax, –p property specifies the properties of the replication component group. You can specify the following script-based plug-in properties:
- switchover_args — Specifies the command-line arguments for the switchover script
- takeover_args — Specifies the command-line arguments for the takeover script
- start_replication_args — Specifies the command-line arguments for the start_replication script
- remove_config_args — Specifies the command-line arguments for the remove_configuration script
- create_config_args — Specifies the command-line arguments for the create_configuration script
- stop_replication_args — Specifies the command-line arguments for the stop_replication script
Caution - Make sure that the command-line arguments are the same for all scripts.

For more information about the properties you can set, see Property Descriptions for Script-Based Plug-Ins in Oracle Solaris Cluster 4.3 Geographic Edition System Administration Guide .

Also in this syntax, goldengate-replicated-component specifies the name of the new replication component, and protection-group specifies the name of the protection group that contains the Oracle GoldenGate replicated component.

For information about the names and values that are supported, see Appendix B, Legal Names and Values of Geographic Edition Entities, in Oracle Solaris Cluster 4.3 Geographic Edition System Administration Guide .

For more information about the geopg command, refer to the geopg (1M) man page.

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