View a markdown version of this page

Instruções de atualização do AWS Transform for mainframe - AWS Mainframe Modernization

Após uma análise cuidadosa, tomamos a decisão de fechar o acesso de novos clientes à experiência autogerenciada de modernização de AWS mainframe, a partir de 30 de junho de 2026. Os clientes existentes podem continuar usando o serviço normalmente.AWS continua investindo em melhorias de segurança e disponibilidade para a experiência autogerenciada de modernização de AWS mainframe, mas não planejamos introduzir novos recursos. Para obter mais informações, consulte Alteração na disponibilidade AWS da modernização do mainframe.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

AWS O Mainframe Modernization Service (experiência em Managed Runtime Environment) não está mais aberto a novos clientes. Para recursos semelhantes ao AWS Mainframe Modernization Service (experiência em Managed Runtime Environment), explore o AWS Mainframe Modernization Service (Experience). Self-Managed Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte Alteração na disponibilidade AWS da modernização do mainframe.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Instruções de atualização do AWS Transform for mainframe

Esta página contém instruções para atualizar a versão AWS Transform for mainframe.

Atualizações comuns

Na maioria dos casos, ao atualizar a versão do AWS Transform for mainframe Runtime, você deve substituir os artefatos (arquivos de configuraçãoWARs, scripts etc.) da versão anterior pelos fornecidos na nova e reiniciar o aplicativo. Realize testes extensivos de regressão de suas aplicações modernizadas após a atualização. Você também pode entrar em contato com o gerente de entrega do AWS Transform for mainframe para obter instruções específicas aplicáveis ao seu aplicativo.

Algumas atualizações podem exigir configuração adicional para garantir a compatibilidade. Nesse caso, siga as instruções para essa atualização específica.

Migrar da 3.10.0 para 4.0.0

A principal mudança na versão 4.0.0 é a migração do Spring Boot 2.7 para o Spring Boot 3.2 e do Tomcat 9 para o Tomcat 10.

Alterações de código

Esta seção lista as alterações necessárias para tornar o código modernizado compatível com o AWS Transform for mainframe Runtime 4.0.0. Você pode pular esta seção se decidir lançar uma nova geração usando a versão 4.0.0 no AWS Transform for mainframe refactor (Transformation Center).

Alterações do POM

Group (Grupo) ArtifactId Alteração
org.slf4j slf4j-api Remover (é uma dependência transitiva)
org.yaml snakeyaml Remover (é uma dependência transitiva)
org.springframework.boot spring-boot-starter-web - Atualize spring.boot.version para 3.2.4 - Remova a exclusão do log4 4j j-to-slf
org.springframework.boot spring-boot-starter-jta-atômico Mude para com.atomikos: 3-starter:6.0.0 transactions-spring-boot
org.apache.commons commons-dbcp2 Atualizar para 2.10.0
org.postgresql postgreql Atualizar para 42.7.2
com.microsoft.sqlserver mssql-jdbc Atualizar para 12.4.2.jre11
com.oracle.database.jdbc ojdbc8 Alterar para ojdbc11 versão 23.3.0.23.09

Migrar de Javax para Jacarta

A atualização do tomcat vem com uma migração do pacote Java Javax para Jakarta. Atualize suas importações adequadamente de javax.* para jakarta.*.

Quase todas as classes antigas referenciadas no pacote Javax podem ser encontradas em Jakarta. As exceções conhecidas a isso são os pacotes javax.sql e javax.xml, que ainda não foram alterados.

Alteração de Atomikos

Devido à alteração de dependência mencionada acima, as referências a org.springframework.boot.jta.atomikos.AtomikosDataSourceBean devem ser alteradas para com.atomikos.spring.AtomikosDataSourceBean.

Remoção do dialeto do PostgreSQL

A classe personalizada PostgreSQLDialect.java é removida. As referências a ele no lançador principal também devem ser removidas.

Implantação (AWS transformação para tempo de execução do mainframe)

Tomcat

Essa versão é compatível com o Tomcat 10.1.17. É necessário atualizar o servidor Tomcat para essa versão para executar o AWS Transform for mainframe Runtime. 4.0.0 Faça a portabilidade das alterações de configuração antigas (principalmente as propriedades do Catalina).

Dependências compartilhadas

A pasta compartilhada em tempo de execução contém as up-to-date dependências.

Dependências extras

Se você usou dependências extras (não incluídas no runtime), talvez seja necessário atualizá-las. O arquivo readme na pasta extra lista as versões aceitas.

Migrando da 5.85.0 para a 5.125.0

A principal mudança no 5.125.0 (pré-lançamento alfa 5.86.0) (Pré-lançamentos alfa) é a migração do Spring Boot 3.5.7 para o Spring Boot 4.0.3+ e do Tomcat 10 para o Tomcat 11+.

Alterações de código

Esta seção lista as alterações necessárias para tornar o código modernizado compatível com o AWS Transform for mainframe Runtime 5.125.0. Você pode pular esta seção se decidir lançar uma nova geração usando a versão 5.125.0 no AWS Transform for mainframe refactor (Transformation Center).

Alterações do POM

Atualize a versão do Spring Boot:

<properties> <spring.boot.version>4.0.3</spring.boot.version> </properties>

spring-boot-starter-webSubstitua porspring-boot-starter-webmvc:

<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-webmvc</artifactId> <scope>provided</scope> </dependency>

Reorganização de pacotes

Devido à mudança de dependências mencionada acima, referências a:

  • org.springframework.boot.autoconfigure.domain.EntityScandeve ser alterado paraorg.springframework.boot.persistence.autoconfigure.EntityScan.

  • org.springframework.boot.autoconfigure.jdbc.DataSourcePropertiesdeve ser alterado paraorg.springframework.boot.jdbc.autoconfigure.DataSourceProperties.

Implantação (AWS transformação para tempo de execução do mainframe)

Tomcat

Essa versão é compatível com o Tomcat 11.0.15+. É necessário atualizar o servidor Tomcat para essa versão para executar o AWS Transform for mainframe Runtime. 5.125.0 Faça a portabilidade das alterações de configuração antigas (principalmente as propriedades do Catalina).

Dependências compartilhadas

A pasta compartilhada em tempo de execução contém as up-to-date dependências.

Dependências extras

Se você usou dependências extras (não incluídas no runtime), talvez seja necessário atualizá-las. O arquivo readme na pasta extra lista as versões aceitas.