5.1 Upgrading Oracle GoldenGate Microservices for Big Data

For Microservices, the earliest version that can be upgraded from is Oracle GoldenGate 21c (21.1.0.0). As a best practice, perform a minimal upgrade first, so that you can troubleshoot more easily in case of any issue. After the environment is upgraded successfully, you can implement the new functionality.

This chapter describes how to upgrade Oracle GoldenGate Microservices Architecture for Big Data from the previous releases of Oracle GoldenGate Microservices Architecture for BigData to the current release.

The pre-upgrade requirements are as follows:

• Stop all Oracle GoldenGate processes.
• Start Oracle GoldenGate.

Topics:

• Obtaining the Oracle GoldenGate Distribution
  
• Scope of Upgrade
  Even though you may only upgrade the source or target, rather than both, all processes are involved in upgrade. All processes must be stopped in the correct order for the upgrade, regardless of which component you upgrade, and the trails must be processed until empty.
• Upgrading Oracle GoldenGate Microservices – GUI Based
  

5.1.1 Obtaining the Oracle GoldenGate Distribution

To obtain Oracle GoldenGate:

1. Go to edelivery.oracle.com. For more information, see My Oracle Support Banner Oracle GoldenGate -- Oracle RDBMS Server Recommended Patches (Doc ID 1557031.1). To access Oracle Technology Network (OTN), go to https://www.oracle.com/integration/goldengate/
2. Find the Oracle GoldenGate 21c (21.1.0) release and download the ZIP file onto your system.

For more information about locating and downloading Oracle Fusion Middleware products, see the Oracle® Fusion Middleware Download, Installation, and Configuration Readme Files on OTN.

5.1.2 Scope of Upgrade

Even though you may only upgrade the source or target, rather than both, all processes are involved in upgrade. All processes must be stopped in the correct order for the upgrade, regardless of which component you upgrade, and the trails must be processed until empty.

Before you start the upgrade, review the information about upgrading Extract and Replicat.

Oracle recommends that you begin your upgrade with the target rather than the source to avoid the necessity of adjusting the trail file format.

• Replicat Upgrade Considerations
  All Replicat installations should be upgraded at the same time. It is critical to ensure that all trails leading to all Replicat groups on all target systems are processed until empty, according to the upgrade instructions.

5.1.2.1 Replicat Upgrade Considerations

All Replicat installations should be upgraded at the same time. It is critical to ensure that all trails leading to all Replicat groups on all target systems are processed until empty, according to the upgrade instructions.

Before you start the upgrade, review the information about upgrading Extract and Replicat.

Oracle recommends that you begin your upgrade with the target rather than the source to avoid the necessity of adjusting the trail file format.

5.1.3 Upgrading Oracle GoldenGate Microservices – GUI Based

To obtain the Oracle GoldenGate installation software and set up the directories for upgrade:

1. Download the latest Oracle GoldenGate Microservices 21c software from the Oracle Technology Network or eDelivery.
2. Upload the Oracle GoldenGate Microservices 21c software to a staging location on the server where a previous release of Oracle GoldenGate Microservices exists.
3. Unzip Oracle GoldenGate Microservices 21c 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 is located. This is not 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.
   At this point, you should have two Oracle GoldenGate MA home directories: one for your old home (21c) and a new home (21.x.x).
8. 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.
9. Update the Service Manager and the deployments with the location of the new Oracle GoldenGate home.
   1. Click Service Manager, then Deployment name.
   2. Next to the deployment details, click the pencil icon to display 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 following, if required:

      LD_LIBRARY_PATH

   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.
10. 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.