Update the OpenEdge Adapter for Sonic ESB
- Last Updated: July 7, 2026
- 2 minute read
- OpenEdge
- Version 12.2
- Documentation
You can update OpenEdge ESB Adapter in one of the following ways, depending on your
installation type:
- Standalone installation—Update manually using the Incremental Update.
- Added as a product to OpenEdge—Update OpenEdge to update the ESB Adapter automatically. For information on updating OpenEdge, see Update OpenEdge.
This topic explains how to update the OpenEdge ESB Adapter when it is installed using the standalone installer.
Update an existing OpenEdge ESB Adapter installation from a Long-Term Support (LTS) release, an Innovation release, or a prior Incremental Update to a newer Incremental Update within the same LTS or Innovation release stream. For example, if you have installed the 12.2.18 version of the OpenEdge ESB Adapter on your system, you can update it to the 12.2.19 or later Incremental Update within the 12.2 LTS.
Each new Incremental Update includes only cumulative changes, that is, changes introduced in
the earlier Incremental Updates are included in the current Incremental Update. These
changes may include bug fixes and security patches.
Note: Starting
with OpenEdge 12.2.20, Sonic ESB 2025 (ESB 14.0) and Java 11 are supported. As part
of adopting Sonic ESB 2025, Progress Software recommends migrating ESB services
deployed on Sonic ESB 2018 to Sonic ESB 2025 Messenger for improved support and
compatibility. For detailed compatibility and platform support
information, see OpenEdge 12 Platform Compatibility Guide.
Prerequisites
- Download the required OpenEdge ESB Adapter software image from the Progress Download Center, also known as Electronic Software Distribution (ESD).
- Close all the OpenEdge applications or the processes because they can interfere with the installation or use files that the installer needs to complete the update.
- Verify that the Sonic ESB installation path and connection properties
reference Sonic ESB 2025 (ESB 14.0). If all required properties already
point to Sonic ESB 2025 (ESB 14.0), no changes are required. To verify and
update Sonic ESB properties, complete these steps:
- Navigate to the Sonic ESB configuration directory under $DLC and locate the installtlr.properties file. For example: $DLC/sonic/ESB<version>/config/installtlr.properties
- Open the file in a text editor.
- Verify that the following properties reference Sonic ESB 2025 (ESB
14.0):
Property name Description szPathToSonicPath to the Sonic ESB installation directory. For example, C:\Sonic2025\ESB14.0
szSonicUsernameSonic ESB username configured for the Sonic ESB 2025 environment. szSonicPasswordPassword associated with the Sonic ESB 2025 user. szSonicUrlTCP URL that connects to the Sonic ESB 2025 instance. - If any of these properties reference the Sonic ESB 2018 (ESB 10.0) environment, update them to the corresponding Sonic ESB 2025 (ESB 14.0) values.
- If all properties already reference Sonic ESB 2025, no changes are required.
- Save and close the file.