11 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 stack to 21c release is not permitted.- Shut down all the Oracle GoldenGate processes in the VM instance.
- Backup all the block storage just in case you need revert it back in the future for a failed upgrade/update.
Topics:
- Stacks
- Retrieving a Stack
Before you upgrade Oracle GoldenGate Marketplace, you have to retrieve the latest stack. - Identifying the Terraform Version for the Stack to be Upgraded
- Upgrading an Oracle Cloud Marketplace Image (Terraform Version is Same)
The upgrade process is only valid for the uprade/patching within the same major version, for example, from V19 - > V19 or V21 -> V21. Current Marketplace doesn't support major version upgrade through Image update. - Upgrading an Oracle Cloud Marketplace Image (To Different Versions of Terraform)
Parent topic: Additional Topics
11.1 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.
When Stacks are available, you can access them through the Oracle Object Store.
Parent topic: Upgrading Oracle GoldenGate Marketplace Image
11.2 Retrieving a Stack
Before you upgrade Oracle GoldenGate Marketplace, you have to retrieve the latest stack.
- Go to the Market Place List.
- Select a version from the Version drop-down list. This is the Market Place image you will use to upgrade.
- Select the I have reviewed and accepted the Oracle Program Limited Use Promotional Terms check box.
- Click Download to download the stack zip file and save it on your local
drive in the following directory:
BundlePatch19c
.
Parent topic: Upgrading Oracle GoldenGate Marketplace Image
11.3 Identifying the Terraform Version for the Stack to be Upgraded
- Log in to the Oracle Cloud Interface (OCI) Console.
- On the Home page, under Developer Services, click Resource Manager, and then click Stacks.
- Select an existing stack for which, you want to
identify the Terraform version.
Note that under Stack Information, the Terrafom version field lists the Terraform version used by the stack.
Note:
If Terraform version of stack to be upgraded and the new stack version are same, then follow the steps in Upgrading an Oracle Cloud Marketplace Image (Terraform Version is Same). If the versions are different, follow the steps in Upgrading an Oracle Cloud Marketplace Image (To Different Versions of Terraform).
Parent topic: Upgrading Oracle GoldenGate Marketplace Image
11.4 Upgrading an Oracle Cloud Marketplace Image (Terraform Version is Same)
The upgrade process is only valid for the uprade/patching within the same major version, for example, from V19 - > V19 or V21 -> V21. Current Marketplace doesn't support major version upgrade through Image update.
Parent topic: Upgrading Oracle GoldenGate Marketplace Image
11.5 Upgrading an Oracle Cloud Marketplace Image (To Different Versions of Terraform)
- Verify that the Stack you want to Upgrade is up to Date
- Download the Terraform State File from your old version Stack
- Create a New Stack
- Import the old Stack State to the new Stack
Parent topic: Upgrading Oracle GoldenGate Marketplace Image
11.5.2 Download the Terraform State File from your old version Stack
- Download the Terraform state file from your old version stack.
- In the left panel, select the compartment containing the stack you need to upgrade.
- In the right panel, click the stack you need to upgrade.
- Click Apply job from the Jobs list to navigate to Job Details page.
- Click Download Terraform State and save the file to
BundlePatch19c
directory.
11.5.3 Create a New Stack
- Open the navigation menu. Under Developer Services, click Resource Manager and then Stacks.
- In the left panel, select the compartment where you want to create the new stack (should be same as the compartment of the stack you want to upgrade).
- Click Create Stack.
- In Stack Configuration, click the Zip file and select
the zip file you downloaded to
BundlePatch19c
directory. - Give your stack a name, for example,
<OriginalStackName> + " 19cBP".
- Click Next.
- In the Configure Variables step ensure the variables are set exactly the same as the old stack.
- Click Next and Create. Do not click Apply yet.