AWS El servicio de modernización de mainframes (experiencia en entornos de ejecución gestionados) ya no está abierto a nuevos clientes. Para obtener prestaciones similares a las del Servicio de Modernización de AWS Mainframe (experiencia en entornos de ejecución gestionados), explore el Servicio de Modernización de AWS Mainframe (experiencia autogestionada). Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte Cambio en la disponibilidad de la modernización del AWS mainframe.
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Instrucciones de actualización de AWS Transform para mainframe
Esta página contiene instrucciones para actualizar la versión AWS Transform para mainframe.
Actualizaciones comunes
En la mayoría de los casos, al actualizar la versión AWS Transform para mainframe Runtime, debe reemplazar los artefactos (archivos de configuraciónWARs, scripts, etc.) de la versión anterior por los que se incluyen en la nueva y reiniciar la aplicación. Asegúrese de realizar exhaustivas pruebas de regresión de las aplicaciones modernizadas una vez que actualice. También puede ponerse en contacto con el administrador de entrega de AWS Transform for mainframe para obtener instrucciones específicas aplicables a su aplicación.
Algunas actualizaciones pueden requerir configuración adicional para garantizar la compatibilidad. En ese caso, siga las instrucciones de esa actualización específica.
Migración de 3.10.0 a 4.0.0
El cambio principal de la versión 4.0.0 es la migración de Spring Boot 2.7 a Spring Boot 3.2 y de Tomcat 9 a Tomcat 10.
Cambios de código
En esta sección se enumeran los cambios necesarios para que el código modernizado sea compatible con AWS Transform for mainframe Runtime 4.0.0. Puede omitir esta sección si decide lanzar una nueva generación con la versión 4.0.0 de AWS Transform for mainframe refactor (Transformation Center).
Cambios en POM
| Group | ArtifactId | Cambio |
|---|---|---|
| org.slf4j | slf4j-api | Eliminación (es una dependencia transitiva) |
| org.yaml | snakeyaml | Eliminación (es una dependencia transitiva) |
| org.springframework.boot | spring-boot-starter-web | - Actualice spring.boot.version a la 3.2.4 - Elimine la exclusión de log4 4j j-to-slf |
| org.springframework.boot | spring-boot-starter-jta-atomikos | Cambiar a com.atomikos: 3-starter:6.0.0 transactions-spring-boot |
| org.apache.commons | commons-dbcp2 | Actualización a 2.10.0 |
| org.postgresql | postgreql | Actualización a 42.7.2 |
| com.microsoft.sqlserver | mssql-jdbc | Actualización a 12.4.2.jre11 |
| com.oracle.database.jdbc | ojdbc8 | Cambio a ojdbc11 versión 23.3.0.23.09 |
Migración de Javax a Yakarta
La actualización de Tomcat incluye una migración del paquete Java Javax a Jakarta. Asegúrese de actualizar las importaciones como corresponde de javax.* a jakarta.*.
Casi todas las clases antiguas de referencia en el paquete Javax se encuentran en Jakarta. Las excepciones conocidas para esto son los paquetes javax.sql y javax.xml, que siguen sin cambios.
Cambio de Atomikos
Debido al cambio de dependencia mencionado anteriormente, las referencias a org.springframework.boot.jta.atomikos.AtomikosDataSourceBean deben cambiarse a com.atomikos.spring.AtomikosDataSourceBean.
Eliminación del dialecto de PostgreSQL
Se elimina la clase personalizada PostgreSQLDialect.java. También se deben eliminar las referencias a ella en el iniciador principal.
AWS Despliegue (Transform for mainframe Runtime)
Tomcat
Esta versión es compatible con Tomcat 10.1.17. Es necesario actualizar el servidor Tomcat a esta versión para ejecutar el AWS Transform for mainframe Runtime. 4.0.0 Asegúrese de transferir los cambios de configuración anteriores (especialmente las propiedades de Catalina).
Dependencias compartidas
La carpeta compartida del motor de ejecución contiene las up-to-date dependencias.
Dependencias adicionales
Si ha usado dependencias adicionales (no incluidas en el tiempo de ejecución), es posible que tenga que actualizarlas. El archivo readme de la carpeta adicional muestra las versiones admitidas.
Migración de 5.85.0 a 5.125.0
El principal cambio de la versión 5.125.0 (versión preliminar alfa 5.86.0) (Versiones preliminares alfa) es la migración de Spring Boot 3.5.7 a Spring Boot 4.0.3+ y de Tomcat 10 a Tomcat 11+.
Cambios de código
En esta sección se enumeran los cambios necesarios para que el código modernizado sea compatible con Transform for mainframe Runtime 5.125.0. AWS Puede omitir esta sección si decide lanzar una nueva generación con la versión 5.125.0 de AWS Transform for mainframe Refactor (Transformation Center).
Cambios en POM
Actualice la versión Spring Boot:
<properties> <spring.boot.version>4.0.3</spring.boot.version> </properties>
spring-boot-starter-webSustitúyala porspring-boot-starter-webmvc:
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-webmvc</artifactId> <scope>provided</scope> </dependency>
Reorganización de paquetes
Debido al cambio de dependencias mencionado anteriormente, las referencias a:
-
org.springframework.boot.autoconfigure.domain.EntityScandebe cambiarse a.org.springframework.boot.persistence.autoconfigure.EntityScan -
org.springframework.boot.autoconfigure.jdbc.DataSourcePropertiesdebe cambiarse aorg.springframework.boot.jdbc.autoconfigure.DataSourceProperties.
Despliegue (AWS Transform for mainframe Runtime)
Tomcat
Esta versión es compatible con Tomcat 11.0.15+. Es necesario actualizar el servidor Tomcat a esta versión para ejecutar el AWS Transform for mainframe Runtime. 5.125.0 Asegúrese de transferir los cambios de configuración anteriores (especialmente las propiedades de Catalina).
Dependencias compartidas
La carpeta compartida del motor de ejecución contiene las up-to-date dependencias.
Dependencias adicionales
Si ha usado dependencias adicionales (no incluidas en el tiempo de ejecución), es posible que tenga que actualizarlas. El archivo readme de la carpeta adicional muestra las versiones admitidas.
