AWS Il servizio di modernizzazione del mainframe (esperienza Managed Runtime Environment) non è più aperto a nuovi clienti. Per funzionalità simili a AWS Mainframe Modernization Service (esperienza Managed Runtime Environment), esplora AWS Mainframe Modernization Service (Self-Managed Experience). I clienti esistenti possono continuare a utilizzare il servizio normalmente. [Per ulteriori informazioni, consulta AWS Modifica della disponibilità di Mainframe Modernization.](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Configurare la configurazione per AWS Transform for mainframe Runtime
<a name="ba-runtime-config"></a>

 AWS Transform for mainframe Runtime e il codice client sono applicazioni Web che utilizzano il [framework Spring Boot](https://docs.spring.io/spring-boot/docs/2.5.14/reference/html/). Sfrutta le funzionalità di Spring per fornire la configurazione, con diverse posizioni possibili e regole di precedenza. Esistono anche regole di precedenza simili per fornire molti altri file, come groovy scripts, sql, ecc.

Il AWS Transform for mainframe Runtime contiene anche applicazioni web opzionali aggiuntive, che possono essere attivate se necessario.

**Topics**
+ [Nozioni di base sulla configurazione delle applicazioni](#ba-runtime-config-app-basics)
+ [Precedenza delle applicazioni](#ba-runtime-config-app-precedence)
+ [JNDI per database](#ba-runtime-config-app-jndi)
+ [AWS I segreti di Transform for mainframe Runtime](ba-runtime-config-app-secrets.md)
+ [Altri file (groovy, sql, ecc.)](#ba-runtime-config-app-files)
+ [Applicazione web aggiuntiva](#ba-runtime-config-app-webapp)
+ [Abilita le proprietà per AWS Transform for mainframe Runtime](ba-runtime-key-value.md)
+ [Proprietà della cache Redis disponibili in AWS Transform for mainframe Runtime](ba-runtime-redis-configuration.md)
+ [Configurare la sicurezza per le applicazioni Gapwalk](ba-runtime-security.md)

## Nozioni di base sulla configurazione delle applicazioni
<a name="ba-runtime-config-app-basics"></a>

Il modo predefinito per gestire la configurazione delle applicazioni consiste nell'uso di file YAML dedicati da fornire nella cartella del server delle applicazioni. `config` Esistono due file di configurazione YAML principali:
+ `application-main.yaml`
+ `application-profile.yaml`(dove `profile` il valore è impostato durante la generazione dell'applicazione).

Il primo file configura il framework, ad esempio`Gapwalk-application.war`, mentre il secondo riguarda opzioni aggiuntive specifiche per l'applicazione client. Funziona con l'uso di profili Spring: l'applicazione Gapwalk utilizza il `main` profilo, mentre l'applicazione client utilizza il profilo. `profile`

L'esempio seguente mostra un tipico file YAML principale.

![\[Estratto di un file YAML «principale».\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/main-yaml.png)


L'esempio seguente mostra un tipico file YAML del client.

![\[Esempio di client YAML\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/client-yaml.png)


Per informazioni sul contenuto dei file YAML, vedere. [Abilita le proprietà per AWS Transform for mainframe Runtime](ba-runtime-key-value.md)

## Precedenza delle applicazioni
<a name="ba-runtime-config-app-precedence"></a>

Per questi file di configurazione, si applicano le regole di precedenza Spring. In particolare:
+ Il file `application-main` YAML appare nel file di guerra principale di Gapwalk con i valori predefiniti e quello nella cartella lo sostituisce. `config`
+ Lo stesso dovrebbe essere fatto per la configurazione dell'applicazione client
+ È possibile passare parametri aggiuntivi sulla riga di comando al momento dell'avvio del server. Avrebbero la precedenza su quelli YAML.

Per ulteriori informazioni, consulta la documentazione [ufficiale di Spring](https://docs.spring.io/spring-boot/docs/2.5.14/reference/html/features.html#features.external-config) Boot.

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

La configurazione del database potrebbe essere fornita con JNDI nel file context.xml in Tomcat. Qualsiasi configurazione di questo tipo avrebbe la precedenza su quella YAML. Ma fai attenzione che l'utilizzo di questa opzione non ti consentirà di racchiudere le tue credenziali in un gestore segreto (vedi sotto).

L'esempio seguente mostra configurazioni di esempio per JICS e database. Blusam

```
<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  
Sarebbe `jdbc/jics` per il database JICS e `jdbc/bluesam` (presta attenzione alla «e») per il database. Blusam

url="jdbc:postgresql: //xxxx.rds.amazonaws.com:5432/XXXX» username="XXXX» password="XXXX»  
L'url, il nome utente e la password del database.

## Altri file (groovy, sql, ecc.)
<a name="ba-runtime-config-app-files"></a>

Gli altri file utilizzati dal progetto del cliente utilizzano regole di precedenza simili a quelle per la configurazione primaverile. Esempi:
+ Gli script Groovy sono `.groovy` file nella cartella o nelle sottocartelle. `scripts` 
+ Gli script SQL sono `.sql` file contenuti nella cartella o nelle sottocartelle. `sql`
+ Gli script daemon sono `.groovy` file contenuti nella cartella o nelle sottocartelle. `daemons` 
+ Queries Database mapping file sono file `queries-database.mapping` denominati file nelle sottocartelle delle cartelle. `sql`
+ I modelli Jasper sono `.jrxml` file contenuti nella cartella o nelle sottocartelle`templates`. 
+ I cataloghi dei set di dati sono `.json` file contenuti nella cartella. `catalog`
+ I file Lnk sono `.json` file contenuti nella cartella. `lnk`

Tutte queste posizioni possono essere sovrascritte tramite una proprietà di sistema o una proprietà YAML del client.
+ Per gli script Groovy: `configuration.scripts`
+ Per gli script SQL: `configuration.sql`
+ Per gli script Daemon: `configuration.daemons`
+ Per il file di mappatura del database Queries: `configuration.databaseMapping`
+ Per i modelli Jasper: `configuration.templates`
+ Per i cataloghi Dataset: `configuration.catalog`
+ Per i file Lnk: `configuration.lnk`

Se la proprietà non viene trovata, i file verranno prelevati dalla posizione predefinita sopra menzionata. La ricerca verrà eseguita prima con la directory di lavoro di tomcat come root e infine nel file war dell'applicazione.

## Applicazione web aggiuntiva
<a name="ba-runtime-config-app-webapp"></a>

 AWS Transform for mainframe Runtime contiene applicazioni Web aggiuntive nella sua `webapps-extra` cartella. Queste applicazioni non sono servite per impostazione predefinita dal server tomcat.

L'attivazione di queste applicazioni Web dipende dal progetto di modernizzazione e viene effettuata spostando il file war desiderato dalla `webapps-extra` cartella alla cartella. `webapps` Dopodiché, la guerra verrà gestita dal server tomcat al prossimo avvio.

Alcune configurazioni aggiuntive specifiche del progetto possono anche essere aggiunte in un file di configurazione YAML per ogni guerra aggiuntiva, come viene fatto nel file e spiegato sopra. `application-main.yml` Le guerre aggiuntive sono:
+ `gapwalk-utility-pgm.war`: contiene il supporto per i programmi di utilità ZOS e li utilizza `application-utility-pgm.yaml` come configurazione.
+ `gapwalk-cl-command.war`: contiene il supporto per i programmi di utilità AS/400 e li utilizza `application-cl-command.yaml` come configurazione.
+ `gapwalk-hierarchical-support.war`: contiene il supporto per le IMS/MFS transazioni e utilizza `application-jhdb.yaml` come configurazione