

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.

# Properti cache Redis yang tersedia di AWS Transform untuk mainframe Runtime
<a name="ba-runtime-redis-configuration"></a>

Anda dapat menggunakan dokumen ini untuk mempelajari tentang cache Redis di AWS Transform for mainframe Runtime, bersama dengan konfigurasi Gapwalk, properti Redis yang didukung dan bagaimana file `application-main.yml` dapat mereferensikan ARN rahasia untuk cache Redis.

## Redis cache di AWS Transform untuk mainframe Runtime
<a name="ba-redis-caches-in-runtime"></a>

Server Redis dapat digunakan sebagai cache untuk berbagai fitur dalam aplikasi AWS Transform for mainframe Gapwalk, seperti:


****  

| AWS Transform untuk fitur Runtime mainframe yang menggunakan Redis caching | Deskripsi | 
| --- | --- | 
| Blusamtembolok | BlusamCache Redis untuk membaca catatan secara efisien, menggunakan strategi penulisan di belakang, untuk mengoptimalkan beban kerja intensif penulisan yang ditemui pada muatan batch.  | 
| Blusamkunci | Cache untuk kunci terdistribusi untuk kumpulan data dan catatan. | 
| Katalog Dataset | Cache dataset katalog. | 
| Cache sesi | Cache Redis untuk HttpSession. Cache menyimpan nama pengguna, status dialog dengan frontend Angular, dan informasi 'dialek' tertentu (BMS, MFS,). AS400 | 
| Pelacak sesi | Cache sesi aktif dengan nama pengguna dan session-creation-time informasi terkait. | 
| Tembolok JICS | Cache untuk definisi sumber daya JICS. | 
| Antrian TS | Penyimpanan untuk antrian TS. | 
| Pos pemeriksaan JCL |  Cache pos pemeriksaan JCL. | 
| Kunci file Gapwalk | Cache untuk file terdistribusi dikunci berdasarkan pekerjaan. | 
| Kunci Blu4IV | Penyimpanan untuk kunci rekaman Blu4IV. | 

## Konfigurasi Redis Gapwalk
<a name="ba-runtime-redis-gapwalk-configuration"></a>

Konfigurasi Redis global digunakan jika `redis` ditentukan sebagai mekanisme caching dan tidak ada konfigurasi Redis yang disediakan untuk fitur tertentu. Konfigurasi ini memungkinkan Anda untuk menggunakan konfigurasi yang sama untuk beberapa cache Redis secara bersamaan.

