Contents

Introduction

Design

Impact of Java JRE Changes in 2025.07 and Later

Upgrading an ADP from Release 24.0 with Mixed Applications

Upgrading an ADP from Release 25.0 with Mixed Applications

Upgrading an ADP from Release 26.0 with Mixed Applications

Introduction

This document describes how Java JRE Changes in 2025.07 affect upgrades on an ADP with both Release Independent and Dependent applications.

Design

The Application Delivery Platform (ADP) is the BroadWorks server that replaces the Xtended Service Platform (XSP) and Profile Server (PS) at version 24.0 and up.

There are two application types, Release Independent (RI) applications and Release Anchored (RA):

- Release Anchored applications contain the major BroadWorks release version in the application name. These applications must be updated after the Application Server (AS) is upgraded and are not backward compatible with older major releases of the AS.

- Release Independent applications do not have the major BroadWorks release version in the application name. These applications must be updated before the Application Server (AS) is upgraded and are backward compatible with an older version of the AS.

The ADP is intended to be dedicated to only Release Independent or only Release Anchored applications on a per server basis. However, this is not enforced and the ADP allows both application types to be deployed on a single server.

The ADP must be upgraded to the same release or greater than the target application version.

For latest compatibility between applications and ADP see the ADP Release Notes, specifically the section 'Known Limitations and Restrictions'.

Impact of Java JRE Changes in 2025.07 and Later

When upgrading a BroadWorks system the Release Independent applications must be upgraded before the Application Server (AS) and the Release Anchored applications must be upgraded after the AS.

Normally this is not a problem and the ADP can be upgraded, Release Independent applications updated and Release Anchored applications updated after the AS is upgraded. However, when upgrading to 2025.07 or later this is not possible.

Release 2025.07 upgrades Java JDK to version 11 for all BroadWorks components. As a result, there is an incompatibility between applications built for Java 8 and the ADP built for java 11. This means that when upgrading to 2025.07 or later, it is mandatory to upgrade all applications at the same time as the ADP. If the ADP has both Release Independent applications and Release Anchored applications deployed on it this becomes a problem. ADPs that are dedicated to only Release Anchored applications (with no RI applications deployed) do not encounter this problem and are upgraded after the AS as normal.

Upgrading an ADP from Release 24.0 with Mixed Applications

When upgrading from release 24 there is a straightforward workaround. Release 24 end of support is July 31, 2026 which means that the release 24 applications have been updated.

Steps to upgrade:

- Install the latest version of the 24.0 Release Anchored applications and Release Independent applications but do not manually update the applications.

- Upgrade the ADP - the upgrade automatically updates the Release Anchored applications and Release Independent applications that use Java 11.

- Upgrade the AS to 26.0.

- Update the Release Anchored applications versions for 26.0.

Some applications, where the file name ends in .war, do not align with the normal naming standard for Release Anchored applications or Release Independent applications such as BWCallSettingsWeb_1.15.20_2.war. These applications need to be updated manually.

Upgrading an ADP from Release 25.0 with Mixed Applications

Release 25 is no longer receiving updates as 2024.07 was the last release of 25 and release 26 begins at 2024.08. This means that the Release Anchored applications for 25 have not been updated. The system must be upgraded in two jumps or the Release Independent and Release Anchored applications be on separate ADPs.

Steps to upgrade:

1. Upgrade the ADP to 2025.06.

2. Install and update the Release Independent applications.

3. Upgrade the AS to release 26 (you can choose a release 26.0 version later than 2025.07).

4. Update the Release Anchored applications versions for 26.0 no later than 2025.06.

5. Install the latest version of the 26.0 Release Anchored applications and Release Independent applications but do not manually update the applications.

6. Upgrade the ADP to 2025.07 or later - the upgrade automatically updates the Release Anchored applications and Release Independent applications that use Java 11.

7. Update remaining applications if necessary.

Some applications, where the file name ends in .war, do not alline with the normal naming standard for Release Anchored applications or Release Independent applications such as BWCallSettingsWeb_1.15.20_2.war. These applications need to be updated manually.

Upgrading an ADP from Release 26.0 with Mixed Applications

Upgrading from 26.0 to a later version beyond 2505.07 only requires that Release Anchored applications be installed prior to upgrading.

Steps to upgrade:

- Install the latest version of the 26.0 Release Anchored applications and Release Independent applications but do not manually update the applications.

- Upgrade the ADP - the upgrade automatically updates the Release Anchored applications and Release Independent applications that use Java 11.

- Upgrade the AS.

- Update remaining applications if necessary.

Some applications, where the file name ends in .war, do not align with the normal naming standard for Release Anchored applications or Release Independent applications such as BWCallSettingsWeb_1.15.20_2.war. These applications need to be updated manually.