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. # Mengatur AWS Transform untuk mainframe Runtime Bagian ini menjelaskan langkah-langkah untuk mengatur AWS Transform untuk mainframe Runtime pada infrastruktur Anda AWS . Sebelum Anda mengatur AWS Transform for mainframe Runtime untuk aplikasi, pahami prasyarat, wilayah, dan bucket, serta pengaturan CloudWatch alarm untuk mengonfigurasi dan mengelola lingkungan runtime Anda. **Topics** + [AWS Transform untuk prasyarat Runtime mainframe](ba-runtime-setup-prereq.md) + [AWS Transformasi Orientasi untuk Runtime mainframe](ba-runtime-setup-onboard.md) + [Persyaratan penyiapan infrastruktur untuk AWS Transform untuk mainframe Runtime](ba-infrastructure-setup.md) + [AWS Transformasi untuk artefak Runtime mainframe](ba-runtime-artifacts.md) + [Menerapkan AWS Transform untuk Runtime mainframe di Amazon EC2](ba-deploy-ec2.md) + [Menerapkan AWS Transform untuk Runtime mainframe pada container di Amazon ECS dan Amazon EKS](ba-deploy-container.md) + [Uji PlanetsDemo aplikasi](ba-runtime-test-planetsdemo.md) # AWS Transform untuk prasyarat Runtime mainframe AWS Transform untuk mainframe Runtime tersedia dalam beberapa versi [AWS Transform untuk catatan rilis mainframe](ba-release-notes.md) rilis. Jika Anda memiliki proyek modernisasi yang sedang berlangsung, Anda mungkin memerlukan versi tambahan dari runtime untuk tujuan implementasi dan pengujian. Untuk menentukan kebutuhan Anda, hubungi AWS Transform for mainframe delivery manager. Sebelum Anda mulai menggunakan AWS Transform for mainframe Runtime, lakukan hal berikut: + Pastikan Anda memiliki AWS akun. + Pastikan Anda memiliki aplikasi modern yang difaktorkan ulang dengan Transform untuk mainframe. AWS + Pilih AWS Region dan salah satu opsi komputasi yang didukung untuk AWS Transform for mainframe Runtime. + Pilih AWS Transform for mainframe Runtime versi yang ingin Anda gunakan. + Tinjau [Persyaratan penyiapan infrastruktur untuk AWS Transform untuk mainframe Runtime](ba-infrastructure-setup.md) dan validasi komponen tambahan yang diperlukan untuk menjalankan AWS Transform for mainframe Runtime. **catatan** [Jika Anda ingin menguji fitur AWS Transform untuk mainframe Runtime, Anda dapat menggunakan aplikasi demo`Planets Demo`, yang dapat Anda unduh dari PlanetsDemo -v1.zip.](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip) # AWS Transformasi Orientasi untuk Runtime mainframe **catatan** [Akses AWS Transform for mainframe Runtime telah beralih dari permintaan berbasis tiket ke unduhan langsung melalui AWS Transform untuk refactor mainframe.](https://bluinsights.aws/) Kami telah memperkenalkan cara baru dan disederhanakan untuk mengakses AWS Transform for mainframe produk melalui fitur [AWS Transform for mainframeToolbox](https://bluinsights.aws/docs/bluage-toolbox-introduction) di AWS Transform untuk refactor mainframe. Untuk memulai, buat [AWS Dukungan](https://support.console.aws.amazon.com/support/home)kasus untuk meminta orientasi mengakses AWS Transform for mainframe Runtime. Sertakan dalam permintaan Akun AWS ID Anda, AWS Wilayah yang ingin Anda gunakan, dan pilihan komputasi, dan AWS Transform untuk versi Runtime mainframe. Jika Anda tidak yakin versi mana yang Anda butuhkan, hubungi AWS Transform for mainframe delivery manager. Jika Anda sudah memiliki sumber kode aplikasi yang dihasilkan oleh alat Refactoring Modernisasi AWS Mainframe, catat nilai `gapwalk.version` tag ke dalam `pom.xml` file dalam basis kode modern Anda. **catatan** AWS Transform for mainframe Runtime tersedia dalam dua varietas utama: Alpha pre-release dan Releases. Untuk menentukan rilis mana yang akan digunakan, lihat[AWS Transformasi untuk pembuatan versi mainframe](ba-versioning.md), atau hubungi AWS Transform for mainframe delivery manager. ## Wilayah dan bucket untuk AWS Transform untuk Runtime mainframe Kami menyimpan artefak AWS Transform for mainframe Runtime di bucket Amazon S3 yang berbeda berdasarkan Wilayah dan dengan pilihan komputasi. Untuk mengakses bucket untuk AWS Transform Wilayah AWS for mainframe Runtime, gunakan nama yang tercantum dalam tabel berikut. | Wilayah AWS | Lepaskan ember | Ember pra-rilis alfa | | --- | --- | --- | | AS Timur (Ohio) | aws-bluage-runtime-artifacts-055777665268-us-timur-2 | aws-bluage-runtime-artifacts-dev-055777665268-us-timur-2 | | AS Timur (Virginia Utara) | aws-bluage-runtime-artifacts-139023371234-kita-timur-1 | aws-bluage-runtime-artifacts-dev-139023371234-kita-timur-1 | | AS Barat (California Utara) | aws-bluage-runtime-artifacts-788454048782-kita-barat-1 | aws-bluage-runtime-artifacts-dev-788454048782-kita-barat-1 | | AS Barat (Oregon) | aws-bluage-runtime-artifacts-836771190483-kita-barat-2 | aws-bluage-runtime-artifacts-dev-836771190483-kita-barat-2 | | Kanada (Pusat) | aws-bluage-runtime-artifacts-637423580979-ca-pusat-1 | aws-bluage-runtime-artifacts-dev-637423580979-ca-pusat-1 | | Eropa (Irlandia) | aws-bluage-runtime-artifacts-925278190477-eu-barat-1 | aws-bluage-runtime-artifacts-dev-925278190477-eu-barat-1 | | Eropa (London) | aws-bluage-runtime-artifacts-767397831990-eu-barat-1 | aws-bluage-runtime-artifacts-dev-767397831990-eu-barat-1 | | Eropa (Paris) | aws-bluage-runtime-artifacts-673009995881-eu-barat-3 | aws-bluage-runtime-artifacts-dev-673009995881-eu-barat-3 | | Eropa (Frankfurt) | aws-bluage-runtime-artifacts-485196800481-eu-pusat-1 | aws-bluage-runtime-artifacts-dev-485196800481-eu-pusat-1 | | Eropa (Stockholm) | aws-bluage-runtime-artifacts-654654484534-eu-utara-1 | aws-bluage-runtime-artifacts-dev-654654484534-eu-utara-1 | | Europe (Milan) | aws-bluage-runtime-artifacts-654654328338-eu-selatan-1 | aws-bluage-runtime-artifacts-dev-654654328338-eu-selatan-1 | | Eropa (Spanyol) | aws-bluage-runtime-artifacts-905417994954-eu-selatan-2 | aws-bluage-runtime-artifacts-dev-905417994954-eu-selatan-2 | | Amerika Selatan (Sao Paulo) | aws-bluage-runtime-artifacts-737536804457-sa-timur-1 | aws-bluage-runtime-artifacts-dev-737536804457-sa-timur-1 | | Asia Pasifik (Tokyo) | aws-bluage-runtime-artifacts-445578176276-ap-timur laut-1 | aws-bluage-runtime-artifacts-dev-445578176276-ap-timur laut-1 | | Asia Pasifik (Seoul) | aws-bluage-runtime-artifacts-381492221498-ap-timur laut-2 | aws-bluage-runtime-artifacts-dev-381492221498-ap-timur laut-2 | | Asia Pasifik (Osaka) | aws-bluage-runtime-artifacts-905418229615-ap-timur laut-3 | aws-bluage-runtime-artifacts-dev-905418229615-ap-timur laut-3 | | Asia Pasifik (Singapura) | aws-bluage-runtime-artifacts-767397774613-ap-tenggara | aws-bluage-runtime-artifacts-dev-767397774613-ap-tenggara | | Asia Pasifik (Sydney) | aws-bluage-runtime-artifacts-726160321909-ap-tenggara-2 | aws-bluage-runtime-artifacts-dev-726160321909-ap-tenggara-2 | | Asia Pasifik (Mumbai) | aws-bluage-runtime-artifacts-905418353577-ap-selatan-1 | aws-bluage-runtime-artifacts-dev-905418353577-ap-selatan-1 | | Africa (Cape Town) | aws-bluage-runtime-artifacts-992382777663-af-selatan-1 | aws-bluage-runtime-artifacts-dev-992382777663-af-selatan-1 | | Israel (Tel Aviv) | aws-bluage-runtime-artifacts-471112516508-il-pusat-1 | aws-bluage-runtime-artifacts-dev-471112516508-il-pusat-1 | ## Menggunakan AWS CLI untuk mencantumkan isi ember Setelah Anda onboard, Anda dapat membuat daftar isi bucket dengan menjalankan AWS CLI perintah berikut di terminal. `aws s3 ls bucket-name ` Ganti `bucket-name` dengan nama ember untuk Anda Wilayah AWS dari tabel sebelumnya. Perintah ini menampilkan daftar folder yang sesuai dengan versi runtime AWS Transform for mainframe Runtime yang berbeda, seperti berikut untuk bucket Release: ``` PRE 4.0.0/ PRE 4.10.0/ ``` Atau berikut ini untuk ember build: ``` PRE 4.11.0/ PRE 4.13.0/ ``` Kami menyarankan Anda menggunakan versi terbaru yang tersedia. Jika itu tidak memungkinkan, gunakan versi runtime yang divalidasi selama fase refactoring aplikasi. Untuk membuat daftar kerangka kerja yang tersedia untuk versi tertentu, jalankan perintah berikut: `aws s3 ls s3://bucket-name/version/Framework/` Ganti `bucket-name` dengan nama ember untuk Anda Wilayah AWS dan `version` dengan versi yang Anda inginkan. Berikut ini adalah dua contoh. Untuk ember rilis: `aws s3 ls s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.10.0/Framework/` Perintah mengembalikan daftar file zip, seperti: ``` 2025-04-08 16:11:19 152040176 aws-bluage-runtime-4.10.0.zip 2025-04-08 16:11:52 176518889 aws-bluage-webapps-4.10.0.zip ``` Untuk bucket pra-rilis Alpha: `aws s3 ls s3://aws-bluage-runtime-artifacts-dev-139023371234-us-east-1/4.11.0/Framework/` Perintah mengembalikan daftar file zip, seperti: ``` 2025-04-09 20:23:34 152304534 aws-bluage-runtime-4.11.0.zip 2025-04-09 20:24:07 176262381 aws-bluage-webapps-4.11.0.zip ``` ## Unduh kerangka kerja Anda dapat mengunduh kerangka kerja misalnya untuk memutakhirkan versi AWS Transform for mainframe Runtime pada instans Amazon EC2 yang ada. `aws s3 cp s3://bucket-name/version/Framework/ folder-of-your-choice --recursive ` Di mana: folder-of-your-choice jalur folder tempat Anda ingin mengunduh kerangka kerja. Misalnya: `aws s3 cp s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.0.0/Framework/ . --recursive` Perintah ini menghasilkan output berikut ini: ``` download: s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.0.0/Framework/aws-bluage-webapps-4.0.0.zip to ./aws-bluage-webapps-4.0.0.zip download: s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.0.0/Framework/aws-bluage-runtime-4.0.0.zip to ./aws-bluage-runtime-4.0.0.zip ``` Anda dapat membuat daftar file kerangka kerja sebagai berikut: `ls -l` Perintah ini menghasilkan output berikut ini: ``` total 230928 -rw-rw-r-- 1 cloudshell-user cloudshell-user 152040176 Apr 8 16:11 aws-bluage-runtime-4.0.0.zip -rw-rw-r-- 1 cloudshell-user cloudshell-user 176518889 Apr 8 16:11 aws-bluage-webapps-4.0.0.zip ``` **catatan** Akses ke artefak dapat terganggu sementara, dan versi dapat dihapus untuk alasan keamanan. Kami sangat menyarankan Anda menyimpan artefak yang Anda gunakan di akun Anda sendiri. Versi lokal harus digunakan untuk referensi dalam arsitektur internal Anda. # Persyaratan penyiapan infrastruktur untuk AWS Transform untuk mainframe Runtime Topik ini menjelaskan konfigurasi infrastruktur minimum yang diperlukan untuk menjalankan AWS Transform for mainframe Runtime. Prosedur berikut menjelaskan cara mengatur AWS Transform untuk mainframe Runtime pada komputasi pilihan Anda untuk menerapkan aplikasi modern pada Transform for mainframe Runtime. AWS Sumber daya yang Anda buat harus berada di VPC Amazon yang memiliki subnet yang didedikasikan untuk domain aplikasi Anda. **Topics** + [Persyaratan infrastruktur](#infrastructure-requirements) + [Menjalankan AWS Transform untuk Runtime mainframe di Amazon EC2](#ba-running-on-ec2) + [Menjalankan AWS Transform untuk Runtime mainframe di Amazon ECS di Amazon EC2](#ba-running-on-ecs-on-ec2) + [Menjalankan AWS Transform untuk Runtime mainframe di Amazon EKS di Amazon EC2](#ba-running-on-eks-on-ec2) + [Menjalankan AWS Transform untuk Runtime mainframe di Amazon ECS yang dikelola oleh AWS Fargate](#ba-running-on-fargate) ## Persyaratan infrastruktur **Membuat grup keamanan** Jika Anda berencana untuk bekerja pada instans Amazon EC2 di Amazon EKS, lewati prosedur ini karena proses pembuatan klaster Amazon EKS membuat grup keamanan atas nama Anda. Gunakan grup keamanan itu dalam prosedur berikut alih-alih membuat yang baru. 1. Buka konsol VPC Amazon di. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/) 1. Di panel navigasi kiri, di bawah **Keamanan**, pilih **Grup keamanan**. 1. Di panel tengah, pilih **Buat grup keamanan**. 1. Di bidang **Nama grup keamanan**, masukkan**M2BluagePrivateLink-SG**. 1. Di bagian **Aturan masuk**, pilih **Tambahkan aturan**. 1. Untuk **Type**, pilih HTTPS. 1. Untuk **Sumber**, masukkan CIDR VPC Anda. 1. Di bagian **Aturan keluar**, pilih **Tambahkan aturan**. 1. Untuk **Type**, pilih HTTPS. 1. Untuk **Tujuan**, masukkan**0.0.0.0/0**. 1. Pilih **Buat grup keamanan**. **Membuat peran IAM** 1. Buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Di panel navigasi kiri, di bawah **Manajemen akses**, pilih **Peran**. 1. Di panel tengah, pilih **Buat peran**. 1. Di bagian **Use case**, tergantung pada pilihan komputasi Anda, pilih salah satu dari berikut ini: + **EC2** (untuk Amazon EC2 dan Amazon EKS di Amazon EC2) + **Layanan Kontainer Elastis** dan kemudian **Peran EC2 untuk Layanan Kontainer Elastis** (untuk Amazon ECS di Amazon EC2) + **Layanan Kontainer Elastis** **dan kemudian Tugas Layanan Kontainer** Elastis (untuk Amazon ECS yang dikelola oleh Fargate) 1. Pilih **Berikutnya**. 1. Masukkan nama peran, lalu pilih **Buat peran**. ## Menjalankan AWS Transform untuk Runtime mainframe di Amazon EC2 Untuk membuat instans Amazon EC2, gunakan langkah-langkah berikut. **Membuat instans Amazon EC2** 1. Buka konsol Amazon EC2 di. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) 1. Pilih **Luncurkan instans**. 1. Untuk **jenis Instance**, pilih jenis instans EC2 yang tersedia. 1. Di bagian **Key pair**, pilih key pair yang ada atau buat yang baru. 1. Di bagian **Pengaturan jaringan**, **pilih Pilih grup keamanan yang ada**. 1. Untuk **grup keamanan umum**, pilih **M2 BluagePrivateLink -SG**. 1. Perluas bagian **Detail lanjutan**. 1. Untuk **profil instans IAM**, pilih peran IAM yang Anda buat sebelumnya. 1. Pilih **Luncurkan instans**. **Instal aplikasi pada instans Amazon EC2** 1. Saat status instans Amazon EC2 berubah menjadi **Running**, sambungkan ke instans. 1. Instal komponen perangkat lunak berikut pada instance (Lihat versi yang disebutkan ke dalam[AWS Transform untuk catatan rilis mainframe](ba-release-notes.md)): + Lingkungan Runtime Java (JRE). + Apache Tomcat. + AWS Transformasi untuk Runtime mainframe (di Amazon EC2). Instal AWS Transform for mainframe runtime di root folder instalasi Apache Tomcat (beberapa file akan ditambahkan sementara yang lain akan ditimpa). Untuk menginstal aplikasi web tambahan yang dikirimkan bersama arsip AWS Transform for mainframe Runtime, siapkan instance sekunder dari server Apache Tomcat, dan dekompresi arsip webapps di lokasi tersebut. Untuk petunjuk mendetail, lihat [AWS Transformasi untuk artefak Runtime mainframe](ba-runtime-artifacts.md). ## Menjalankan AWS Transform untuk Runtime mainframe di Amazon ECS di Amazon EC2 1. Buat klaster Amazon ECS, dengan instans **Amazon EC2** sebagai infrastruktur dasar. Lihat [Memulai Windows di Amazon EC2](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/getting-started-ecs-ec2-v2.html#getting-started-ec2-cluster-v2) di Panduan Pengembang Layanan Amazon Elastic Container. 1. Tentukan peran IAM yang Anda buat di langkah sebelumnya. 1. Pilih jenis instans EC2. 1. Di **Pengaturan jaringan untuk instans Amazon EC2**, pilih grup keamanan yang Anda buat di langkah sebelumnya. ## Menjalankan AWS Transform untuk Runtime mainframe di Amazon EKS di Amazon EC2 1. Buat klaster Amazon EKS. Lihat [Membuat klaster Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/create-cluster.html) di *Panduan Pengguna Amazon EKS*. 1. Seperti disebutkan sebelumnya, grup keamanan dibuat atas nama Anda. 1. Buat grup simpul. Tentukan peran IAM yang Anda buat di langkah sebelumnya. 1. Pilih jenis instans EC2. 1. Amazon EKS akan secara otomatis menetapkan grup keamanan ke instans Amazon EC2 yang muncul. ## Menjalankan AWS Transform untuk Runtime mainframe di Amazon ECS yang dikelola oleh AWS Fargate Buat klaster Amazon ECS dengan **AWS Fargate (tanpa server**) sebagai infrastruktur yang mendasarinya. Lihat [Memulai Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/getting-started-fargate.html) di Panduan *Pengembang Layanan Kontainer Elastis Amazon*. # AWS Transformasi untuk artefak Runtime mainframe AWS Transform untuk artefak Runtime mainframe adalah komponen untuk menerapkan dan menjalankan aplikasi modern. Dokumen ini menguraikan berbagai jenis artefak yang tersedia, lokasi penyimpanannya, dan cara mengaksesnya. ## AWS Transformasi untuk artefak Runtime mainframe ### Isi artefak Di bucket Rilis dan Pra-rilis, Anda akan menemukan: **gapwalk-xyz.zip** Arsip ini, di mana x.y.z mewakili nomor versi (lihat [AWS Transform untuk pembuatan versi mainframe), berisi komponen inti Transform for mainframe](https://docs.aws.amazon.com/m2/latest/userguide/ba-versioning.html) Runtime yang penting untuk menjalankan AWS Transform untuk aplikasi mainframe, termasuk: AWS | Artifact | Deskripsi | Tipe | Folder Distribusi | | --- | --- | --- | --- | | gapwalk-application-x.y.z.war | AWS Transform for mainframeaplikasi web utama Gapwalk | Perang | aplikasi web | | \$1.toples | AWS Transform for mainframePerpustakaan Bersama Runtime Framework (Gapwalk) | Stoples | bersama | | gapwalk-\$1-x.y.z.war | AWS Transform for mainframeaplikasi web tambahan (utilitas-pgm, dukungan hierarkis,...) | Perang | webapps-ekstra | | bac-x.y.z.war/jac-x.y.z.war | AWS Transform for mainframeKonsol Administrasi (non-mandiri) | Perang | webapps-konsol | **aws-bluage-webapps-x.y.z.zip** Arsip ini, di mana xy.z mengikuti skema versi yang sama seperti di atas, termasuk AWS Transform for mainframe Konsol Administrasi (mandiri) + **BAC** (Blusamkonsol) WAR file, yang digunakan untuk memantau Blusam database. + File WAR **JAC** (JICS console), digunakan untuk memantau database JICS. + Perpustakaan pendukung yang diperlukan. ### Verifikasi Tanda Tangan Paket File zip yang dirilis disediakan sebagai arsip ZIP yang ditandatangani secara digital untuk memastikan keamanan dan keaslian. Tanda tangan digital membantu memverifikasi bahwa file yang Anda unduh asli, tidak diubah, dan dirilis secara resmi oleh organisasi kami. Ini mencegah gangguan dan melindungi terhadap malware atau file yang disusupi yang dapat didistribusikan secara jahat. Untuk memverifikasi tanda tangan file ZIP sebelum menggunakannya, Anda dapat menggunakan perintah berikut: `jarsigner -verify -certs -verbose aws-bluage-runtime-x.y.z.zip` Berikut contoh hasil untuk file bersertifikat: ``` ... jar verified. ``` Untuk detail tentang cara mengatasi kerentanan keamanan, lihat [AWS Mainframe Modernization Refactor](https://docs.aws.amazon.com/m2/latest/userguide/lifecycle-m2.html#lifecycle-ba-overview) dengan ikhtisar rilis. AWS Transform for mainframe **catatan** Sementara kami berusaha untuk merilis produk kami tanpa CVEs, baru CVEs mungkin muncul nanti. # Menerapkan AWS Transform untuk Runtime mainframe di Amazon EC2 Anda dapat mempelajari cara mengatur AWS Transform for mainframe Runtime di Amazon EC2, cara memperbarui versi runtime, cara memantau penerapan menggunakan alarm CloudWatch Amazon, dan cara menambahkan dependensi berlisensi dengan topik di bagian ini. Petunjuk ini berlaku saat Anda membuat instans Amazon EC2 serta saat Anda menggunakan Amazon ECS di Amazon EC2 atau Amazon EKS di Amazon EC2. Dimulai dengan versi alfa 5.60.0, AWS Transform untuk distribusi Runtime mainframe menyertakan folder penerapan dengan file README.md yang komprehensif. Panduan ini menyediakan petunjuk penerapan step-by-step Amazon EC2, opsi konfigurasi, dan tips pemecahan masalah. **Topics** + [Mengatur AWS Transform untuk Runtime mainframe di Amazon EC2](ba-runtime-deploy-ec2.md) + [Tingkatkan AWS Transform untuk Runtime mainframe di Amazon EC2](ba-runtime-maint-ec2.md) + [Mengatur AWS Transform untuk mainframe Runtime (di Amazon EC2) alarm Amazon CloudWatch](ba-cw-alarms-ec2.md) + [Siapkan dependensi berlisensi di AWS Transform untuk Runtime mainframe di Amazon EC2](ba-runtime-dependencies-ec2.md) # Mengatur AWS Transform untuk Runtime mainframe di Amazon EC2 Topik ini menjelaskan cara menyiapkan dan menerapkan aplikasi PlanetsDemo sampel menggunakan AWS Transform for mainframe Runtime di Amazon EC2. **Topics** + [Prasyarat](#ba-runtime-deploy-prereq) + [Menyiapkan](#ba-runtime-deploy-setup) + [Uji aplikasi yang digunakan](#ba-runtime-deploy-test) ## Prasyarat Sebelum Anda mulai, pastikan Anda menyelesaikan prasyarat berikut. + Konfigurasikan AWS CLI dengan mengikuti langkah-langkah dalam [Mengonfigurasi AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html). + Lengkap [AWS Transform untuk prasyarat Runtime mainframe](ba-runtime-setup-prereq.md) dan[AWS Transformasi Orientasi untuk Runtime mainframe](ba-runtime-setup-onboard.md). + Buat instans Amazon EC2 menggunakan salah satu jenis instans yang didukung. Untuk informasi selengkapnya, lihat [Memulai instans Amazon EC2 Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html). + Pastikan Anda dapat terhubung ke instans Amazon EC2 dengan sukses, misalnya dengan menggunakan SSM. **catatan** Sepanjang panduan ini, jalur instalasi Tomcat diasumsikan. `/m2-anywhere/tomcat-gapwalk/velocity` Pastikan Anda menggunakan jalur ini saat mengikuti petunjuk di bawah ini atau sesuaikan instruksi berikut dengan jalur pilihan Anda. + Unduh dan ekstrak AWS Transform untuk mainframe Runtime (di Amazon EC2) langsung ke `/m2-anywhere/tomcat-gapwalk/velocity` direktori velocity (folder instalasi Tomcat). Untuk petunjuk tentang cara mengambil artefak AWS Transform for mainframe Runtime, termasuk informasi tentang penyimpanan, akses, dan konten, lihat. [AWS Transformasi untuk artefak Runtime mainframe](ba-runtime-artifacts.md) + Unduh [arsip PlanetsDemo aplikasi](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip). + Buka zip arsip dan unggah aplikasi ke ember Amazon S3 pilihan Anda. + Buat database Amazon Aurora PostgreSQL untuk JICS. AWS Transform for mainframe Runtime akan secara otomatis mengeksekusi `PlanetsDemo-v1/jics/sql/initJics.sql` script selama startup pertama. Untuk informasi tentang cara membuat database PostgreSQL Amazon Aurora, lihat Membuat dan [menghubungkan ke](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster) klaster DB PostgreSQL Aurora. ## Menyiapkan Untuk mengatur aplikasi PlanetsDemo sampel, selesaikan langkah-langkah berikut. 1. Hubungkan ke instans Amazon EC2 Anda dan buka `conf` folder di bawah folder instalasi Apache Tomcat Anda. Buka `catalina.properties` file untuk diedit dan ganti baris yang dimulai `common.loader` dengan baris berikut. ``` common.loader="${catalina.base}/lib","${catalina.base}/lib/*.jar","${catalina.home}/lib","${catalina.home}/lib/*.jar","${catalina.home}/shared","${catalina.home}/shared/*.jar","${catalina.home}/extra","${catalina.home}/extra/*.jar" ``` 1. Arahkan ke `/m2-anywhere/tomcat-gapwalk/velocity/webapps` folder. 1. Salin PlanetsDemo binari yang tersedia di `PlanetsDemo-v1/webapps/` folder dari bucket Amazon S3 menggunakan perintah berikut. ``` aws s3 cp s3://path-to-demo-app-webapps/ . --recursive ``` **catatan** Ganti `path-to-demo-app-webapps` dengan URI Amazon S3 yang benar untuk bucket tempat Anda membuka ritsleting arsip sebelumnya. PlanetsDemo 1. Salin konten `PlanetsDemo-v1/config/` folder ke`/m2-anywhere/tomcat-gapwalk/velocity/config/`. 1. Berikan informasi koneksi untuk database yang Anda buat sebagai bagian dari prasyarat dalam cuplikan berikut dalam file. `/m2-anywhere/tomcat-gapwalk/velocity/config/application-main.yml` Untuk informasi selengkapnya lihat, [Membuat dan menghubungkan ke klaster DB PostgreSQL Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster). ``` datasource: jicsDs: driver-class-name : url: username: password: type : ``` 1. Mulai server Apache Tomcat Anda dan verifikasi log. ``` /m2-anywhere/tomcat-gapwalk/velocity/startup.sh tail -f /m2-anywhere/tomcat-gapwalk/velocity/logs/catalina.log ``` Jika Anda menemukan kode kesalahan yang dimulai dengan C diikuti oleh angka, seperti CXXXX, perhatikan pesan kesalahan. Misalnya, kode kesalahan C5102 adalah kesalahan umum yang menunjukkan konfigurasi infrastruktur yang salah. ## Uji aplikasi yang digunakan Untuk contoh cara menguji PlanetsDemo aplikasi, lihat[Uji PlanetsDemo aplikasi](ba-runtime-test-planetsdemo.md). # Tingkatkan AWS Transform untuk Runtime mainframe di Amazon EC2 Panduan ini menjelaskan cara memutakhirkan AWS Transform for mainframe Runtime di Amazon EC2. **Topics** + [Prasyarat](#ba-runtime-maint-prereq) + [Upgrade AWS Transform untuk Runtime mainframe di instans Amazon EC2](#ba-runtime-maint-copy-files) + [Tingkatkan AWS Transform untuk Runtime mainframe dalam sebuah wadah](#ba-runtime-maint-copy-files) ## Prasyarat Sebelum Anda mulai, pastikan Anda memenuhi prasyarat berikut. + Untuk memeriksa apakah ada instruksi khusus untuk versi Anda, lihat[Instruksi upgrade untuk AWS Transform untuk mainframe](ba-migration-notes.md). + Lengkap [AWS Transform untuk prasyarat Runtime mainframe](ba-runtime-setup-prereq.md) dan[AWS Transformasi Orientasi untuk Runtime mainframe](ba-runtime-setup-onboard.md). + Pastikan Anda memiliki instans Amazon EC2 dengan instalasi AWS Transform for mainframe Runtime yang sudah ada. Untuk informasi selengkapnya, lihat [Memulai instans Amazon EC2 Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html). + Pastikan Anda dapat terhubung ke instans Amazon EC2 dengan sukses, misalnya, dengan menggunakan SSM. + Unduh AWS Transform for mainframe Runtime versi yang ingin Anda tingkatkan. Kerangka kerja terdiri dari dua file arsip: `gapwalk-x.y.z.zip` dan`aws-bluage-webapps-x.y.z.zip`. Untuk informasi selengkapnya, lihat [AWS Transformasi untuk artefak Runtime mainframe](ba-runtime-artifacts.md). ## Upgrade AWS Transform untuk Runtime mainframe di instans Amazon EC2 Selesaikan langkah-langkah berikut untuk memutakhirkan AWS Transform for mainframe Runtime. 1. Connect ke instans Amazon EC2 Anda dan ubah pengguna ke **su** dengan menjalankan perintah berikut. ``` sudo su ``` Anda memerlukan hak superuser untuk menjalankan perintah dalam tutorial ini. 1. Untuk mengekstrak binari, gunakan perintah berikut. Jalankan perintah di setiap folder. ``` unzip gapwalk-x.y.z.zip unzip aws-bluage-webapps-x.y.z.zip ``` 1. Hentikan layanan Apache Tomcat dengan menggunakan perintah berikut. ``` systemctl stop tomcat.service systemctl stop tomcat-webapps.service ``` 1. Ganti konten `/shared/` dengan konten`gapwalk-x.y.z/shared/`. 1. Ganti `/webapps/gapwalk-application.war` dengan`gapwalk-x.y.z/webapps/gapwalk-application.war`. 1. Ganti file perang di`/webapps/`, yaitu `bac.war` dan`jac.war`, dengan file yang sama dari`aws-bluage-webapps-x.y.z/velocity/webapps/`. 1. Mulai layanan Apache Tomcat dengan menjalankan perintah berikut. ``` systemctl start tomcat.service systemctl start tomcat-webapps.service ``` 1. Periksa log. Untuk memeriksa status aplikasi yang digunakan, jalankan perintah berikut. ``` curl http://localhost:8080/gapwalk-application/ ``` Pesan berikut akan muncul. ``` Jics application is running ``` ``` curl http://localhost:8181/jac/api/services/rest/jicsservice/ ``` Pesan berikut akan muncul. ``` Jics application is running ``` ``` curl http://localhost:8181/bac/api/services/rest/bluesamserver/serverIsUp ``` Responsnya harus kosong. AWS Transform untuk runtime mainframe berhasil ditingkatkan. ## Tingkatkan AWS Transform untuk Runtime mainframe dalam sebuah wadah Selesaikan langkah-langkah berikut untuk memutakhirkan AWS Transform for mainframe Runtime. 1. Bangun kembali gambar Docker Anda dengan AWS Transform yang diinginkan untuk versi Runtime mainframe. Untuk petunjuk, lihat [Mengatur AWS Transform untuk Runtime mainframe di Amazon EC2](ba-runtime-deploy-ec2.md). 1. Dorong gambar Docker Anda ke repositori Amazon ECR Anda. 1. Hentikan dan mulai ulang layanan Amazon ECS atau Amazon EKS Anda. 1. Periksa log. AWS Transform for mainframe Runtime berhasil ditingkatkan. # Mengatur AWS Transform untuk mainframe Runtime (di Amazon EC2) alarm Amazon CloudWatch Anda dapat mengatur CloudWatch untuk menerima log aplikasi Anda dan menambahkan alarm untuk memperingatkan Anda tentang kemungkinan kesalahan. Ini memungkinkan Anda untuk memiliki notifikasi yang lebih terlihat setiap kali aplikasi yang Anda gunakan menemukan pengecualian. Bagian berikut membantu Anda memahami dan mempelajari tentang konfigurasi CloudWatch pencatatan dan pengaturan alarm. ## Aktifkan CloudWatch pencatatan Untuk mengaktifkan CloudWatch logging, buat `logback-cloudwatch.xml` file di folder konfigurasi menggunakan templat konfigurasi yang disediakan di bagian berikut. Kemudian, rujuk file ini dalam `application-main.yml` file dengan menghapus komentar baris berikut: ``` # logging: # config: classpath:logback-cloudwatch.xml ``` Setelah menghapus komentar baris ini, CloudWatch logging akan diaktifkan dan dapat dikonfigurasi lebih lanjut seperti yang dijelaskan di bagian berikut. ## Konfigurasi CloudWatch logging Gunakan template berikut untuk membuat `logback-cloudwatch.xml` file: ``` %date{yyyy-MM-dd HH:mm:ss.SSS,UTC} %level --- [%thread{15}] %logger{40} : %msg%n%xThrowable BluAgeRuntimeOnEC2-Logs %date{yyyy-MM-dd,UTC}.%instanceId.%uuid %date{yyyy-MM-dd HH:mm:ss.SSS,UTC} %level --- [%thread{15}] %logger{40} : %msg%n%xThrowable ``` Segala sesuatu di luar elemen adalah konfigurasi logback standar. Ada dua appender dalam file ini: appender konsol untuk mengirim log ke konsol dan CloudWatch appender untuk mengirim log ke. CloudWatch `level`Atribut dalam `root` elemen menentukan tingkat logging dari seluruh aplikasi. Nilai yang diperlukan di dalam tag adalah: + :Menetapkan nama grup log di CloudWatch. Jika nilai tidak ditentukan, defaultnya. `BluAgeRuntimeOnEC2-Logs` Jika grup log tidak ada maka akan dibuat secara otomatis. Perilaku ini dapat diubah melalui konfigurasi, yang dibahas di bawah ini. + : Menetapkan nama LogStream (di dalam grup log) di. CloudWatch Nilai opsional: + : Mengganti Wilayah tempat aliran log akan ditulis. Secara default, log masuk ke Wilayah yang sama dengan instans EC2. + : Pola pesan log akan digunakan. + : Jumlah maksimum pesan log untuk dikirim CloudWatch per operasi. + : Waktu dalam milidetik untuk memungkinkan CloudWatch log ditulis. + : Waktu dalam milidetik untuk mencoba memasukkan permintaan dalam antrian log internal. + : Ukuran maksimum antrian internal. + : Buat grup log dan aliran log jika tidak ada. + : Jumlah waktu yang Anda inginkan thread untuk tidur saat startup. Penantian awal ini memungkinkan akrual awal log. + : Ukuran maksimum peristiwa log. Log yang melebihi ukuran ini tidak akan dikirim. + : Memutus pesan yang terlalu panjang. + : Aktifkan appender darurat. ## CloudWatch penyiapan Agar konfigurasi di atas dapat mendorong log dengan benar CloudWatch, perbarui peran profil instans Amazon EC2 IAM Anda untuk memberinya izin tambahan untuk grup log `BluAgeRuntimeOnEC2-Logs` dan aliran lognya: + `logs:CreateLogStream` + `logs:DescribeLogStreams` + `logs:CreateLogGroup` + `logs:PutLogEvents` + `logs:DescribeLogGroups` ## Pengaturan alarm Berkat CloudWatch log, Anda kemudian dapat mengonfigurasi metrik dan alarm yang berbeda, tergantung pada aplikasi dan kebutuhan Anda. Secara khusus, Anda dapat mengatur alarm proaktif untuk peringatan penggunaan, agar diperingatkan jika terjadi kesalahan yang mungkin menempatkan aplikasi Anda dalam masa tenggang (dan pada akhirnya, mencegahnya berfungsi sama sekali). Untuk mencapai ini, Anda dapat menambahkan metrik mengenai string “Kesalahan C5001" di log, yang menyoroti kesalahan dalam koneksi ke AWS Transform untuk sistem kontrol mainframe. Anda kemudian dapat menentukan alarm yang bereaksi terhadap metrik ini. # Siapkan dependensi berlisensi di AWS Transform untuk Runtime mainframe di Amazon EC2 Panduan ini menjelaskan cara menyiapkan dependensi berlisensi tambahan yang dapat Anda gunakan dengan AWS Transform for mainframe Runtime di Amazon EC2. **Topics** + [Prasyarat](#ba-runtime-dependencies-prereq) + [Langkah-langkah instalasi](#ba-runtime-dependencies-overview) ## Prasyarat Sebelum Anda mulai, pastikan Anda menyelesaikan prasyarat berikut. + Lengkap [AWS Transform untuk prasyarat Runtime mainframe](ba-runtime-setup-prereq.md) dan[AWS Transformasi Orientasi untuk Runtime mainframe](ba-runtime-setup-onboard.md). + Pastikan Anda memiliki instans Amazon EC2 dengan AWS Transform for mainframe Runtime (di Amazon EC2) diinstal. Untuk informasi selengkapnya, lihat [Memulai instans Amazon EC2 Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html). + Pastikan Anda dapat terhubung ke instans Amazon EC2 dengan sukses, misalnya, dengan menggunakan SSM. + Dapatkan dependensi berikut dari sumbernya. ### Basis data Oracle Menyediakan [driver database Oracle](https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html). Kami menguji fungsionalitas AWS Transform for mainframe Runtime (di Amazon EC2) dengan **versi ojdbc11-23.3.0.23.09.jar, tetapi versi** yang lebih baru mungkin kompatibel. ### Koneksi IBM MQ Menyediakan klien [IBM MQ](https://www.ibm.com/support/pages/mqc91-ibm-mq-clients). Kami menguji fungsionalitas AWS Transform for mainframe Runtime (di Amazon EC2) dengan **versi com.ibm.mq.jakarta.client-9.3.4.1.jar, tetapi versi** yang lebih baru mungkin kompatibel. Dengan versi dependensi ini, berikan juga dependensi transitif berikut: + bcprov-jdk15to18-1.76.jar + bcpkix-jdk15to18-1.76.jar + bcutil-jdk15to18-1.76.jar ### File Printer DDS Menyediakan perpustakaan laporan Jasper (https://community.jaspersoft. com/download-jaspersoft/community-edisi). Kami menguji fungsionalitas AWS Transform for mainframe Runtime (di Amazon EC2) **dengan** jasperreports-6.16.0.jar, tetapi versi yang lebih baru mungkin kompatibel. Dengan versi dependensi ini, berikan juga dependensi transitif berikut: + castor-core-1.4.1.jar + kastor-xml-1.4.1.jar + commons-digester-2.1.jar + ecj-3.21.0.jar + itext-2.1.7.js8.jar + javax.inject-1.jar + jcommon-1.0.23.jar + jfreechart-1.0.19.jar + commons-beanutils-1.9.4.jar + commons-collections-3.2.2.jar ## Langkah-langkah instalasi Untuk menginstal dependensi, selesaikan langkah-langkah berikut. 1. Hubungkan ke instans Amazon EC2 Anda dan ubah pengguna ke **su** dengan menjalankan perintah berikut. ``` sudo su ``` Anda memerlukan hak Superuser untuk menjalankan perintah dalam tutorial ini. 1. Arahkan ke `/extra/` folder. ``` cd /extra/ ``` 1. Salin salah satu dependensi di atas seperti yang diperlukan di folder ini. **catatan** Untuk aplikasi web JAC dan BAC dengan database yang dihosting Oracle, pastikan Anda menyertakan driver database Oracle (ojdbc) di folder ini. 1. Hentikan dan mulai tomcat.service dengan menjalankan perintah berikut. ``` systemctl stop tomcat.service ``` ``` systemctl start tomcat.service ``` 1. Periksa status layanan untuk memastikannya berjalan. ``` systemctl status tomcat.service ``` 1. Verifikasi log. # Menerapkan AWS Transform untuk Runtime mainframe pada container di Amazon ECS dan Amazon EKS Anda dapat menggunakan topik di bagian ini untuk mempelajari cara mengatur AWS Transform for mainframe Runtime pada container untuk menerapkannya di Amazon ECS (dikelola oleh Amazon EC2 atau) AWS Fargate, dan Amazon EKS yang dikelola oleh Amazon EC2, cara memperbarui versi runtime, cara memantau penerapan menggunakan alarm Amazon, dan cara menambahkan dependensi berlisensi. CloudWatch **catatan** Ini tidak kompatibel dengan Amazon EKS yang dikelola oleh AWS Fargate. **Topics** + [Siapkan AWS Transform untuk mainframe Runtime pada container](ba-runtime-deploy-container.md) + [Tingkatkan AWS Transform untuk Runtime mainframe pada container](ba-runtime-maint-container.md) + [Siapkan CloudWatch alarm Amazon untuk AWS Transform untuk Runtime mainframe pada container](ba-cw-alarms-container.md) + [Siapkan dependensi berlisensi di AWS Transform untuk mainframe Runtime pada container](ba-runtime-dependencies-container.md) # Siapkan AWS Transform untuk mainframe Runtime pada container Topik ini menjelaskan cara menyiapkan dan menerapkan aplikasi PlanetsDemo sampel menggunakan AWS Transform for mainframe Runtime pada wadah docker. AWS Transform untuk Runtime mainframe pada container tersedia untuk Amazon ECS yang dikelola oleh Amazon EC2, Amazon ECS yang dikelola oleh, AWS Fargate dan Amazon EKS yang dikelola oleh Amazon EC2. Ini tidak kompatibel dengan Amazon EKS yang dikelola oleh AWS Fargate. **Topics** + [Prasyarat](#ba-runtime-deploy-prereq) + [Menyiapkan](#ba-runtime-deploy-setup) + [Uji aplikasi yang digunakan](#ba-runtime-deploy-test) ## Prasyarat Sebelum Anda mulai, pastikan Anda menyelesaikan prasyarat berikut. + Konfigurasikan AWS CLI dengan mengikuti langkah-langkah dalam [Mengonfigurasi AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html). + Lengkap [AWS Transform untuk prasyarat Runtime mainframe](ba-runtime-setup-prereq.md) dan[AWS Transformasi Orientasi untuk Runtime mainframe](ba-runtime-setup-onboard.md). + Unduh AWS binari Transform for mainframe Runtime. Untuk petunjuk, lihat [AWS Transformasi Orientasi untuk Runtime mainframe](ba-runtime-setup-onboard.md). + Unduh binari Apache Tomcat. + Unduh [arsip PlanetsDemo aplikasi](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip). + Buat database Amazon Aurora PostgreSQL untuk JICS, dan jalankan kueri di atasnya. `PlanetsDemo-v1/jics/sql/initJics.sql` Untuk informasi tentang cara membuat database PostgreSQL Amazon Aurora, lihat, Membuat dan [menghubungkan ke](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster) klaster DB PostgreSQL Aurora. ## Menyiapkan Untuk mengatur aplikasi PlanetsDemo sampel, selesaikan langkah-langkah berikut. 1. Setelah mengunduh binari Apache Tomcat, ekstrak isinya, dan buka folder. `conf` Buka `catalina.properties` file untuk diedit dan ganti baris yang dimulai `common.loader` dengan baris berikut. ``` common.loader="${catalina.base}/lib","${catalina.base}/lib/*.jar","${catalina.home}/lib","${catalina.home}/lib/*.jar","${catalina.home}/shared","${catalina.home}/shared/*.jar","${catalina.home}/extra","${catalina.home}/extra/*.jar" ``` 1. Kompres folder Apache Tomcat dengan menggunakan perintah tar untuk membangun arsip `tar.gz`. 1. Siapkan [Dockerfile](https://docs.docker.com/engine/reference/builder/) untuk membangun gambar kustom Anda berdasarkan binari runtime yang disediakan dan binari server Apache Tomcat. Lihat contoh berikut Dockerfile. Tujuannya adalah untuk menginstal Apache Tomcat, diikuti oleh AWS Transform for mainframe Runtime (untuk Amazon ECS dikelola oleh AWS Fargate) diekstraksi di root direktori instalasi Apache Tomcat, dan kemudian untuk menginstal contoh aplikasi modern bernama. PlanetsDemo **catatan** Isi skrip install-gapwalk.sh dan install-app.sh, yang digunakan dalam contoh ini Dockerfile, terdaftar setelah Dockerfile. ``` FROM --platform=linux/x86_64 amazonlinux:2 RUN mkdir -p /workdir/apps WORKDIR /workdir COPY install-gapwalk.sh . COPY install-app.sh . RUN chmod +x install-gapwalk.sh RUN chmod +x install-app.sh # Install Java and AWS CLI v2-y RUN yum install sudo java-17-amazon-corretto unzip tar -y RUN sudo yum remove awscli -y RUN curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" RUN sudo unzip awscliv2.zip RUN sudo ./aws/install # Installation dir RUN mkdir -p /usr/local/velocity/installation/gapwalk # Copy PlanetsDemo archive to a dedicated apps dir COPY PlanetsDemo-v1.zip /workdir/apps/ # Copy resources (tomcat, blu age runtime) to installation dir COPY tomcat.tar.gz /usr/local/velocity/installation/tomcat.tar.gz COPY aws-bluage-runtime-4.x.x.zip /usr/local/velocity/installation/gapwalk/gapwalk.zip # run relevant installation scripts RUN ./install-gapwalk.sh RUN ./install-app.sh EXPOSE 8080 EXPOSE 8081 # ... WORKDIR /bluage/tomcat.gapwalk/velocity # Run Command to start Tomcat server CMD ["sh", "-c", "sudo bin/catalina.sh run"] ``` Berikut ini adalah isi dari `install-gapwalk.sh.` ``` # Vars TEMP_DIR=/bluage-on-fargate/tomcat.gapwalk/temp # Install echo "Installing Gapwalk and Tomcat" sudo rm -rf /bluage-on-fargate mkdir -p ${TEMP_DIR} # Copy AWS Transform for mainframe runtime and tomcat archives to temporary extraction dir sudo cp /usr/local/velocity/installation/gapwalk/gapwalk.zip ${TEMP_DIR} sudo cp /usr/local/velocity/installation/tomcat.tar.gz ${TEMP_DIR} # Create velocity dir mkdir -p /bluage/tomcat.gapwalk/velocity # Extract tomcat files tar -xvf ${TEMP_DIR}/tomcat.tar.gz -C ${TEMP_DIR} # Copy all tomcat files to velocity dir cp -fr ${TEMP_DIR}/apache-tomcat-10.x.x/* /bluage/tomcat.gapwalk/velocity # Remove default webapps of Tomcat rm -f /bluage-on-fargate/tomcat.gapwalk/velocity/webapps/* # Extract AWS Transform for mainframe runtime at velocity dir unzip ${TEMP_DIR}/gapwalk.zip -d /bluage/tomcat.gapwalk # Remove temporary extraction dir sudo rm -rf ${TEMP_DIR} ``` Berikut ini adalah isi dari`install-app.sh`. ``` #!/bin/sh APP_DIR=/workdir/apps TOMCAT_GAPWALK_DIR=/bluage-on-fargate/tomcat.gapwalk unzip ${APP_DIR}/PlanetsDemo-v1.zip -d ${APP_DIR} cp -r ${APP_DIR}/webapps/* ${TOMCAT_GAPWALK_DIR}/velocity/webapps/ cp -r ${APP_DIR}/config/* ${TOMCAT_GAPWALK_DIR}/velocity/config/ ``` 1. Berikan informasi koneksi untuk database yang Anda buat sebagai bagian dari prasyarat dalam cuplikan berikut dalam `application-main.yml` file, yang terletak di folder. `{TOMCAT_GAPWALK_DIR}/config` Untuk informasi selengkapnya lihat, [Membuat dan menghubungkan ke klaster DB PostgreSQL Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster). ``` datasource: jicsDs: driver-class-name : url: username: password: type : ``` 1. Buat dan dorong gambar ke repositori Amazon ECR Anda. Untuk petunjuknya, lihat [Mendorong gambar Docker](https://docs.aws.amazon.com/AmazonECR/latest/userguide/docker-push-ecr-image.html) di Panduan Pengguna Amazon Elastic Container Registry. Kemudian, tergantung pada situasi Anda, buat pod Amazon EKS atau definisi tugas Amazon ECS menggunakan image Amazon ECR Anda, dan terapkan ke cluster Anda. Misalnya saat membuat ini, lihat [Membuat definisi tugas menggunakan konsol di Panduan Pengembang](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-task-definition.html) *Amazon Elastic Container Service (Amazon ECS) Container Service (Amazon ECS)* [dan Menerapkan contoh aplikasi](https://docs.aws.amazon.com/eks/latest/userguide/sample-deployment.html) di Panduan Pengguna *Amazon* EKS. 1. Khususnya, untuk **Amazon ECS yang dikelola berdasarkan AWS Fargate** kasus, saat membuat definisi Tugas, gunakan peran IAM yang Anda buat sebagai bagian dari penyiapan Infrastruktur awal. Kemudian, saat membuat layanan, perluas bagian **Jaringan**, dan konfigurasikan VPC, subnet, dan grup keamanan yang Anda buat sebagai bagian dari penyiapan Infrastruktur awal. Lihat, [Persyaratan penyiapan infrastruktur untuk AWS Transform for mainframe Runtime](https://docs.aws.amazon.com/m2/latest/userguide/ba-infrastructure-setup.html). ## Uji aplikasi yang digunakan Untuk contoh cara menguji PlanetsDemo aplikasi, lihat[Uji PlanetsDemo aplikasi](ba-runtime-test-planetsdemo.md). # Tingkatkan AWS Transform untuk Runtime mainframe pada container Panduan ini menjelaskan cara memutakhirkan AWS Transform for mainframe Runtime pada container. Untuk melakukan ini, Anda harus terlebih dahulu menyelesaikan beberapa prasyarat, dan kemudian bekerja dengan image Docker untuk memutakhirkan Transform for mainframe AWS Runtime. **Topics** + [Prasyarat](#ba-runtime-maint-prereq) + [Tingkatkan AWS Transform untuk Runtime mainframe](#ba-runtime-maint-copy-files) ## Prasyarat Sebelum Anda mulai, pastikan Anda memenuhi prasyarat berikut. + Lengkap [AWS Transform untuk prasyarat Runtime mainframe](ba-runtime-setup-prereq.md) dan[AWS Transformasi Orientasi untuk Runtime mainframe](ba-runtime-setup-onboard.md). + Unduh versi AWS Transform for mainframe Runtime yang ingin Anda tingkatkan. Untuk informasi selengkapnya, lihat [AWS Transformasi Orientasi untuk Runtime mainframe](ba-runtime-setup-onboard.md). Kerangka kerja terdiri dari dua file biner: `aws-bluage-runtime-x.y.z.zip` dan`aws-bluage-webapps-x.y.z.zip`. ## Tingkatkan AWS Transform untuk Runtime mainframe Selesaikan langkah-langkah berikut untuk meningkatkan AWS Transform for mainframe Runtime. 1. Bangun kembali gambar Docker Anda dengan AWS Transform yang diinginkan untuk versi Runtime mainframe. Untuk petunjuk, lihat [Siapkan AWS Transform untuk mainframe Runtime pada container](ba-runtime-deploy-container.md). 1. Dorong gambar Docker Anda ke repositori Amazon ECR Anda. 1. Hentikan dan mulai ulang layanan Amazon ECS atau Amazon EKS Anda. 1. Verifikasi log. AWS Transform for mainframe Runtime berhasil ditingkatkan. # Siapkan CloudWatch alarm Amazon untuk AWS Transform untuk Runtime mainframe pada container Anda dapat mengatur CloudWatch agar pemberitahuan yang lebih terlihat setiap kali aplikasi yang Anda gunakan menemukan pengecualian. Ini membantu Anda memantau log aplikasi yang dialihkan ke CloudWatch, dan menambahkan alarm untuk memperingatkan Anda tentang kemungkinan kesalahan. ## Pengaturan alarm Dengan CloudWatch log, Anda dapat mengonfigurasi sejumlah metrik dan alarm, tergantung pada aplikasi dan kebutuhan Anda. Secara khusus, Anda dapat mengatur alarm proaktif untuk peringatan penggunaan secara langsung selama pembuatan klaster, sehingga Anda mendapatkan pemberitahuan saat terjadi kesalahan. Untuk menyoroti kesalahan dalam koneksi ke AWS Transform untuk sistem kontrol mainframe, tambahkan metrik mengenai string “Error C” di log. Anda kemudian dapat menentukan alarm yang bereaksi terhadap metrik ini. # Siapkan dependensi berlisensi di AWS Transform untuk mainframe Runtime pada container Topik ini menjelaskan cara menyiapkan dependensi berlisensi tambahan yang dapat Anda gunakan dengan AWS Transform for mainframe Runtime pada container. **Topics** + [Prasyarat](#ba-runtime-dependencies-prereq) + [Ikhtisar](#ba-runtime-dependencies-overview) ## Prasyarat Sebelum Anda mulai, pastikan Anda menyelesaikan prasyarat berikut. + Lengkap [AWS Transform untuk prasyarat Runtime mainframe](ba-runtime-setup-prereq.md) dan[AWS Transformasi Orientasi untuk Runtime mainframe](ba-runtime-setup-onboard.md). + Dapatkan dependensi berikut dari sumbernya. ### Basis data Oracle Menyediakan [driver database Oracle]( https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html). Misalnya, **ojdbc11-23.3.0.23.09.jar**. ### Koneksi IBM MQ Menyediakan klien [IBM MQ](https://www.ibm.com/support/pages/mqc91-ibm-mq-clients). Misalnya, **com.ibm.mq.jakarta.client-9.3.4.1.jar**. Dengan versi dependensi ini, berikan juga dependensi transitif berikut: + bcprov-jdk15to18-1.76.jar + bcpkix-jdk15to18-1.76.jar + bcutil-jdk15to18-1.76.jar ### File Printer DDS Menyediakan perpustakaan laporan Jasper (https://community.jaspersoft. com/download-jaspersoft/community-edisi). Misalnya, **jasperreports-6.16.0.jar**, tetapi versi yang lebih baru mungkin kompatibel. Dengan versi dependensi ini, berikan juga dependensi transitif berikut: + castor-core-1.4.1.jar + kastor-xml-1.4.1.jar + commons-digester-2.1.jar + ecj-3.21.0.jar + itext-2.1.7.js8.jar + javax.inject-1.jar + jcommon-1.0.23.jar + jfreechart-1.0.19.jar + commons-beanutils-1.9.4.jar + commons-collections-3.2.2.jar ## Ikhtisar Untuk menginstal dependensi, selesaikan langkah-langkah berikut. 1. Salin salah satu dependensi di atas seperti yang diperlukan ke folder build image Docker Anda. 1. Jika database JICS Anda di-host di Oracle, berikan driver database Oracle. `your-tomcat-path/extra` 1. Di Dockerfile Anda, salin dependensi ini ke. `your-tomcat-path/extra` 1. Buat image Docker Anda, lalu dorong ke Amazon ECR. 1. Hentikan dan mulai ulang layanan Amazon ECS atau Amazon EKS Anda. 1. Periksa log. # Uji PlanetsDemo aplikasi Untuk memeriksa status PlanetsDemo aplikasi yang digunakan, jalankan perintah berikut setelah Anda mengganti `load-balancer-DNS-name``listener-port`, dan `web-binary-name` dengan nilai yang benar untuk pengaturan Anda. ``` curl http://load-balancer-DNS-name:listener-port/gapwalk-application/ ``` Jika aplikasi berjalan, Anda melihat pesan output berikut:`Jics application is running`. Selanjutnya, jalankan perintah berikut. ``` curl http://load-balancer-DNS-name:listener-port/jac/api/services/rest/jicsservice/ ``` Jika aplikasi berjalan, Anda melihat pesan output berikut:`Jics application is running`. ``` Jics application is running ``` Jika Anda telah mengonfigurasiBlusam, Anda dapat mengharapkan respons kosong saat menjalankan perintah berikut. ``` curl http://load-balancer-DNS-name:listener-port/bac/api/services/rest/bluesamserver/serverIsUp ``` Perhatikan nama biner web (PlanetsDemo-web-1.0.0, jika tidak berubah). Untuk mengakses PlanetsDemo aplikasi, gunakan URL dengan format berikut. ``` https://load-balancer-DNS-name:listener-port/web-binary-name ``` Setelah PlanetsDemo aplikasi dimulai, halaman beranda ditampilkan. ![\[Halaman beranda\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/PlanetsDemo-homepage.png) Masukkan PINQ di kotak teks dan kemudian tekan Enter. Halaman pertanyaan data ditampilkan. ![\[Halaman pertanyaan data\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/PlanetsDemo-app.png) Misalnya, masukkan EARTH di bidang PlanetsDemo nama, lalu tekan Enter. Halaman untuk planet yang Anda masukkan ditampilkan. ![\[Halaman EARTH\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/PlanetsDemo-EARTH.png)