2025.03 Titanium Platform Upgrade

This document describes the steps to help users upgrade from Scandium to Titanium platform. Refer to Managed Snapshot Integrated (MSI) project upgrade patches for more information and hints for solutions to common problems not explicitly listed here.

Preparation

JDK 21 Version

2025.03 Titanium, requires Java 21, both during compile-time and run-time. Make sure to install JDK 21 corresponding to at least openjdk-21.0.8, and that the JAVA_HOME environment variable points to the JDK directory.

Version Bump

Before performing platform upgrade, do the following to bump the odlparent versions (for example, bump-odl-version):

  1. Update the odlparent version from 14.0.3 to 14.1.0. There should not be any reference to org.opendaylight.odlparent, except for 14.1.0. This includes custom feature.xml templates (src/main/feature/feature.xml), the version range should be “[14,15)”.

bump-odl-version odlparent 14.0.3 14.1.0

  1. Update the direct yangtools version references from 14.0.4 to 14.0.14, There should not be any reference to org.opendaylight.yangtools, except for 14.0.14. This includes custom feature.xml templates (src/main/feature/feature.xml), the version range should be “[14,15)” instead of “[13,14)”.

bump-odl-version yangtools 14.0.4 14.0.14

  1. Update the MD-SAL version from 14.0.2 to 14.0.13. There should not be any reference to org.opendaylight.mdsal, except for 14.0.13.

bump-odl-version mdsal 14.0.2 14.0.13

  1. Update the Controller version from 10.0.2 to 11.0.0. There should not be any reference to org.opendaylight.controller, except for 11.0.0.

bump-odl-version controller 10.0.2 11.0.0

  1. Update the InfraUtils version from 7.0.3 to 7.1.4. There should not be any reference to org.opendaylight.infrautils, except for 7.1.4.

bump-odl-version infrautils 7.0.3 7.1.4

  1. Update the AAA version from 0.20.1 to 0.21.0 There should not be any reference to org.opendaylight.aaa, except for 0.21.0.

bump-odl-version aaa 0.20.1 0.21.0

  1. Update the NETCONF version from 8.0.2 to 9.0.0 There should not be any reference to org.opendaylight.netconf, except for 9.0.0.

bump-odl-version netconf 8.0.2 9.0.0

Install Dependent Projects

Before performing platform upgrade, users must also install any dependent project. To locally install a dependent project, pull and install the respective titanium-mri changes for any dependent project.

Perform the following steps to save time when locally installing any dependent project:

  • For quick install:

mvn -Pq clean install

  • If previously installed, go offline and/or use the no-snapshot-update option.

mvn -Pq -o -nsu clean install

Upgrade the ODL Parent

The following sub-section describes how to upgrade to the ODL Parent version 14. Refer to the ODL Parent Release Notes for more information.

Features

Any version range referencing version of ODL Parent must be “[14,15)” for ODL Parent 14.

<feature name="odl-infrautils-caches">
    <feature version="[14,15)">odl-guava</feature>
</feature>

ODL Parent Impacts

None.

YANG Tools Impacts

None.

MD-SAL Impacts

None.

Netconf Impacts

None.

AAA Impacts

None.