Introduction
Oracle GoldenGate Release Updates include important bug fixes and stability improvements for GoldenGate components. In this example, Oracle GoldenGate 26ai Microservices Architecture was patched to version 23.26.3.0.0 using Patch 39740103.
The patch was applied to the existing GoldenGate home using OPatch. The activity included updating OPatch, stopping Extract and Replicat, shutting down GoldenGate services, applying the patch, resolving a file-in-use issue, verifying the installed patch, and restarting the GoldenGate processes.
1. Check the Existing OPatch Version
Before applying the GoldenGate patch, check the existing OPatch version and patch inventory.
[oracle@host1 ContentsXML]$ cd /data/app/oracle/product/ogg26ai
[oracle@host1 ogg26ai]$
[oracle@host1 ogg26ai]$ cd OPatch/
[oracle@host1 OPatch]$ ./opatch version
OPatch Version: 12.2.0.1.48
OPatch succeeded.
[oracle@host1 OPatch]$ ./opatch lspatches
29585399;OCW RELEASE UPDATE 19.3.0.0.0 (29585399)
29517242;Database Release Update : 19.3.0.0.190416 (29517242)
OPatch succeeded.
[oracle@host1 OPatch]$2. Update OPatch
Upload the required OPatch version to the GoldenGate home and verify it.
[oracle@host1 OPatch]$ ./opatch version
OPatch Version: 12.2.0.1.52
OPatch succeeded.
[oracle@host1 OPatch]$3. Stop Extract and Replicat
Stop the GoldenGate processes before patching.
OGG (...) 41> stop extai
2026-08-21T19:39:58Z INFO OGG-08100 Extract group EXTAI is already stopped.
OGG (...) 42> stop repai
2026-08-21T19:40:10Z INFO OGG-08100 Sending STOP request to Replicat group REPAI.
2026-08-21T19:40:10Z INFO OGG-02965 Replicat group REPAI is down (gracefully).
OGG (...) 43>4. Check the GoldenGate Service Manager
Check whether Service Manager is still running.
# systemctl status OracleGoldenGate
[oracle@host1 OPatch]$ ps -ef | grep -i servicemanager | grep -v grep
oracle 809 1 7 Aug19 ? 03:57:49 /data/app/oracle/product/ogg26ai/bin/ServiceManager --inventory '/ogg/ggma26/deployment/etc/conf'
[oracle@host1 OPatch]$
5. Prepare the GoldenGate Patch
The downloaded GoldenGate Release Update was Patch 39740103.
[oracle@host1 ~]$ ls -ltr *397*
-rw-r--r--. 1 oracle oinstall 466495691 Aug 22 01:29 p39740103_2326300OGGRU_Linux-x86-64.zip
39740103:
total 0
drwxr-x---. 9 oracle oinstall 94 Jul 20 12:43 files
drwxr-x---. 3 oracle oinstall 20 Jul 20 12:43 etc
[oracle@host1 ~]$
[oracle@host1 39740103]$ export OGG_HOME=/data/app/oracle/product/ogg26ai
[oracle@host1 39740103]$ export PATH=$OGG_HOME/bin:$PATH
[oracle@host1 39740103]$ export PATH=$OGG_HOME/OPatch:$PATH
[oracle@host1 39740103]$ which opatch
/data/app/oracle/product/ogg26ai/OPatch/opatch
[oracle@host1 39740103]$ opatch version
OPatch Version: 12.2.0.1.52
OPatch succeeded.
[oracle@host1 39740103]$6. Run the OPatch Prerequisite Check
Run the conflict check before applying the patch.
[oracle@host1 39740103]$ opatch prereq CheckConflictAgainstOHWithDetail -ph ./
Oracle Interim Patch Installer version 12.2.0.1.52
Copyright (c) 2026, Oracle Corporation. All rights reserved.
PREREQ session
Oracle Home : /data/app/oracle/product/19C/dbhome_3
Central Inventory : /data/app/oraInventory
from : /data/app/oracle/product/19C/dbhome_3/oraInst.loc
OPatch version : 12.2.0.1.52
OUI version : 12.2.0.7.0
Log file location : /data/app/oracle/product/19C/dbhome_3/cfgtoollogs/opatch/opatch2026-08-22_01-32-08AM_1.log
Invoking prereq "checkconflictagainstohwithdetail"
Prereq "checkConflictAgainstOHWithDetail" passed.
OPatch succeeded.
[oracle@host1 39740103]$The output showed an important issue. OPatch was using the database Oracle Home instead of the GoldenGate home because the existing ORACLE_HOME environment variable was still set.
7. First Patch Attempt Using the Wrong Oracle Home
The first patch attempt therefore targeted the database Oracle Home.
[oracle@host1 39740103]$ opatch apply
Oracle Interim Patch Installer version 12.2.0.1.52
Copyright (c) 2026, Oracle Corporation. All rights reserved.
Oracle Home : /data/app/oracle/product/19C/dbhome_3
Central Inventory : /data/app/oraInventory
from : /data/app/oracle/product/19C/dbhome_3/oraInst.loc
OPatch version : 12.2.0.1.52
OUI version : 12.2.0.7.0
Log file location : /data/app/oracle/product/19C/dbhome_3/cfgtoollogs/opatch/opatch2026-08-22_01-32-35AM_1.log
Verifying environment and performing prerequisite checks...
Skip patch 39740103 from list of patches to apply: This patch is skipped because none of the components from patch are present in ORACLE_HOME.
Please ensure that atleast one of the component from patch is present in ORACLE_HOME.
After skipping patches with missing components, there are no patches to apply.
OPatch Session completed with warnings.
Log file location: /data/app/oracle/product/19C/dbhome_3/cfgtoollogs/opatch/opatch2026-08-22_01-32-35AM_1.log
OPatch completed with warnings.
[oracle@host1 39740103]$The existing ORACLE_HOME was therefore cleared before retrying.
[oracle@host1 39740103]$ export ORACLE_HOME=
[oracle@host1 39740103]$ echo $ORACLE_HOME
[oracle@host1 39740103]$8. Apply the Patch to the GoldenGate Home
Run OPatch again. This time the correct GoldenGate home was identified.
[oracle@host1 39740103]$ opatch apply
Oracle Interim Patch Installer version 12.2.0.1.52
Copyright (c) 2026, Oracle Corporation. All rights reserved.
Oracle Home : /data/app/oracle/product/ogg26ai
Central Inventory : /data/app/oraInventory
from : /data/app/oracle/product/ogg26ai/oraInst.loc
OPatch version : 12.2.0.1.52
OUI version : 12.2.0.9.0
Log file location : /data/app/oracle/product/ogg26ai/cfgtoollogs/opatch/opatch2026-08-22_01-42-30AM_1.log
Verifying environment and performing prerequisite checks...
--------------------------------------------------------------------------------
Start OOP by Prereq process.
Launch OOP...
Oracle Interim Patch Installer version 12.2.0.1.52
Copyright (c) 2026, Oracle Corporation. All rights reserved.
Oracle Home : /data/app/oracle/product/ogg26ai
Central Inventory : /data/app/oraInventory
from : /data/app/oracle/product/ogg26ai/oraInst.loc
OPatch version : 12.2.0.1.52
OUI version : 12.2.0.9.0
Log file location : /data/app/oracle/product/ogg26ai/cfgtoollogs/opatch/opatch2026-08-22_01-42-41AM_1.log
Verifying environment and performing prerequisite checks...
OPatch continues with these patches: 39740103
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 = '/data/app/oracle/product/ogg26ai')
Is the local system ready for patching? [y|n]
y
User Responded with: Y
Backing up files...
Applying interim patch '39740103' to OH '/data/app/oracle/product/ogg26ai'
Patching component oracle.oggcore.services.ora23ai, 23.4.0.0.0...
Copy failed from '/home/oracle/39740103/files/bin/AIService' to '/data/app/oracle/product/ogg26ai/bin/AIService'...
Please verify all applications associated with the Oracle Home '/data/app/oracle/product/ogg26ai' are shut down. If this is AIX, please perform solution documented in Note 739963.1 on https://myoraclesupport.oracle.com.
Do you want to retry copying the file? [y|n]The patch could not replace AIService because GoldenGate processes were still using binaries from the GoldenGate home.
9. Identify the Processes Holding GoldenGate Binaries
Check AIService and pluginsrvr.
[oracle@host1 ~]$ fuser -v /data/app/oracle/product/ogg26ai/bin/AIService
fuser -v /data/app/oracle/product/ogg26ai/bin/pluginsrvr
USER PID ACCESS COMMAND
/data/app/oracle/product/ogg26ai/bin/AIService:
oracle 2196 ...e. AIService
USER PID ACCESS COMMAND
/data/app/oracle/product/ogg26ai/bin/pluginsrvr:
oracle 2198 ...e. pluginsrvr
[oracle@host1 ~]$
[oracle@host1 ~]$ ps -o pid,ppid,user,cmd -p 2196,2198
PID PPID USER CMD
2196 808 oracle /data/app/oracle/product/ogg26ai/bin/AIService
2198 808 oracle /data/app/oracle/product/ogg26ai/bin/pluginsrvr
[oracle@host1 ~]$ pstree -aps 2196
systemd,1 --switched-root --system --deserialize 31 rhgb
└─ServiceManager,808 --inventory '/ogg/ggma26/deployment/etc/conf'
└─AIService,2196
├─{AIService},2244
├─{AIService},2255
├─{AIService},2258
├─{AIService},2259
├─{AIService},2260
├─{AIService},2261
├─{AIService},2262
├─{AIService},2263
└─{AIService},2265
[oracle@host1 ~]$Service Manager was the parent process responsible for starting these services.
10. Stop the Remaining GoldenGate Processes
Check all the related processes, stop Service Manager, and then terminate the remaining AIService and pluginsrvr processes.
[oracle@host1 ~]$ ps -ef | grep -E 'ServiceManager|adminsrvr|pmsrvr|AIService|pluginsrvr' | grep -v grep
oracle 808 1 0 01:41 ? 00:00:01 /data/app/oracle/product/ogg26ai/bin/ServiceManager --inventory '/ogg/ggma26/deployment/etc/conf'
oracle 2196 808 0 01:41 ? 00:00:00 /data/app/oracle/product/ogg26ai/bin/AIService
oracle 2198 808 0 01:41 ? 00:00:00 /data/app/oracle/product/ogg26ai/bin/pluginsrvr
[oracle@host1 ~]$ pgrep -af ServiceManager
808 /data/app/oracle/product/ogg26ai/bin/ServiceManager --inventory '/ogg/ggma26/deployment/etc/conf'
[oracle@host1 ~]$ kill 808
[oracle@host1 ~]$ ps -ef | grep -E 'ServiceManager|AIService|pluginsrvr' | grep -v grep
oracle 2196 1 0 01:41 ? 00:00:00 /data/app/oracle/product/ogg26ai/bin/AIService
oracle 2198 1 0 01:41 ? 00:00:00 /data/app/oracle/product/ogg26ai/bin/pluginsrvr
[oracle@host1 ~]$ ps -ef | grep -E 'ServiceManager|AIService|pluginsrvr' | grep -v grep
oracle 2196 1 0 01:41 ? 00:00:00 /data/app/oracle/product/ogg26ai/bin/AIService
oracle 2198 1 0 01:41 ? 00:00:00 /data/app/oracle/product/ogg26ai/bin/pluginsrvr
[oracle@host1 ~]$ kill -9 21962196
-bash: kill: (21962196) - No such process
[oracle@host1 ~]$ kill -9 2196
[oracle@host1 ~]$ ps -ef | grep -E 'ServiceManager|AIService|pluginsrvr' | grep -v grep
oracle 2198 1 0 01:41 ? 00:00:00 /data/app/oracle/product/ogg26ai/bin/pluginsrvr
[oracle@host1 ~]$ kill -9 2198
[oracle@host1 ~]$ ps -ef | grep -E 'ServiceManager|AIService|pluginsrvr' | grep -v grep
[oracle@host1 ~]$All processes using the GoldenGate home were now stopped.
11. Retry and Complete the Patch
The patch operation was retried after stopping the remaining processes.
[oracle@host1 39740103]$ opatch apply
Oracle Interim Patch Installer version 12.2.0.1.52
Copyright (c) 2026, Oracle Corporation. All rights reserved.
Oracle Home : /data/app/oracle/product/ogg26ai
Central Inventory : /data/app/oraInventory
from : /data/app/oracle/product/ogg26ai/oraInst.loc
OPatch version : 12.2.0.1.52
OUI version : 12.2.0.9.0
Log file location : /data/app/oracle/product/ogg26ai/cfgtoollogs/opatch/opatch2026-08-22_01-42-30AM_1.log
Verifying environment and performing prerequisite checks...
--------------------------------------------------------------------------------
Start OOP by Prereq process.
Launch OOP...
Oracle Interim Patch Installer version 12.2.0.1.52
Copyright (c) 2026, Oracle Corporation. All rights reserved.
Oracle Home : /data/app/oracle/product/ogg26ai
Central Inventory : /data/app/oraInventory
from : /data/app/oracle/product/ogg26ai/oraInst.loc
OPatch version : 12.2.0.1.52
OUI version : 12.2.0.9.0
Log file location : /data/app/oracle/product/ogg26ai/cfgtoollogs/opatch/opatch2026-08-22_01-42-41AM_1.log
Verifying environment and performing prerequisite checks...
OPatch continues with these patches: 39740103
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 = '/data/app/oracle/product/ogg26ai')
Is the local system ready for patching? [y|n]
y
User Responded with: Y
Backing up files...
Applying interim patch '39740103' to OH '/data/app/oracle/product/ogg26ai'
Patching component oracle.oggcore.services.ora23ai, 23.4.0.0.0...
Copy failed from '/home/oracle/39740103/files/bin/AIService' to '/data/app/oracle/product/ogg26ai/bin/AIService'...
Please verify all applications associated with the Oracle Home '/data/app/oracle/product/ogg26ai' are shut down. If this is AIX, please perform solution documented in Note 739963.1 on https://myoraclesupport.oracle.com.
Do you want to retry copying the file? [y|n]
y
User Responded with: Y
Retry copying the file to '/data/app/oracle/product/ogg26ai/bin/AIService'.
Patch 39740103 successfully applied.
Log file location: /data/app/oracle/product/ogg26ai/cfgtoollogs/opatch/opatch2026-08-22_01-42-41AM_1.log
OPatch succeeded.
[oracle@host1 39740103]$The GoldenGate Release Update was successfully applied.
12. Verify the Installed Patch
Check the GoldenGate patch inventory.
[oracle@host1 39740103]$ opatch lspatches
39740103;Oracle GoldenGate 23.26.3.0.0 for Oracle
OPatch succeeded.
[oracle@host1 39740103]$This confirms that the GoldenGate home is now running Patch 39740103, Oracle GoldenGate 23.26.3.0.0.
13. Start Service Manager
Start GoldenGate Service Manager after completing the patch.
[root@host1 ~]# cd /data/app/oracle/product/ogg26ai/
[root@host1 ogg26ai]# cd bin
[root@host1 bin]# nohup ./ServiceManager &
[1] 4032
[root@host1 bin]# nohup: ignoring input and appending output to 'nohup.out'
[root@host1 bin]#
[root@host1 bin]# ps -ef | grep -E 'ServiceManager|adminsrvr|pmsrvr|AIService|pluginsrvr' | grep -v grep
root 4035 1 3 01:53 ? 00:00:00 /data/app/oracle/product/ogg26ai/bin/ServiceManager
root 4055 4035 2 01:53 ? 00:00:00 /data/app/oracle/product/ogg26ai/bin/AIService
root 4057 4035 0 01:53 ? 00:00:00 /data/app/oracle/product/ogg26ai/bin/pluginsrvr
[1]+ Done nohup ./ServiceManager
[root@host1 bin]#
[root@host1 bin]#14. Verify the New GoldenGate Version
Start Admin Client and verify the version.
[oracle@host1 bin]$ ./adminclient
Oracle GoldenGate Administration Client for Oracle
Version 23.26.3.0.0 OGGCORE_23.26.3.0.0OGGRU_LINUX.X64_260715.0927_FBO
Copyright (C) 1995, 2026, Oracle and/or its affiliates. All rights reserved.
Linux, x64, 64bit (optimized) on Jul 15 2026 23:44:48
Operating system character set identified as UTF-8.
OGG (not connected) 1>
The version confirms that the GoldenGate home was successfully upgraded to 23.26.3.0.0.
15. Start Extract and Replicat
Connect to the GoldenGate deployment and start the processes.
OGG (not connected) 2> connect http://<host>:8001/ deployment GGHUBDEPLOY as oggadmin password ********
OGG (...) 3> start extai
2026-08-21T20:26:50Z INFO OGG-00975 Extract group EXTAI starting.
2026-08-21T20:26:50Z INFO OGG-15426 Extract group EXTAI started.
OGG (...) 4> start repai
2026-08-21T20:26:52Z INFO OGG-00975 Replicat group REPAI starting.
2026-08-21T20:26:52Z INFO OGG-15445 Replicat group REPAI started.
OGG (...) 5>Conclusion
Oracle GoldenGate 26ai was successfully patched to version 23.26.3.0.0 using Patch 39740103. During the patching, OPatch initially selected the database Oracle Home because of the existing ORACLE_HOME setting, and later the patch encountered a file-copy failure because AIService and pluginsrvr were still running. After correcting the environment and stopping all GoldenGate processes, the patch completed successfully. Post-patching verification confirmed the new GoldenGate version, and the existing Integrated Extract and Replicat were started successfully.
