AWS Mainframe Modernization Service （受管執行期環境體驗） 不再開放給新客戶使用。對於與 AWS Mainframe Modernization Service （受管執行期環境體驗） 類似的功能，探索 AWS Mainframe Modernization Service （自我管理體驗）。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[AWS 大型主機現代化可用性變更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 升級適用於大型主機之 AWS Transform 的指示
此頁面包含升級大型主機版本 AWS 轉換的指示。
**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)
## 常見升級
在大多數情況下，升級大型主機執行期版本的 AWS 轉換時，您應該將先前版本的成品 (WARs、組態檔案、指令碼等） 取代為新版本中提供的成品，然後重新啟動應用程式。升級後，請務必對現代化應用程式執行廣泛的迴歸測試。您也可以聯絡適用於大型主機交付管理員的 AWS Transform，以取得適用於您應用程式的特定指示。
某些升級可能需要額外的組態，以確保相容性。在這種情況下，請遵循該特定升級的指示。
## 從 3.10.0 遷移至 4.0.0
4.0.0 的主要變更是從 Spring Boot 2.7 遷移至 Spring Boot 3.2，以及從 Tomcat 9 遷移至 Tomcat 10。
### 程式碼變更
本節列出讓現代化程式碼與適用於大型主機執行期 4.0.0 的 AWS Transform 相容所需的變更。如果您決定在 AWS Transform for mainframe refactor (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 - 移除 log4j-to-slf4j 的排除 |
| org.springframework.boot | spring-boot-starter-jta-atomikos | 變更為 com.atomikos：transactions-spring-boot3-starter：6.0.0 |
| 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 遷移到雅加達**
tomcat 升級隨附從 Javax Java 套件到雅加達的遷移。**請務必相應地將匯入從 javax.\$1 更新至 jakarta.\$1**。
Javax 套件中幾乎所有舊的參考類別都可以在雅加達找到。已知的例外狀況是 `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相依性。
**額外相依性**
如果您使用額外的相依性 （不包含在執行時間中），您可能需要更新它們。額外資料夾中的讀我檔案會列出支援的版本。
## 從 5.85.0 遷移至 5.86.0
5.86.0 ([Alpha 發行前版本](ba-versioning.md#ba-versioning-alpha)) 的主要變更是從 Spring Boot 3.5.7 遷移至 Spring Boot 4.0.3，以及從 Tomcat 10 遷移至 Tomcat 11。
### 程式碼變更
本節列出使現代化程式碼與適用於大型主機執行期 5.86.0 的 AWS Transform 相容所需的變更。如果您決定使用 Blu Insights （轉型中心） 上的 5.86.0 版本啟動新一代，可以略過本節。
**POM 變更**
更新 Spring Boot 版本：
```
4.0.3
```
將 取代`spring-boot-starter-web`為 `spring-boot-starter-webmvc`：
```
org.springframework.boot
spring-boot-starter-webmvc
provided
```
**套件重組**
由於上述相依性變更， 參考：
+ `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.86.0`。請務必移植舊的組態變更 （特別是 Catalina 屬性）。
**共用相依性**
執行期共用資料夾包含up-to-date相依性。
**額外相依性**
如果您使用額外的相依性 （不包含在執行時間中），您可能需要更新它們。額外資料夾中的讀我檔案會列出支援的版本。