An OCI Cache Cluster connection stores the information that Oracle GoldenGate uses to connect to an Oracle Cloud Infrastructure (OCI) Cache Cluster. After the connection is created and validated, you can reuse it when configuring Replicat processes that deliver transactional data to the cache cluster.

The connection stores the server addresses, authentication settings, security configuration, and optional runtime settings independently of the Replicat configuration. This enables multiple Replicat processes to reuse the same validated connection.

Before creating an OCI Cache Cluster connection, ensure that you have the following:

• An Oracle GoldenGate deployment.
• Network connectivity between the Oracle GoldenGate deployment and the OCI Cache Cluster.
• One or more cache cluster server addresses.
• Authentication credentials, if authentication is enabled.
• TLS certificates or truststore files if secure communication is required.
• Required client libraries if additional runtime dependencies are required.
• Common runtime settings, such as the runtime classpath, if additional client libraries are required.
• Proxy information if the Oracle GoldenGate deployment accesses the cache cluster through an HTTP proxy.

Use the Add Connection page to create an OCI Cache Cluster connection.

Procedure

1. In the navigation menu, select DB Connections.
2. Click Add Connection.
3. In Connection Alias, enter a unique name for the connection.
4. From Technology Type, select OCI Cache Cluster.
5. In the Technology Settings section, provide the OCI Cache Cluster connection information.

   Configure the following technology settings:

   • Servers – Specifies a comma-separated list of OCI Cache Cluster server addresses. Each server can be specified as host:port. This field is required.
   • Authentication Type – Specifies the authentication mechanism used by the OCI Cache Cluster. Supported values depend on the deployment configuration.
6. Configure the Authentication Settings section.

   Configure the following authentication settings:

   • Username – Specifies the user name used to authenticate with the OCI Cache Cluster. Configure this field only when the selected authentication type requires credentials.
   • Password – Specifies the password associated with the user name. This field is treated as sensitive information and is displayed as a password field. Configure this field only when required by the selected authentication type.
7. Configure the Security Settings section.

   Configure the following security settings:

   • Security Protocol – Specifies the communication protocol used by the connection. Configure this property according to your deployment requirements.
   • Truststore – Specifies the truststore used to validate server certificates when TLS is enabled.
   • Truststore Password – Specifies the password associated with the truststore, if applicable.
   • Keystore – Specifies the keystore containing the client certificate when mutual authentication is required.
   • Keystore Password – Specifies the password associated with the keystore, if applicable.

   Note:

   Configure only the security properties required by the selected authentication type and security protocol.
8. Configure Common Settings, if additional runtime configuration is required.

   Configure the following common settings:

   Classpath: Specifies the runtime classpath used to load the required client libraries. You can use Dependency Downloader to download client libraries.

   Note:

   • Download the supported client libraries by using the Dependency Downloader for OCI Cache Cluster.
   • Configure the runtime classpath to reference the downloaded client libraries before starting the Replicat process.
9. (Optional) Configure Proxy Settings if the Oracle GoldenGate for Distributed Applications and Analytics deployment accesses the OCI Cache Cluster through an HTTP proxy.

   Configure the following proxy settings:

   • Proxy URL – Specifies the URL or host name of the proxy server used to access the OCI Cache Cluster.
   • Proxy Port – Specifies the port number of the proxy server.
   • Proxy Username – Specifies the user name for proxy authentication, if required.
   • Proxy Password – Specifies the password for proxy authentication. This field is treated as sensitive information.
   • Truststore – Specifies the Java truststore file that contains the certificate authority (CA) certificates used to validate the proxy server certificate, when required.
   • Truststore Password – Specifies the password associated with the truststore.
   • Keystore – Specifies the Java keystore file containing the client certificate and private key used for client authentication, when required.
   • Keystore Password – Specifies the password associated with the keystore.
   • SSL Key Password – Specifies the password protecting the private key stored in the keystore when it differs from the keystore password.

   Note:

   Configure the proxy and SSL settings only if the Oracle GoldenGate for Distributed Applications and Analytics deployment accesses the OCI Cache Cluster through a proxy that requires authentication or TLS. If the deployment has direct network connectivity to the OCI Cache Cluster, leave the Proxy Settings blank.
10. Click Submit.
11. On the DB Connections page, click DBLOGIN to validate the connection.

    Note:

    A successful DBLOGIN validates only the saved connection information. It does not validate the Replicat configuration or OCI Cache Cluster Handler configuration. After successful validation, the connection is available for selection during Replicat creation.

After the OCI Cache Cluster connection has been successfully validated:

1. Create or edit a Replicat.
2. Select OCI Cache Cluster as the target technology.
3. Select the validated OCI Cache Cluster connection.
4. Complete the remaining Replicat configuration.
5. Create and start the Replicat.