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 AWS Transform for mainframe Runtime su Amazon EC2
<a name="ba-runtime-deploy-ec2"></a>

Questo argomento spiega come configurare e distribuire l'applicazione di PlanetsDemo esempio utilizzando AWS Transform for mainframe Runtime su Amazon EC2.

**Topics**
+ [Prerequisiti](#ba-runtime-deploy-prereq)
+ [Configurazione](#ba-runtime-deploy-setup)
+ [Verifica l'applicazione distribuita](#ba-runtime-deploy-test)

## Prerequisiti
<a name="ba-runtime-deploy-prereq"></a>

Prima di iniziare, assicurati di completare i seguenti prerequisiti.
+ Configura il AWS CLI seguendo i passaggi descritti in [Configurazione dell'interfaccia a riga di comando di AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html).
+ Completa [AWS Prerequisiti di Transform for mainframe Runtime](ba-runtime-setup-prereq.md) e. [Onboarding AWS Transform per mainframe Runtime](ba-runtime-setup-onboard.md)
+ Crea un'istanza Amazon EC2 utilizzando uno dei tipi di istanza supportati. Per ulteriori informazioni, consulta [Nozioni di base sulle istanze Amazon EC2 Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html).
+ Assicurati di poterti connettere correttamente all'istanza Amazon EC2, ad esempio utilizzando SSM.
**Nota**  
In questa guida, si presume che il percorso di installazione di Tomcat sia. `/m2-anywhere/tomcat-gapwalk/velocity` Assicuratevi di utilizzare questo percorso quando seguite le istruzioni riportate di seguito o adattate le seguenti istruzioni al percorso di vostra scelta.
+ Scarica ed estrai AWS Transform for mainframe Runtime (su Amazon EC2) direttamente `/m2-anywhere/tomcat-gapwalk/velocity` nella directory velocity (la cartella di installazione di Tomcat). Per istruzioni su come recuperare gli artefatti di AWS Transform for mainframe Runtime, incluse informazioni sullo storage, l'accesso e il contenuto, consulta. [AWS Transform for mainframe Runtime artefact](ba-runtime-artifacts.md)
+ [Scaricate l'archivio dell'applicazione. PlanetsDemo](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip)
+ Decomprimi l'archivio e carica l'applicazione in un bucket Amazon S3 a tua scelta.
+ Crea un database Amazon Aurora PostgreSQL per JICS. AWS Transform for mainframe Runtime eseguirà automaticamente lo script al `PlanetsDemo-v1/jics/sql/initJics.sql` primo avvio. Per informazioni su come creare un database Amazon Aurora PostgreSQL, consulta Creazione e [connessione a](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster) un cluster Aurora PostgreSQL DB.

## Configurazione
<a name="ba-runtime-deploy-setup"></a>

Per configurare l'applicazione di esempio, completa i seguenti passaggi. PlanetsDemo 

1. Connettiti alla tua istanza Amazon EC2 e vai alla `conf` cartella sotto la cartella di installazione di Apache Tomcat. Apri il `catalina.properties` file per modificarlo e sostituisci la riga che inizia `common.loader` con la riga seguente.

   ```
   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. Accedi alla cartella `/m2-anywhere/tomcat-gapwalk/velocity/webapps`.

1. Copia i PlanetsDemo file binari disponibili nella `PlanetsDemo-v1/webapps/` cartella dal bucket Amazon S3 utilizzando il seguente comando.

   ```
   aws s3 cp s3://path-to-demo-app-webapps/ . --recursive
   ```
**Nota**  
Sostituiscilo `path-to-demo-app-webapps` con l'URI Amazon S3 corretto per il bucket in cui hai precedentemente decompresso l'archivio. PlanetsDemo 

1. Copia il contenuto della cartella in. `PlanetsDemo-v1/config/` `/m2-anywhere/tomcat-gapwalk/velocity/config/`

1. Fornisci le informazioni di connessione per il database che hai creato come parte dei prerequisiti nel seguente frammento del file. `/m2-anywhere/tomcat-gapwalk/velocity/config/application-main.yml` Per ulteriori informazioni, consulta [Creazione e connessione a un cluster Aurora PostgreSQL DB](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. Avvia il server Apache Tomcat e verifica i log.

   ```
   /m2-anywhere/tomcat-gapwalk/velocity/startup.sh
   
   tail -f /m2-anywhere/tomcat-gapwalk/velocity/logs/catalina.log
   ```

   Se trovi codici di errore che iniziano con una C seguita da un numero, ad esempio CXXXX, prendi nota dei messaggi di errore. Ad esempio, il codice di errore C5102 è un errore comune che indica una configurazione errata dell'infrastruttura.

## Verifica l'applicazione distribuita
<a name="ba-runtime-deploy-test"></a>

Per un esempio di come testare l' PlanetsDemo applicazione, vedere[Prova l' PlanetsDemo applicazione](ba-runtime-test-planetsdemo.md).