Go to main content

Oracle Solaris Cluster 4.3 Data Services Reference Manual

Exit Print View

Updated: September 2015
 
 

GoldenGate(5)

Name

ORCL.GoldenGate, GoldenGate - resource type implementation for processing of Oracle Solaris Cluster HA for Oracle GoldenGate

Description

The ORCL.GoldenGate resource type represents the Oracle GoldenGate instance in an Oracle Solaris Cluster. The resource type controls the manager, extract, replicat, and server processes of an Oracle GoldenGate instance.

The ORCL.GoldenGate resource must depend on a database resource in a cluster configuration and has to be co-located with the same database. You can achieve this condition either by placing the Oracle GoldenGate resource in the same resource group as the database resource or by using the resource group affinities.

The resource type logs the output of the Oracle GoldenGate start and stop functions in the /var/cluster/logs/DS/ORCL.GoldenGate/message_log.resource_name directory as well as in the /var/adm/messages file.

For more information about Oracle Solaris Cluster HA for Oracle GoldenGate, see Oracle Solaris Cluster Data Service for Oracle GoldenGate Guide.

Standard properties and extension properties that are defined for the ORCL.GoldenGate resource type are described in the subsections that follow. To set these properties for an instance of the ORCL.GoldenGate resource type, use the clresourcetype (1CL) command.

Standard Properties

None of the standard resources properties have been overridden for this resource type.

For a description of all standard resource properties, see the r_properties(5) man page.

Extension Properties

The Oracle GoldenGate resource type inherits the extension properties from ORCL.gds. For a list of the ORCL.gds standard and extension properties, see the ORCL.gds man page.

The additional extension properties of the ORCL.GoldenGate resource type are as follows:

User

This property indicates the owner of an Oracle GoldenGate installation.

Data type

String

Default

None defined

Range

Not applicable

Tunable

When disabled

Basepath

This property indicates the Oracle GoldenGate installation directory.

Data type

String

Default

None defined

Range

Not applicable

Tunable

When disabled

Degraded_code

This property indicates the return code of the probes, if all of the extract or replicat processes are abended.

Data type

Integer

Default

10

Range

1–50

Tunable

When disabled

Port

This property indicates the port on which the manager responds.

Data type

Integer

Default

0

Range

0–65535

Tunable

When disabled

Parameter_file

This property indicates the parameter file for a manager process to run on the Oracle GoldenGate instance.

Data type

String

Default

None defined

Range

Not applicable

Tunable

When disabled

Database_resource

This property indicates the resource name which protects the database to be replicated by the Oracle GoldenGate instance.

Data type

String

Default

None defined

Range

Not applicable

Tunable

When disabled

Start_pattern

This property indicates a list of pattern describing the extract and the replicat names to be started by the Oracle GoldenGate agent.

Data type

String

Default

"'er \\\*'"


Note -  Precede the asterisk by three backward slash (\ ) characters, and surround the entire string by single quotation marks (') as well as double quotation marks (").
Range

Not applicable

Tunable

When disabled

Examples

Example 1 Creating an ORCL.GoldenGate Resource

This example shows the commands to create an ORCL.GoldenGate resource. These commands perform the following operations:

  • Registering ORCL.GoldenGate

  • Adding the gg-rs resource to the db-rg resource group

This example makes the following assumptions:

  • The bash shell is used.

  • The failover resource group db-rg is already created.

  • The logical host resource is already created.

  • The database resource db-rs and the storage resource hsp-rs are already created.

Note that only the mandatory extension properties are used in the following example.

# clrt register ORCL.GoldenGate
# clrs create -d -g db-rg \
-t ORCL.GoldenGate \
-p user=gg \
-p Basepath=/gg2 \
-p port=7809 \
-p parameter_file=/gg2/dirprm/mgr.prm \
-p database_resource=db-rs \
-p resource_dependencies=db-rs,soma-3 \
-p resource_dependencies_offline_restart=hsp-rs \
gg-rs

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
ha-cluster/data-service/goldengate

See Also

clresource (1CL) , clresourcegroup (1CL) , clresourcetype (1CL) , attributes (5) , r_properties (5)