Connect to Oracle API for MongoDB

Use the Oracle API for MongoDB connection type to replicate data from MongoDB to a user-managed on premises or cloud Oracle Database.

Before you begin

Before you create the connection, ensure you have the following:

Create the connection

To connect to Oracle API for MongoDB:
  1. From the OCI GoldenGate Overview page, click Connections.
    You can also click Create Connection under the Get started section and skip to step 3.
  2. On the Connections page, click Create Connection.
  3. On the Create Connection page, complete the fields as follows:
    1. For Name, enter a name for the connection.
    2. (Optional) For Description, enter a description that helps you distinguish this connection from others.
    3. For Compartment, select the compartment in which to create the connection.
    4. For Type, under Big Data, select Oracle API for MongoDB.
    5. For Connection string, enter the MongoDB connection string URI without the username and password. For example, mongodb://mongodb1.example.com:27017. Ensure that FQDN is used in the connection to establish SSL connections..
    6. For Username, enter the username for this database.
    7. Select the Password secret. If located in a different compartment, use the dropdown to change compartments.

      Note:

      • Secrets are credentials such as passwords, certificates, SSH keys, or authentication tokens that you use with OCI services. To create a secret, see Creating a secret. Ensure that you:
        • Select Manual secret generation.
        • Paste the credentials into Secret contents.
      • If you prefer not to use password secrets, ensure that you deselect Use secrets in vault in the Security section under Advanced Options, located at the bottom of this form.
  4. For Security protocol, select TLS and upload the CA certificate.
  5. Expand Show advanced options. You can configure the following options:
    • Security
      • Select Use Oracle-managed encryption key to leave all encryption key management to Oracle.
      • Select Use customer-managed encryption key to select a specific encryption key stored in your OCI Vault to encrypt your connection credentials.
    • Network connectivity
      • Shared endpoint, to share an endpoint with the assigned deployment. You must allow connectivity from the deployment's ingress IP.
      • Dedicated endpoint, for network traffic through a dedicated endpoint in the assigned subnet in your VCN. You must allow connectivity from this connection's ingress IPs.

        Note:

        • If a dedicated connection remains unassigned for seven days, then the service converts it to a shared connection.
        • Learn more about Oracle GoldenGate connectivity.
    • Tags: Add tags to organize your resources.
  6. Click Create.
After the connection is created, it appears in the Connections list. Ensure that you assign the connection to a deployment, and then Add a Replicat for MongoDB.

Known issues

MongoDB, DocumentDB, and Oracle JSON Collection TLS Security Protocol

If the MongoDB Replicat, DocumentDB Replicat, or Oracle JSON Collection connection fails with the following error in the Report file:
Error: Caused by: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

Workaround: Add the following property to your Properties file, update <connection_ocid> with your connection OCID and keep the rest as is. 

jvm.bootoptions=-Djavax.net.ssl.trustStore=/u02/connections/<connection_ocid>/truststore.pkcs12 -Djavax.net.ssl.trustStorePassword=Welcome123