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à.
# Tutorial: Usa AWS Transform for mainframe Developer sulle applicazioni WorkSpaces
Questo tutorial mostra come accedere a AWS Transform for mainframe Developer on WorkSpaces Applications e utilizzarlo con un'applicazione di esempio in modo da poterne provare le funzionalità. Al termine di questo tutorial, puoi seguire gli stessi passaggi con le tue applicazioni.
**Topics**
+ [Fase 1: crea un database](#tutorial-ba-developer-create-db)
+ [Fase 2: Accedere all'ambiente](#tutorial-ba-developer-access-env)
+ [Fase 3: Configurare il runtime](#tutorial-ba-developer-set-up-runtime)
+ [Passaggio 4: Avvia l'IDE di Eclipse](#tutorial-ba-developer-start-eclipse)
+ [Passaggio 5: configura un progetto Maven](#tutorial-ba-developer-set-up-maven)
+ [Passaggio 6: Configurare un server Tomcat](#tutorial-ba-developer-config-tomcat)
+ [Passaggio 7: Esegui la distribuzione su Tomcat](#tutorial-ba-developer-deploy-tomcat)
+ [Fase 8: Creare il database JICS](#tutorial-ba-developer-create-jics)
+ [Passaggio 9: avviare e testare l'applicazione](#tutorial-ba-developer-test-app)
+ [Fase 10: Eseguire il debug dell'applicazione](#tutorial-ba-developer-debug)
+ [Eseguire la pulizia delle risorse](#tutorial-ba-developer-clean)
## Fase 1: crea un database
In questa fase, utilizzi Amazon RDS per creare un database PostgreSQL gestito che l'applicazione demo utilizza per archiviare le informazioni di configurazione.
1. Apri la console Amazon RDS.
1. Scegli **Database > Crea database**.
1. **Scegli **Standard create > PostgreSQL**, lascia la versione predefinita, quindi scegli Livello gratuito.**
1. Scegli un identificatore di istanza DB.
1. Per **Impostazioni delle credenziali**, scegli **Gestisci le credenziali principali** in. Gestione dei segreti AWS Per ulteriori informazioni, consulta la sezione [Gestione delle password con Amazon RDS e Gestione dei segreti AWS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html) nella *Guida per l'utente di Amazon RDS*.
1. Assicurati che il VPC sia lo stesso che usi per l'istanza WorkSpaces Applications. Puoi chiedere al tuo amministratore questo valore.
1. Per il **gruppo di sicurezza VPC**, scegli **Crea** nuovo.
1. Imposta **l'accesso pubblico** su **Sì**.
1. Lascia tutti gli altri valori predefiniti. Rivedi questi valori.
1. Scegliere **Crea database**.
Per rendere il server di database accessibile dalla tua istanza, seleziona il server di database in Amazon RDS. In **Connettività e sicurezza**, scegli il gruppo di sicurezza VPC per il server del database. Questo gruppo di sicurezza è stato creato in precedenza per te e dovrebbe avere una descrizione simile a quella nella console di **gestione Created by RDS**. Scegli **Azione > Modifica regole in entrata**, scegli **Aggiungi regola** e crea una regola di tipo **PostgreSQL**. Per l'origine della regola, usa il gruppo di sicurezza **predefinito**. Puoi iniziare a digitare il nome della fonte nel campo **Origine** e quindi accettare l'ID suggerito. Infine, scegli **Salva regole**.
## Fase 2: Accedere all'ambiente
In questo passaggio, si accede all'ambiente di sviluppo AWS Transform for mainframe su WorkSpaces Applications.
1. Contatta l'amministratore per sapere come accedere correttamente all'istanza di WorkSpaces Applications. Per informazioni generali sui possibili client e configurazioni, consulta [WorkSpaces Applications Access Methods and Clients](https://docs.aws.amazon.com/appstream2/latest/developerguide/clients-access-methods-user.html) nella *Amazon WorkSpaces Applications Administration Guide*. Valuta la possibilità di utilizzare il client nativo per un'esperienza ottimale.
1. In WorkSpaces Applicazioni scegli **Desktop**.
## Fase 3: Configurare il runtime
In questo passaggio, si configura il runtime AWS Transform for mainframe. È necessario configurare il runtime al primo avvio e di nuovo se si riceve una notifica di aggiornamento del runtime. Questo passaggio popola la `.m2` cartella.
1. Scegli **Applicazioni**, dalla barra dei menu, quindi scegli **Terminale**.
1. Immetti il comando seguente:
```
~/_install-velocity-runtime.sh
```
## Passaggio 4: Avvia l'IDE di Eclipse
In questo passaggio, avvii l'IDE di Eclipse e scegli una posizione in cui desideri creare uno spazio di lavoro.
1. **In WorkSpaces Applicazioni, scegli l'icona Avvia applicazione sulla barra degli strumenti, quindi scegli Eclipse JEE.**
![\[Avvia l'icona dell'applicazione sulla barra degli strumenti in Applicazioni. WorkSpaces Eclipse JEE è selezionato.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/aas-ba-eclipse.png)
1. **Quando si apre il programma di avvio, inserisci la posizione in cui desideri creare l'area di lavoro e scegli Avvia.**
![\[AWS Transform for mainframeLauncher IDE Eclipse in Applicazioni. WorkSpaces L'area di lavoro è selezionata.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/ba-eclipse-launcher.png)
Facoltativamente, è possibile avviare Eclipse dalla riga di comando, come segue:
```
~/eclipse &
```
## Passaggio 5: configura un progetto Maven
In questo passaggio, si importa un progetto Maven per l'applicazione demo Planets.
1. Carica [PlanetsDemo-pom.zip nella](https://d3lkpej5ajcpac.cloudfront.net/appstream/bluage/developer-ide/PlanetsDemo/PlanetsDemo-pom.zip) tua cartella Home. A tale scopo, puoi utilizzare la funzione nativa del client «I miei file».
1. Usa lo strumento da riga di `unzip` comando per estrarre i file.
1. Naviga all'interno della cartella decompressa e apri la radice `pom.xml` del progetto in un editor di testo.
1. Modifica la `gapwalk.version` proprietà in modo che corrisponda al runtime AWS Transform for mainframe installato.
Se non siete sicuri della versione installata, eseguite il seguente comando in un terminale:
```
cat ~/runtime-version.txt
```
Questo comando stampa la versione di runtime attualmente disponibile, `3.1.0-b3257-dev` ad esempio.
**Nota**
Non includere il `-dev` suffisso in`gapwalk.version`. Ad esempio, un valore valido sarebbe`3.1.0-b3257`.
1. In Eclipse, scegli **File**, quindi **Importa**. Nella finestra di dialogo **Importa**, espandi **Maven e scegli Progetti Maven** **esistenti**. Scegli **Next (Successivo)**.
1. **In **Importa progetti Maven**, fornisci la posizione dei file estratti e scegli Fine.**
Puoi tranquillamente ignorare il seguente popup. Maven scarica una copia locale di `node.js` per creare la parte Angular (\$1-web) del progetto:
![\[Messaggio di avviso relativo alla mancanza di node.js.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/ba-eclipse-node-warning.png)
Attendi fino alla fine della compilazione. Puoi seguire la build nella vista **Progress**.
1. In Eclipse, seleziona il progetto e scegli **Esegui come**. Quindi scegli **Maven install**. Una volta completata l'installazione di Maven, crea il file seguente. `war` `PlanetsDemoPom/PlanetsDemo-web/target/PlanetsDemo-web-1.0.0.war`
## Passaggio 6: Configurare un server Tomcat
In questo passaggio, si configura un server Tomcat in cui distribuire e avviare l'applicazione compilata.
1. **In Eclipse, scegli **Finestra > Mostra vista > Server per mostrare la vista dei server**:**
![\[AWS Trasforma per mainframe Eclipse con la visualizzazione Server selezionata.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/ba-eclipse-servers.png)
1. Scegli **Non ci sono server disponibili. Fai clic su questo link per creare un nuovo server...** . Viene visualizzata la procedura guidata **New Server**. **Nel campo **Seleziona il tipo di server** della procedura guidata, inserisci **tomcat v9 e scegli Tomcat v9.0** Server.** Quindi scegli **Successivo**.
![\[La finestra di dialogo Nuovo server. È selezionato il server Tomcat v9.0.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/ba-eclipse-new-server.png)
1. Scegli **Sfoglia** e scegli la cartella **tomcat** nella radice della cartella Home. **Lascia JRE al valore predefinito e scegli Fine.**
**Un progetto **Servers** viene creato nell'area di lavoro e un server Tomcat v9.0 è ora disponibile nella vista Server.** Qui verrà distribuita e avviata l'applicazione compilata:
![\[AWS Scheda Transform for mainframe Eclipse Servers con il nuovo server Tomcat elencato.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/ba-eclipse-server-added.png)
## Passaggio 7: Esegui la distribuzione su Tomcat
In questo passaggio, distribuisci l'applicazione demo Planets sul server Tomcat in modo da poter eseguire l'applicazione.
1. Seleziona il `PlanetsDemo-web` file e scegli **Esegui come > Maven** install. Seleziona `PlanetsDemo-web` di nuovo e scegli **Aggiorna** per assicurarti che il frontend compilato con npm sia correttamente compilato in .war e notato da Eclipse.
1. Carica [PlanetsDemo-runtime.zip](https://d3lkpej5ajcpac.cloudfront.net/appstream/bluage/developer-ide/PlanetsDemo/PlanetsDemo-runtime.zip) sull'istanza e decomprimi il file in una posizione accessibile. Ciò garantisce che l'applicazione demo possa accedere alle cartelle e ai file di configurazione richiesti.
1. Copia il contenuto di `PlanetsDemo-runtime/tomcat-config` nella `Servers/Tomcat v9.0...` sottocartella che hai creato per il tuo server Tomcat:
![\[AWS Trasforma la sottocartella Eclipse Tomcat v9.0 per mainframe e i file in essa contenuti.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/ba-eclipse-tomcat-subfolder.png)
1. Aprire la voce relativa al `tomcat v9.0` server nella vista Server. Viene visualizzato l'editor delle proprietà del server:
![\[L'editor delle proprietà del server. La scheda Panoramica è selezionata.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/ba-eclipse-server-properties-editor.png)
1. Nella scheda **Panoramica**, aumenta **i valori dei timeout** a 450 secondi per Start e 150 secondi per Stop, come illustrato di seguito:
![\[Valore di timeout di inizio impostato su 450 secondi. Valore di timeout di arresto impostato su 150 secondi.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/ba-eclipse-timeout-values.png)
1. Scegli **Open launch configuration**. Viene visualizzata una procedura guidata. **Nella procedura guidata, accedete alla cartella **Arguments** e, per **Working directory**, scegliete Altro.** Scegliete **File System** e accedete alla `PlanetsDemo-runtime` cartella decompressa in precedenza. **Questa cartella dovrebbe contenere una sottocartella diretta chiamata config.**
![\[La finestra di dialogo Modifica configurazioni con la directory di lavoro specificata nel campo Altro.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/ba-eclipse-edit-configuration.png)
1. Scegliete la scheda **Moduli** dell'editor delle proprietà del server e apportate le seguenti modifiche:
+ Scegli **Aggiungi modulo Web** e aggiungi`PlanetsDemo-service`.
+ Scegli **Aggiungi modulo Web esterno**. Viene visualizzata la finestra di dialogo **Aggiungi modulo Web**. Apporta le seguenti modifiche:
+ In **Document Base**, scegliete **Sfoglia** e accedete a `~/webapps/gapwalk-application...war`
+ In **Path**, inserisci`/gapwalk-application`.
+ Scegli OK.
+ **Scegliete nuovamente Aggiungi modulo Web esterno** e apportate le seguenti modifiche:
+ Per **Document base**, inserisci il percorso del frontend .war (in) `PlanetsDemo-web/target`
+ Per **Path**, inserisci `/demo`
+ Seleziona OK
+ Salva le modifiche all'editor (Ctrl \$1 S).
Il contenuto dell'editor dovrebbe ora essere simile al seguente.
![\[La scheda Moduli Web per le proprietà del server Tomcat con i moduli elencati.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/ba-eclipse-web-modules.png)
## Fase 8: Creare il database JICS
In questo passaggio, ti connetti al database in [Fase 1: crea un database](#tutorial-ba-developer-create-db) cui hai creato.
1. Dall'istanza WorkSpaces Applications, esegui il seguente comando in un terminale per avviare`pgAdmin`:
```
./pgadmin-start.sh
```
1. Scegli un indirizzo e-mail e una password come identificatori di accesso. Prendi nota dell'URL fornito (in genere http://127.0.0.1:5050). Avvia Google Chrome nell'istanza, copia e incolla l'URL nel browser e accedi con i tuoi identificatori.
![\[La finestra di dialogo di accesso di pgAdmin.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/ba-pgadmin-login.png)
1. Dopo aver effettuato l'accesso, scegli **Aggiungi nuovo server** e inserisci le informazioni di connessione al database creato in precedenza come segue.
![\[La finestra di dialogo pgAdmin Register Server. La scheda Connessione è selezionata.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/ba-pgadmin-register-server.png)
1. Quando ti connetti al server del database, usa **Oggetto > Crea > Database** e crea un nuovo database denominato **jics.**
1. Modifica le informazioni di connessione al database utilizzate dall'app demo. Queste informazioni sono definite in`PlanetsDemo-runtime/config/application-main.yml`. Cerca la `jicsDs` voce. Per recuperare i valori per `username` e`password`, nella console Amazon RDS, accedi al database. Nella scheda **Configuration (Configurazione)**, in **Master Credentials ARN (ARN delle credenziali principali)**, scegli **Manage in Secrets Manager (gestisci in secrets manager)**. Quindi, nella console di Secrets Manager, nel campo segreto, scegli **Recupera valore segreto**.
## Passaggio 9: avviare e testare l'applicazione
In questo passaggio, si avvia il server Tomcat e l'applicazione demo in modo da poterla testare.
1. **Per avviare il server Tomcat e le applicazioni precedentemente distribuite, seleziona la voce relativa al server nella vista Server e scegli Avvia.** Viene visualizzata una console che mostra i registri di avvio.
1. Controlla lo stato del **server** nella vista Server o attendi il messaggio di **avvio del server tra [xxx] millisecondi nella** console. Dopo l'avvio del server, verifica che gapwalk-application sia distribuita correttamente. Per fare ciò, accedi all'URL **http://localhost:8080/gapwalk-application** in un browser Google Chrome. Dovresti vedere quanto segue.
![\[Messaggio di conferma che indica che l'applicazione jics è in esecuzione.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/ba-jics-run-confirm.png)
1. Accedi al frontend dell'applicazione distribuita da Google Chrome all'indirizzo http://localhost:8080/demo. Dovrebbe apparire la seguente pagina **Transaction Launcher**.
![\[La pagina di avvio delle transazioni JICS.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/ba-jics-launcher.png)
1. Per avviare la transazione dell'applicazione, inserisci `PINQ` nel campo di immissione e scegli **Esegui** (o premi Invio).
Dovrebbe apparire la schermata dell'app demo.
![\[La schermata PlanetsDemo dell'applicazione in modalità inserimento.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/ba-demo-app-screen.png)
1. Digita il nome di un pianeta nel campo corrispondente e premi Invio.
![\[La schermata PlanetsDemo dell'applicazione con la Terra inserita nel campo Nome del pianeta.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/ba-demo-with-data.png)
## Fase 10: Eseguire il debug dell'applicazione
In questo passaggio, esegui il test utilizzando le funzionalità di debug standard di Eclipse. Queste funzionalità sono disponibili quando si lavora su un'applicazione modernizzata.
1. Per aprire la classe di servizio principale, premi Ctrl \$1 Shift \$1 T. Quindi inserisci. `PlanetsinqProcessImpl`
![\[La finestra di dialogo Eclipse Open Type è inserita PlanetsinqProcessImpl .\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/ba-eclipse-open-type.png)
1. Passa al `searchPlanet` metodo e inserisci lì un punto di interruzione.
1. Seleziona il nome del server e seleziona **Riavvia in Debug**.
1. Ripeti i passaggi precedenti. Cioè, accedi all'applicazione, inserisci il nome di un pianeta e premi Invio.
Eclipse interromperà l'applicazione nel `searchPlanet` metodo. Ora puoi esaminarlo.
## Eseguire la pulizia delle risorse
Se non ti servono più le risorse che hai creato per questo tutorial, eliminale in modo da non incorrere in costi aggiuntivi. Completa questa procedura:
+ Se l'applicazione Planets è ancora in esecuzione, interrompila.
+ Elimina il database in cui hai creato[Fase 1: crea un database](#tutorial-ba-developer-create-db). Per ulteriori informazioni, consulta la sezione relativa all'[eliminazione di un'istanza database](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteInstance.html).