AWS Le service de modernisation du mainframe (expérience de l'environnement d'exécution géré) n'est plus ouvert aux nouveaux clients. Pour des fonctionnalités similaires au service de modernisation AWS du mainframe (expérience de l'environnement d'exécution géré), explorez le service de modernisation AWS du mainframe (expérience autogérée). Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez la section [Modification de la disponibilité de la modernisation du AWS mainframe](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Instructions de mise à niveau pour AWS Transform pour mainframe
Cette page contient des instructions pour la mise à niveau de la version AWS Transform pour mainframe.
**Topics**
+ [Mises à niveau courantes](#common-upgrades)
+ [Migration de la version 3.10.0 vers la version 4.0.0](#3.10-to-4.0)
+ [Migration de la version 5.85.0 vers la version 5.86.0](#5.85-to-5.86)
## Mises à niveau courantes
Dans la plupart des cas, lors de la mise à niveau de la version Runtime de AWS Transform for mainframeWARs, vous devez remplacer les artefacts (fichiers de configuration, scripts, etc.) de votre version précédente par ceux fournis dans la nouvelle version et redémarrer votre application. Assurez-vous d'effectuer des tests de régression approfondis sur vos applications modernisées une fois la mise à niveau effectuée. Vous pouvez également contacter votre responsable de livraison de AWS Transform for mainframe pour obtenir des instructions spécifiques applicables à votre application.
Certaines mises à niveau peuvent nécessiter une configuration supplémentaire pour garantir la compatibilité. Dans ce cas, suivez les instructions relatives à cette mise à niveau spécifique.
## Migration de la version 3.10.0 vers la version 4.0.0
La principale modification apportée à la version 4.0.0 est la migration de Spring Boot 2.7 vers Spring Boot 3.2 et de Tomcat 9 vers Tomcat 10.
### Changements de code
Cette section répertorie les modifications nécessaires pour rendre le code modernisé compatible avec AWS Transform for mainframe Runtime 4.0.0. Vous pouvez ignorer cette section si vous décidez de lancer une nouvelle génération à l'aide de la version 4.0.0 sur AWS Transform pour le refactorage des mainframes (Transformation Center).
**Modifications du POM**
| Groupe | ArtifactId | Modifier |
| --- | --- | --- |
| org.slf4j | slf4j-api | Supprimer (est une dépendance transitive) |
| org.yaml | snakeyaml | Supprimer (est une dépendance transitive) |
| org.springframework.boot | spring-boot-starter-web | - Mettre à jour spring.boot.version vers la version 3.2.4 - Supprimer l'exclusion de log4 4j j-to-slf |
| org.springframework.boot | spring-boot-starter-jta-atomiques | Passez à com.atomikos : 3-starter:6.0.0 transactions-spring-boot |
| org.apache.commons | commons-dbcp2 | Mise à niveau vers la version 2.10.0 |
| org.postgresql | postgreql | Mise à niveau vers la version 42.7.2 |
| com.microsoft.sqlserver | mssql-jdbc | Mise à niveau vers 12.4.2.jre11 |
| com.oracle.database.jdbc | ojdbc8 | Passage à la version 23.3.0.23.09 d'ojdbc11 |
**Migrer de Javax vers Jakarta**
La mise à niveau de Tomcat s'accompagne d'une migration du package Java Javax vers Jakarta. **Assurez-vous de mettre à jour vos importations en conséquence de javax.\$1 vers jakarta. **\$1.
Presque toutes les anciennes classes référencées du package Javax se trouvent à Jakarta. Les exceptions connues à cette règle sont les `javax.xml` packages `javax.sql` et, qui sont toujours inchangés.
**Atomikos change**
En raison de la modification de dépendance mentionnée ci-dessus, les références à `org.springframework.boot.jta.atomikos.AtomikosDataSourceBean` doivent être remplacées par`com.atomikos.spring.AtomikosDataSourceBean`.
**Suppression du dialecte PostgreSQL**
La classe personnalisée `PostgreSQLDialect.java` est supprimée. Les références à celui-ci dans le lanceur principal doivent également être supprimées.
### Déploiement (AWS Transform for mainframe Runtime)
**Tomcat**
Cette version est compatible avec Tomcat`10.1.17`. La mise à niveau du serveur Tomcat vers cette version est nécessaire pour exécuter le AWS Transform for mainframe Runtime`4.0.0`. Assurez-vous de transférer les anciennes modifications de configuration (notamment les propriétés Catalina).
**Dépendances partagées**
Le dossier partagé d'exécution contient les up-to-date dépendances.
**Dépendances supplémentaires**
Si vous avez utilisé des dépendances supplémentaires (non incluses dans le runtime), vous devrez peut-être les mettre à jour. Le fichier readme situé dans le dossier supplémentaire répertorie les versions prises en charge.
## Migration de la version 5.85.0 vers la version 5.86.0
La principale modification apportée à 5.86.0 ([Pré-versions alpha](ba-versioning.md#ba-versioning-alpha)) est la migration de Spring Boot 3.5.7 vers Spring Boot 4.0.3 et de Tomcat 10 vers Tomcat 11.
### Changements de code
Cette section répertorie les modifications nécessaires pour rendre le code modernisé compatible avec AWS Transform for mainframe Runtime 5.86.0. Vous pouvez ignorer cette section si vous décidez de lancer une nouvelle génération en utilisant la version 5.86.0 sur Blu Insights (Transformation Center).
**Modifications du POM**
Mettez à jour la version Spring Boot :
```
4.0.3
```
Remplacer `spring-boot-starter-web` par `spring-boot-starter-webmvc` :
```
org.springframework.boot
spring-boot-starter-webmvc
provided
```
**Réorganisation du package**
En raison de la modification des dépendances mentionnée ci-dessus, les références à :
+ `org.springframework.boot.autoconfigure.domain.EntityScan`doit être remplacé par`org.springframework.boot.persistence.autoconfigure.EntityScan`.
+ `org.springframework.boot.autoconfigure.jdbc.DataSourceProperties`doit être remplacé par`org.springframework.boot.jdbc.autoconfigure.DataSourceProperties`.
### Déploiement (AWS Transform for mainframe Runtime)
**Tomcat**
Cette version est compatible avec Tomcat`11.0.15`. La mise à niveau du serveur Tomcat vers cette version est nécessaire pour exécuter le AWS Transform for mainframe Runtime`5.86.0`. Assurez-vous de transférer les anciennes modifications de configuration (notamment les propriétés Catalina).
**Dépendances partagées**
Le dossier partagé d'exécution contient les up-to-date dépendances.
**Dépendances supplémentaires**
Si vous avez utilisé des dépendances supplémentaires (non incluses dans le runtime), vous devrez peut-être les mettre à jour. Le fichier readme situé dans le dossier supplémentaire répertorie les versions prises en charge.