AWS Mainframe Modernization Service (Managed Runtime Environment experience) is no longer open to new customers. For capabilities similar to AWS Mainframe Modernization Service (Managed Runtime Environment experience) explore AWS Mainframe Modernization Service (Self-Managed Experience). Existing customers can continue to use the service as normal. For more information, see AWS Mainframe Modernization availability change.

Upgrading instructions for AWS Transform for mainframe

This page contains instructions for upgrading the AWS Transform for mainframe version.

Common upgrades

In most of the cases, when upgrading the AWS Transform for mainframe Runtime version, you should replace the artifacts (WARs, configuration files, scripts, etc.) of your previous version with the ones provided in the new one and restart your application. Make sure to perform extensive regression tests of your modernized applications once you upgrade. You may also contact your AWS Transform for mainframe delivery manager for specific instructions applicable to your application.

Some upgrades may require additional configuration to ensure compatibility. In that case, follow the instructions for that specific upgrade.

Migrating from 3.10.0 to 4.0.0

The main change in 4.0.0 is the migration from Spring Boot 2.7 to Spring Boot 3.2 and from Tomcat 9 to Tomcat 10.

Code changes

This section lists changes required to make the modernized code compatible with AWS Transform for mainframe Runtime 4.0.0. You can skip this section if you decide to launch a new generation using the 4.0.0 version on AWS Transform for mainframe refactor (Transformation Center).

POM changes

Migrate from Javax to Jakarta

The tomcat upgrade comes with a migration from the Javax Java package to Jakarta. Make sure to update your imports accordingly from javax.* to jakarta.*.

Nearly all the old referenced classes in the Javax package can be found in Jakarta. Known exceptions to this are the javax.sql and javax.xml packages, which are still unchanged.

Atomikos change

Due to the dependency change referenced above, references to org.springframework.boot.jta.atomikos.AtomikosDataSourceBean must be changed to com.atomikos.spring.AtomikosDataSourceBean.

PostgreSQL dialect removal

The custom class PostgreSQLDialect.java is removed. References to it in the main launcher must be removed too.

Deployment (AWS Transform for mainframe Runtime)

Tomcat

This version is compatible with Tomcat 10.1.17. Upgrading the Tomcat server to this version is required to run the AWS Transform for mainframe Runtime 4.0.0. Make sure to port the old configuration changes (notably the Catalina properties).

Shared dependencies

The runtime shared folder contains the up-to-date dependencies.

Extra dependencies

If you used extra dependencies (not included on the runtime), you might need to update them. The readme file in the extra folder lists the supported versions.

Migrating from 5.85.0 to 5.86.0

The main change in 5.86.0 (Alpha pre-releases) is the migration from Spring Boot 3.5.7 to Spring Boot 4.0.3 and from Tomcat 10 to Tomcat 11.

Code changes

This section lists changes required to make the modernized code compatible with AWS Transform for mainframe Runtime 5.86.0. You can skip this section if you decide to launch a new generation using the 5.86.0 version on Blu Insights (Transformation Center).

POM changes

Update the Spring Boot version:

<properties>
    <spring.boot.version>4.0.3</spring.boot.version>
</properties>

Replace spring-boot-starter-web with spring-boot-starter-webmvc:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-webmvc</artifactId>
    <scope>provided</scope>
</dependency>

Package reorganization

Due to the dependencies change referenced above, references to:

Deployment (AWS Transform for mainframe Runtime)

Tomcat

This version is compatible with Tomcat 11.0.15. Upgrading the Tomcat server to this version is required to run the AWS Transform for mainframe Runtime 5.86.0. Make sure to port the old configuration changes (notably the Catalina properties).

Shared dependencies

The runtime shared folder contains the up-to-date dependencies.

Extra dependencies

If you used extra dependencies (not included on the runtime), you might need to update them. The readme file in the extra folder lists the supported versions.