1. Using Oracle GoldenGate on Oracle Cloud Marketplace
  2. Additional Configurations
  3. Upgrading Oracle GoldenGate Marketplace Image

7 Upgrading Oracle GoldenGate Marketplace Image

This chapter helps you to upgrade an existing (or older version of) Oracle GoldenGate Marketplace stack to the latest release, using the OCI Stacks approach.

Note:

Upgrade from a 19c or 21c stack to the 23ai release is not permitted.

Note:

OCI GoldenGate Marketplace will only keep the latest five patch versions of the GoldenGate image for each release baseline. We recommend that users update to the latest OCI GoldenGate Marketplace patch version whenever possible. OCI GoldenGate Marketplace typically implements quarterly patches/updates for the image, however there may be additional interim patch version releases for urgent updates. Overall, availability of patch versions of an image older than latest 5 releases is not guaranteed.

Before any upgrade, ensure to do the following:

  1. Shut down all the Oracle GoldenGate processes in the VM instance.

  2. Backup all the block storage just in case you need revert it back in the future for a failed upgrade/update.

Stacks

Stacks are zip files that contain the latest Terraform code base. These stacks enable you to provision a new compute node and attach your existing block storage. This approach ensures that Oracle GoldenGate does not lose any associated data present in the environment.

Retrieving a Stack

Before you upgrade Oracle GoldenGate Marketplace, you have to retrieve the latest stack. To retrieve a stack:

  1. Log in to the Oracle Cloud Interface (OCI).
  2. In the home page, navigate to the top left corner to select the Context menu.
  3. Select Marketplace -> All Applications.
  4. Search for Oracle GoldenGate for Oracle.
  5. Downloaded zip file to perform the upgrade.

Identifying the Terraform Version for the Stack to be Upgraded

To identify the Terraform version for the stack to be upgraded:
  1. Log in to the Oracle Cloud Interface (OCI) Console.
  2. On the Home page, under Developer Services, click Resource Manager, and then click Stacks.
  3. Select an existing stack for which, you want to identify the Terraform version.

    Under Stack Information, the Terrafom version field lists the Terraform version used by the stack.

Upgrading an Oracle Cloud Marketplace Image

The upgrade process is only valid for the upgrade or patching within the same major version, for example, from v21c to v21c or 23ai to V23ai. Current Marketplace doesn't support major version upgrade through image update.

To upgrade an existing Oracle GoldenGate Marketplace image, perform the following tasks:

Note:

These steps are applicable in Oracle GoldenGate Marketplace that are updated from Terraform v .14 to 1.0.x only.
  1. Download the correct version of the Stack.
  2. Log in to the Oracle Cloud Interface (OCI) Console.
  3. On the Home page, click the navigation menu in the top left corner and under Developer Services, click Resource Manager, and then click Stacks.
  4. Select an existing stack that you want to upgrade.
  5. Click Edit from the top menu.
  6. Click Browse to select the downloaded stack.
  7. Upload the new .zip file.
  8. Update the terraform version in the stack to 1.0.x and click Next.
  9. Verify that the pre-filled details are accurate and click Save Changes.
  10. Login to your Oracle GoldenGate Instance and stop all the running Oracle GoldenGate processes. Ensure that you stop all the Microservices (Administration Service, Distribution Service, Receiver Service and Performance Metrics Service) including Service Manager.
  11. Go to Compute and select Instances.
  12. Terminate the existing compute instance that needs to be upgraded.
  13. Ensure that the Permanently delete the attached boot volume option is selected.
  14. After the instance is terminated, from the left navigation pane, select Developer Services and click Resource Manager and then click Stacks.
  15. Select the Stack that you edited in step 6, for upgrade.
  16. Click Apply Job.

    Wait until the job completes and verify whether the compute node is up and running.

  17. After upgrade, remove the compute instance's IP address from the ~/.ssh/known_hosts file, so that you can log in to the compute node to start all the Oracle GoldenGate processes.