# Oracle GoldenGate for MongoDB Migrations 23ai (23.8.0.25.05) Container Image Documentation GoldenGate for MongoDB Migrations is an easy way to migrate collections from a MongoDB source to an Oracle Autonomous JSON Database or JSON Collection Tables using MongoDB API on Oracle. This container includes both an orchestration service backend and the GoldenGate Studio UI to perform online and offline migrations. ## Using This Image To use GoldenGate for MongoDB Migrations you’ll need to download and run this container from a location that has network access to the database(s) that you want to connect and replicate data with – this can be on a local machine or on cloud compute, but please ensure that the database is accessible from the location you choose to run this container. To make things as easy as possible there is dedicated ‘how-to’ documentation, here are some guides to get started: * Get started with GoldenGate for MongoDB Migrations: https://apexapps.oracle.com/pls/apex/f?p=44785:24:0:::24:P24_CONTENT_ID:34427 * Overview / About GoldenGate for MongoDB Migrations: http://www.oracle.com/pls/topic/lookup?ctx=en/middleware/goldengate/studio-free/23&id=ggsfm-about * Begin building solutions with GoldenGate for MongoDB Migrations: http://www.oracle.com/pls/topic/lookup?ctx=en/middleware/goldengate/studio-free/23&id=ggsfm-db-migrations As you are using GoldenGate for MongoDB Migrations, if you need any help or spot any issues that Oracle Development should take a look at, please consider posting a comment or question on the Oracle Developer Community forum for GoldenGate Free, here: https://forums.oracle.com/ords/apexds/domain/dev-community/category/goldengate-free ## How to run Oracle GoldenGate for MongoDB Migrations in a Container Use the `docker run` command to create and start a container from the Oracle GoldenGate for MongoDB Migrations container image. ```sh $ docker run -p 80:80 -p 443:443 -p 8443:8443 -e OGG_ADMIN=<username> -e OGG_ADMIN_PWD=<password> container-registry.oracle.com/goldengate/goldengate-mongodb-migrations:latest ... ``` It will instantiate a container with following default options: * Auto-generated container name * 80 port for HTTP Server * 443 port for HTTPS Server * 8443 port for Web UI server * 'Local' for the name of the deployment * Use container storage for /u02 and /u03 volume * Auto-generated self-signed certificate ## Advanced usage of the image ```sh $ docker run \ --name <container name> \ -p <host port>:80 \ -p <host port>:443 \ -p <host port>:8443 \ -e OGG_ADMIN=<admin user name> \ -e OGG_ADMIN_PWD=<admin password> \ -v [<host mount point>:]/u02 \ -v [<host mount point>:]/u03 \ -v [<host mount point>:]/etc/nginx/cert \ container-registry.oracle.com/goldengate/goldengate-mongodb-migrations:latest ``` Parameters: * `--name <container name>` - A name for the new container (default: auto generated) * `-p <host-port>:80` - The host port to map to the Oracle GoldenGate HTTP server (default: no mapping) * `-p <host-port>:443` - The host port to map to the Oracle GoldenGate HTTPS server (default: no mapping) * `-p <host-port>:8443` - The host port to map to the Oracle GoldenGate Web UI server (default: no mapping) * `-e OGG_ADMIN` - The name of the administrative account to create (default: `oggadmin`) * `-e OGG_ADMIN_PWD` - The password for the administrative account (default: auto generated) * `-v /u02` - The volume used for persistent GoldenGate data (default: use container storage) Consider large host volume for mount to accommodate sizable migration * `-v /u03` - The volume used for temporary MongoDB export and GoldenGate data (default: use container storage) * `-v /etc/nginx/cert` - The volume used for storing the SSL certificate for the HTTPS server (default: create a self-signed certificate) See the following sections for additional details. ### Data Storage Volumes * /u01 - The volume for GoldenGate system * /u02 - The volume for persistent GoldenGate data * /u03 - The volume for temporary MongoDB export and GoldenGate data ### SSL Certificate By default, a self-signed certificate is generated. /u02/oggf/certificate/ca.pem contains the issuing CA certificate used in generating the self-signed certificate. When bringing your own SSL certificate to an Oracle GoldenGate container, several files are needed: 1. `ogg.key` - The private key for the SSL certificate of ogg. 2. `ogg.pem` - The SSL leaf certificate, and a full certificate trust chain of ogg. If these files are located in a directory called `cert`, they can be used in the GoldenGate container with a volume mount as shown here: ```sh $ docker run -v ${PWD}/cert:/etc/nginx/cert:ro -p 8443:443 container-registry.oracle.com/goldengate/goldengate-free:latest ... ``` All certificate files must contain a full certificate chain starting with the leaf certificate, then followed by all other certificates in the Certificate Authority chain. ```pem -----BEGIN CERTIFICATE----- MIIFBTCCA+2gAwIBAgISBJSzNXE+Ha5eDw76N5lgHhTpMA0GCSqGSIb3DQEBCwUA MEoxCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1MZXQncyBFbmNyeXB0MSMwIQYDVQQD ... dr7wTE+AQwcOLAGjIvFOL7GK8JrhKvuFvnSoys/1O2CK3vVhBgS+mEF6D+QjIGTv VC01LCPT51q58INy4RtDBPSqlJwrzz+pOOWd5rBWhu2UPktVHz3AtYE= -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- MIIEkjCCA3qgAwIBAgIQCgFBQgAAAVOFc2oLheynCDANBgkqhkiG9w0BAQsFADA/ MSQwIgYDVQQKExtEaWdpdGFsIFNpZ25hdHVyZSBUcnVzdCBDby4xFzAVBgNVBAMT ... PfZ+G6Z6h7mjem0Y+iWlkYcV4PIWL1iwBi8saCbGS5jN2p8M+X+Q7UNKEkROb3N6 KOqkqm57TH2H3eDJAkSnh6/DNFu0Qg== -----END CERTIFICATE----- ``` ### Best practices to secure Docker containers Running containers as a non-root helps to mitigate security vulnerabilities. Running your containers on rootless mode will verify that your application environment is safe. By default, Docker gives root permission to the processes within your containers, which means they have full administrative access to your container and host environments. Oracle Enterprise Linux is using the docker-compatible Podman to run and manage Open Container Initiative (OCI) compatible containers. Follow the Rootless Podman tutorial to setup Podman in rootless mode. ### Diagnostic logging The logs for Oracle GoldenGate for MongoDB Migrations can be found from /u02/oggf/logs volume * oggf-apiserver*.log - The rolling logs from api-server * deployment.log - The logs from deploying OGG Microservice Architecture ## Known Issues http://www.oracle.com/pls/topic/lookup?ctx=en/middleware/goldengate/studio-free/23&id=ggsfm-known-issues ## GoldenGate Licensing Information User Manual (LIUM) https://docs.oracle.com/en/middleware/goldengate/core/23/ogglc/index.html ## Documentation Accessibility For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at https://www.oracle.com/corporate/accessibility/. --- Oracle GoldenGate for MongoDB Migrations Release 23ai (23.8.0.25.05) Container Image Documentation Copyright © 2025 Oracle and/or its affiliates. ## Oracle GoldenGate for Database Migrations License Agreement Oracle is willing to authorize Your access to software associated with this License Agreement (“Agreement”) only upon the condition that You accept that this Agreement governs Your use of the software. By selecting the “Accept License Agreement” button or box (or the equivalent) or installing or using the Programs You indicate Your acceptance of this Agreement and Your agreement, as an authorized representative of Your company or organization (if being acquired for use by an entity) or as an individual, to comply with the license terms that apply to the software that You wish to download and access. If You are not willing to be bound by this Agreement, do not select the “Accept License Agreement” button or box (or the equivalent) and do not download or access the software. Definitions "Oracle" refers to Oracle America, Inc. "You" and "Your" refers to (a) a company or organization (each an “Entity”) accessing the Programs, if use of the Programs will be on behalf of such Entity; or (b) an individual accessing the Programs, if use of the Programs will not be on behalf of an Entity. “Contractors” refers to Your agents and contractors (including, without limitation, outsourcers). "Program(s)" refers to Oracle software provided by Oracle pursuant to this Agreement and any updates, error corrections, and/or Program Documentation provided by Oracle. “Program Documentation” refers to Program user manuals and Program installation manuals, if any. If available, Program Documentation may be delivered with the Programs and/or may be accessed from docs.oracle.com/en/middleware/goldengate/. “Separate Terms” refers to separate license terms that are specified in the Program Documentation, readmes or notice files and that apply to Separately Licensed Third Party Technology. “Separately Licensed Third Party Technology” refers to third party technology that is licensed under Separate Terms and not under the terms of this Agreement. License Rights and Restrictions Oracle grants You a nonexclusive, nontransferable, limited license to internally use the Programs, subject to the restrictions stated in this Agreement, only for the purpose of: • Migration of Your data to an Oracle Database and not for any other purpose. You may allow Your Contractor(s) to use the Programs, provided they are acting on Your behalf to exercise license rights granted in this Agreement and further provided that You are responsible for their compliance with this Agreement in such use. You will have a written agreement with Your Contractor(s) that strictly limits their right to use the Programs and that otherwise protects Oracle’s intellectual property rights to the same extent as this Agreement. You may make copies of the Programs to the extent reasonably necessary to exercise the license rights granted in this Agreement. You may make one copy of the Programs for backup purposes. Further, You may not: * remove or modify any Program markings or any notice of Oracle’s or a licensor’s proprietary rights; * make the Programs available in any manner to any third party (other than Contractors acting on Your behalf as set forth in this Agreement); * use the Programs to provide third party training; * assign this Agreement or distribute, give, or transfer the Programs or an interest in them to any third party, except as expressly permitted in this Agreement for Contractors (the foregoing shall not be construed to limit the rights You may otherwise have with respect to Separately Licensed Third Party Technology); * cause or permit reverse engineering (unless required by law for interoperability), disassembly or decompilation of the Programs; and * disclose results of any Program benchmark tests without Oracle’s prior consent. The Programs may contain source code that, unless expressly licensed in this Agreement for other purposes (for example, licensed under an open-source license), is provided solely for reference purposes pursuant to the terms of this Agreement and may not be modified. All rights not expressly granted in this Agreement are reserved by Oracle. License Term The license to copy and use the Programs as set forth herein shall be valid for 183 days from the date You first accept this Agreement. Each of Your subsequent click-through acceptances of this Agreement commences a new 183-day period during which You may use the Programs under the licenses granted herein. Your licenses to copy and use the Programs as set forth herein, shall automatically terminate 183 days after the date of Your most recent click-through acceptance of this Agreement, and, unless there is a new click-through acceptance of the Agreement, this Agreement will automatically terminate 15 days thereafter. You may terminate this Agreement at any time by destroying all copies of the Programs. This Agreement and the licenses granted herein shall automatically terminate without notice if You fail to comply with any of the terms of this Agreement. Upon termination of this Agreement You shall promptly destroy all copies of the Programs. Obligations that, by the nature, extend beyond the termination of this Agreement, including but not limited to those in this paragraph, shall survive termination. Ownership Oracle or its licensors retain all ownership and intellectual property rights to the Programs. Third-Party Technology The Programs may contain or require the use of third party technology that is provided with the Programs. Oracle may provide certain notices to You in Program Documentation, readmes or notice files in connection with such third party technology. Third party technology will be licensed to You either under the terms of this Agreement or, if specified in the Program Documentation, readmes or notice files, under Separate Terms. Your rights to use Separately Licensed Third Party Technology under Separate Terms are not restricted in any way by this Agreement. However, for clarity, notwithstanding the existence of a notice, third party technology that is not Separately Licensed Third Party Technology shall be deemed part of the Programs and is licensed to You under the terms of this Agreement. Source Code for Open Source Software For software that you receive from Oracle in binary form that is licensed under an open source license that gives you the right to receive the source code for that binary, you may be able to obtain a copy of the applicable source code from https://www.oracle.com/downloads/opensource/software-components-source-code.html. Further, if the source code for such software was not provided to you with the binary, you can receive a copy of the source code on physical media by submitting a written request pursuant to the instructions in the "Written Offer for Source Code" section of the latter website. Export Controls Export laws and regulations of the United States and any other relevant local export laws and regulations apply to the Programs . You agree that such export control laws govern Your use of the Programs (including technical data) and any services deliverables provided under this agreement, and You agree to comply with all such export laws and regulations (including "deemed export" and "deemed re-export" regulations). You agree that no data, information, program and/or materials resulting from Programs or services (or direct products thereof) will be exported, directly or indirectly, in violation of these laws, or will be used for any purpose prohibited by these laws including, without limitation, nuclear, chemical, or biological weapons proliferation, or development of missile technology. Accordingly, You confirm: * You will not download, provide, make available or otherwise export or re-export the Programs, directly or indirectly, to countries prohibited by applicable laws and regulations nor to citizens, nationals or residents of those countries. * You are not listed on the United States Department of Treasury lists of Specially Designated Nationals and Blocked Persons, Specially Designated Terrorists, and Specially Designated Narcotic Traffickers, nor are You listed on the United States Department of Commerce Table of Denial Orders. * You will not download or otherwise export or re-export the Programs, directly or indirectly, to persons on the above-mentioned lists. * You will not use the Programs for, and will not allow the Programs to be used for, any purposes prohibited by applicable law, including, without limitation, for the development, design, manufacture or production of nuclear, chemical or biological weapons of mass destruction. Information Collection The Programs’ installation and/or auto-update processes, if any, may transmit a limited amount of data to Oracle or its service provider about those processes to help Oracle understand and optimize them. Oracle does not associate the data with personally identifiable information. Refer to Oracle’s Privacy Policy at www.oracle.com/privacy. Disclaimer of Warranties; Limitation of Liability THE PROGRAMS ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. ORACLE FURTHER DISCLAIMS ALL WARRANTIES, EXPRESS AND IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NONINFRINGEMENT. IN NO EVENT WILL ORACLE BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, PUNITIVE OR CONSEQUENTIAL DAMAGES, OR DAMAGES FOR LOSS OF PROFITS, REVENUE, DATA OR DATA USE, INCURRED BY YOU OR ANY THIRD PARTY, WHETHER IN AN ACTION IN CONTRACT OR TORT, EVEN IF ORACLE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. ORACLE’S ENTIRE LIABILITY FOR DAMAGES UNDER THIS AGREEMENT SHALL IN NO EVENT EXCEED ONE THOUSAND DOLLARS (U.S. $1,000). No Technical Support Unless Oracle support for the Programs, if any, is expressly included in a separate, current support agreement between You and Oracle, Oracle’s technical support organization will not provide technical support, phone support, or updates to You for the Programs provided under this Agreement. Audit Oracle may audit Your use of the Programs upon reasonable notice. Relationship Between the Parties Oracle is an independent contractor and we agree that no partnership, joint venture, or agency relationship exists between us. We each will be responsible for paying our own employees, including employment related taxes and insurance.. Nothing in this agreement shall be construed to limit either party's right to independently develop or distribute software that is functionally similar to the other party's products, so long as proprietary information of the other party is not included in such software. Entire Agreement; Governing Law You agree that this Agreement is the complete agreement for the Programs and this Agreement supersedes all prior or contemporaneous agreements or representations, including any clickwrap, shrinkwrap or similar licenses, or license agreements for prior versions of the Programs. This Agreement may not be modified and the rights and restrictions may not be altered or waived except in a writing signed by authorized representatives of You and of Oracle. If any term of this Agreement is found to be invalid or unenforceable, the remaining provisions will remain effective. This Agreement is governed by the substantive and procedural laws of the State of California, USA, and You and Oracle agree to submit to the exclusive jurisdiction of, and venue in, the courts of San Francisco or Santa Clara counties in California in any dispute arising out of or relating to this Agreement. Notices Should you have any questions concerning this License Agreement, or if you desire to contact Oracle for any reason, please write: Oracle America, Inc. 500 Oracle Parkway Redwood City, CA 94065 Oracle Employees: Under no circumstances are Oracle Employees authorized to download software for the purpose of distributing it to customers. Oracle products are available to employees for internal use or demonstration purposes only. In keeping with Oracle's trade compliance obligations under U.S. and applicable multilateral law, failure to comply with this policy could result in disciplinary action up to and including termination. Last updated: June 4, 2025