

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

# Esegui l'upgrade di AWS Transform for mainframe Runtime su Amazon EC2
<a name="ba-runtime-maint-ec2"></a>

Questa guida descrive come aggiornare AWS Transform for mainframe Runtime su Amazon EC2.

**Topics**
+ [Prerequisiti](#ba-runtime-maint-prereq)
+ [Esegui l'upgrade di AWS Transform for mainframe Runtime nell'istanza Amazon EC2](#ba-runtime-maint-copy-files)
+ [Aggiorna il runtime AWS Transform for mainframe in un contenitore](#ba-runtime-maint-copy-files)

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

Prima di iniziare, assicurati di soddisfare i seguenti prerequisiti.
+ Per verificare se esistono istruzioni specifiche per la versione in uso, consulta[Istruzioni per l'aggiornamento di AWS Transform for mainframe](ba-migration-notes.md).
+ 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).
+ Assicurati di avere un'istanza Amazon EC2 con un'installazione esistente di AWS Transform for mainframe Runtime. 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.
+ Scarica la versione di AWS Transform for mainframe Runtime a cui desideri eseguire l'aggiornamento. Il framework è composto da due file di archivio: `gapwalk-x.y.z.zip` e`aws-bluage-webapps-x.y.z.zip`. Per ulteriori informazioni, consulta [AWS Transform for mainframe Runtime artefact](ba-runtime-artifacts.md).

## Esegui l'upgrade di AWS Transform for mainframe Runtime nell'istanza Amazon EC2
<a name="ba-runtime-maint-copy-files"></a>

Completa i seguenti passaggi per aggiornare AWS Transform for mainframe Runtime.

1. Connettiti alla tua istanza Amazon EC2 e cambia l'utente in **su** eseguendo il comando seguente.

   ```
   sudo su
   ```

   È necessario il privilegio di superutente per eseguire i comandi in questo tutorial.

1. Per estrarre i file binari, usa i seguenti comandi. Esegui i comandi in ogni cartella.

   ```
   unzip gapwalk-x.y.z.zip
   unzip aws-bluage-webapps-x.y.z.zip
   ```

1. Arrestare i servizi Apache Tomcat utilizzando i seguenti comandi.

   ```
   systemctl stop tomcat.service
   systemctl stop tomcat-webapps.service
   ```

1. Sostituisci il contenuto di `<your-tomcat-path>/shared/` con il contenuto di. `gapwalk-x.y.z/shared/`

1. Sostituisci `<your-tomcat-path>/webapps/gapwalk-application.war` con `gapwalk-x.y.z/webapps/gapwalk-application.war`.

1. Sostituisci i file di guerra in`<your-tomcat-path>/webapps/`, vale a dire `bac.war` e`jac.war`, con gli stessi file di`aws-bluage-webapps-x.y.z/velocity/webapps/`.

1. Avvia i servizi Apache Tomcat eseguendo i seguenti comandi.

   ```
   systemctl start tomcat.service
   systemctl start tomcat-webapps.service
   ```

1. Controllo dei log.

Per verificare lo stato dell'applicazione distribuita, esegui i seguenti comandi.

```
curl http://localhost:8080/gapwalk-application/
```

Deve essere visualizzato il seguente messaggio.

```
Jics application is running
```

```
curl http://localhost:8181/jac/api/services/rest/jicsservice/
```

Deve essere visualizzato il seguente messaggio.

```
Jics application is running
```

```
curl http://localhost:8181/bac/api/services/rest/bluesamserver/serverIsUp
```

La risposta dovrebbe essere vuota.

Il runtime di AWS Transform for mainframe è stato aggiornato correttamente.

## Aggiorna il runtime AWS Transform for mainframe in un contenitore
<a name="ba-runtime-maint-copy-files"></a>

Completa i seguenti passaggi per aggiornare AWS Transform for mainframe Runtime.

1. Ricostruisci l'immagine Docker con la versione AWS Transform for mainframe Runtime desiderata. Per istruzioni, consulta [Configurare AWS Transform for mainframe Runtime su Amazon EC2](ba-runtime-deploy-ec2.md).

1. Invia la tua immagine Docker al tuo repository Amazon ECR.

1. Interrompi e riavvia il servizio Amazon ECS o Amazon EKS.

1. Controllo dei log.

 AWS Transform for mainframe Runtime è stato aggiornato correttamente.