

AWS Le service de modernisation du mainframe (expérience de l'environnement d'exécution géré) n'est plus ouvert aux nouveaux clients. Pour des fonctionnalités similaires au service de modernisation AWS du mainframe (expérience de l'environnement d'exécution géré), explorez le service de modernisation AWS du mainframe (expérience autogérée). Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez la section [Modification de la disponibilité de la modernisation du AWS mainframe](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Propriétés du cache Redis disponibles dans AWS Transform for mainframe Runtime
<a name="ba-runtime-redis-configuration"></a>

Vous pouvez utiliser ce document pour en savoir plus sur les caches Redis dans AWS Transform for mainframe Runtime, ainsi que sur la configuration de Gapwalk, les propriétés Redis prises en charge et sur la manière dont le fichier `application-main.yml` peut référencer l'ARN secret pour les caches Redis.

## Redis met en cache dans AWS Transform for mainframe Runtime
<a name="ba-redis-caches-in-runtime"></a>

Les serveurs Redis peuvent être utilisés comme caches pour diverses fonctionnalités de l'application Gapwalk AWS Transform for mainframe, telles que :


****  

| AWS Fonctionnalités d'exécution de Transform for mainframe qui utilisent la mise en cache Redis | Description | 
| --- | --- | 
| Blusamcache | Un Blusam cache Redis pour lire les enregistrements de manière efficace, en utilisant une stratégie d'écriture différée, afin d'optimiser les charges de travail intensives en écriture rencontrées sur les charges utiles par lots.  | 
| Blusamserrures | Un cache pour les verrous distribués pour les ensembles de données et les enregistrements. | 
| Catalogue de jeux de données | Le cache du jeu de données du catalogue. | 
| Cache de session | Un cache Redis pour. HttpSession Le cache stocke le nom d'utilisateur, l'état du dialogue avec le frontend Angular et des informations spécifiques sur le « dialecte » (BMS, MFS). AS400 | 
| Suivi de session | Un cache de sessions actives avec le nom d'utilisateur et les session-creation-time informations associés. | 
| cache JICS | Un cache pour les définitions de ressources JICS. | 
| files d'attente TS | Stockage pour les files d'attente TS. | 
| Point de contrôle JCL |  Cache de point de contrôle JCL. | 
| Verrouillages de fichiers Gapwalk | Un cache pour les verrouillages de fichiers distribués par tâche. | 
| Serrures Blu4iv | Stockage pour les verrous d'enregistrement Blu4IV. | 

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

La configuration Redis globale est utilisée si elle `redis` est spécifiée comme mécanisme de mise en cache et qu'aucune configuration Redis n'est fournie pour la fonctionnalité spécifique. Cette configuration vous permet d'utiliser la même configuration pour plusieurs caches Redis simultanément.

