Update the OpenEdge Adapter for Sonic ESB
- Last Updated: July 7, 2026
- 2 minute read
- OpenEdge
- Version 12.8
- 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.
Each new Incremental Update includes cumulative changes, that is, changes introduced in the
earlier ones are included in the latest Incremental Update. These changes may include
bug fixes and security patches.
Note: Starting with OpenEdge
12.8.12, Sonic ESB 2025 (ESB 14.0) and Java 17 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.