Upgrade Oracle GoldenGate Maximum Availability Hub Stack

Learn to upgrade an existing Oracle GoldenGate Marketplace stack using OCI Stacks.

Before you upgrade, ensure that you:

Shut down all Oracle GoldenGate processes in the VM instance.
Back up all block storage, in case you need to revert back in the future because of a failed upgrade or update.
Take note of or backup any files and configuration settings saved on the VMs that are located outside of the GoldenGate block volume so you can reapply them after the stack upgrade.

About Stacks

Stacks are zip files that contain the latest Terraform code base. 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.

Download the latest stack

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

Log in to Oracle Cloud Infrastructure.
In the Oracle Cloud navigation menu, select Marketplace, and then All applications.
Enter Oracle GoldenGate Maximum Availability Hub into the Marketplace search bar.
On the Oracle GoldenGate Maximum Availability Hub page, click the Download link located beneath the Launch Stack button.

Identify the stack's Terraform version

Before you upgrade the stack, identify the Terraform version of the stack to upgrade.

To identify the stack's Terraform version:

Log in to Oracle Cloud Infrastructure.
In the Oracle Cloud navigation menu, select Developer Services, and then under Resource Manager, click Stacks.
On the Stacks page, select the stack that you want to upgrade.
On the Stack details page, under Stack Information, locate the Terraform version field and take note of its value.

Upgrade an Oracle Oracle GoldenGate Maximum Availability Hub image

Before you upgrade the stack, verify that /mnt/acfs_gg/deployments/ogg-credentials.json on primary cluster node-1 has the latest oggadmin password saved.

To upgrade an existing Oracle GoldenGate Maximum Availability Hub image:

Download the latest stack.
In the Oracle Cloud navigation menu, select Developer Services, and then under Resource Manager, click Stacks.
On the Stacks page, select the stack to upgrade.
On the Stack's details page, click Edit, then select Edit stack.
On the Edit stack page, for Terraform configuration source, click Browse, and upload the latest stack zip file.
Verify the autofilled fields are correct on each page of the Edit stack form, and then click Save changes.

WARNING:
Don't modify any autofilled fields in the update stack workflow.
Log in to your Oracle GoldenGate instance and stop all running processes. Ensure that you stop all Microservices (Administration, Distribution, Receiver, and Performance Metrics), including Service Manager.
Back in Oracle Cloud, from the navigation menu, select Compute, and then click Instances.
On the Instances page, select the instance to upgrade, and then click Terminate.
Note:
You can:
- Click the instance and then click Terminate on the Instance details page
- Check the box next to the instance in the list, and then select Terminate from the Actions menu
- Open the instance's Actions (three dots) menu and then select Terminate.
In the Terminate instance dialog, select Permanently delete attached boot volume, and then click Terminate instance.
After the instance is terminated, use the Oracle Cloud navigation menu to return to the Stacks page.
On the Stacks page, select the stack to upgrade. It must be the same one you edited earlier.
On the Stack's details page, click Apply.

After the job completes, verify that the compute node is running. Monitor the /tmp/startupScript.log on the primary cluster's node-1 to check if the deployment startup succeeded. You can then access the deployment.