AWS Layanan Modernisasi Mainframe (Managed Runtime Environment experience) tidak lagi terbuka untuk pelanggan baru. Untuk kemampuan yang mirip dengan Layanan Modernisasi AWS Mainframe (pengalaman Lingkungan Runtime Terkelola), jelajahi Layanan Modernisasi AWS Mainframe (Pengalaman yang Dikelola Sendiri). Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat Perubahan [AWS ketersediaan Modernisasi Mainframe](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Instruksi upgrade untuk AWS Transform untuk mainframe
Halaman ini berisi petunjuk untuk memutakhirkan AWS Transform untuk versi mainframe.
**Topics**
+ [Upgrade umum](#common-upgrades)
+ [Migrasi dari 3.10.0 ke 4.0.0](#3.10-to-4.0)
+ [Migrasi dari 5.85.0 ke 5.86.0](#5.85-to-5.86)
## Upgrade umum
Dalam sebagian besar kasus, saat memutakhirkan AWS Transform untuk versi Runtime mainframe, Anda harus mengganti artefak (WARs, file konfigurasi, skrip, dll.) dari versi sebelumnya dengan yang disediakan di yang baru dan restart aplikasi Anda. Pastikan untuk melakukan tes regresi ekstensif dari aplikasi modern Anda setelah Anda meng-upgrade. Anda juga dapat menghubungi manajer pengiriman AWS Transform for mainframe untuk instruksi spesifik yang berlaku untuk aplikasi Anda.
Beberapa upgrade mungkin memerlukan konfigurasi tambahan untuk memastikan kompatibilitas. Dalam hal ini, ikuti instruksi untuk peningkatan khusus itu.
## Migrasi dari 3.10.0 ke 4.0.0
Perubahan utama pada 4.0.0 adalah migrasi dari Spring Boot 2.7 ke Spring Boot 3.2 dan dari Tomcat 9 ke Tomcat 10.
### Perubahan kode
Bagian ini mencantumkan perubahan yang diperlukan untuk membuat kode modern kompatibel dengan AWS Transform for mainframe Runtime 4.0.0. Anda dapat melewati bagian ini jika memutuskan untuk meluncurkan generasi baru menggunakan versi 4.0.0 di AWS Transform untuk refactor mainframe (Pusat Transformasi).
**Perubahan POM**
| Kelompok | ArtifactId | Ubah |
| --- | --- | --- |
| org.slf4j | slf4j-api | Hapus (adalah ketergantungan transitif) |
| org.yaml | snakeyaml | Hapus (adalah ketergantungan transitif) |
| org.springframework.boot | spring-boot-starter-web | - Upgrade spring.boot.version ke 3.2.4 - Hapus pengecualian log4 4j j-to-slf |
| org.springframework.boot | spring-boot-starter-jta-atomikos | Ubah ke com.atomikos: 3-starter:6.0.0 transactions-spring-boot |
| org.apache.commons | umum-dbcp2 | Tingkatkan ke 2.10.0 |
| org.postgresql | postgreql | Tingkatkan ke 42.7.2 |
| com.microsoft.sqlserver | mssql-jdbc | Tingkatkan ke 12.4.2.jre11 |
| com.oracle.database.jdbc | ojdbc8 | Ubah ke ojdbc11 versi 23.3.0.23.09 |
**Bermigrasi dari Javax ke Jakarta**
Upgrade tomcat dilengkapi dengan migrasi dari paket Javax Java ke Jakarta. **Pastikan untuk memperbarui impor Anda dari javax.\$1 ke jakarta. **\$1.
Hampir semua kelas referensi lama dalam paket Javax dapat ditemukan di Jakarta. Pengecualian yang diketahui untuk ini adalah `javax.xml` paket `javax.sql` dan, yang masih tidak berubah.
**Atomikos berubah**
Karena perubahan ketergantungan yang dirujuk di atas, referensi `org.springframework.boot.jta.atomikos.AtomikosDataSourceBean` harus diubah menjadi. `com.atomikos.spring.AtomikosDataSourceBean`
**Penghapusan dialek PostgreSQL**
Kelas kustom `PostgreSQLDialect.java` dihapus. Referensi untuk itu di peluncur utama harus dihapus juga.
### Penerapan (AWS Transformasi untuk Runtime mainframe)
**Tomcat**
Versi ini kompatibel dengan Tomcat`10.1.17`. Memutakhirkan server Tomcat ke versi ini diperlukan untuk menjalankan Runtime. AWS Transform for mainframe `4.0.0` Pastikan untuk mem-port perubahan konfigurasi lama (terutama properti Catalina).
**Dependensi bersama**
Folder bersama runtime berisi up-to-date dependensi.
**Ketergantungan ekstra**
Jika Anda menggunakan dependensi tambahan (tidak disertakan pada runtime), Anda mungkin perlu memperbaruinya. File readme di folder tambahan mencantumkan versi yang didukung.
## Migrasi dari 5.85.0 ke 5.86.0
Perubahan utama di 5.86.0 ([Pra-rilis alfa](ba-versioning.md#ba-versioning-alpha)) adalah migrasi dari Spring Boot 3.5.7 ke Spring Boot 4.0.3 dan dari Tomcat 10 ke Tomcat 11.
### Perubahan kode
Bagian ini mencantumkan perubahan yang diperlukan untuk membuat kode modern kompatibel dengan AWS Transform for mainframe Runtime 5.86.0. Anda dapat melewati bagian ini jika Anda memutuskan untuk meluncurkan generasi baru menggunakan versi 5.86.0 di Blu Insights (Pusat Transformasi).
**Perubahan POM**
Perbarui versi Spring Boot:
```
4.0.3
```
Ganti `spring-boot-starter-web` dengan`spring-boot-starter-webmvc`:
```
org.springframework.boot
spring-boot-starter-webmvc
provided
```
**Package reorganisasi**
Karena perubahan dependensi yang direferensikan di atas, referensi ke:
+ `org.springframework.boot.autoconfigure.domain.EntityScan`harus diubah menjadi`org.springframework.boot.persistence.autoconfigure.EntityScan`.
+ `org.springframework.boot.autoconfigure.jdbc.DataSourceProperties`harus diubah menjadi`org.springframework.boot.jdbc.autoconfigure.DataSourceProperties`.
### Penerapan (AWS Transformasi untuk Runtime mainframe)
**Tomcat**
Versi ini kompatibel dengan Tomcat`11.0.15`. Memutakhirkan server Tomcat ke versi ini diperlukan untuk menjalankan Runtime. AWS Transform for mainframe `5.86.0` Pastikan untuk mem-port perubahan konfigurasi lama (terutama properti Catalina).
**Dependensi bersama**
Folder bersama runtime berisi up-to-date dependensi.
**Ketergantungan ekstra**
Jika Anda menggunakan dependensi tambahan (tidak disertakan pada runtime), Anda mungkin perlu memperbaruinya. File readme di folder tambahan mencantumkan versi yang didukung.