Dalam contoh berikut cache Blusam dataset dan cache JICS menggunakan konfigurasi `gapwalk.redis` (`redis.server1`) karena jenis cache mereka diatur ke`redis`, dan tidak ada properti Redis implisit yang ditentukan di bawah dan. [Definisi sumber daya JICS](#ba-runtime-redis-jics-cache) [Definisi sumber daya JICS](#ba-runtime-redis-jics-cache) Namun, cache Blusam kunci akan menggunakan konfigurasi Redis (`redis.server2`) yang berbeda karena properti Redis didefinisikan secara eksplisit.

```
...
 
 gapwalk:
   redis:
     hostName: redis.server1
 	port: 6379
 ...
 
 bluesam:
   # Redis bluesam cache
   cache: redis
   # Redis locks cache
   locks:
     cache: redis
 	hostName: redis.server2
 	port: 6379
 ...
 # Redis jics cache
 jics:
   resource-definitions:
     store-type: redis
 ...
```

 Untuk mengaktifkan konfigurasi Redis global, tambahkan konfigurasi berikut di`main-application.yml`. 

```
 gapwalk:
   redis:
     hostName: localhost
     port: 6379
     mode: standalone                        # Optional
     username:                               # Optional
     password: ""                            # Optional
     useSsl: false                           # Optional
     database: 0                             # Optional
     maxTotal: 128                           # Optional
     maxIdle: 128                            # Optional
     minIdle: 16                             # Optional
     testOnBorrow: true                      # Optional
     testOnReturn: true                      # Optional
     testWhileIdle: true                     # Optional
     testOnCreate: true                      # Optional
     minEvictableIdleTimeMillis: 60000       # Optional
     timeBetweenEvictionRunsMillis: 30000    # Optional
     numTestsPerEvictionRun: -1              # Optional
     blockWhenExhausted: true                # Optional
     nettyThreads: 32                        # Optional
     subscriptionsPerConnection: 10          # Optional
     subscriptionConnectionPoolSize: 100     # Optional
     pageSizeInBytes: 8192                   # Optional
     readTimeout: 2000                       # Optional
```

## Properti Redis yang didukung
<a name="ba-runtime-redis-supported-properties"></a>

Tabel berikut menunjukkan properti Redis yang didukung untuk cache Redis global dan spesifik pada AWS Transform for mainframe Runtime.


****  

| Nama properti | Wajib? | Deskripsi | Nilai | Default | 
| --- | --- | --- | --- | --- | 
| mode | Tidak | Mode lari Redis. | standalone \| cluster | standalone | 
| hostname | Ya | Nama host atau alamat IP server Redis. | string | null | 
| port | Ya | Nomor port tempat server Redis mendengarkan koneksi. | int | null | 
| username | Tidak | Nama pengguna untuk otentikasi. | string | null | 
| password | Tidak | Kata sandi untuk otentikasi. | string | string kosong | 
| useSsl  | Tidak | Menentukan apakah akan mengaktifkan SSL/TLS enkripsi untuk koneksi Redis. | boolean | false | 
| database | Tidak | Nomor database Redis yang akan digunakan. Redis mendukung beberapa database logis, dan properti ini menentukan mana yang akan digunakan. | int | 0 | 
| maxTotal | Tidak | Jumlah maksimum koneksi yang diizinkan di kolam koneksi Redis. | int  | 128 | 
| maxIdle | Tidak | Jumlah maksimum koneksi idle yang diizinkan di kumpulan koneksi Redis. | int | 128 | 
| minIdle | Tidak | Jumlah minimum koneksi idle yang harus dipertahankan di kumpulan koneksi Redis. | int | 16 | 
| testOnBorrow  | Tidak | Nilai boolean yang menunjukkan apakah akan memvalidasi koneksi sebelum meminjamnya dari pool. | boolean | true | 
| testOnReturn  | Tidak | Nilai boolean yang menunjukkan apakah akan memvalidasi koneksi sebelum mengembalikannya ke pool.  | boolean | true | 
| testWhileIdle  | Tidak | Nilai boolean yang menunjukkan apakah akan memvalidasi koneksi idle di pool secara berkala. | boolean | true | 
| testOnCreate  | Tidak | Nilai boolean yang menunjukkan apakah akan memvalidasi koneksi ketika mereka dibuat. | boolean | true | 
| minEvictableIdleTimeMillis  | Tidak | Jumlah waktu minimum (dalam milidetik) bahwa koneksi idle harus tetap berada di kolam sebelum dapat diusir. | long | 60000L  | 
| timeBetweenEvictionRunsMillis  | Tidak | Waktu (dalam milidetik) antara proses berturut-turut dari utas evictor koneksi idle. | long | 30000L | 
| numTestsPerEvictionRun  | Tidak | Jumlah maksimum koneksi yang akan diuji selama setiap proses thread evictor koneksi idle. | int | -1 | 
| blockWhenExhausted  | Tidak | Nilai boolean yang menunjukkan apakah akan memblokir dan menunggu koneksi tersedia saat pool habis. | boolean | true | 
| nettyThreads  | Tidak | Jumlah thread Netty yang digunakan untuk menangani koneksi Redis. | int | 32 | 
| subscriptionsPerConnection  | Tidak | Jumlah maksimum langganan yang diizinkan per koneksi Redis. | int | 10 | 
| subscriptionConnectionPoolSize  | Tidak | Jumlah maksimum koneksi yang diizinkan di kumpulan koneksi berlangganan Redis.  | int | 100 | 
| pageSizeInBytes  | Tidak | Ukuran halaman default dalam byte untuk operasi Redis. | long | 262144000  | 
| readTimeout | Tidak | Batas waktu baca dalam milidetik untuk operasi Redis. | long | 2000 | 
| timeToLiveMillis | Tidak | Durasi (dalam Millidetik) di mana entri cache tetap berada di cache sebelum dianggap kedaluwarsa dan dihapus. Jika properti ini tidak ditentukan, entri cache tidak akan secara otomatis kedaluwarsa secara default. | long | -1 | 
| useAsyncBatch | Tidak | Mengaktifkan eksekusi asinkron untuk operasi penulisan massal Redis untuk meningkatkan kinerja. Saat disetel ke false, kembali ke mode eksekusi sinkron. | boolean | true | 
| useBatchInMemoryAtomic | Tidak | Mengaktifkan In-memory-atomic mode untuk operasi baca batch Redis. Saat disetel ke false, kembali ke mode batch dalam memori default. | boolean | false | 
| connectionPoolSize | Tidak | Ukuran kolam koneksi yang digunakan untuk koneksi klien Redisson ke server Redis. | int | 64 | 
| connectionMinimumIdleSize | Tidak | Jumlah minimum koneksi idle yang akan dipertahankan Redisson di kumpulan koneksinya. | int | 24 | 
| idleConnectionTimeout | Tidak | Batas waktu dalam milidetik setelah itu koneksi idle di kolam akan ditutup. | int | 10000 | 
| connectTimeout | Tidak | Batas waktu dalam milidetik untuk membuat koneksi ke server Redis. | int | 10000 | 

## Properti cache Redis
<a name="ba-runtime-redis-caches-properties"></a>

### Redis cache Blusam
<a name="ba-runtime-redis-blusam-cache"></a>

```
bluesam:
   cache: redis
 # If the following redis properties are not specified gapwalk.redis configuration will be used for this cache 
   redis:
     hostName: localhost
     port: 6379
     mode: standalone                        # Optional
     username:                               # Optional
     password: ""                            # Optional
     useSsl: false                           # Optional
     database: 0                             # Optional
     maxTotal: 128                           # Optional
     maxIdle: 128                            # Optional
     minIdle: 16                             # Optional
     testOnBorrow: true                      # Optional
     testOnReturn: true                      # Optional
     testWhileIdle: true                     # Optional
     testOnCreate: true                      # Optional
     minEvictableIdleTimeMillis: 60000       # Optional
     timeBetweenEvictionRunsMillis: 30000    # Optional
     numTestsPerEvictionRun: -1              # Optional
     blockWhenExhausted: true                # Optional
     nettyThreads: 32                        # Optional
     subscriptionsPerConnection: 10          # Optional
     subscriptionConnectionPoolSize: 100     # Optional
     pageSizeInBytes: 8192                   # Optional
     readTimeout: 2000                       # Optional
     timeToLiveMillis: 60000                 # Optional
     connectionPoolSize: 64                  # Optional
     connectionMinimumIdleSize: 24           # Optional
     idleConnectionTimeout: 10000            # Optional
     connectTimeout: 10000                   # Optional
```

### Redis cache Blusam
<a name="ba-runtime-redis-blusame-locks"></a>

```
bluesam:
   locks:
     cache: redis
 # If the following redis properties are not specified gapwalk.redis configuration will be used for this cache 
       hostName: localhost
       port: 6379
       mode: standalone                        # Optional
       username:                               # Optional
       password: ""                            # Optional
       useSsl: false                           # Optional
       database: 0                             # Optional
       maxTotal: 128                           # Optional
       maxIdle: 128                            # Optional
       minIdle: 16                             # Optional
       testOnBorrow: true                      # Optional
       testOnReturn: true                      # Optional
       testWhileIdle: true                     # Optional
       testOnCreate: true                      # Optional
       minEvictableIdleTimeMillis: 60000       # Optional
       timeBetweenEvictionRunsMillis: 30000    # Optional
       numTestsPerEvictionRun: -1              # Optional
       blockWhenExhausted: true                # Optional
       nettyThreads: 32                        # Optional
       subscriptionsPerConnection: 10          # Optional
       subscriptionConnectionPoolSize: 100     # Optional
       pageSizeInBytes: 8192                   # Optional
       readTimeout: 2000                       # Optional
```

### Cache sesi
<a name="ba-runtime-redis-session-cache"></a>

```
 spring:
   session:
     store-type: redis
 # If the following redis properties are not specified gapwalk.redis configuration will be used for this cache 
 jics:
   redis:
     hostName: localhost
     port: 6379
     mode: standalone                        # Optional
     username:                               # Optional
     password: ""                            # Optional
     useSsl: false                           # Optional
     database: 0                             # Optional
     maxTotal: 128                           # Optional
     maxIdle: 128                            # Optional
     minIdle: 16                             # Optional
     testOnBorrow: true                      # Optional
     testOnReturn: true                      # Optional
     testWhileIdle: true                     # Optional
     testOnCreate: true                      # Optional
     minEvictableIdleTimeMillis: 60000       # Optional
     timeBetweenEvictionRunsMillis: 30000    # Optional
     numTestsPerEvictionRun: -1              # Optional
     blockWhenExhausted: true                # Optional
     nettyThreads: 32                        # Optional
     subscriptionsPerConnection: 10          # Optional
     subscriptionConnectionPoolSize: 100     # Optional
     pageSizeInBytes: 8192                   # Optional
     readTimeout: 2000                       # Optional
```

### Definisi sumber daya JICS
<a name="ba-runtime-redis-jics-cache"></a>

```
jics:
   resource-definitions:
     store-type: redis
 # If the following redis properties are not specified gapwalk.redis configuration will be used for this cache 
   redis:
     hostName: localhost
     port: 6379
     mode: standalone                        # Optional
     username:                               # Optional
     password: ""                            # Optional
     useSsl: false                           # Optional
     database: 0                             # Optional
     maxTotal: 128                           # Optional
     maxIdle: 128                            # Optional
     minIdle: 16                             # Optional
     testOnBorrow: true                      # Optional
     testOnReturn: true                      # Optional
     testWhileIdle: true                     # Optional
     testOnCreate: true                      # Optional
     minEvictableIdleTimeMillis: 60000       # Optional
     timeBetweenEvictionRunsMillis: 30000    # Optional
     numTestsPerEvictionRun: -1              # Optional
     blockWhenExhausted: true                # Optional
     nettyThreads: 32                        # Optional
     subscriptionsPerConnection: 10          # Optional
     subscriptionConnectionPoolSize: 100     # Optional
     pageSizeInBytes: 8192                   # Optional
     readTimeout: 2000                       # Optional
```

### Antrian JICS TS
<a name="ba-runtime-jics-ts-queues"></a>

```
jics:
   parameters:
     tsqimpl: redis
 # If the following redis properties are not specified gapwalk.redis configuration will be used for this cache 
   queues:
     ts:
       redis:
         hostName: localhost
         port: 6379
         mode: standalone                        # Optional
         username:                               # Optional
         password: ""                            # Optional
         useSsl: false                           # Optional
         database: 0                             # Optional
         maxTotal: 128                           # Optional
         maxIdle: 128                            # Optional
         minIdle: 16                             # Optional
         testOnBorrow: true                      # Optional
         testOnReturn: true                      # Optional
         testWhileIdle: true                     # Optional
         testOnCreate: true                      # Optional
         minEvictableIdleTimeMillis: 60000       # Optional
         timeBetweenEvictionRunsMillis: 30000    # Optional
         numTestsPerEvictionRun: -1              # Optional
         blockWhenExhausted: true                # Optional
         nettyThreads: 32                        # Optional
         subscriptionsPerConnection: 10          # Optional
         subscriptionConnectionPoolSize: 100     # Optional
         pageSizeInBytes: 8192                   # Optional
         readTimeout: 2000                       # Optional
```

### Pelacak sesi
<a name="ba-runtime-session-tracker"></a>

```
session-tracker:
   store-type: redis
 # If the following redis properties are not specified gapwalk.redis configuration will be used for this cache 
   redis:
     hostName: localhost
     port: 6379
     mode: standalone                        # Optional
     username:                               # Optional
     password: ""                            # Optional
     useSsl: false                           # Optional
     database: 0                             # Optional
     maxTotal: 128                           # Optional
     maxIdle: 128                            # Optional
     minIdle: 16                             # Optional
     testOnBorrow: true                      # Optional
     testOnReturn: true                      # Optional
     testWhileIdle: true                     # Optional
     testOnCreate: true                      # Optional
     minEvictableIdleTimeMillis: 60000       # Optional
     timeBetweenEvictionRunsMillis: 30000    # Optional
     numTestsPerEvictionRun: -1              # Optional
     blockWhenExhausted: true                # Optional
     nettyThreads: 32                        # Optional
     subscriptionsPerConnection: 10          # Optional
     subscriptionConnectionPoolSize: 100     # Optional
     pageSizeInBytes: 8192                   # Optional
     readTimeout: 2000                       # Optional
```

### Pos pemeriksaan JCL
<a name="ba-runtime-jcl-checkpoint"></a>

```
jcl:
   checkpoint:
     provider: redis
 # If the following redis properties are not specified gapwalk.redis configuration will be used for this cache 
   redis:
     hostname: localhost
     port: 6379
     mode: standalone                        # Optional
     username:                               # Optional
     password: ""                            # Optional
     useSsl: false                           # Optional
     database: 0                             # Optional
     maxTotal: 128                           # Optional
     maxIdle: 128                            # Optional
     minIdle: 16                             # Optional
     testOnBorrow: true                      # Optional
     testOnReturn: true                      # Optional
     testWhileIdle: true                     # Optional
     testOnCreate: true                      # Optional
     minEvictableIdleTimeMillis: 60000       # Optional
     timeBetweenEvictionRunsMillis: 30000    # Optional
   	 numTestsPerEvictionRun: -1              # Optional
     blockWhenExhausted: true                # Optional
     nettyThreads: 32                        # Optional
     subscriptionsPerConnection: 10          # Optional
     subscriptionConnectionPoolSize: 100     # Optional
     pageSizeInBytes: 8192                   # Optional
     readTimeout: 2000                       # Optional
```

### Kunci file Gapwalk
<a name="ba-runtime-gapwalk-file-locks"></a>

```
filesLocks:
   enabled: true
   retryTime: 1000
   MaxRetry: 5
   provider: redis
 # If the following redis properties are not specified gapwalk.redis configuration will be used for this cache 
   redis:
     hostName: localhost
     port: 6379
     mode: standalone                          # Optional
     username:                                 # Optional
     password: ""                              # Optional
     useSsl: false                             # Optional
     database: 0                               # Optional
     pool:
       maxTotal: 128                           # Optional
       maxIdle: 128                            # Optional
       minIdle: 16                             # Optional
       testOnBorrow: true                      # Optional
       testOnReturn: true                      # Optional
       testWhileIdle: true                     # Optional
       testOnCreate: true                      # Optional
       minEvictableIdleTimeMillis: 60000       # Optional
       timeBetweenEvictionRunsMillis: 30000    # Optional
       numTestsPerEvictionRun: -1              # Optional
       blockWhenExhausted: true                # Optional
       nettyThreads: 32                        # Optional
       subscriptionsPerConnection: 10          # Optional
       subscriptionConnectionPoolSize: 100     # Optional
       pageSizeInBytes: 8192                   # Optional
       readTimeout: 2000                       # Optional
```

### Kunci Blu4IV
<a name="ba-runtime-blu4iv-locks"></a>

```
 blu4iv.lock: redis
 blu4iv.lock.timeout: 10 #(in millisecondes)
 	# If the following redis properties are not specified gapwalk.redis configuration will be used for this cache 
 blu4iv.lock.redis:
       hostName: localhost
       port: 6379
       mode: standalone                        # Optional
       username:                               # Optional
       password: ""                            # Optional
       useSsl: false                           # Optional
       database: 0                             # Optional
       maxTotal: 128                           # Optional
       maxIdle: 128                            # Optional
       minIdle: 16                             # Optional
       testOnBorrow: true                      # Optional
       testOnReturn: true                      # Optional
       testWhileIdle: true                     # Optional
       testOnCreate: true                      # Optional
       minEvictableIdleTimeMillis: 60000       # Optional
       timeBetweenEvictionRunsMillis: 30000    # Optional
       numTestsPerEvictionRun: -1              # Optional
       blockWhenExhausted: true                # Optional
       nettyThreads: 32                        # Optional
       subscriptionsPerConnection: 10          # Optional
       subscriptionConnectionPoolSize: 100     # Optional
       pageSizeInBytes: 8192                   # Optional
       readTimeout: 2000                       # Optional
```

### Katalog Dataset
<a name="ba-runtime-dataset-catalog"></a>

```
datasimplifier:   
   catalogImplementation: redis
   # If the following redis properties are not specified gapwalk.redis configuration will be used for this cache    
   redis:
     hostName: localhost
     port: 6379
     mode: standalone                        # Optional
     username:                               # Optional
     password: ""                            # Optional
     useSsl: false                           # Optional
     database: 0                             # Optional
     maxTotal: 128                           # Optional
     maxIdle: 128                            # Optional
     minIdle: 16                             # Optional
     testOnBorrow: true                      # Optional
     testOnReturn: true                      # Optional
     testWhileIdle: true                     # Optional
     testOnCreate: true                      # Optional
     minEvictableIdleTimeMillis: 60000       # Optional
     timeBetweenEvictionRunsMillis: 30000    # Optional
     numTestsPerEvictionRun: -1              # Optional
     blockWhenExhausted: true                # Optional
     nettyThreads: 32                        # Optional
     subscriptionsPerConnection: 10          # Optional
     subscriptionConnectionPoolSize: 100     # Optional
     pageSizeInBytes: 8192                   # Optional
     readTimeout: 2000                       # Optional
```

## Manajer rahasia untuk cache Redis
<a name="ba-runtime-redis-secrets-properties"></a>

`application-main.yaml`File tersebut dapat mereferensikan ARN rahasia untuk cache Redis. Untuk informasi tentang cara mengintegrasikan AWS Secrets Manager untuk mengambil detail koneksi Redis dengan aman saat runtime, lihat. [AWS Transformasi untuk rahasia Runtime mainframe](ba-runtime-config-app-secrets.md)