View a markdown version of this page

适用于大型机的 Trans AWS form 的升级说明 - AWS 大型机现代化
通用升级从 3.10.0 迁移到 4.0.0从 5.85.0 迁移到 5.125.0

AWS 大型机现代化服务（托管运行时环境体验）不再向新客户开放。有关类似于 AWS 大型机现代化服务（托管运行时环境体验）的功能，请浏览 AWS 大型机现代化服务（自我管理体验）。现有客户可以继续正常使用该服务。有关更多信息，请参阅AWS 大型机现代化可用性变更。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

适用于大型机的 Trans AWS form 的升级说明

本页包含升级适用于大型机的 Trans AWS form 版本的说明。

通用升级

在大多数情况下，在升级 Tr AWS ansform for Mainframe Runtime 版本时WARs，应将先前版本的工件（配置文件、脚本等）替换为新版本中提供的工件（配置文件、脚本等），然后重新启动应用程序。升级后，请务必对经过现代化改造的应用程序进行全面的回归测试。您也可以联系您的大型机Transf AWS orm交付经理，获取适用于您的应用程序的具体说明。

某些升级可能需要进行额外的配置来确保兼容性。在这种情况下，请按照该特定升级的说明进行操作。

从 3.10.0 迁移到 4.0.0

4.0.0 中的主要变化是从 Spring Boot 2.7 迁移到 Spring Boot 3.2，以及从 Tomcat 9 迁移到 Tomcat 10。

代码更改

本节列出了使现代化代码与适用于大型机的 Tr AWS ansform Runtime 4.0.0 兼容所需的更改。如果您决定在 Tr AWS ansform for 大型机重构（Transformation Center）上使用 4.0.0 版本发布新一代，则可以跳过本节。

POM 更改

Group ArtifactId 更改
org.slf4j slf4j-api 删除（是一种传递依赖）
org.yaml snakeyaml 删除（是一种传递依赖）
org.springframework.boot spring-boot-starter-web -将 spring.boot.version 升级到 3.2.4-移除 log4 4j 的排除项 j-to-slf
org.springframework.boot spring-boot-starter-jta-atomikos 改为 com.atomikos：3-starter：6.0.0 transactions-spring-boot
org.apache.commons commons-dbcp2 升级到 2.10.0
org.postgresql postgreql 升级到 42.7.2
com.microsoft.sqlserver mssql-jdbc 升级到 12.4.2.jre11
com.oracle.database.jdbc ojdbc8 改为 ojdbc11 版本 23.3.0.23.09

从 Javax 迁移到 Jakarta

tomcat 升级附带从 Javax Java 程序包迁移到 Jakarta。请务必将导入相应地从 javax.* 更新到 jakarta.*。

Javax 程序包中引用的几乎所有旧类都可以在 Jakarta 中找到。已知的例外情况是 javax.sql 和 javax.xml 程序包，它们将仍然保持不变。

Atomikos 更改

由于上文提到的依赖变更，必须将对 org.springframework.boot.jta.atomikos.AtomikosDataSourceBean 的引用更改为 com.atomikos.spring.AtomikosDataSourceBean。

删除 PostgreSQL 方言

已删除自定义类 PostgreSQLDialect.java。主启动器中对该类的引用也必须删除。

部署（针对大型机运行时进行AWS 转换）

Tomcat

此版本与 Tomcat 10.1.17 兼容。需要将 Tomcat 服务器升级到此版本才能运行AWS Transform for mainframe运行4.0.0时。请确保移植旧的配置更改（特别是 Catalina 属性）。

共享依赖项

运行时共享文件夹包含 up-to-date依赖关系。

额外的依赖项

如果您使用了额外的依赖项（未包含在运行时中），则可能需要对其进行更新。extra 文件夹中的自述文件列出了支持的版本。

从 5.85.0 迁移到 5.125.0

5.125.0（alpha 预发行版 5.86.0）(Alpha 预发行版) 的主要变化是从 Spring Boot 3.5.7 迁移到 Spring Boot 4.0.3+，从 Tomcat 10 迁移到 Tomcat 11+。

代码更改

本节列出了使现代化代码与适用于大型机运行时的 Tr AWS ansform 5.125.0 兼容所需的更改。如果您决定在 Tr AWS ansform for 大型机重构（Transformation Center）上使用 5.125.0 版本发布新一代，则可以跳过本节。

POM 更改

更新 Spring Boot 版本：

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

替换spring-boot-starter-web为spring-boot-starter-webmvc：

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

Package 重组

由于上面提到的依赖关系发生了变化，因此引用了：

  • org.springframework.boot.autoconfigure.domain.EntityScan必须更改为org.springframework.boot.persistence.autoconfigure.EntityScan。

  • org.springframework.boot.autoconfigure.jdbc.DataSourceProperties必须更改为org.springframework.boot.jdbc.autoconfigure.DataSourceProperties。

部署（针对大型机运行时进行AWS 转换）

Tomcat

此版本与 Tomcat 11.0.15+ 兼容。需要将 Tomcat 服务器升级到此版本才能运行AWS Transform for mainframe运行5.125.0时。请确保移植旧的配置更改（特别是 Catalina 属性）。

共享依赖项

运行时共享文件夹包含 up-to-date依赖关系。

额外的依赖项

如果您使用了额外的依赖项（未包含在运行时中），则可能需要对其进行更新。extra 文件夹中的自述文件列出了支持的版本。