To use Oracle GoldenGate Studio, you need the following:

• A system running on a Docker, or a compatible container runtime such as Podman
• Internet connectivity to access the container registry
• A valid Oracle.com login

You can get GoldenGate Studio from the Oracle Container Registry (OCR). Follow the applicable instructions to access GoldenGate Studio:

You must sign in to your Oracle account and accept the license agreement before you can pull the GoldenGate Studio docker image from the Oracle Container Registry.

To access the GoldenGate Free docker image:

1. Accept the license agreement.
2. In your Docker client, enter the following command to log in to the Oracle Container Registry:

   docker login container-registry.oracle.com
   

3. When prompted, enter your Oracle account username and password.
4. Copy the docker pull command to pull the latest GoldenGate Studio image, and run it in your Docker client:

   docker pull container-registry.oracle.com/goldengate/goldengate-mongodb-migrations:latest

Learn to start and run GoldenGate Studio after pulling the docker image from Oracle Container Registry.

1. In your Docker client, you can enter a run command with default settings or enter a run command with parameter values:
   • To run GoldenGate Studio with default settings:

     docker run -v ${PWD}/cert:/etc/nginx/cert:ro -p 8443:443 container-registry.oracle.com/goldengate/goldengate-free:latest

     A container instantiates with the following default options:

     • auto generated container name
     • 80 port for HTTP Server
     • 443 port for HTTPS Server
     • oggadmin for the name of the administrative account
     • auto generated the password for the administrative account
     • Local for the name of the deployment
     • Use container storage for /u02 and /u03 volume
     • auto generated self-signed certificate
   • To run GoldenGate Studio with modified settings:

     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> \
         -e OGG_DEPLOYMENT=<deployment name> \
         -e OGG_DOMAIN=<domain name> \
         -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

     Parameter descriptions:

     • <container-name>: Name for the container. Auto-generated by default.
     • -p <host-port>:80: The host port to map the Oracle GoldenGate HTTP server. No mapping by default.
     • -p <host-port>:443: The host port to map the Oracle GoldenGate HTTPS server. No mapping by default.
     • -e OGG_ADMIN: The name of the administrative account to create. oggadmin by default.
     • -e OGG_ADMIN_PWD: The password of the administrative account. Auto-generated by default.

       Tip:

       Ensure the password meets the following requirements:

       • At least one lowercase character [a...z]
       • At least one upposercase character [A...Z]
       • At least one digit [0...9]
       • At least one special character [- ! @ % & * . #]
       • The length should be between 8 and 30 characters.
     • -e OGG_DEPLOYMENT: The name of the deployment. Local by default.
     • -e OGG_DOMAIN=<domain name>: The domain name to use for the self-signed certificate (default: hostname of the container). Not needed if you bring your own ssl certificates.
     • -v /u02: The volume used for persistent GoldenGate data. Use container storage by default.
     • -v /u03: The volume used for temporary MongoDB export and GoldenGate data. Use container storage by default.
     • -v /etc/nginx/cert: The volume used for storing the SSL certificat for the HTTPS server. Creates a self-signed certificate by default.

     Data storage volumes

     • /u01: the volume for the GoldenGate system
     • /u02: the volume for persistent GoldenGate data
     • /u03: the volume for temporary MongoDB export and GoldenGate data

     Administrative account password

     On first startup of the container, a random password is generated for the Oracle GoldenGate if one is not provided for OGG_ADMIN_PWD. You can find this password at the start of the container log:

     docker logs <container-name> | head -3

2. After a few minutes, you should see Server started at: http://localhost:8443. GoldenGate Studio is now ready for you to use.
3. Launch a web browser, and go to http://localhost:8443.
4. On the GoldenGate Studio login screen, enter the username and password that you passed to the docker run command, and then click Log in.

Now that you're in GoldenGate Studio, you can:

• Learn about Oracle GoldenGate for MongoDB Migrations
• Learn about connections
• Create connections