5 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
- Upgrading Oracle GoldenGate Microservices Using REST APIs
5.1 Obtaining the Oracle GoldenGate Distribution
To obtain Oracle GoldenGate:
- 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/
- 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.
Parent topic: Upgrading Oracle GoldenGate Microservices for Big Data
5.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.
Parent topic: Upgrading Oracle GoldenGate Microservices for Big Data
5.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.
Parent topic: Scope of Upgrade
5.3 Upgrading Oracle GoldenGate Microservices – GUI Based
Parent topic: Upgrading Oracle GoldenGate Microservices for Big Data
5.4 Upgrading Oracle GoldenGate Microservices Using REST APIs
After you have completed the upgrade tasks detailed in Upgrading Oracle GoldenGate Microservices – GUI Based, you are ready to update the Oracle GoldenGate MA home
(OGG_HOME
) for the Service Manager or deployments using REST
API.
curl -X PATCH \ https://<hostname>:<port>/services/v2/deployments/ServiceManager \ -H 'cache-control: no-cache' \ -d '{"oggHome":"/opt/oracle/product/21.1.0/oggcore_1", "status":"restart"}'
After the Service Manager or Deployment restarts, you are upgraded to the next version.
Parent topic: Upgrading Oracle GoldenGate Microservices for Big Data