AWS 大型机现代化服务（托管运行时环境体验）不再向新客户开放。有关类似于 AWS 大型机现代化服务（托管运行时环境体验）的功能，请浏览 AWS 大型机现代化服务（自我管理体验）。现有客户可以继续正常使用该服务。有关更多信息，请参阅[AWS 大型机现代化可用性变更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)。

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

# 适用于大型机的 Trans AWS form 的升级说明
<a name="ba-migration-notes"></a>

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

**Topics**
+ [通用升级](#common-upgrades)
+ [从 3.10.0 迁移到 4.0.0](#3.10-to-4.0)
+ [从 5.85.0 迁移到 5.86.0](#5.85-to-5.86)

## 通用升级
<a name="common-upgrades"></a>

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

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

## 从 3.10.0 迁移到 4.0.0
<a name="3.10-to-4.0"></a>

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

### 代码更改
<a name="code-changes"></a>

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

**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.\$1 更新到 jakarta.\$1**。

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

**Atomikos 更改**

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

**删除 PostgreSQL 方言**

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

### 部署（针对大型机运行时进行AWS 转换）
<a name="deployment"></a>

**Tomcat**

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

**共享依赖项**

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

**额外的依赖项**

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

## 从 5.85.0 迁移到 5.86.0
<a name="5.85-to-5.86"></a>

5.86.0 ([Alpha 预发行版](ba-versioning.md#ba-versioning-alpha)) 的主要变化是从 Spring Boot 3.5.7 迁移到 Spring Boot 4.0.3，从 Tomcat 10 迁移到 Tomcat 11。

### 代码更改
<a name="code-changes-5.86.0"></a>

本节列出了使现代化代码与适用于大型机运行时的 Tr AWS ansform 5.86.0 兼容所需的更改。如果您决定在 Blu Insights（转型中心）上使用 5.86.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 转换）
<a name="deployment-5.86.0"></a>

**Tomcat**

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

**共享依赖项**

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

**额外的依赖项**

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