10.2.2 OCI Object Storage

<Enter Section Title Here>

(Optional) <Enter the purpose or a description of the reference item.>

Syntax

(Optional) <Enter syntax information here.>

Example 10-1 <Enter Example Title Here>

(Optional) <Explain the example.>

• About OCI Object Storage Connections
  
• Before You Begin
  
• Create and Validate an OCI Object Storage Connection
  
• Use an OCI Object Storage Connection in Replicat
  

10.2.2.1 About OCI Object Storage Connections

An OCI Object Storage connection stores the information that Oracle GoldenGate uses to connect to Oracle Cloud Infrastructure (OCI) Object Storage. After the connection is created and validated, you can reuse it when configuring Replicat processes that write transactional data to OCI Object Storage.

The connection stores the OCI tenancy information, user credentials, security configuration, and optional runtime settings independently of the Replicat configuration. This enables multiple Replicat processes to reuse the same validated connection.

10.2.2.2 Before You Begin

Before creating an OCI Object Storage connection, ensure that you have the following:

• An Oracle GoldenGate for Distributed Applications and Analytics deployment.

• Network connectivity between the Oracle GoldenGate deployment and Oracle Cloud Infrastructure.

• The Oracle Cloud Infrastructure tenancy OCID.

• The Oracle Cloud Infrastructure user OCID.

• The Oracle Cloud Infrastructure region.

• An OCI API signing key pair.

• The public key fingerprint associated with the API signing key.

• The private key file and passphrase, if the private key is encrypted.

• Common runtime settings, such as the runtime classpath, if required by your deployment.

• Proxy information if the Oracle GoldenGate deployment accesses OCI Object Storage through an HTTP proxy

10.2.2.3 Create and Validate an OCI Object Storage Connection

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

   • Tenancy OCID: Specifies the Oracle Cloud Infrastructure tenancy OCID associated with the Object Storage account. This field is required.
   • User OCID: Specifies the Oracle Cloud Infrastructure user OCID used to access Object Storage. If this field is not specified, Oracle GoldenGate uses the identity of the caller that invokes the API.
   • Region: Specifies the Oracle Cloud Infrastructure region that hosts the target Object Storage resources. This field is required.
6. Configure the Security Settings section.
   Security Settings

   • Private Key: Upload the Base64-encoded OCI API private key (.pem) used to authenticate with Oracle Cloud Infrastructure.
   • Private Key Passphrase: Specifies the passphrase protecting the private key, when the private key is encrypted.
   • Public Key Fingerprint: Specifies the fingerprint of the OCI API public key uploaded for the user. This field is required.

   Note:

   The private key and passphrase are treated as sensitive information and are securely stored.
7. Configure Common Settings, if additional runtime configuration is required.

   Common Settings

   Classpath: (Required) Specify the full path to client libraries are required by the replicat type. You can use Dependency Downloader to download client libraries.

8. (Optional) Configure Proxy Settings if the Oracle GoldenGate deployment accesses OCI Object Storage through an HTTP proxy.
   Proxy Settings

   • Proxy URL – Specifies the URL or host name of the proxy server used to access OCI Object Storage.
   • 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:

   If the Oracle GoldenGate deployment has direct network connectivity to OCI Object Storage, leave the Proxy Settings blank.
9. Click Submit.
10. On the DB Connections page, click DB Login to validate the connection.

    Note:

    A successful DB Login validates only the saved connection information. It does not validate the Replicat configuration or OCI Object Storage handler configuration. After successful validation, the connection is available for selection during Replicat creation.

10.2.2.4 Use an OCI Object Storage Connection in Replicat

After the OCI Object Storage connection has been successfully validated:

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