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 (experiência autogerenciada). 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](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).
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.
**Topics**
+ [Atualizações comuns](#common-upgrades)
+ [Migrar da 3.10.0 para 4.0.0](#3.10-to-4.0)
+ [Migrando da 5.85.0 para a 5.86.0](#5.85-to-5.86)
## 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.\$1 para jakarta.\$1**.
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.86.0
A principal mudança no 5.86.0 ([Pré-lançamentos alfa](ba-versioning.md#ba-versioning-alpha)) é 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.86.0. Você pode pular esta seção se decidir lançar uma nova geração usando a versão 5.86.0 no Blu Insights (Centro de Transformação).
**Alterações do POM**
Atualize a versão do Spring Boot:
```
4.0.3
```
`spring-boot-starter-web`Substitua por`spring-boot-starter-webmvc`:
```
org.springframework.boot
spring-boot-starter-webmvc
provided
```
**Reorganização de pacotes**
Devido à mudança de dependências mencionada acima, referências a:
+ `org.springframework.boot.autoconfigure.domain.EntityScan`deve ser alterado para`org.springframework.boot.persistence.autoconfigure.EntityScan`.
+ `org.springframework.boot.autoconfigure.jdbc.DataSourceProperties`deve ser alterado para`org.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.86.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.