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 Questa sezione spiega i passaggi per configurare AWS Transform for mainframe Runtime sulla tua AWS infrastruttura. Prima di configurare AWS Transform for mainframe Runtime for Applications, è necessario comprendere i prerequisiti, le regioni e i bucket e la configurazione degli CloudWatch allarmi necessari per configurare e gestire l'ambiente di runtime. **Topics** + [AWS Prerequisiti di Transform for mainframe Runtime](ba-runtime-setup-prereq.md) + [Onboarding AWS Transform per mainframe Runtime](ba-runtime-setup-onboard.md) + [Requisiti di configurazione dell'infrastruttura per AWS Transform for mainframe Runtime](ba-infrastructure-setup.md) + [AWS Transform for mainframe Runtime artefact](ba-runtime-artifacts.md) + [Implementa AWS Transform for mainframe Runtime su Amazon EC2](ba-deploy-ec2.md) + [Implementa AWS Transform for mainframe Runtime su container su Amazon ECS e Amazon EKS](ba-deploy-container.md) + [Prova l' PlanetsDemo applicazione](ba-runtime-test-planetsdemo.md) # AWS Prerequisiti di Transform for mainframe Runtime AWS Transform for mainframe Runtime è disponibile in diverse versioni di [AWS Note sulla versione di Transform for mainframe](ba-release-notes.md) rilascio. Se avete progetti di modernizzazione in corso, potreste aver bisogno di versioni incrementali del runtime per scopi di implementazione e test. Per definire le vostre esigenze, contattate il vostro responsabile della distribuzione di AWS Transform for mainframe. Prima di iniziare a utilizzare AWS Transform for mainframe Runtime, procedi come segue: + Assicuratevi di avere un AWS account. + Assicurati di avere un'applicazione modernizzata rifattorizzata con AWS Transform for mainframe. + Scegli una AWS regione e una delle opzioni di elaborazione supportate per Transform for AWS mainframe Runtime. + Scegli la versione di AWS Transform for mainframe Runtime che desideri utilizzare. + Rivedi [Requisiti di configurazione dell'infrastruttura per AWS Transform for mainframe Runtime](ba-infrastructure-setup.md) e convalida i componenti aggiuntivi necessari per eseguire AWS Transform for mainframe Runtime. **Nota** [Se desideri testare le funzionalità di AWS Transform for mainframe Runtime, puoi utilizzare l'applicazione demo`Planets Demo`, che puoi scaricare da -v1.zip. PlanetsDemo](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip) # Onboarding AWS Transform per mainframe Runtime **Nota** L'accesso a AWS Transform for mainframe Runtime è passato dalle richieste basate su ticket al download diretto tramite [AWS Transform](https://bluinsights.aws/) for mainframe refactor. Abbiamo introdotto un modo nuovo e semplificato per accedere ai AWS Transform for mainframe prodotti tramite la funzionalità [AWS Transform for mainframeToolbox](https://bluinsights.aws/docs/bluage-toolbox-introduction) in AWS Transform for mainframe refactor. Per iniziare, crea un [Supporto AWS](https://support.console.aws.amazon.com/support/home)caso per richiedere l'onboarding per accedere a Transform for mainframe Runtime. AWS Includi nella richiesta il tuo Account AWS ID, la AWS regione che desideri utilizzare e una scelta di elaborazione e la versione AWS Transform for mainframe Runtime. Se non sei sicuro di quale versione ti serve, contatta il tuo responsabile della distribuzione di AWS Transform for mainframe. Se disponi già del codice sorgente dell'applicazione generato dagli strumenti AWS Mainframe Modernization Refactoring, annota il valore del `gapwalk.version` tag in un `pom.xml` file all'interno della tua base di codice modernizzata. **Nota** AWS Transform for mainframe Runtime è disponibile in due varianti principali: versioni pre-release Alpha e Releases. Per determinare quale versione utilizzare[AWS Transform per il controllo delle versioni mainframe](ba-versioning.md), consultate o contattate il vostro responsabile della distribuzione di AWS Transform for mainframe. ## Regioni e bucket per AWS Transform for mainframe Runtime Archiviamo gli artefatti AWS Transform for mainframe Runtime in diversi bucket Amazon S3 per regione e per scelta di elaborazione. Per accedere al bucket per for AWS Transform Regione AWS for mainframe Runtime, usa il nome elencato nella tabella seguente. | Regione AWS | Secchio di rilascio | Bucket Alpha pre-release | | --- | --- | --- | | Stati Uniti orientali (Ohio) | aws-bluage-runtime-artifacts-055777665268-us-east-2 | aws-bluage-runtime-artifacts-dev-055777665268-us-east-2 | | Stati Uniti orientali (Virginia settentrionale) | aws-bluage-runtime-artifacts-139023371234-us-est-1 | aws-bluage-runtime-artifacts-dev-139023371234-us-east-1 | | Stati Uniti occidentali (California settentrionale) | aws-bluage-runtime-artifacts-788454048782-us-west-1 | aws-bluage-runtime-artifacts-dev-788454048782-us-west-1 | | Stati Uniti occidentali (Oregon) | aws-bluage-runtime-artifacts-836771190483-us-west-2 | aws-bluage-runtime-artifacts-dev-836771190483-us-west-2 | | Canada (Centrale) | aws-bluage-runtime-artifacts-637423580979-ca-central-1 | aws-bluage-runtime-artifacts-dev-637423580979-ca-central-1 | | Europa (Irlanda) | aws-bluage-runtime-artifacts-925278190477-eu-west-1 | aws-bluage-runtime-artifacts-dev-925278190477-eu-west-1 | | Europa (Londra) | aws-bluage-runtime-artifacts-767397831990-eu-west-1 | aws-bluage-runtime-artifacts-dev-767397831990-eu-west-1 | | Europa (Parigi) | aws-bluage-runtime-artifacts-673009995881-eu-west-3 | aws-bluage-runtime-artifacts-dev-673009995881-eu-west-3 | | Europa (Francoforte) | aws-bluage-runtime-artifacts-485196800481-eu-central-1 | aws-bluage-runtime-artifacts-dev-485196800481-eu-central-1 | | Europa (Stoccolma) | aws-bluage-runtime-artifacts-654654484534-eu-nord-1 | aws-bluage-runtime-artifacts-dev-654654484534-eu-nord-1 | | Europa (Milano) | aws-bluage-runtime-artifacts-654654328338-eu-sud-1 | aws-bluage-runtime-artifacts-dev-654654328338-eu-sud-1 | | Europa (Spagna) | aws-bluage-runtime-artifacts-905417994954-eu-sud-2 | aws-bluage-runtime-artifacts-dev-905417994954-eu-sud-2 | | Sud America (San Paolo) | aws-bluage-runtime-artifacts-737536804457-sa-est-1 | aws-bluage-runtime-artifacts-dev-737536804457-sa-est-1 | | Asia Pacifico (Tokyo) | aws-bluage-runtime-artifacts-445578176276-ap-nord-est-1 | aws-bluage-runtime-artifacts-dev-445578176276-ap-nord-est-1 | | Asia Pacifico (Seul) | aws-bluage-runtime-artifacts-381492221498-ap-nordest-2 | aws-bluage-runtime-artifacts-dev-381492221498-ap-nordest-2 | | Asia Pacifico (Osaka) | aws-bluage-runtime-artifacts-905418229615-ap-nord-est-3 | aws-bluage-runtime-artifacts-dev-905418229615-ap-nord-est-3 | | Asia Pacifico (Singapore) | aws-bluage-runtime-artifacts-767397774613-ap-sudest-1 | aws-bluage-runtime-artifacts-dev-767397774613-ap-sudest-1 | | Asia Pacifico (Sydney) | aws-bluage-runtime-artifacts-726160321909-ap-sutheast-2 | aws-bluage-runtime-artifacts-dev-726160321909-ap-sudest-2 | | Asia Pacifico (Mumbai) | aws-bluage-runtime-artifacts-905418353577-ap-sud-1 | aws-bluage-runtime-artifacts-dev-905418353577-ap-sud-1 | | Africa (Città del Capo) | aws-bluage-runtime-artifacts-992382777663-af-sud-1 | aws-bluage-runtime-artifacts-dev-992382777663-af-sud-1 | | Israele (Tel Aviv) | aws-bluage-runtime-artifacts-471112516508-il-central-1 | aws-bluage-runtime-artifacts-dev-471112516508-il-centrale-1 | ## Utilizzo di per elencare il contenuto del bucket AWS CLI Dopo l'onboarding, puoi elencare il contenuto del bucket eseguendo il seguente AWS CLI comando in un terminale. `aws s3 ls bucket-name ` Sostituiscilo `bucket-name` con il nome del bucket indicato nella tabella Regione AWS precedente. Questo comando restituisce un elenco di cartelle che corrispondono a diverse versioni del runtime AWS Transform for mainframe Runtime, come la seguente per un bucket Release: ``` PRE 4.0.0/ PRE 4.10.0/ ``` Oppure quanto segue per un bucket di compilazione: ``` PRE 4.11.0/ PRE 4.13.0/ ``` Ti consigliamo di utilizzare l'ultima versione disponibile. Se ciò non è possibile, utilizzate la versione di runtime convalidata durante la fase di refactoring dell'applicazione. Per elencare i framework disponibili per una versione specifica, esegui il comando seguente: `aws s3 ls s3://bucket-name/version/Framework/` Sostituiscilo `bucket-name` con il nome del bucket del tuo Regione AWS e `version` con la versione che desideri. Di seguito sono riportati due esempi. Per un bucket di rilascio: `aws s3 ls s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.10.0/Framework/` Il comando restituisce un elenco di file zip, ad esempio: ``` 2025-04-08 16:11:19 152040176 aws-bluage-runtime-4.10.0.zip 2025-04-08 16:11:52 176518889 aws-bluage-webapps-4.10.0.zip ``` Per un bucket Alpha pre-release: `aws s3 ls s3://aws-bluage-runtime-artifacts-dev-139023371234-us-east-1/4.11.0/Framework/` Il comando restituisce un elenco di file zip, ad esempio: ``` 2025-04-09 20:23:34 152304534 aws-bluage-runtime-4.11.0.zip 2025-04-09 20:24:07 176262381 aws-bluage-webapps-4.11.0.zip ``` ## Scarica il framework Puoi scaricare il framework, ad esempio, per aggiornare la versione AWS Transform for mainframe Runtime su un'istanza Amazon EC2 esistente. `aws s3 cp s3://bucket-name/version/Framework/ folder-of-your-choice --recursive ` Dove: folder-of-your-choice percorso della cartella in cui desideri scaricare il framework. Ad esempio: `aws s3 cp s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.0.0/Framework/ . --recursive` Questo comando produce il seguente output: ``` download: s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.0.0/Framework/aws-bluage-webapps-4.0.0.zip to ./aws-bluage-webapps-4.0.0.zip download: s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.0.0/Framework/aws-bluage-runtime-4.0.0.zip to ./aws-bluage-runtime-4.0.0.zip ``` Puoi elencare i file del framework come segue: `ls -l` Questo comando produce il seguente output: ``` total 230928 -rw-rw-r-- 1 cloudshell-user cloudshell-user 152040176 Apr 8 16:11 aws-bluage-runtime-4.0.0.zip -rw-rw-r-- 1 cloudshell-user cloudshell-user 176518889 Apr 8 16:11 aws-bluage-webapps-4.0.0.zip ``` **Nota** L'accesso agli artefatti potrebbe essere temporaneamente interrotto e le versioni potrebbero essere rimosse per motivi di sicurezza. Ti consigliamo vivamente di archiviare gli artefatti che utilizzi nel tuo account. La versione locale deve essere utilizzata come riferimento nelle architetture interne. # Requisiti di configurazione dell'infrastruttura per AWS Transform for mainframe Runtime Questo argomento descrive la configurazione minima dell'infrastruttura richiesta per eseguire AWS Transform for mainframe Runtime. Le seguenti procedure descrivono come configurare AWS Transform for mainframe Runtime sul computer prescelto per distribuire un'applicazione modernizzata su Transform for mainframe Runtime. AWS Le risorse che crei devono trovarsi in un Amazon VPC con una sottorete dedicata al dominio dell'applicazione. **Topics** + [Requisiti di infrastruttura](#infrastructure-requirements) + [Esecuzione di AWS Transform for mainframe Runtime su Amazon EC2](#ba-running-on-ec2) + [Esecuzione di AWS Transform for mainframe Runtime su Amazon ECS su Amazon EC2](#ba-running-on-ecs-on-ec2) + [Esecuzione di AWS Transform for mainframe Runtime su Amazon EKS su Amazon EC2](#ba-running-on-eks-on-ec2) + [Esecuzione di AWS Transform for mainframe Runtime su Amazon ECS gestito da AWS Fargate](#ba-running-on-fargate) ## Requisiti di infrastruttura **Creare un gruppo di sicurezza** Se hai intenzione di lavorare su istanze Amazon EC2 su Amazon EKS, salta questa procedura perché il processo di creazione del cluster Amazon EKS crea un gruppo di sicurezza per tuo conto. Utilizza quel gruppo di sicurezza nelle seguenti procedure invece di crearne uno nuovo. 1. Apri la console Amazon VPC all'indirizzo [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/). 1. Nel riquadro di navigazione a sinistra, in **Sicurezza**, scegli **Gruppi di sicurezza**. 1. Nel riquadro centrale, scegli **Crea gruppo di sicurezza**. 1. Nel campo **Nome del gruppo di sicurezza**, inserisci**M2BluagePrivateLink-SG**. 1. Nella sezione **Regole in entrata**, scegliere **Aggiungi regola**. 1. Per **Tipo**, scegli HTTPS. 1. Per **Source** inserisci il tuo VPC CIDR. 1. **Nella sezione **Regole in uscita**, scegli Aggiungi regola.** 1. Per **Tipo**, scegli HTTPS. 1. In **Destination (Destinazione)**, immettere **0.0.0.0/0**. 1. Scegliere **Create Security Group** (Crea gruppo di sicurezza). **Creazione di un ruolo IAM** 1. Aprire la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Nel riquadro di navigazione a sinistra, in **Gestione degli accessi**, scegli **Ruoli**. 1. Nel riquadro centrale, scegli **Crea ruolo**. 1. Nella sezione **Caso d'uso**, a seconda della scelta di elaborazione, scegli una delle seguenti opzioni: + **EC2** (per Amazon EC2 e Amazon EKS su Amazon EC2) + **Elastic Container Service** e quindi **ruolo EC2 per Elastic Container Service** (per Amazon ECS su Amazon EC2) + **Elastic Container Service** e poi **Elastic Container Service Task** (per Amazon ECS gestito da Fargate) 1. Scegli **Next (Successivo)**. 1. Immetti un nome del ruolo, quindi scegli **Crea ruolo**. ## Esecuzione di AWS Transform for mainframe Runtime su Amazon EC2 Per creare un'istanza Amazon EC2, utilizza i seguenti passaggi. **Creazione di un'istanza Amazon EC2** 1. Apri la console Amazon EC2 all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. Scegliere **Launch Instance (Avvia istanza)**. 1. Per **Tipo di istanza**, scegli un tipo di istanza EC2 disponibile. 1. Nella sezione **Coppia di chiavi**, scegli una coppia di chiavi esistente o creane una nuova. 1. Nella sezione **Impostazioni di rete**, scegli **Seleziona gruppo di sicurezza esistente**. 1. Per **Gruppi di sicurezza comuni**, scegli **M2 BluagePrivateLink -SG**. 1. Espandi la sezione **Dettagli avanzati**. 1. Per il **profilo dell'istanza IAM**, scegli il ruolo IAM che hai creato in precedenza. 1. Scegliere **Launch Instance (Avvia istanza)**. **Installa l'applicazione sull'istanza Amazon EC2** 1. Quando lo stato dell'istanza Amazon EC2 passa a **Running**, connettiti all'istanza. 1. Installa i seguenti componenti software sull'istanza (fai riferimento alle versioni menzionate nell'istanza[AWS Note sulla versione di Transform for mainframe](ba-release-notes.md)): + Java Runtime Environment (JRE). + Apache Tomcat. + AWS Transform for mainframe Runtime (su Amazon EC2). Installa il runtime AWS Transform for mainframe nella radice della cartella di installazione di Apache Tomcat (alcuni file verranno aggiunti mentre altri verranno sovrascritti). Per installare le webapp aggiuntive fornite insieme all'archivio AWS Transform for mainframe Runtime, configura un'istanza secondaria del server Apache Tomcat e decomprimi l'archivio delle webapps in quella posizione. Per istruzioni dettagliate, vedi [AWS Transform for mainframe Runtime artefact](ba-runtime-artifacts.md). ## Esecuzione di AWS Transform for mainframe Runtime su Amazon ECS su Amazon EC2 1. Crea un cluster Amazon ECS, con istanze **Amazon EC2** come infrastruttura sottostante. Consulta la sezione [Guida introduttiva a Windows su Amazon EC2](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/getting-started-ecs-ec2-v2.html#getting-started-ec2-cluster-v2) nella Guida per gli sviluppatori di Amazon Elastic Container Service. 1. Specificate il ruolo IAM che avete creato nei passaggi precedenti. 1. Scegli un tipo di istanza EC2. 1. Nelle **impostazioni di rete per le istanze Amazon EC2**, scegli il gruppo di sicurezza creato nei passaggi precedenti. ## Esecuzione di AWS Transform for mainframe Runtime su Amazon EKS su Amazon EC2 1. Crea un cluster Amazon EKS. Consulta [Creazione di un cluster Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/create-cluster.html) nella *Guida per l'utente di Amazon EKS*. 1. Come accennato in precedenza, viene creato un gruppo di sicurezza per tuo conto. 1. Crea un gruppo di nodi. Specificate il ruolo IAM che avete creato nei passaggi precedenti. 1. Scegli un tipo di istanza EC2. 1. Amazon EKS assegnerà automaticamente il gruppo di sicurezza alle istanze Amazon EC2 generate. ## Esecuzione di AWS Transform for mainframe Runtime su Amazon ECS gestito da AWS Fargate Crea un cluster Amazon ECS con **AWS Fargate (serverless**) come infrastruttura sottostante. Vedi [Guida introduttiva a Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/getting-started-fargate.html) nella *Amazon Elastic Container Service Developer Guide*. # AWS Transform for mainframe Runtime artefact AWS Gli artefatti di Transform for mainframe Runtime sono i componenti per la distribuzione e l'esecuzione di applicazioni modernizzate. Questo documento descrive i diversi tipi di artefatti disponibili, le relative posizioni di archiviazione e come accedervi. ## AWS Artefatti di Transform for mainframe Runtime ### Contenuto degli artefatti In entrambi i bucket Release e Pre-release, troverai: **gapwalk-x.y.z.zip** Questo archivio, in cui x.y.z rappresenta il numero di versione (vedi [AWS Transform for mainframe versioning), contiene i componenti principali di Transform for mainframe](https://docs.aws.amazon.com/m2/latest/userguide/ba-versioning.html) Runtime essenziali per l'esecuzione di AWS Transform for mainframe, tra cui: AWS | Artifact | Description | Tipo | Cartella di distribuzione | | --- | --- | --- | --- | | gapwalk-application-x.y.z.war | AWS Transform for mainframeapplicazione web principale Gapwalk | guerra | webapp | | \$1.jar | AWS Transform for mainframeLibrerie condivise di Runtime Framework (Gapwalk) | Barattoli | shared | | gapwalk-\$1-x.y.z.war | AWS Transform for mainframeapplicazioni web aggiuntive (utility-pgm, supporto gerarchico,...) | Guerra | webapps-extra | | bac-x.y.z.war/jac-x.y.z.war | AWS Transform for mainframeConsole di amministrazione (non autonome) | Guerra | webapp-console | **aws-bluage-webapps-x.y.z.zip** Questo archivio, in cui x.y.z segue lo stesso schema di versioni di cui sopra, include Administration Consoles (standalone) AWS Transform for mainframe + File WAR **BAC** (Blusamconsole), utilizzato per monitorare il database. Blusam + File WAR **JAC** (console JICS), utilizzato per monitorare il database JICS. + Librerie di supporto necessarie. ### Verifica della firma del pacchetto I file zip rilasciati vengono forniti come archivi ZIP con firma digitale per garantire sicurezza e autenticità. Le firme digitali aiutano a verificare che i file scaricati siano autentici, inalterati e rilasciati ufficialmente dalla nostra organizzazione. Ciò impedisce la manomissione e protegge da malware o file compromessi che potrebbero essere distribuiti in modo malevolo. Per verificare la firma del file ZIP prima di utilizzarlo, puoi usare il seguente comando: `jarsigner -verify -certs -verbose aws-bluage-runtime-x.y.z.zip` Ecco l'esempio di risultato per un file certificato: ``` ... jar verified. ``` Per i dettagli su come vengono affrontate le vulnerabilità di sicurezza, consulta [AWS Mainframe Modernization Refactor](https://docs.aws.amazon.com/m2/latest/userguide/lifecycle-m2.html#lifecycle-ba-overview) con panoramica della versione. AWS Transform for mainframe **Nota** Facciamo del nostro meglio per rilasciare i nostri prodotti senza CVEs, ma in seguito potrebbero apparire nuovi CVEs prodotti. # Implementa AWS Transform for mainframe Runtime su Amazon EC2 Puoi scoprire come configurare AWS Transform for mainframe Runtime su Amazon EC2, come aggiornare la versione di runtime, come monitorare la distribuzione utilizzando gli allarmi CloudWatch Amazon e come aggiungere dipendenze concesse in licenza con gli argomenti di questa sezione. Queste istruzioni sono applicabili quando crei istanze Amazon EC2 e quando utilizzi Amazon ECS su Amazon EC2 o Amazon EKS su Amazon EC2. A partire dalla versione alpha 5.60.0, la distribuzione AWS Transform for mainframe Runtime include una cartella di distribuzione con un file README.md completo. Questa guida fornisce istruzioni per la distribuzione di step-by-step Amazon EC2, opzioni di configurazione e suggerimenti per la risoluzione dei problemi. **Topics** + [Configurare AWS Transform for mainframe Runtime su Amazon EC2](ba-runtime-deploy-ec2.md) + [Esegui l'upgrade di AWS Transform for mainframe Runtime su Amazon EC2](ba-runtime-maint-ec2.md) + [Configurazione degli allarmi Amazon AWS Transform for mainframe Runtime (su Amazon EC2) CloudWatch](ba-cw-alarms-ec2.md) + [Configura le dipendenze concesse in licenza in AWS Transform for mainframe Runtime su Amazon EC2](ba-runtime-dependencies-ec2.md) # Configurare AWS Transform for mainframe Runtime su Amazon EC2 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 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 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 Per un esempio di come testare l' PlanetsDemo applicazione, vedere[Prova l' PlanetsDemo applicazione](ba-runtime-test-planetsdemo.md). # Esegui l'upgrade di AWS Transform for mainframe Runtime su Amazon EC2 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 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 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 `/shared/` con il contenuto di. `gapwalk-x.y.z/shared/` 1. Sostituisci `/webapps/gapwalk-application.war` con `gapwalk-x.y.z/webapps/gapwalk-application.war`. 1. Sostituisci i file di guerra in`/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 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. # Configurazione degli allarmi Amazon AWS Transform for mainframe Runtime (su Amazon EC2) CloudWatch Puoi CloudWatch configurare la ricezione del registro dell'applicazione e aggiungere un allarme per avvisarti di possibili errori. Ciò consente di avere notifiche più visibili ogni volta che le applicazioni distribuite incontrano eccezioni. Le seguenti sezioni aiutano a comprendere e conoscere la configurazione della CloudWatch registrazione e della configurazione degli allarmi. ## Abilita la registrazione CloudWatch Per abilitare CloudWatch la registrazione, create un `logback-cloudwatch.xml` file nella cartella config utilizzando il modello di configurazione fornito nella sezione seguente. Quindi, fate riferimento a questo file nel `application-main.yml` file decommentando le seguenti righe: ``` # logging: # config: classpath:logback-cloudwatch.xml ``` Dopo aver rimosso il commento da queste righe, CloudWatch la registrazione verrà attivata e potrà essere ulteriormente configurata come spiegato nelle sezioni seguenti. ## Configurazione della registrazione CloudWatch Utilizzate il seguente modello per creare il `logback-cloudwatch.xml` file: ``` %date{yyyy-MM-dd HH:mm:ss.SSS,UTC} %level --- [%thread{15}] %logger{40} : %msg%n%xThrowable BluAgeRuntimeOnEC2-Logs %date{yyyy-MM-dd,UTC}.%instanceId.%uuid %date{yyyy-MM-dd HH:mm:ss.SSS,UTC} %level --- [%thread{15}] %logger{40} : %msg%n%xThrowable ``` Tutto ciò che è al di fuori dell'elemento è una configurazione di logback standard. In questo file sono presenti due appendici: un'appendice console per inviare i log alla console e un' CloudWatch appendice a cui inviare i log. CloudWatch L'`level`attributo nell'`root`elemento specifica il livello di registrazione dell'intera applicazione. I valori richiesti all'interno del tag sono: + :Imposta il nome del gruppo di log. CloudWatch Se il valore non è specificato, il valore predefinito è. `BluAgeRuntimeOnEC2-Logs` Se il gruppo di log non esiste, verrà creato automaticamente. Questo comportamento può essere modificato tramite la configurazione, descritta di seguito. + : Imposta il nome di LogStream (all'interno del gruppo di log) in. CloudWatch Valori opzionali: + : sostituisce la regione in cui verrà scritto il flusso di registro. Per impostazione predefinita, i log vanno nella stessa regione dell'istanza EC2. + : Lo schema che verranno utilizzati dai messaggi di registro. + : Il numero massimo di messaggi di registro a cui inviare CloudWatch per operazione. + : il tempo in millisecondi per consentire la scrittura CloudWatch dei log. + : Il tempo in millisecondi necessario per provare a inserire le richieste nella coda di registro interna. + : La dimensione massima della coda interna. + : crea un gruppo di log e un flusso di log se non esistono. + : La quantità di tempo in cui desideri che il thread rimanga sospeso all'avvio. Questa attesa iniziale consente un accumulo iniziale di log. + : La dimensione massima di un evento di registro. I log che superano questa dimensione non verranno inviati. + : Tronca i messaggi troppo lunghi. + : abilita l'appendice di emergenza. ## CloudWatch configurazione Affinché la configurazione precedente invii correttamente i log a CloudWatch, aggiorna il ruolo del profilo dell'istanza IAM di Amazon EC2 per concederle autorizzazioni aggiuntive per il gruppo di log BluAgeRuntimeOn EC2 `-Logs` e i relativi flussi di log: + `logs:CreateLogStream` + `logs:DescribeLogStreams` + `logs:CreateLogGroup` + `logs:PutLogEvents` + `logs:DescribeLogGroups` ## Configurazione degli allarmi Grazie ai CloudWatch log, puoi quindi configurare diverse metriche e allarmi, a seconda dell'applicazione e delle tue esigenze. In particolare, potete impostare allarmi proattivi per avvisi di utilizzo, in modo da essere avvisati in caso di errori che potrebbero mettere l'applicazione in un periodo di prova (e, alla fine, impedirne del tutto il funzionamento). A tale scopo, è possibile aggiungere una metrica relativa alla stringa «Error C5001" nei log, che evidenzia gli errori nella connessione al sistema di controllo Transform for mainframe. AWS È quindi possibile definire un allarme che reagisca a questa metrica. # Configura le dipendenze concesse in licenza in AWS Transform for mainframe Runtime su Amazon EC2 Questa guida descrive come configurare dipendenze con licenza aggiuntive da utilizzare con AWS Transform for mainframe Runtime su Amazon EC2. **Topics** + [Prerequisiti](#ba-runtime-dependencies-prereq) + [Fasi di installazione](#ba-runtime-dependencies-overview) ## Prerequisiti Prima di iniziare, assicurati di completare i seguenti prerequisiti. + 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 AWS Transform for mainframe Runtime (su Amazon EC2) installata. 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. + Ottieni le seguenti dipendenze dalle loro fonti. ### Oracle database Fornisci un [driver di database Oracle](https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html). Abbiamo testato la funzionalità AWS Transform for mainframe Runtime (su Amazon EC2) con la **versione ojdbc11-23.3.0.23.09.jar, ma una versione** più recente potrebbe essere compatibile. ### Connessione IBM MQ Fornisci un [client IBM MQ](https://www.ibm.com/support/pages/mqc91-ibm-mq-clients). Abbiamo testato la funzionalità AWS Transform for mainframe Runtime (su Amazon EC2) con la **versione com.ibm.mq.jakarta.client-9.3.4.1.jar, ma una versione** più recente potrebbe essere compatibile. Con questa versione di dipendenza, fornisci anche le seguenti dipendenze transitive: + bcprov-jdk15to18-1.76.jar + bcpkix-jdk15 a 18-1.76.jar + bcutil-jdk15 a 18-1.76.jar ### File della stampante DDS Fornisci la libreria di report Jasper (munity.jaspersoft)https://com. com/download-jaspersoft/community-edizione). Abbiamo testato la funzionalità AWS Transform for mainframe Runtime (su Amazon EC2) **con** jasperreports-6.16.0.jar, ma una versione più recente potrebbe essere compatibile. Con questa versione di dipendenza, fornisci anche le seguenti dipendenze transitive: + castor-core-1.4.1.jar + castor-xml-1.4.1.jar + commons-digester-2.1.jar + ecj-3.21.0.jar + itext-2.1.7.js8.jar + javax.inject-1.jar + jcommon-1.0.23.jar + jfreechart-1.0.19.jar + commons-beanutils-1.9.4.jar + commons-collections-3.2.2.jar ## Fasi di installazione Per installare le dipendenze, completa i passaggi seguenti. 1. Connettiti alla tua istanza Amazon EC2 e cambia l'utente in **su** eseguendo il comando seguente. ``` sudo su ``` È necessario il privilegio Superuser per eseguire i comandi in questo tutorial. 1. Accedi alla cartella `/extra/`. ``` cd /extra/ ``` 1. Copia una delle dipendenze precedenti come richiesto in questa cartella. **Nota** Per le webapp JAC e BAC con database ospitati da Oracle, assicurati di includere il driver del database Oracle (ojdbc) in questa cartella. 1. Arresta e avvia tomcat.service eseguendo i seguenti comandi. ``` systemctl stop tomcat.service ``` ``` systemctl start tomcat.service ``` 1. Controlla lo stato del servizio per assicurarti che sia in esecuzione. ``` systemctl status tomcat.service ``` 1. Verifica i log. # Implementa AWS Transform for mainframe Runtime su container su Amazon ECS e Amazon EKS Puoi utilizzare gli argomenti di questa sezione per scoprire come configurare AWS Transform for mainframe Runtime sui container per distribuirlo su Amazon ECS (gestito da Amazon EC2 o) e Amazon EKS gestito da Amazon EC2 AWS Fargate, come aggiornare la versione di runtime, come monitorare la distribuzione utilizzando Amazon CloudWatch alarms e come aggiungere dipendenze concesse in licenza. **Nota** Non è compatibile con Amazon EKS gestito da AWS Fargate. **Topics** + [Configurare AWS Transform for mainframe Runtime su container](ba-runtime-deploy-container.md) + [Aggiorna AWS Transform for mainframe Runtime su container](ba-runtime-maint-container.md) + [Configura gli CloudWatch allarmi Amazon per AWS Transform for mainframe Runtime su container](ba-cw-alarms-container.md) + [Configura le dipendenze concesse in licenza in AWS Transform for mainframe Runtime on container](ba-runtime-dependencies-container.md) # Configurare AWS Transform for mainframe Runtime su container Questo argomento spiega come configurare e distribuire l'applicazione di PlanetsDemo esempio utilizzando AWS Transform for mainframe Runtime su un contenitore docker. AWS Transform for mainframe Runtime on container è disponibile per Amazon ECS gestito da Amazon EC2, Amazon ECS gestito da e Amazon AWS Fargate EKS gestito da Amazon EC2. Non è compatibile con Amazon EKS gestito da AWS Fargate. **Topics** + [Prerequisiti](#ba-runtime-deploy-prereq) + [Configurazione](#ba-runtime-deploy-setup) + [Testa l'applicazione distribuita](#ba-runtime-deploy-test) ## Prerequisiti Prima di iniziare, assicurati di completare i seguenti prerequisiti. + Configura il AWS CLI seguendo i passaggi descritti in [Configurazione della CLI 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) + Scarica i file binari di AWS Transform for mainframe Runtime. Per istruzioni, consulta [Onboarding AWS Transform per mainframe Runtime](ba-runtime-setup-onboard.md). + Scarica i binari di Apache Tomcat. + [Scarica l'archivio dell'applicazione. PlanetsDemo](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip) + Crea un database Amazon Aurora PostgreSQL per JICS ed esegui la query su di esso. `PlanetsDemo-v1/jics/sql/initJics.sql` 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 Per configurare l'applicazione di esempio, completa i seguenti passaggi. PlanetsDemo 1. Dopo aver scaricato i file binari di Apache Tomcat, estrai il contenuto e vai alla cartella. `conf` 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. Comprimi la cartella Apache Tomcat usando il comando tar per creare un archivio `tar.gz`. 1. Prepara un [Dockerfile](https://docs.docker.com/engine/reference/builder/) per creare l'immagine personalizzata in base ai binari di runtime forniti e ai binari del server Apache Tomcat. Vedi il seguente esempio Dockerfile. L'obiettivo è installare Apache Tomcat, seguito da AWS Transform for mainframe Runtime (per Amazon ECS managed by AWS Fargate) estratto nella radice della directory di installazione di Apache Tomcat, e quindi installare l'applicazione modernizzata di esempio denominata. PlanetsDemo **Nota** Il contenuto degli script install-gapwalk.sh e install-app.sh, utilizzati in questo esempio Dockerfile, è elencato dopo il Dockerfile. ``` FROM --platform=linux/x86_64 amazonlinux:2 RUN mkdir -p /workdir/apps WORKDIR /workdir COPY install-gapwalk.sh . COPY install-app.sh . RUN chmod +x install-gapwalk.sh RUN chmod +x install-app.sh # Install Java and AWS CLI v2-y RUN yum install sudo java-17-amazon-corretto unzip tar -y RUN sudo yum remove awscli -y RUN curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" RUN sudo unzip awscliv2.zip RUN sudo ./aws/install # Installation dir RUN mkdir -p /usr/local/velocity/installation/gapwalk # Copy PlanetsDemo archive to a dedicated apps dir COPY PlanetsDemo-v1.zip /workdir/apps/ # Copy resources (tomcat, blu age runtime) to installation dir COPY tomcat.tar.gz /usr/local/velocity/installation/tomcat.tar.gz COPY aws-bluage-runtime-4.x.x.zip /usr/local/velocity/installation/gapwalk/gapwalk.zip # run relevant installation scripts RUN ./install-gapwalk.sh RUN ./install-app.sh EXPOSE 8080 EXPOSE 8081 # ... WORKDIR /bluage/tomcat.gapwalk/velocity # Run Command to start Tomcat server CMD ["sh", "-c", "sudo bin/catalina.sh run"] ``` Di seguito sono riportati i contenuti di `install-gapwalk.sh.` ``` # Vars TEMP_DIR=/bluage-on-fargate/tomcat.gapwalk/temp # Install echo "Installing Gapwalk and Tomcat" sudo rm -rf /bluage-on-fargate mkdir -p ${TEMP_DIR} # Copy AWS Transform for mainframe runtime and tomcat archives to temporary extraction dir sudo cp /usr/local/velocity/installation/gapwalk/gapwalk.zip ${TEMP_DIR} sudo cp /usr/local/velocity/installation/tomcat.tar.gz ${TEMP_DIR} # Create velocity dir mkdir -p /bluage/tomcat.gapwalk/velocity # Extract tomcat files tar -xvf ${TEMP_DIR}/tomcat.tar.gz -C ${TEMP_DIR} # Copy all tomcat files to velocity dir cp -fr ${TEMP_DIR}/apache-tomcat-10.x.x/* /bluage/tomcat.gapwalk/velocity # Remove default webapps of Tomcat rm -f /bluage-on-fargate/tomcat.gapwalk/velocity/webapps/* # Extract AWS Transform for mainframe runtime at velocity dir unzip ${TEMP_DIR}/gapwalk.zip -d /bluage/tomcat.gapwalk # Remove temporary extraction dir sudo rm -rf ${TEMP_DIR} ``` Di seguito sono riportati i contenuti di `install-app.sh`. ``` #!/bin/sh APP_DIR=/workdir/apps TOMCAT_GAPWALK_DIR=/bluage-on-fargate/tomcat.gapwalk unzip ${APP_DIR}/PlanetsDemo-v1.zip -d ${APP_DIR} cp -r ${APP_DIR}/webapps/* ${TOMCAT_GAPWALK_DIR}/velocity/webapps/ cp -r ${APP_DIR}/config/* ${TOMCAT_GAPWALK_DIR}/velocity/config/ ``` 1. Fornisci le informazioni di connessione per il database creato come parte dei prerequisiti nel seguente frammento del `application-main.yml` file, che si trova nella cartella. `{TOMCAT_GAPWALK_DIR}/config` 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. Crea e trasferisci l'immagine nel tuo repository Amazon ECR. Per istruzioni, consulta [Pushing a Docker image](https://docs.aws.amazon.com/AmazonECR/latest/userguide/docker-push-ecr-image.html) nella Amazon Elastic Container Registry User Guide. Quindi, a seconda della situazione, crea un pod Amazon EKS o una definizione di attività Amazon ECS utilizzando l'immagine Amazon ECR e distribuiscila nel tuo cluster. Ad esempio, sulla creazione di questi, consulta [Creazione di una definizione di attività utilizzando la console](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-task-definition.html) nella Guida per gli *sviluppatori di Amazon Elastic Container Service (Amazon ECS)* [e Distribuire un'applicazione](https://docs.aws.amazon.com/eks/latest/userguide/sample-deployment.html) di esempio nella *Amazon* EKS User Guide. 1. In particolare, per **Amazon ECS gestito** per AWS Fargate caso, quando crei la definizione del task, usa il ruolo IAM che hai creato come parte della configurazione iniziale dell'infrastruttura. Quindi, durante la creazione del servizio, **espandi la sezione Rete** e configura il VPC, le sottoreti e il gruppo di sicurezza che hai creato come parte della configurazione iniziale dell'infrastruttura. Vedi, [Requisiti di configurazione dell'infrastruttura per AWS Transform for mainframe Runtime](https://docs.aws.amazon.com/m2/latest/userguide/ba-infrastructure-setup.html). ## Testa l'applicazione distribuita Per un esempio di come testare l' PlanetsDemo applicazione, vedere[Prova l' PlanetsDemo applicazione](ba-runtime-test-planetsdemo.md). # Aggiorna AWS Transform for mainframe Runtime su container Questa guida descrive come aggiornare AWS Transform for mainframe Runtime su container. A tale scopo, è necessario innanzitutto completare alcuni prerequisiti e quindi utilizzare l'immagine Docker per aggiornare AWS Transform for mainframe Runtime. **Topics** + [Prerequisiti](#ba-runtime-maint-prereq) + [Aggiorna AWS Transform for mainframe Runtime](#ba-runtime-maint-copy-files) ## Prerequisiti Prima di iniziare, assicurati di soddisfare i seguenti prerequisiti. + 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) + Scaricate la versione di AWS Transform for mainframe Runtime a cui desiderate effettuare l'aggiornamento. Per ulteriori informazioni, consulta [Onboarding AWS Transform per mainframe Runtime](ba-runtime-setup-onboard.md). Il framework è composto da due file binari: `aws-bluage-runtime-x.y.z.zip` e`aws-bluage-webapps-x.y.z.zip`. ## Aggiorna AWS Transform for mainframe Runtime 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 container](ba-runtime-deploy-container.md). 1. Invia la tua immagine Docker al tuo repository Amazon ECR. 1. Interrompi e riavvia il servizio Amazon ECS o Amazon EKS. 1. Verifica i log. Il runtime di AWS Transform for mainframe è stato aggiornato correttamente. # Configura gli CloudWatch allarmi Amazon per AWS Transform for mainframe Runtime su container Puoi configurare la configurazione CloudWatch per avere notifiche più visibili ogni volta che le applicazioni distribuite incontrano eccezioni. Questo ti aiuta a monitorare il registro dell'applicazione reindirizzato e CloudWatch ad aggiungere un allarme per avvisarti di possibili errori. ## Configurazione degli allarmi Con CloudWatch i log, puoi configurare un numero qualsiasi di metriche e allarmi, a seconda dell'applicazione e delle tue esigenze. In particolare, è possibile impostare allarmi proattivi per avvisi di utilizzo direttamente durante la creazione del cluster, in modo da ricevere notifiche quando si verificano errori. Per evidenziare gli errori nella connessione al sistema di controllo AWS Transform for mainframe, aggiungi una metrica relativa alla stringa «Error C» nei log. È quindi possibile definire un allarme che reagisca a questa metrica. # Configura le dipendenze concesse in licenza in AWS Transform for mainframe Runtime on container Questo argomento descrive come configurare dipendenze con licenza aggiuntive che è possibile utilizzare con AWS Transform for mainframe Runtime on container. **Topics** + [Prerequisiti](#ba-runtime-dependencies-prereq) + [Panoramica di](#ba-runtime-dependencies-overview) ## Prerequisiti Prima di iniziare, assicurati di completare i seguenti prerequisiti. + 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) + Ottieni le seguenti dipendenze dalla loro fonte. ### Oracle database Fornisci un [driver di database Oracle]( https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html). Ad esempio, **ojdbc11-23.3.0.23.09.jar**. ### Connessione IBM MQ Fornisci un [client IBM MQ](https://www.ibm.com/support/pages/mqc91-ibm-mq-clients). Ad esempio, **com.ibm.mq.jakarta.client-9.3.4.1.jar**. Con questa versione di dipendenza, fornisci anche le seguenti dipendenze transitive: + bcprov-jdk15to18-1.76.jar + bcpkix-jdk15 a 18-1.76.jar + bcutil-jdk15 a 18-1.76.jar ### File della stampante DDS Fornisci la libreria di report Jasper (munity.jaspersoft)https://com. com/download-jaspersoft/community-edizione). Ad esempio, **jasperreports-6.16.0.jar**, ma una versione più recente potrebbe essere compatibile. Con questa versione di dipendenza, fornisci anche le seguenti dipendenze transitive: + castor-core-1.4.1.jar + castor-xml-1.4.1.jar + commons-digester-2.1.jar + ecj-3.21.0.jar + itext-2.1.7.js8.jar + javax.inject-1.jar + jcommon-1.0.23.jar + jfreechart-1.0.19.jar + commons-beanutils-1.9.4.jar + commons-collections-3.2.2.jar ## Panoramica di Per installare le dipendenze, completa i passaggi seguenti. 1. Copia una delle dipendenze precedenti come richiesto nella cartella di creazione dell'immagine Docker. 1. Se il tuo database JICS è ospitato su Oracle, inserisci il driver del database Oracle. `your-tomcat-path/extra` 1. Sul tuo Dockerfile, copia queste dipendenze in. `your-tomcat-path/extra` 1. Crea la tua immagine Docker e inviala ad Amazon ECR. 1. Interrompi e riavvia il servizio Amazon ECS o Amazon EKS. 1. Controllo dei log. # Prova l' PlanetsDemo applicazione Per verificare lo stato dell' PlanetsDemo applicazione distribuita, esegui i seguenti comandi dopo la sostituzione `load-balancer-DNS-name` e `web-binary-name` con `listener-port` i valori corretti per la configurazione. ``` curl http://load-balancer-DNS-name:listener-port/gapwalk-application/ ``` Se l'applicazione è in esecuzione, viene visualizzato il seguente messaggio di output:`Jics application is running`. Quindi, esegui il seguente comando. ``` curl http://load-balancer-DNS-name:listener-port/jac/api/services/rest/jicsservice/ ``` Se l'applicazione è in esecuzione, viene visualizzato il seguente messaggio di output:`Jics application is running`. ``` Jics application is running ``` Se hai configuratoBlusam, puoi aspettarti una risposta vuota quando esegui il comando seguente. ``` curl http://load-balancer-DNS-name:listener-port/bac/api/services/rest/bluesamserver/serverIsUp ``` Nota il nome del file binario web (PlanetsDemo-web-1.0.0, se invariato). Per accedere all' PlanetsDemo applicazione, utilizzate un URL nel seguente formato. ``` https://load-balancer-DNS-name:listener-port/web-binary-name ``` Dopo l'avvio PlanetsDemo dell'applicazione, viene visualizzata la home page. ![\[Home page\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/PlanetsDemo-homepage.png) Immettete PINQ nella casella di testo, quindi premete Invio. Viene visualizzata la pagina di richiesta dati. ![\[Pagina di richiesta dati\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/PlanetsDemo-app.png) Ad esempio, immettete EARTH nel campo del PlanetsDemo nome, quindi premete Invio. Viene visualizzata la pagina relativa al pianeta inserito. ![\[Pagina EARTH\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/PlanetsDemo-EARTH.png)