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.

# Siapkan konfigurasi untuk AWS Transform untuk mainframe Runtime
<a name="ba-runtime-config"></a>

 AWS Transform untuk mainframe Runtime dan kode klien adalah aplikasi web menggunakan framework [Spring Boot](https://docs.spring.io/spring-boot/docs/2.5.14/reference/html/). Ini memanfaatkan kemampuan Spring untuk memasok konfigurasi, dengan beberapa kemungkinan lokasi dan aturan prioritas. Ada juga aturan prioritas serupa untuk memasok banyak file lain, seperti skrip groovy, sql, dll.

 AWS Transform for mainframe Runtime juga berisi aplikasi web opsional tambahan, yang dapat dipilih jika diperlukan.

**Topics**
+ [Dasar-dasar konfigurasi aplikasi](#ba-runtime-config-app-basics)
+ [Prioritas aplikasi](#ba-runtime-config-app-precedence)
+ [JNDI untuk database](#ba-runtime-config-app-jndi)
+ [AWS Transformasi untuk rahasia Runtime mainframe](ba-runtime-config-app-secrets.md)
+ [File lain (groovy, sql, dll.)](#ba-runtime-config-app-files)
+ [Aplikasi web tambahan](#ba-runtime-config-app-webapp)
+ [Aktifkan properti untuk AWS Transform untuk mainframe Runtime](ba-runtime-key-value.md)
+ [Properti cache Redis yang tersedia di AWS Transform untuk mainframe Runtime](ba-runtime-redis-configuration.md)
+ [Konfigurasikan keamanan untuk aplikasi Gapwalk](ba-runtime-security.md)

## Dasar-dasar konfigurasi aplikasi
<a name="ba-runtime-config-app-basics"></a>

Cara default untuk menangani konfigurasi aplikasi adalah melalui penggunaan file YAMAL khusus yang akan disediakan di `config` folder server aplikasi. Ada dua file konfigurasi YAMB utama:
+ `application-main.yaml`
+ `application-profile.yaml`(di mana `profile` nilai diatur selama pembuatan aplikasi).

File pertama mengkonfigurasi kerangka kerja, yaitu`Gapwalk-application.war`, sedangkan yang kedua adalah untuk opsi tambahan khusus untuk aplikasi klien. Ini berfungsi dengan penggunaan profil pegas: aplikasi Gapwalk menggunakan `main` profil, sedangkan aplikasi klien menggunakan profil. `profile`

Contoh berikut menunjukkan file YAMG utama yang khas.

![\[Kutipan dari file YAMG “utama”.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/main-yaml.png)


Contoh berikut menunjukkan file YAMG klien tipikal.

![\[Contoh YAMG klien\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/client-yaml.png)


Untuk informasi tentang konten file YAMB, lihat[Aktifkan properti untuk AWS Transform untuk mainframe Runtime](ba-runtime-key-value.md).

## Prioritas aplikasi
<a name="ba-runtime-config-app-precedence"></a>

Untuk file konfigurasi ini, aturan prioritas musim semi berlaku. Khususnya:
+ File `application-main` YAMB muncul di file perang utama Gapwalk dengan nilai default, dan yang ada di `config` folder menggantinya.
+ Hal yang sama harus dilakukan untuk konfigurasi aplikasi klien
+ Parameter tambahan dapat diteruskan pada baris perintah pada waktu peluncuran server. Mereka akan mengganti yang YAMB.

Untuk informasi selengkapnya, lihat [dokumentasi Official Spring Boot](https://docs.spring.io/spring-boot/docs/2.5.14/reference/html/features.html#features.external-config).

## JNDI untuk database
<a name="ba-runtime-config-app-jndi"></a>

Konfigurasi database mungkin disertakan dengan JNDI di file context.xml di Tomcat. Konfigurasi seperti itu akan mengesampingkan konfigurasi YAMAL. Tetapi perhatikan bahwa menggunakan ini tidak akan memungkinkan untuk membungkus kredensil Anda di manajer rahasia (lihat di bawah).

Contoh berikut menunjukkan konfigurasi sampel untuk JICS dan Blusam database.

```
<Resource auth="Container" driverClassName="org.postgresql.Driver" initialSize="0" maxIdle="5" 
   maxOpenPreparedStatements="-1" maxTotal="10" maxWaitMillis="-1" name="jdbc/jics"
   poolPreparedStatements="true" testOnBorrow="false" type="javax.sql.DataSource" 		
   url="jdbc:postgresql://XXXX.rds.amazonaws.com:5432/XXXX" username="XXXX" password="XXXX" />
```

jdbc/jics  
Akan `jdbc/jics` untuk database JICS dan `jdbc/bluesam` (perhatikan 'e') untuk Blusam database.

url="jdbc:postgresql: //xxxx.rds.amazonaws.com:5432/xxxx” Username="xxxx” kata sandi="xxxx”  
Url database, nama pengguna dan kata sandi.

## File lain (groovy, sql, dll.)
<a name="ba-runtime-config-app-files"></a>

File lain yang digunakan oleh proyek pelanggan menggunakan aturan prioritas yang sama seperti yang untuk konfigurasi pegas. Contoh:
+ Skrip Groovy adalah `.groovy` file di folder atau `scripts` subfolder. 
+ Skrip SQL adalah `.sql` file dalam `sql` folder atau subfolder.
+ Skrip daemon adalah `.groovy` file di folder atau `daemons` subfolder. 
+ Query File pemetaan database adalah file bernama `queries-database.mapping` file dalam `sql` subfolder folder.
+ Template Jasper adalah `.jrxml` file di `templates` folder atau subfolder. 
+ Katalog dataset adalah `.json` file dalam folder. `catalog`
+ File LNK adalah `.json` file di folder. `lnk`

Semua lokasi ini dapat diganti melalui properti sistem atau properti YAML klien.
+ Untuk skrip Groovy: `configuration.scripts`
+ Untuk skrip SQL: `configuration.sql`
+ Untuk skrip Daemon: `configuration.daemons`
+ Untuk file pemetaan Database Query: `configuration.databaseMapping`
+ Untuk template Jasper: `configuration.templates`
+ Untuk katalog Dataset: `configuration.catalog`
+ Untuk file Lnk: `configuration.lnk`

Jika properti tidak ditemukan, file akan diambil dari lokasi default yang disebutkan di atas. Pencarian pertama akan dilakukan dengan direktori kerja tomcat sebagai root, dan terakhir di file perang aplikasi.

## Aplikasi web tambahan
<a name="ba-runtime-config-app-webapp"></a>

 AWS Transform for mainframe Runtime berisi aplikasi web tambahan di foldernya`webapps-extra`. Aplikasi ini tidak dilayani secara default oleh server tomcat.

Memilih masuk ke aplikasi web ini bergantung pada proyek modernisasi dan dilakukan dengan memindahkan file perang yang diinginkan dari `webapps-extra` folder ke folder. `webapps` Setelah itu, perang akan dilayani oleh server tomcat pada startup berikutnya.

Beberapa konfigurasi tambahan khusus proyek juga dapat ditambahkan dalam file konfigurasi YAMAL untuk setiap perang tambahan, seperti yang dilakukan dalam `application-main.yml` file dan dijelaskan di atas. Perang tambahan adalah:
+ `gapwalk-utility-pgm.war`: berisi dukungan untuk program utilitas ZOS dan digunakan `application-utility-pgm.yaml` sebagai konfigurasinya.
+ `gapwalk-cl-command.war`: berisi dukungan untuk program utilitas AS/400 dan digunakan `application-cl-command.yaml` sebagai konfigurasinya.
+ `gapwalk-hierarchical-support.war`: berisi dukungan IMS/MFS transaksi dan digunakan `application-jhdb.yaml` sebagai konfigurasinya