When applying the latest patches to Oracle GoldenGate 23ai (OGG 23ai), we have confirmed that the notation in the GUI and logs is updated to “26ai.” In this article, we will explain the specific flow of applying patches to Oracle GoldenGate 23ai, the transition to the “26ai” notation, and the steps to perform a safe GoldenGate 26ai update, including actual system logs.
Conclusion: Version Notation Evolves to “23.26.x” via Patching
Applying patches (such as Release Updates) to Oracle GoldenGate 23ai raises the version to the 23.26.1.0.0 lineage. Consequently, the name “26ai” begins to appear in internal names and some documentation. This represents the continuous evolution of the product, and the procedure itself is completed using the standard method utilizing the conventional opatch utility.
Quick Procedure (Checklist)
- Stop Services: Stop the Service Manager using
systemctl stop. - Update OPatch: Apply the latest
p6880880toOGG_HOME. - Apply Patch: Introduce the fix using the
opatch applycommand. - Restart Services: Restore services with
systemctl startand verify the version.
Background and Basic Knowledge
Oracle GoldenGate currently centers around the Microservices Architecture. Patching is performed using the OPatch utility, similar to the Oracle Database (RDBMS) itself.
- RU (Release Update): Cumulative fix patches released periodically.
- Notation change from 23ai to 26ai: This is considered part of version management in anticipation of long-term support and feature integration heading toward 2026.
Quick Note for Beginners Since GoldenGate patching only involves “updating binaries,” your configurations (Deployments) and the data itself will not be deleted. However, a backup before the operation is mandatory.
Detailed Patching Procedures
The following implementation example assumes this environment:
- Target OS: Oracle Linux 8/9
- Product: Oracle GoldenGate 23ai (Microservices Architecture)
- Privileges:
root(for stopping/starting services) andoracle(for applying patches)
1. Verification of Status and Stopping Services
First, check the current status and stop the services completely.
# Check status (Verify version is 23.4.x)
[root@server ~]# systemctl status OracleGoldenGate
# Stop service
[root@server ~]# systemctl stop OracleGoldenGate
# Verify completion of stop
[root@server ~]# systemctl status OracleGoldenGate
[root@26ai-gg23ais ~]# systemctl status OracleGoldenGate
● OracleGoldenGate.service - Oracle GoldenGate Service Manager
Loaded: loaded (/etc/systemd/system/OracleGoldenGate.service; enabled; vendo>
Active: active (running) since Sun 2026-02-15 19:07:10 EST; 32min ago
Main PID: 874 (ServiceManager)
Tasks: 112 (limit: 22827)
Memory: 446.2M
CGroup: /system.slice/OracleGoldenGate.service
tq 874 /opt/oracle/goldengate/23ai/ogg_home/bin/ServiceManager --inv>
tq2320 /opt/oracle/goldengate/23ai/ogg_home/bin/recvsrvr --config /o>
tq2322 /opt/oracle/goldengate/23ai/ogg_home/bin/adminsrvr --config />
tq2324 /opt/oracle/goldengate/23ai/ogg_home/bin/distsrvr --config /o>
mq2326 /opt/oracle/goldengate/23ai/ogg_home/bin/pmsrvr --config /opt>
Feb 15 19:07:25 26ai-gg23ais adminsrvr[2322]: 2026-02-15T19:07:25.330-0500 INFO>
Feb 15 19:07:25 26ai-gg23ais OracleGoldenGate.sh[2322]: Oracle GoldenGate Admin>
Feb 15 19:07:25 26ai-gg23ais OracleGoldenGate.sh[2322]: Version 23.4.1.24.05 OG>
Feb 15 19:07:25 26ai-gg23ais OracleGoldenGate.sh[2322]: Copyright (C) 1995, 202>
Feb 15 19:07:25 26ai-gg23ais OracleGoldenGate.sh[2322]: Linux, x64, 64bit (opti>
Feb 15 19:07:25 26ai-gg23ais OracleGoldenGate.sh[2322]: Operating system charac>
Feb 15 19:07:26 26ai-gg23ais distsrvr[2324]: 2026-02-15T19:07:26.053-0500 INFO >
Feb 15 19:07:26 26ai-gg23ais OracleGoldenGate.sh[2326]: Process ID .......: 2326
Feb 15 19:07:26 26ai-gg23ais OracleGoldenGate.sh[2326]: HTTP Port ........: 9004
Feb 15 19:07:26 26ai-gg23ais OracleGoldenGate.sh[2326]: IPC Path .........: /op>
[root@26ai-gg23ais ~]# systemctl stop OracleGoldenGate
[root@26ai-gg23ais ~]# systemctl status OracleGoldenGate
● OracleGoldenGate.service - Oracle GoldenGate Service Manager
Loaded: loaded (/etc/systemd/system/OracleGoldenGate.service; enabled; vendo>
Active: inactive (dead) since Sun 2026-02-15 19:39:52 EST; 3s ago
Process: 874 ExecStart=/usr/bin/OracleGoldenGate.sh (code=exited, status=0/SU>
Main PID: 874 (code=exited, status=0/SUCCESS)
Tasks: 91 (limit: 22827)
Memory: 415.5M
CGroup: /system.slice/OracleGoldenGate.service
tq2320 /opt/oracle/goldengate/23ai/ogg_home/bin/recvsrvr --config /o>
tq2322 /opt/oracle/goldengate/23ai/ogg_home/bin/adminsrvr --config />
tq2324 /opt/oracle/goldengate/23ai/ogg_home/bin/distsrvr --config /o>
mq2326 /opt/oracle/goldengate/23ai/ogg_home/bin/pmsrvr --config /opt>
Feb 15 19:07:25 26ai-gg23ais OracleGoldenGate.sh[2322]: Linux, x64, 64bit (opti>
Feb 15 19:07:25 26ai-gg23ais OracleGoldenGate.sh[2322]: Operating system charac>
Feb 15 19:07:26 26ai-gg23ais distsrvr[2324]: 2026-02-15T19:07:26.053-0500 INFO >
Feb 15 19:07:26 26ai-gg23ais OracleGoldenGate.sh[2326]: Process ID .......: 2326
Feb 15 19:07:26 26ai-gg23ais OracleGoldenGate.sh[2326]: HTTP Port ........: 9004
Feb 15 19:07:26 26ai-gg23ais OracleGoldenGate.sh[2326]: IPC Path .........: /op>
Feb 15 19:39:49 26ai-gg23ais systemd[1]: Stopping Oracle GoldenGate Service Man>
Feb 15 19:39:52 26ai-gg23ais OracleGoldenGate.sh[874]: Stopping...STOPPED.
Feb 15 19:39:52 26ai-gg23ais systemd[1]: OracleGoldenGate.service: Succeeded.
Feb 15 19:39:52 26ai-gg23ais systemd[1]: Stopped Oracle GoldenGate Service Mana>
[root@26ai-gg23ais ~]#
2. Setting Environment Variables and Preparing Tools (oracle user)
The patching task is performed by the oracle user. Ensure ORACLE_HOME (OGG_HOME) is set correctly.
# Switch to oracle user
[root@server ~]# su - oracle
# Set environment variables (Modify paths according to your environment)
[oracle@server ~]$ export ORACLE_HOME=/opt/oracle/goldengate/23ai/ogg_home
[oracle@server ~]$ export PATH=$ORACLE_HOME/OPatch:$PATH
# Backup old OPatch and extract the latest version
[oracle@server ~]$ mv $ORACLE_HOME/OPatch/ $ORACLE_HOME/OPatch_bk/
[oracle@server ~]$ unzip -q p6880880_230000_Linux-x86-64.zip -d $ORACLE_HOME
[root@26ai-gg23ais ~]# su - oracle
[oracle@26ai-gg23ait ~]$ export ORACLE_HOME=/opt/oracle/goldengate/23ai/ogg_home
[oracle@26ai-gg23ait ~]$ export PATH=/opt/oracle/goldengate/23ai/ogg_home/OPatch:$PATH
[oracle@26ai-gg23ait ~]$ ls
p38850057_2326100OGGRU_Linux-x86-64.zip p6880880_230000_Linux-x86-64.zip
[oracle@26ai-gg23ait ~]$ mv /opt/oracle/goldengate/23ai/ogg_home/OPatch/ /opt/oracle/goldengate/23ai/ogg_home/OPatch_bk/
[oracle@26ai-gg23ait ~]$ unzip -q p6880880_230000_Linux-x86-64.zip -d /opt/oracle/goldengate/23ai/ogg_home
[oracle@26ai-gg23ait ~]$
3. Applying the Patch (opatch apply)
Extract the downloaded patch (e.g., 38850057) and execute the application.
# Extract the patch
[oracle@server ~]$ unzip -q p38850057_2326100OGGRU_Linux-x86-64.zip
[oracle@server ~]$ cd 38850057/
# Execute patch application
[oracle@server 38850057]$ opatch apply
Respond with y to “Do you want to proceed? [y|n]”. Respond with y to “Is the local system ready for patching? [y|n]”.
[oracle@26ai-gg23ait ~]$ unzip -q p38850057_2326100OGGRU_Linux-x86-64.zip
[oracle@26ai-gg23ait ~]$ rm -rf p6880880_230000_Linux-x86-64.zip
[oracle@26ai-gg23ait ~]$ rm -rf p38850057_2326100OGGRU_Linux-x86-64.zip
[oracle@26ai-gg23ait ~]$ ls
38850057 oracle-goldengate-release-notes-23.26.1.0.0.pdf
OGG-26ai-README.txt README_oracle.txt
[oracle@26ai-gg23ait ~]$ cd 38850057/
[oracle@26ai-gg23ait 38850057]$ opatch apply
Oracle Interim Patch Installer version 12.2.0.1.49
Copyright (c) 2026, Oracle Corporation. All rights reserved.
Oracle Home : /opt/oracle/goldengate/23ai/ogg_home
Central Inventory : /opt/oracle/oraInventory
from : /opt/oracle/goldengate/23ai/ogg_home/oraInst.loc
OPatch version : 12.2.0.1.49
OUI version : 12.2.0.9.0
Log file location : /opt/oracle/goldengate/23ai/ogg_home/cfgtoollogs/opatch/opatch2026-02-15_20-30-28PM_1.log
Verifying environment and performing prerequisite checks...
--------------------------------------------------------------------------------
Start OOP by Prereq process.
Launch OOP...
Oracle Interim Patch Installer version 12.2.0.1.49
Copyright (c) 2026, Oracle Corporation. All rights reserved.
Oracle Home : /opt/oracle/goldengate/23ai/ogg_home
Central Inventory : /opt/oracle/oraInventory
from : /opt/oracle/goldengate/23ai/ogg_home/oraInst.loc
OPatch version : 12.2.0.1.49
OUI version : 12.2.0.9.0
Log file location : /opt/oracle/goldengate/23ai/ogg_home/cfgtoollogs/opatch/opatch2026-02-15_20-30-42PM_1.log
Verifying environment and performing prerequisite checks...
OPatch continues with these patches: 38850057
Do you want to proceed? [y|n]
y
User Responded with: Y
All checks passed.
Please shutdown Oracle instances running out of this ORACLE_HOME on the local system.
(Oracle Home = '/opt/oracle/goldengate/23ai/ogg_home')
Is the local system ready for patching? [y|n]
y
User Responded with: Y
Backing up files...
Applying interim patch '38850057' to OH '/opt/oracle/goldengate/23ai/ogg_home'
Patching component oracle.oggcore.services.ora23ai, 23.4.0.0.0...
Patch 38850057 successfully applied.
Log file location: /opt/oracle/goldengate/23ai/ogg_home/cfgtoollogs/opatch/opatch2026-02-15_20-30-42PM_1.log
OPatch succeeded.
[oracle@26ai-gg23ait 38850057]$
Execution Example: Version Verification (Appearance of 26ai Notation)
After applying the patch, starting the service and checking the logs reveals that the version notation has been updated.
# Start service as root user
[root@server ~]# systemctl start OracleGoldenGate
# Verify startup logs
[root@server ~]# systemctl status OracleGoldenGate
[oracle@26ai-gg23ait 38850057]$ su -
Password:
[root@26ai-gg23ait ~]# systemctl start OracleGoldenGate
[root@26ai-gg23ait ~]# systemctl status OracleGoldenGate
● OracleGoldenGate.service - Oracle GoldenGate Service Manager
Loaded: loaded (/etc/systemd/system/OracleGoldenGate.service; enabled; vendo>
Active: active (running) since Sun 2026-02-15 20:34:13 EST; 54s ago
Main PID: 5556 (ServiceManager)
Tasks: 127 (limit: 22827)
Memory: 281.6M
CGroup: /system.slice/OracleGoldenGate.service
tq5556 /opt/oracle/goldengate/23ai/ogg_home/bin/ServiceManager --inv>
tq5872 /opt/oracle/goldengate/23ai/ogg_home/bin/recvsrvr --config /o>
tq5874 /opt/oracle/goldengate/23ai/ogg_home/bin/adminsrvr --config />
tq5876 /opt/oracle/goldengate/23ai/ogg_home/bin/distsrvr --config /o>
tq5878 /opt/oracle/goldengate/23ai/ogg_home/bin/pmsrvr --config /opt>
mq5976 /opt/oracle/goldengate/23ai/ogg_home/bin/AIService
Feb 15 20:34:21 26ai-gg23ait adminsrvr[5874]: 2026-02-15T20:34:21.871-0500 INFO>
Feb 15 20:34:21 26ai-gg23ait OracleGoldenGate.sh[5874]: Oracle GoldenGate Admin>
Feb 15 20:34:21 26ai-gg23ait OracleGoldenGate.sh[5874]: Version 23.26.1.0.0 OGG>
Feb 15 20:34:21 26ai-gg23ait OracleGoldenGate.sh[5874]: Copyright (C) 1995, 202>
Feb 15 20:34:21 26ai-gg23ait OracleGoldenGate.sh[5874]: Linux, x64, 64bit (opti>
Feb 15 20:34:21 26ai-gg23ait OracleGoldenGate.sh[5874]: Operating system charac>
Feb 15 20:34:22 26ai-gg23ait OracleGoldenGate.sh[5878]: Process ID .......: 5878
Feb 15 20:34:22 26ai-gg23ait OracleGoldenGate.sh[5878]: HTTP Port ........: 9004
Feb 15 20:34:22 26ai-gg23ait OracleGoldenGate.sh[5878]: IPC Path .........: /op>
Feb 15 20:34:32 26ai-gg23ait OracleGoldenGate.sh[5976]: Listening on '/opt/orac>
[root@26ai-gg23ait ~]#
Supplementary Execution Results (Log Excerpt): Feb 15 20:34:21 server OracleGoldenGate.sh[5874]: Version 23.26.1.0.0 OGGCORE_23.26.1.0.0_PLATFORMS_260124.1130
As shown, the version becomes 23.26.x, and files such as OGG-26ai-README.txt are generated within the directory, indicating that the update to the GoldenGate 26ai generation is effectively complete.

Troubleshooting: Common Errors
| Error Phenomenon | Cause | Countermeasure |
|---|---|---|
| OPatch failed with error code 73 | Services are still running | Identify and stop processes using $ORACLE_HOME with the fuser command, etc. |
| Prerequisite check “CheckActiveFiles” failed | Files are locked | Check if Admin Server (adminsrvr), etc., are still active. |
| NApply could not delete… | Insufficient privileges | Verify that the file owner within ORACLE_HOME is oracle. |
Operational and Security Considerations
- Advantages: Latest vulnerability fixes (CVE compliance) and improved affinity with Oracle Database 23ai.
- Risks: Replication stops during patch application. Perform this during a timeframe where lag (latency) is within acceptable limits.
- Rollback: In the unlikely event of a malfunction, you can revert using
opatch rollback -id 38850057, but it is safest to back up the entire$ORACLE_HOME(usingtar, etc.) beforehand.
FAQ
Q: Will changing from 23ai to 26ai incur additional licenses or costs? A: Basically, as long as it is within the scope of a patch application (RU), it is available within the existing 23ai license and support contract.
Q: Is it necessary to reconfigure Extract or Replicat after patching? A: No. After the binary update, starting the service will resume processes with the existing configurations.
Q: Can I still use existing 23ai documentation and configuration guides even if the version notation becomes 26ai? A: Yes, they remain usable. 26ai (23.26.x) is based on the latest release of the 23ai development line, and compatibility for architecture and configuration parameters is maintained.
Summary
- By applying the latest patch to Oracle GoldenGate 23ai, the version is updated to 23.26.x (commonly known as 26ai).
- The latest OPatch utility is required for the task.
- Ensure services are stopped via
systemctl, etc., before executingopatch apply. - After application, verify the “Version 23.26.1.0.0” notation in logs or the GUI.
[reference]
Patching Using OPatch
This article explains targeting Oracle GoldenGate 23ai / 26ai (screens and default values may differ for other versions).


コメント