Dans l'exemple suivant, le cache Blusam des ensembles de données et le cache JICS utilisent la configuration `gapwalk.redis` (`redis.server1`) car leur type de cache est défini sur et aucune propriété Redis implicite n'est spécifiée sous et. `redis` [Définitions des ressources JICS](#ba-runtime-redis-jics-cache) [Définitions des ressources JICS](#ba-runtime-redis-jics-cache) Cependant, le cache de Blusam verrous utilisera une configuration Redis différente (`redis.server2`) car ses propriétés Redis sont définies de manière explicite.

```
...
 
 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
 ...
```

 Pour activer la configuration globale de Redis, ajoutez la configuration suivante dans`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
```

## Propriétés Redis prises en charge
<a name="ba-runtime-redis-supported-properties"></a>

Le tableau suivant indique les propriétés Redis prises en charge pour les caches Redis globaux et spécifiques sur AWS Transform for mainframe Runtime.


****  

| Nom de la propriété | Obligatoire ? | Description | Valeurs | Par défaut | 
| --- | --- | --- | --- | --- | 
| mode | Non | Le mode de fonctionnement de Redis. | standalone \| cluster | standalone | 
| hostname | Oui | Le nom d'hôte ou l'adresse IP du serveur Redis. | chaîne | null | 
| port | Oui | Le numéro de port sur lequel le serveur Redis écoute les connexions. | int | null | 
| username | Non | Nom d'utilisateur pour l'authentification. | chaîne | null | 
| password | Non | Le mot de passe pour l'authentification. | chaîne | chaîne vide | 
| useSsl  | Non | Spécifie s'il faut activer SSL/TLS le chiffrement pour la connexion Redis. | boolean | false | 
| database | Non | Le numéro de base de données Redis à utiliser. Redis prend en charge plusieurs bases de données logiques, et cette propriété indique laquelle utiliser. | int | 0 | 
| maxTotal | Non | Le nombre maximum de connexions autorisées dans le pool de connexions Redis. | int  | 128 | 
| maxIdle | Non | Le nombre maximum de connexions inactives autorisées dans le pool de connexions Redis. | int | 128 | 
| minIdle | Non | Le nombre minimum de connexions inactives à maintenir dans le pool de connexions Redis. | int | 16 | 
| testOnBorrow  | Non | Valeur booléenne indiquant s'il faut valider les connexions avant de les emprunter au pool. | boolean | true | 
| testOnReturn  | Non | Valeur booléenne indiquant s'il faut valider les connexions avant de les renvoyer au pool.  | boolean | true | 
| testWhileIdle  | Non | Valeur booléenne indiquant s'il faut valider régulièrement les connexions inactives dans le pool. | boolean | true | 
| testOnCreate  | Non | Valeur booléenne indiquant si les connexions doivent être validées lors de leur création. | boolean | true | 
| minEvictableIdleTimeMillis  | Non | Durée minimale (en millisecondes) pendant laquelle une connexion inactive doit rester dans le pool avant de pouvoir être expulsée. | long | 60000 L  | 
| timeBetweenEvictionRunsMillis  | Non | Durée (en millisecondes) entre les exécutions successives du thread d'éviction de connexion inactif. | long | 30 000 L | 
| numTestsPerEvictionRun  | Non | Nombre maximal de connexions à tester lors de chaque exécution du thread d'éviction de connexion inactif. | int | -1 | 
| blockWhenExhausted  | Non | Valeur booléenne indiquant s'il faut bloquer et attendre qu'une connexion soit disponible lorsque le pool est épuisé. | boolean | true | 
| nettyThreads  | Non | Le nombre de threads Netty à utiliser pour gérer les connexions Redis. | int | 32 | 
| subscriptionsPerConnection  | Non | Le nombre maximum d'abonnements autorisés par connexion Redis. | int | 10 | 
| subscriptionConnectionPoolSize  | Non | Le nombre maximum de connexions autorisées dans le pool de connexions d'abonnement Redis.  | int | 100 | 
| pageSizeInBytes  | Non | Taille de page par défaut en octets pour les opérations Redis. | long | 262144000  | 
| readTimeout | Non | Le délai de lecture en millisecondes pour les opérations Redis. | long | 2000 | 
| timeToLiveMillis | Non | Durée (en millisecondes) pendant laquelle une entrée de cache reste dans le cache avant d'être considérée comme expirée et supprimée. Si cette propriété n'est pas spécifiée, les entrées du cache n'expireront pas automatiquement par défaut. | long | -1 | 
| useAsyncBatch | Non | Permet l'exécution asynchrone des opérations d'écriture en bloc Redis afin d'améliorer les performances. Lorsque ce paramètre est défini sur false, il revient en mode d'exécution synchrone. | boolean | true | 
| useBatchInMemoryAtomic | Non | Active In-memory-atomic le mode pour les opérations de lecture par lots Redis. Lorsque ce paramètre est défini sur false, il revient au mode batch en mémoire par défaut. | boolean | false | 
| connectionPoolSize | Non | Taille du pool de connexions utilisé pour les connexions du client Redisson au serveur Redis. | int | 64 | 
| connectionMinimumIdleSize | Non | Le nombre minimum de connexions inactives que Redisson conservera dans son pool de connexions. | int | 24 | 
| idleConnectionTimeout | Non | Délai d'expiration en millisecondes après lequel une connexion inactive dans le pool sera fermée. | int | 10 000 | 
| connectTimeout | Non | Délai d'attente en millisecondes pour établir une connexion au serveur Redis. | int | 10 000 | 

## Propriétés du cache Redis
<a name="ba-runtime-redis-caches-properties"></a>

### Cache Redis 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
```

### Cache Redis 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 de session
<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
```

### Définitions des ressources 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
```

### files d'attente 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
```

### Suivi de session
<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
```

### Point de contrôle 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
```

### Verrouillages de fichiers 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
```

### Serrures 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
```

### Catalogue de jeux de données
<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
```

## Gestionnaire secret pour les caches Redis
<a name="ba-runtime-redis-secrets-properties"></a>

Le `application-main.yaml` fichier peut référencer l'ARN secret des caches Redis. Pour plus d'informations sur la manière d'intégrer AWS Secrets Manager afin de récupérer en toute sécurité les détails de connexion Redis lors de l'exécution, consultez[AWS Les secrets d'exécution de Transform for Mainframe](ba-runtime-config-app-secrets.md).