A Redis connection stores the information that Oracle GoldenGate uses to connect to a Redis deployment. After the connection is created and validated, you can reuse it when configuring Replicat processes that deliver transactional data to Redis.

The connection stores the Redis server information, 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 a Redis connection, ensure that you have the following:

• An Oracle GoldenGate deployment.
• Network connectivity between the Oracle GoldenGate deployment and the Redis deployment.
• One or more Redis server addresses.
• Authentication credentials if Redis authentication is enabled.
• TrustStore and KeyStore files if the deployment uses TLS or mutual TLS (mTLS).
• Required Redis 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 Redis through an HTTP proxy.

Use the Add Connection page to create a Redis 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 Redis.
5. In the Technology Settings section, provide the Redis connection information.

   Configure the following technology settings:

   • Servers – Specifies a comma-separated list of Redis server addresses in host[:port] format. If the port is omitted, Oracle GoldenGate for Distributed Applications and Analytics uses the default Redis port 6379. This field is required.
   • Authentication Type – Specifies the Redis authentication mode. Supported values are NONE and BASIC. This field is required.
6. Configure the Authentication Settings section when Authentication Type is BASIC.

   Configure the following authentication settings:

   • Username – Specifies the Redis user name. This field is required when Authentication Type is BASIC.
   • Password – Specifies the password associated with the Redis user name. This field is required when Authentication Type is BASIC and is treated as sensitive information.
7. Configure the Security Settings section.

   Configure the following security settings:

   • Security Protocol – Specifies the communication protocol. Supported values are PLAIN, TLS, and MTLS.
   • Truststore – Upload the Base64-encoded truststore file used to validate the Redis server certificate. This property is required for TLS and MTLS connections. This property is deprecated and will be replaced by trustStoreSecretId.
   • Truststore Password – Specifies the password associated with the truststore. Configure this field when the truststore is password protected. This property is deprecated and will be replaced by trustStorePasswordSecretId.
   • Keystore – Upload the Base64-encoded keystore file containing the client certificate and private key. This property is required only for MTLS connections. This property is deprecated and will be replaced by keyStoreSecretId.
   • Keystore Password – Specifies the password associated with the keystore. Configure this field when Security Protocol is MTLS. This property is deprecated and will be replaced by keyStorePasswordSecretId.

   Note:

   Configure only the authentication and 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 Redis client libraries. You can use Dependency Downloader to download client libraries

   Note:

   • Download the supported Redis client libraries by using the Dependency Downloader for Redis.
   • 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 Redis through an HTTP proxy.

   Configure the following proxy settings:

   • Proxy URL – Specifies the URL or host name of the proxy server used to access Redis.
   • 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 Redis through a proxy that requires authentication or TLS. If the deployment has direct network connectivity to Redis, 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 Redis Handler configuration. After successful validation, the connection is available for selection during Replicat creation.

After the Redis connection has been successfully validated:

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