

AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) は、新規のお客様に公開されなくなりました。 AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) と同様の機能については、 AWS Mainframe Modernization Service (セルフマネージドエクスペリエンス) をご覧ください。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、[AWS 「 Mainframe Modernization の可用性の変更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# メインフレームの AWS 変換をアップグレードする手順
<a name="ba-migration-notes"></a>

このページには、メインフレームバージョンの 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)

## 一般的なアップグレード
<a name="common-upgrades"></a>

ほとんどの場合、メインフレームランタイムバージョン用の AWS 変換をアップグレードするときは、以前のバージョンのアーティファクト (WARs、設定ファイル、スクリプトなど) を新しいバージョンで提供されているアーティファクトに置き換え、アプリケーションを再起動する必要があります。アップグレード後は、モダナイズされたアプリケーションの広範な回帰テストを必ず実行してください。アプリケーションに適用される特定の手順については、メインフレーム配信マネージャーの AWS Transform に問い合わせることもできます。

のアップグレードによっては、互換性を確保するために追加の設定が必要になる場合があります。その場合、その特定のアップグレードの手順に従ってください。

## 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>

このセクションでは、メインフレームランタイム 4.0.0 の AWS 変換と互換性のあるモダナイズされたコードを作成するために必要な変更を一覧表示します。メインフレームリファクタリング用の AWS Transform (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 から Jakarta への移行**

tomcat のアップグレードには、Javax Java パッケージから Jakarta への移行が付属しています。**必ず、インポートを javax.\$1 から jakarta.\$1 へと更新してください**。

Javax パッケージ内の古い参照クラスはほぼすべてジャカルタにあります。これに対する既知の例外は `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` と互換性があります。AWS Transform for mainframe ランタイム を実行するには、Tomcat サーバーをこのバージョンにアップグレードする必要があります`4.0.0`。古い設定変更 (特に Catalina プロパティ) は、必ず移植してください。

**共有依存関係**

ランタイム共有フォルダには、最新の依存関係が含まれています。

**追加の依存関係**

追加の依存関係 (ランタイムには含まれていない) を使用した場合は、それらを更新する必要が生じることがあります。追加フォルダの readme ファイルには、サポートされているバージョンが一覧表示されます。

## 5.85.0 から 5.86.0 への移行
<a name="5.85-to-5.86"></a>

5.86.0 ([アルファプレリリース](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>

このセクションでは、メインフレームランタイム 5.86.0 の AWS 変換と互換性のあるモダナイズされたコードを作成するために必要な変更を一覧表示します。Blu Insights (Transformation Center) で 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>
```

**パッケージの再編成**

上記の依存関係の変更により、 は以下を参照します。
+ `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` と互換性があります。AWS Transform for mainframe ランタイム を実行するには、Tomcat サーバーをこのバージョンにアップグレードする必要があります`5.86.0`。古い設定変更 (特に Catalina プロパティ) は、必ず移植してください。

**共有依存関係**

ランタイム共有フォルダには、最新の依存関係が含まれています。

**追加の依存関係**

追加の依存関係 (ランタイムには含まれていない) を使用した場合は、それらを更新する必要が生じることがあります。追加フォルダの readme ファイルには、サポートされているバージョンが一覧表示されます。