AWS Der Mainframe Modernization Service (Managed Runtime Environment Experience) steht Neukunden nicht mehr zur Verfügung. Funktionen, die dem AWS Mainframe Modernization Service (Managed Runtime Environment-Erfahrung) ähneln, finden Sie unter AWS Mainframe Modernization Service (Self-Managed Experience). Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Änderung der Verfügbarkeit von [AWS Mainframe Modernization](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Anweisungen zur Aktualisierung von AWS Transform for Mainframe
Diese Seite enthält Anweisungen für das Upgrade der AWS Transform for Mainframe-Version.
**Topics**
+ [Allgemeine Upgrades](#common-upgrades)
+ [Migration von 3.10.0 auf 4.0.0](#3.10-to-4.0)
+ [Migration von 5.85.0 auf 5.86.0](#5.85-to-5.86)
## Allgemeine Upgrades
In den meisten Fällen sollten Sie beim Upgrade der Runtime-Version von AWS Transform for Mainframe die Artefakte (WARs, Konfigurationsdateien, Skripte usw.) Ihrer vorherigen Version durch die in der neuen Version bereitgestellten ersetzen und Ihre Anwendung neu starten. Stellen Sie sicher, dass Sie nach dem Upgrade umfangreiche Regressionstests Ihrer modernisierten Anwendungen durchführen. Sie können sich auch an Ihren AWS Transform for Mainframe Delivery Manager wenden, um spezifische Anweisungen für Ihre Anwendung zu erhalten.
Bei einigen Upgrades ist möglicherweise eine zusätzliche Konfiguration erforderlich, um die Kompatibilität sicherzustellen. Folgen Sie in diesem Fall den Anweisungen für das jeweilige Upgrade.
## Migration von 3.10.0 auf 4.0.0
Die wichtigste Änderung in 4.0.0 ist die Migration von Spring Boot 2.7 auf Spring Boot 3.2 und von Tomcat 9 auf Tomcat 10.
### Änderungen am Code
In diesem Abschnitt werden die Änderungen aufgeführt, die erforderlich sind, um den modernisierten Code mit AWS Transform for Mainframe Runtime 4.0.0 kompatibel zu machen. Sie können diesen Abschnitt überspringen, wenn Sie sich entscheiden, eine neue Generation mit der Version 4.0.0 auf AWS Transform for Mainframe Refactor (Transformation Center) zu starten.
**POM-Änderungen**
| Group (Gruppieren) | ArtifactId | Änderungen |
| --- | --- | --- |
| org.slf4j | slf4j-api | Entfernen (ist eine transitive Abhängigkeit) |
| org.yaml | Snakeyaml | Entfernen (ist eine transitive Abhängigkeit) |
| org.springframework.boot | spring-boot-starter-web | - Spring.boot.version auf 3.2.4 aktualisieren - Ausschluss von log4 4j entfernen j-to-slf |
| org.springframework.boot | spring-boot-starter-jta-Atomikos | Wechseln Sie zu com.atomikos: 3-starter:6.0.0 transactions-spring-boot |
| org.apache.commons | commons-dbcp2 | Führen Sie ein Upgrade auf 2.10.0 durch |
| org.postgresql | postgreql | Führen Sie ein Upgrade auf 42.7.2 durch |
| com.microsoft.sqlserver | mssql-jdbc | Führen Sie ein Upgrade auf 12.4.2.jre11 durch |
| com.oracle.database.jdbc | ojdbc 8 | Wechseln Sie zu ojdbc11 Version 23.3.0.23.09 |
**Migrieren Sie von Javax nach Jakarta**
Das Tomcat-Upgrade beinhaltet eine Migration vom Javax-Java-Paket nach Jakarta. **Stellen Sie sicher, dass Sie Ihre Importe von javax.\$1 nach Jakarta entsprechend aktualisieren. \$1.**
Fast alle alten Klassen, auf die im Javax-Paket verwiesen wurde, befinden sich in Jakarta. Bekannte Ausnahmen sind die `javax.xml` Pakete `javax.sql` und, die immer noch unverändert sind.
**Atomikos ändern sich**
Aufgrund der oben genannten Änderung der Abhängigkeit `org.springframework.boot.jta.atomikos.AtomikosDataSourceBean` müssen Verweise auf geändert werden in. `com.atomikos.spring.AtomikosDataSourceBean`
**Entfernung des PostgreSQL-Dialekts**
Die benutzerdefinierte Klasse `PostgreSQLDialect.java` wird entfernt. Verweise darauf im Haupt-Launcher müssen ebenfalls entfernt werden.
### Bereitstellung (AWS Transformation für Mainframe-Runtime)
**Tomcat**
Diese Version ist mit `10.1.17` Tomcat kompatibel. Für die Ausführung der Runtime ist ein Upgrade des Tomcat-Servers auf diese Version erforderlich. AWS Transform for mainframe `4.0.0` Stellen Sie sicher, dass Sie die alten Konfigurationsänderungen (insbesondere die Catalina-Eigenschaften) portieren.
**Geteilte Abhängigkeiten**
Der gemeinsam genutzte Runtime-Ordner enthält die up-to-date Abhängigkeiten.
**Zusätzliche Abhängigkeiten**
Wenn Sie zusätzliche Abhängigkeiten verwendet haben (die nicht in der Laufzeit enthalten sind), müssen Sie diese möglicherweise aktualisieren. In der Readme-Datei im zusätzlichen Ordner sind die unterstützten Versionen aufgeführt.
## Migration von 5.85.0 auf 5.86.0
Die wichtigste Änderung in 5.86.0 ([Alpha-Vorabversionen](ba-versioning.md#ba-versioning-alpha)) ist die Migration von Spring Boot 3.5.7 auf Spring Boot 4.0.3 und von Tomcat 10 auf Tomcat 11.
### Änderungen am Code
In diesem Abschnitt werden die Änderungen aufgeführt, die erforderlich sind, um den modernisierten Code mit AWS Transform for Mainframe Runtime 5.86.0 kompatibel zu machen. Sie können diesen Abschnitt überspringen, wenn Sie sich entscheiden, eine neue Generation mit der Version 5.86.0 auf Blu Insights (Transformation Center) zu starten.
**POM-Änderungen**
Aktualisieren Sie die Spring Boot-Version:
```
4.0.3
```
Ersetze `spring-boot-starter-web` durch`spring-boot-starter-webmvc`:
```
org.springframework.boot
spring-boot-starter-webmvc
provided
```
**Reorganisation von Paketen**
Aufgrund der oben genannten Änderung der Abhängigkeiten verweisen wir auf:
+ `org.springframework.boot.autoconfigure.domain.EntityScan`muss geändert werden in`org.springframework.boot.persistence.autoconfigure.EntityScan`.
+ `org.springframework.boot.autoconfigure.jdbc.DataSourceProperties`muss geändert werden auf`org.springframework.boot.jdbc.autoconfigure.DataSourceProperties`.
### Bereitstellung (AWS Transformation für Mainframe-Runtime)
**Tomcat**
Diese Version ist mit `11.0.15` Tomcat kompatibel. Für die Ausführung der Runtime ist ein Upgrade des Tomcat-Servers auf diese Version erforderlich. AWS Transform for mainframe `5.86.0` Stellen Sie sicher, dass Sie die alten Konfigurationsänderungen (insbesondere die Catalina-Eigenschaften) portieren.
**Geteilte Abhängigkeiten**
Der gemeinsam genutzte Runtime-Ordner enthält die up-to-date Abhängigkeiten.
**Zusätzliche Abhängigkeiten**
Wenn Sie zusätzliche Abhängigkeiten verwendet haben (die nicht in der Laufzeit enthalten sind), müssen Sie diese möglicherweise aktualisieren. In der Readme-Datei im zusätzlichen Ordner sind die unterstützten Versionen aufgeführt.