Upgrading Oracle GoldenGate Microservices – GUI Based

Learn the steps to upgrade Oracle GoldenGate Microservices using the GUI.

Follow these steps to obtain the Oracle GoldenGate installation software and set up the directories for upgrade.

  1. Download the latest Oracle GoldenGate MA 19c software from the Oracle Technology Network or eDelivery.

  2. Upload the Oracle GoldenGate MA 19c software to a staging location on the server where a previous release of Oracle GoldenGate Microservices exists.

  3. Unzip Oracle GoldenGate MA 19c software in the staging location.

    $ cd /tmp

    $ unzip ./fbo_ggs_Linux_x64_services_shiphome.zip

  4. Untar the tar file that gets created after the unzip command:

    tar -xvf ggs_Linux_x64_Oracle_64bit.tar

  5. Move into the unzipped files and execute the runInstaller command.

    $ cd ./fbo_ggs_Linux_x64_services_shiphome/Disk1

    $ ./runInstaller

  6. For Software Location, specify where the new Oracle GoldenGate home will be located. This will not be the same location as the current Oracle GoldenGate home. Click Next.

  7. Click Install to begin installing the new Oracle GoldenGate MA. When the installation is done, click Close.

  8. At this point, you should have two Oracle GoldenGate MA home directories: one for your old home (12c or 18c) and a new home (19c).

Now, perform the following steps:
  1. Verify the current version of Oracle GoldenGate Home through Service Manager.
    1. Login to the Service Manager: http://host:servicemanager_port
    2. Review the deployment section for your current Oracle GoldenGate home location.
  2. Update the Service Manager and the deployments with the location of the new Oracle GoldenGate home.
    1. Click Service Manager, then the Deployment name link.
    2. Next to the deployment details, click the pencil icon. This opens the dialog box to edit the Oracle GoldenGate home.
    3. Update the Oracle GoldenGate home with the complete path to the new Oracle GoldenGate home. Also update the LD_LIBRARY_PATH, if required.
    4. Click Apply.
    5. Confirm that the Oracle GoldenGate home has been updated.
    6. Stop all Extracts, Replicats, and Distribution paths.
    7. Use the action button to restart Service Manager or Deployment.

    Note:

    You can confirm that the Oracle GoldenGate home was updated by looking at the process from the operating system for Service Manager. The Service Manager process should be running from the new Oracle GoldenGate home.
  3. To upgrade the associated deployments, follow the same steps for Service Manager after ensuring that all the Extract and Replicat processes in that deployment have been stopped.