

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

# Integra il controller universale Stonebranch con la modernizzazione del mainframe AWS
<a name="integrate-stonebranch-universal-controller-with-aws-mainframe-modernization"></a>

*Vaidy Sankaran e Pablo Alonso Prieto, Amazon Web Services*

*Robert Lemieux e Huseyin Gomleksizoglu, Stonebranch*

## Riepilogo
<a name="integrate-stonebranch-universal-controller-with-aws-mainframe-modernization-summary"></a>

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

Questo modello spiega come integrare l'orchestrazione del [carico di lavoro Stonebranch Universal Automation Center (UAC) con](https://www.stonebranch.com/stonebranch-platform/universal-automation-center) il servizio di modernizzazione del mainframe di [Amazon Web Services (](https://aws.amazon.com/mainframe-modernization/)AWS). Il servizio AWS Mainframe Modernization migra e modernizza le applicazioni mainframe nel cloud AWS. Offre due modelli: [AWS Mainframe Modernization Replatform](https://aws.amazon.com/mainframe-modernization/patterns/replatform/) con tecnologia Micro Focus Enterprise e AWS [Mainframe Modernization Automated Refactor con AWS](https://aws.amazon.com/mainframe-modernization/patterns/refactor/?mainframe-blogs.sort-by=item.additionalFields.createdDate&mainframe-blogs.sort-order=desc) Blu Age.  

Stonebranch UAC è una piattaforma di automazione e orchestrazione IT in tempo reale. L'UAC è progettato per automatizzare e orchestrare lavori, attività e flussi di lavoro su sistemi IT ibridi, da quelli locali a AWS. I clienti aziendali che utilizzano sistemi mainframe stanno passando a infrastrutture e applicazioni modernizzate incentrate sul cloud. Gli strumenti e i servizi professionali di Stonebranch facilitano la migrazione degli scheduler e delle funzionalità di automazione esistenti nel cloud AWS.

Quando migri o modernizzi i tuoi programmi mainframe sul cloud AWS utilizzando il servizio AWS Mainframe Modernization, puoi utilizzare questa integrazione per automatizzare la pianificazione in batch, aumentare l'agilità, migliorare la manutenzione e ridurre i costi.

Questo modello fornisce istruzioni per l'integrazione dello [scheduler Stonebranch](https://www.stonebranch.com/) con le applicazioni mainframe migrate al runtime Micro Focus Enterprise del servizio AWS Mainframe Modernization. Questo modello è destinato agli architetti di soluzioni, agli sviluppatori, ai consulenti, agli specialisti della migrazione e a tutti coloro che si occupano di migrazioni, modernizzazioni, operazioni o. DevOps

**Risultato mirato**

Questo modello si concentra sul raggiungimento dei seguenti obiettivi:
+ La capacità di pianificare, automatizzare ed eseguire processi batch mainframe in esecuzione nel servizio AWS Mainframe Modernization (runtime Microfocus) di Stonebranch Universal Controller.
+ Monitora i processi batch dell'applicazione dallo Stonebranch Universal Controller.
+ Start/Restart/Rerun/Stopi processi in batch vengono eseguiti automaticamente o manualmente dallo Stonebranch Universal Controller.
+ Recupera i risultati dei processi batch di AWS Mainframe Modernization.
+ Acquisisci i CloudWatch log [AWS](https://aws.amazon.com/cloudwatch/) dei lavori in batch in Stonebranch Universal Controller.

## Prerequisiti e limitazioni
<a name="integrate-stonebranch-universal-controller-with-aws-mainframe-modernization-prereqs"></a>

**Prerequisiti**
+ Un account AWS attivo
+ Un'applicazione Micro Focus [Bankdemo](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo_runtime.zip) con file Job Control Language (JCL) e un processo batch distribuito in un ambiente del servizio AWS Mainframe Modernization (Micro Focus runtime)
+ [Conoscenza di base su come creare e distribuire un'applicazione mainframe eseguita su Micro Focus Enterprise Server](https://www.microfocus.com/media/data-sheet/enterprise_server_ds.pdf)
+ Conoscenza di base di Stonebranch Universal Controller
+ [Licenza di prova di Stonebranch (contatta Stonebranch)](https://www.stonebranch.com/)
+ Istanze Amazon Elastic Compute Cloud (Amazon EC2) Windows o Linux (ad esempio xlarge) con un minimo di quattro core, 8 GB di memoria e 2 GB di spazio su disco
+ Apache Tomcat versione 8.5.x o 9.0.x
+ Oracle Java Runtime Environment (JRE) o OpenJDK versione 8 o 11
+ [Edizione compatibile con Amazon Aurora MySQL](https://aws.amazon.com/rds/aurora/)
+ [Bucket Amazon Simple Storage Service (Amazon S3](https://aws.amazon.com/s3/)) per repository di esportazione
+ [Amazon Elastic File System (Amazon EFS)](https://aws.amazon.com/efs/) per le connessioni degli agenti Stonebranch Universal Message Service (OMS) per l'alta disponibilità (HA)
+ File di installazione di Stonebranch Universal Controller 7.2 Universal Agent 7.2
+ [Modello di pianificazione delle attività](https://github.com/aws-samples/aws-mainframe-modernization-stonebranch-integration/releases) di AWS Mainframe Modernization (ultima versione rilasciata del file.zip)

**Limitazioni**
+ Il prodotto e la soluzione sono stati testati e la compatibilità è stata convalidata solo con OpenJDK 8 e 11.
+ Il modello [aws-mainframe-modernization-stonebranchdi pianificazione delle attività di integrazione](https://github.com/aws-samples/aws-mainframe-modernization-stonebranch-integration/releases) funzionerà solo con il servizio AWS Mainframe Modernization.
+ Questo modello di pianificazione delle attività funzionerà solo su un'edizione Unix, Linux o Windows degli agenti Stonebranch.
+ Alcuni servizi AWS non sono disponibili in tutte le regioni AWS. Per la disponibilità regionale, consulta [i servizi AWS per regione](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/). Per endpoint specifici, consulta la pagina [Endpoint e quote del servizio](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html) e scegli il link relativo al servizio.

## Architecture
<a name="integrate-stonebranch-universal-controller-with-aws-mainframe-modernization-architecture"></a>

**Architettura dello stato di destinazione**

Il diagramma seguente mostra l'esempio di ambiente AWS richiesto per questo programma pilota.

![Stonebranch UAC che interagisce con l'ambiente di modernizzazione del mainframe AWS.](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/images/pattern-img/01c6f9fa-87e6-459a-b694-5e03dd7f7952/images/4a7bea37-0a5b-4663-902b-9b051e92f0cb.png)


1. Stonebranch Universal Automation Center (UAC) include due componenti principali: Universal Controller e Universal Agents. Stonebranch OMS viene utilizzato come bus di messaggi tra il controller e i singoli agenti.

1. Il database Stonebranch UAC viene utilizzato da Universal Controller. Il database può essere compatibile con MySQL, Microsoft SQL Server, Oracle o Aurora MySQL.

1. Servizio AWS Mainframe Modernization: ambiente di runtime Micro Focus con l'[BankDemo applicazione](https://aws.amazon.com/blogs/aws/modernize-your-mainframe-applications-deploy-them-in-the-cloud/) distribuita. I file BankDemo dell'applicazione verranno archiviati in un bucket S3. Questo bucket contiene anche i file JCL del mainframe.

1. Stonebranch UAC può eseguire le seguenti funzioni per l'esecuzione in batch:

   1. Avvia un processo batch utilizzando il nome del file JCL presente nel bucket S3 collegato al servizio di modernizzazione del mainframe AWS.

   1. Ottieni lo stato dell'esecuzione del processo batch.

   1. Attendi il completamento dell'esecuzione del processo batch.

   1. Recupera i registri dell'esecuzione del processo batch.

   1. Esegui nuovamente i processi batch non riusciti.

   1. Annulla il processo batch mentre il processo è in esecuzione.

1. Stonebranch UAC può eseguire le seguenti funzioni dell'applicazione:

   1. Avvia l'applicazione

   1. Ottieni lo stato della domanda

   1. Attendi che l'applicazione venga avviata o interrotta

   1. Interrompi l'applicazione

   1. Recupera i registri delle operazioni dell'applicazione

**Conversione dei lavori di Stonebranch**

Il diagramma seguente rappresenta il processo di conversione del lavoro di Stonebranch durante il percorso di modernizzazione. Descrive come le pianificazioni dei lavori e le definizioni delle attività vengono convertite in un formato compatibile in grado di eseguire attività batch di AWS Mainframe Modernization.

![Processo dal mainframe alla conversione allo strumento di pianificazione dei processi su Amazon EC2 con file JCL in Amazon S3.](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/images/pattern-img/01c6f9fa-87e6-459a-b694-5e03dd7f7952/images/4d2ed890-f143-455e-8180-4d967b71c494.png)


1. Per il processo di conversione, le definizioni dei job vengono esportate dal sistema mainframe esistente.

1. I file JCL possono essere caricati nel bucket S3 per l'applicazione Mainframe Modernization in modo che questi file JCL possano essere distribuiti dal servizio AWS Mainframe Modernization.

1. Lo strumento di conversione converte le definizioni di lavoro esportate in attività UAC.

1. Dopo aver creato tutte le definizioni delle attività e le pianificazioni dei lavori, questi oggetti verranno importati nell'Universal Controller. Le attività convertite eseguono quindi i processi nel servizio AWS Mainframe Modernization anziché eseguirli sul mainframe.

**Architettura Stonebranch UAC**

Il seguente diagramma di architettura rappresenta un active-active-passive modello di controller universale ad alta disponibilità (HA). Stonebranch UAC è implementato in più zone di disponibilità per fornire alta disponibilità e supportare il disaster recovery (DR).

![Ambiente Multi-AZ con DR e controller, Amazon EFS, Aurora e un bucket S3 per i backup.](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/images/pattern-img/01c6f9fa-87e6-459a-b694-5e03dd7f7952/images/3f94b855-c146-4fcb-902c-5d343438a558.png)


*Controller universale*

Due server Linux vengono forniti come controller universali. Entrambi si connettono allo stesso endpoint del database. Ogni server ospita un'applicazione Universal Controller e un OMS. La versione più recente di Universal Controller viene utilizzata al momento del provisioning.

Gli Universal Controller vengono distribuiti nella webapp Tomcat come documento ROOT e vengono serviti sulla porta 80. Questa implementazione semplifica la configurazione del load balancer del frontend.

HTTP over TLS o HTTPS è abilitato utilizzando il certificato wildcard di Stonebranch (ad esempio,). `https://customer.stonebranch.cloud` Ciò protegge la comunicazione tra il browser e l'applicazione.

*OMS*

Un Universal Agent e un OMS (Opswise Message Service) risiedono su ogni server Universal Controller. Tutti gli Universal Agent distribuiti dal cliente sono configurati per connettersi a entrambi i servizi OMS. OMS funge da servizio di messaggistica comune tra gli Universal Agent e l'Universal Controller.

Amazon EFS monta una directory di spool su ogni server. OMS utilizza questa directory di spool condivisa per mantenere le informazioni sulla connessione e sulle attività lontane da controller e agenti. OMS funziona in modalità ad alta disponibilità. Se l'OMS attivo non funziona, l'OMS passivo ha accesso a tutti i dati e riprende automaticamente le operazioni attive. Gli Universal Agent rilevano questa modifica e si connettono automaticamente al nuovo OMS attivo.

*Database*

Amazon Relational Database Service (Amazon RDS) ospita il database UAC, con Amazon Aurora MySQL come motore. Amazon RDS aiuta a gestire e offrire backup pianificati a intervalli regolari. Entrambe le istanze Universal Controller si connettono allo stesso endpoint del database.

*Sistema di bilanciamento del carico*

Per ogni istanza è configurato un Application Load Balancer. Il load balancer indirizza il traffico verso il controller attivo in qualsiasi momento. I nomi di dominio delle istanze puntano ai rispettivi endpoint di bilanciamento del carico.

*URLs*

Ciascuna delle tue istanze ha un URL, come illustrato nell'esempio seguente.


| 
| 
| Ambiente | Istanza | 
| --- |--- |
| **Produzione** | `customer.stonebranch.cloud` | 
| **Sviluppo (non produzione)** | `customerdev.stonebranch.cloud` | 
| **Test (non di produzione)** | `customertest.stonebranch.cloud` | 

**Nota**  
  I nomi delle istanze non di produzione possono essere impostati in base alle proprie esigenze.

*Disponibilità elevata*

L'alta disponibilità (HA) è la capacità di un sistema di funzionare ininterrottamente senza guasti per un determinato periodo di tempo. Tali errori includono, a titolo esemplificativo, lo storage, i ritardi di risposta nelle comunicazioni con il server causati da problemi di CPU o memoria e la connettività di rete.

Per soddisfare i requisiti HA:
+ Tutte le istanze EC2, i database e le altre configurazioni vengono replicati su due zone di disponibilità separate all'interno della stessa regione AWS.
+ Il controller viene fornito tramite un'Amazon Machine Image (AMI) su due server Linux nelle due zone di disponibilità. Ad esempio, se hai effettuato il provisioning nella regione Europa eu-west-1, hai un controller universale nella zona di disponibilità eu-west-1a e nella zona di disponibilità eu-west-1c.
+ Nessun processo può essere eseguito direttamente sui server delle applicazioni e nessun dato può essere archiviato su questi server.
+ L'Application Load Balancer esegue controlli di integrità su ogni Universal Controller per identificare quello attivo e indirizzare il traffico verso di esso. Nel caso in cui un server presenti problemi, il load balancer porta automaticamente l'Universal Controller passivo a uno stato attivo. Il load balancer identifica quindi la nuova istanza attiva di Universal Controller dai controlli di integrità e inizia a indirizzare il traffico. Il failover avviene entro quattro minuti senza perdita di posti di lavoro e l'URL del frontend rimane lo stesso.
+ Il servizio di database compatibile con Aurora MySQL archivia i dati di Universal Controller. Per gli ambienti di produzione, un cluster di database è creato con due istanze di database in due diverse zone di disponibilità all'interno di una singola regione AWS. Entrambi gli Universal Controller utilizzano un'interfaccia Java Database Connectivity (JDBC) che punta a un singolo endpoint del cluster di database. Nel caso in cui un'istanza di database presenti problemi, l'endpoint del cluster di database punta dinamicamente all'istanza integra. Non sono richiesti interventi manuali.

*Backup ed eliminazione*

Stonebranch Universal Controller è configurato per eseguire il backup e l'eliminazione dei vecchi dati seguendo la pianificazione mostrata nella tabella.


| 
| 
| Tipo | Schedule | 
| --- |--- |
| **Attività** | 7 giorni | 
| **Audit** | 90 giorni | 
| **Cronologia** | 60 giorni | 

I dati di backup precedenti alle date mostrate vengono esportati in formato.xml e archiviati nel file system. Una volta completato il processo di backup, i dati più vecchi vengono eliminati dal database e archiviati in un bucket S3 per un massimo di un anno per le istanze di produzione.

È possibile modificare questa pianificazione nell'interfaccia Universal Controller. Tuttavia, l'aumento di questi intervalli di tempo potrebbe causare tempi di inattività più lunghi durante la manutenzione.

## Tools (Strumenti)
<a name="integrate-stonebranch-universal-controller-with-aws-mainframe-modernization-tools"></a>

**Servizi AWS**
+ [AWS Mainframe Modernization](https://docs.aws.amazon.com/m2/latest/userguide/what-is-m2.html) è una piattaforma AWS nativa per il cloud che ti aiuta a modernizzare le tue applicazioni mainframe in ambienti di runtime gestiti da AWS. Offre strumenti e risorse per aiutarti a pianificare e implementare la migrazione e la modernizzazione.
+ [Amazon Elastic Block Store (Amazon EBS)](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AmazonEBS.html) fornisce volumi di storage a livello di blocchi da utilizzare con le istanze Amazon EC2.
+ [Amazon Elastic File System (Amazon EFS)](https://docs.aws.amazon.com/efs/latest/ug/whatisefs.html) ti aiuta a creare e configurare file system condivisi nel cloud AWS.
+ [Amazon Relational Database Service (Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Welcome.html)) ti aiuta a configurare, gestire e scalare un database relazionale nel cloud AWS. Questo modello utilizza l'edizione compatibile con Amazon Aurora MySQL.
+ [Amazon Simple Storage Service (Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html) è un servizio di archiviazione degli oggetti basato sul cloud che consente di archiviare, proteggere e recuperare qualsiasi quantità di dati.
+ [Elastic Load Balancing (ELB)](https://docs.aws.amazon.com/elasticloadbalancing/latest/userguide/what-is-load-balancing.html) distribuisce il traffico di applicazioni o di rete in entrata su più destinazioni. Ad esempio, puoi distribuire il traffico tra istanze Amazon EC2, contenitori e indirizzi IP in una o più zone di disponibilità. Questo modello utilizza un Application Load Balancer.

**Stonebranch**
+ [Universal Automation Center (UAC)](https://stonebranchdocs.atlassian.net/wiki/spaces/SD/pages/239239169/Universal+Automation+Center) è un sistema di prodotti per l'automazione dei carichi di lavoro aziendali. Questo modello utilizza i seguenti componenti UAC:
  + [Universal Controller](https://www.stonebranch.com/documentation-universal-controller), un'applicazione Web Java in esecuzione in un contenitore Web Tomcat, è la soluzione aziendale per la pianificazione dei lavori e l'automazione del carico di lavoro di Universal Automation Center. Il controller presenta un'interfaccia utente per la creazione, il monitoraggio e la configurazione delle informazioni sul controller, gestisce la logica di pianificazione, elabora tutti i messaggi da e verso gli Universal Agent e sincronizza gran parte delle operazioni ad alta disponibilità di Universal Automation Center.
  + [Universal Agent è un agente](https://www.stonebranch.com/documentation-universal-agent) di pianificazione indipendente dal fornitore che collabora con Job Scheduler esistente su tutte le principali piattaforme informatiche, sia legacy che distribuite. Sono supportati tutti gli scheduler che funzionano su Unixz/Series, i/Series, Linux o Windows.
+ [Universal Agent è un agente](https://www.stonebranch.com/documentation-universal-agent) di pianificazione indipendente dal fornitore che collabora con Job Scheduler esistente su tutte le principali piattaforme informatiche, sia legacy che distribuite. Sono supportati tutti gli scheduler che funzionano su Unixz/Series, i/Series, Linux o Windows.
+ [Stonebranch -integration aws-mainframe-modernization-stonebranch AWS Mainframe Modernization Universal Extension](https://github.com/aws-samples/aws-mainframe-modernization-stonebranch-integration/releases) è il modello di integrazione per eseguire, monitorare e rieseguire lavori in batch nella piattaforma AWS Mainframe Modernization.

**Codice**

[Il codice per questo pattern è disponibile nel repository -integration. aws-mainframe-modernization-stonebranch](https://github.com/aws-samples/aws-mainframe-modernization-stonebranch-integration/releases/) GitHub 

## Epiche
<a name="integrate-stonebranch-universal-controller-with-aws-mainframe-modernization-epics"></a>

### Installa Universal Controller e Universal Agent su Amazon EC2
<a name="install-universal-controller-and-universal-agent-on-amazon-ec2"></a>


| Operazione | Description | Competenze richieste | 
| --- | --- | --- | 
| Scarica i file di installazione. | Scarica l'installazione dai server Stonebranch. Per ottenere i file di installazione, contatta Stonebranch. | Architetto del cloud | 
| Avvia l'istanza EC2. | Avrai bisogno di circa 3 GB di spazio aggiuntivo per le installazioni di Universal Controller e Universal Agent. Fornisci quindi almeno 30 GB di spazio su disco per l'istanza.<br />Aggiungi la porta 8080 al gruppo di sicurezza in modo che sia accessibile. | Architetto del cloud | 
| Verifica i prerequisiti. | Prima dell'installazione, procedi come segue:1. Installate Java come descritto in [Downloading Java Runtime Environment](https://www.stonebranch.com/documentation-java-runtime).<pre>$ sudo yum -y update<br />$ sudo yum install java-11-amazon-corretto</pre><br />Assicuratevi di utilizzare una delle versioni JAVA supportate. Il comando precedente dovrebbe installare java-11. Controlla la versione Java e assicurati di utilizzare la versione 11 prima di continuare.<br />2. Come descritto in [Installazione di Apache Tomcat](https://www.stonebranch.com/documentation-apache-tomcat), esegui i seguenti comandi.<pre>$ sudo yum install tomcat tomcat-admin-webapps<br />$ sudo systemctl enable tomcat<br />$ sudo systemctl start tomcat</pre><br />3. Crea un database Amazon Aurora come descritto in [Creazione e connessione a un cluster Aurora MySQL DB](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.Aurora.html). Usa l'edizione compatibile con Amazon Aurora MySQL.<br />Scegli un nome utente e una password principali. Mantieni i valori predefiniti per il resto delle impostazioni. | Amministratore cloud, amministratore Linux | 
| Installa Universal Controller. | 1. Carica il file `universal-controller-7.2.0.0.tar`**** di installazione sull'istanza EC2.<br />2. Estrai l'archiviazione dei file di installazione in una `temp` cartella.<pre>$ tar -xvf universal-controller-7.2.0.0.tar</pre><br />3. Concedi l'autorizzazione all'esecuzione dello script di installazione.<pre>$ chmod a+x install-controller.sh</pre><br />4. Installare il controller. Questo esempio utilizza il comando seguente per installare Universal Controller sotto `/usr/share/tomca` t. Usa il database Amazon Aurora creato nei passaggi precedenti.<pre>$ sudo ./install-controller.sh --tomcat-dir /usr/share/tomcat/ --controller-file universal-controller-7.2.0.0-build.145.war --dbuser admin --dbpass "****" --dbname uc --rdbms mysql --dburl jdbc:mysql://database-2-instance-1.cih63miincgy.us-east-1.rds.amazonaws.com:3306/</pre><br />L'ultima riga dell'output dello script dovrebbe essere «Installazione completa».<br />5. Vai al seguente URL nell'istanza EC2.<pre>http://<public_ip>:8080/uc</pre><br />6. Nella schermata di accesso, inserisci **ops.admin** nella sezione **Nome utente** e mantieni vuoto il campo **Password**.<br />7. Imposta una nuova password per l'`ops.admin`utente. | Architetto cloud, amministratore Linux | 
| Installa Universal Agent. | 1. Carica il file `sb-7.2.0.1-linux-3.10-x86_64.tar.Z` di installazione sull'istanza EC2.<br />2. Accedi all'istanza EC2.<br />3. Annulla l'archiviazione del pacchetto di installazione di Universal Agent.<pre>$ zcat sb-7.2.0.1-linux-3.10-x86_64.tar.Z | tar xvf –</pre><br />4. Eseguire il seguente comando seguente.<pre>$ sudo ./unvinst --oms_servers 7878@localhost --oms_autostart yes --python yes</pre><br />5. Crea un file PAM.<pre>$ cp /etc/pam.d/login /etc/pam.d/ucmd</pre><br />6. Abilita l'avvio automatico per Universal Agent.<pre>$ /sbin/restorecon -v /etc/rc.d/init.d/ubrokerd</pre> | Amministratore cloud, amministratore Linux | 
| Aggiungi OMS a Universal Controller. | 1. Accedi a Universal Controller con l'`ops.admin`utente.<br />2. Scegli il menu **Servizi** nell'angolo in alto a sinistra dello schermo, quindi scegli il menu **OMS Servers** nel **Sistema**<br />3. Nel campo Indirizzo server OMS`localhost`, digita e quindi salva.<br />4. Verrà visualizzato lo stato del server OMS come **Connesso** e lo **stato della sessione** come **Operativo**. | Amministratore di Universal Controller | 

### Importa AWS Mainframe Modernization Universal Extension e crea un'attività
<a name="import-aws-mainframe-modernization-universal-extension-and-create-a-task"></a>


| Operazione | Description | Competenze richieste | 
| --- | --- | --- | 
| Importa modello di integrazione. | Per questo passaggio, è necessaria l'estensione [universale di AWS Mainframe Modernization](https://github.com/aws-samples/aws-mainframe-modernization-stonebranch-integration/releases). Assicurati che sia stata scaricata l'ultima versione rilasciata del file.zip.1. Accedi all'Universal Controller con l'`ops.admin`utente.<br />2. Vai a **Servizi**, **Importa modello di integrazione**.<br />3. Seleziona il file.zip del modello di integrazione (`aws_mainframe_modernization_stonebranch_extension.zip`) e scegli **Importa**.<br />Dopo l'importazione del modello di integrazione, vedrai **AWS Mainframe Modernization Tasks in Servizi** **disponibili**. | Amministratore di Universal Controller | 
| Abilita credenziali risolvibili. | 1. Passa a **Services**, **AWS Mainframe Modernization** Tasks.<br />2. Nel pannello a destra, compila i campi obbligatori:**Nome**: Nuova attività di modernizzazione del mainframe**Agente**: seleziona l'unico agente ()AGNT0001.<br />Nella sezione Dettagli sulla **modernizzazione dei mainframe di AWS**:**Azione: elenca** gli ambienti**Credenziali AWS**: se hai un ruolo AWS Identity and Access Management (IAM) aggiunto all'istanza EC2, puoi lasciare questo campo vuoto. Se intendi utilizzare `AWSAccessKeyID` e`AWSSecretKey`, scegli l'icona **()** accanto al campo.<br />Nella finestra **Dettagli delle credenziali** che si apre, inserisci le seguenti informazioni e quindi salva.**Nome: credenziali** di modernizzazione dei mainframe AWS**Utente di runtime**: scrivi l'ID della chiave di accesso AWS in questo campo.**Password di runtime**: scrivi la chiave segreta AWS in questo campo.**Punto finale**:**** assicurati che l'endpoint abbia la regione AWS corretta. Il valore predefinito è `https://m2.us-east-1.amazonaws.com`.**Regione**: entra nella regione del servizio AWS Mainframe Modernization. Il valore predefinito è `us-east-1`.<br />3. Mantieni i valori predefiniti nel resto dei campi e salva l'attività. | Amministratore di Universal Controller | 
| Avvia l'operazione. | 1. Nella parte superiore del pannello di destra, scegli **Avvia attività**.<br />2. Nella finestra di **conferma**, scegli **Avvia**. Dopodiché, la Universal Controller Console visualizzerà un messaggio simile al seguente messaggio.<br />*2022-08-24 10:11:49*<br />*Lanciato con successo il task universale «New Mainframe Modernization Task» con l'istanza di attività sys\_id 1661291493634146313 E38 OZJY. NC8 DB8*<br />3. **Vai alla scheda **Istanze Se non vedi la scheda Istanze**, scegli la freccia destra per scorrere verso destra.**<br />4. **Apri il menu contestuale (fai clic con il pulsante destro del mouse) per l'istanza dell'attività nell'elenco, scegli **Recupera output**, quindi scegli **Invia** in Recupera output**<br />5. Nella finestra **Recupera output**, vedrai l'elenco degli ambienti in STDOUT. | Amministratore di Universal Controller | 

### Test di avvio di un processo in batch
<a name="test-starting-a-batch-job"></a>


| Operazione | Description | Competenze richieste | 
| --- | --- | --- | 
| Crea un'attività per il processo batch. | 1. Passa a **Services**, **AWS Mainframe Modernization** Tasks.<br />2. Nel pannello a destra, compila i campi obbligatori:**Nome**: Nuova attività di modernizzazione del mainframe**Agente**: seleziona l'unico agente ()AGNT0001.<br />Nella sezione Dettagli sulla **modernizzazione dei mainframe di AWS**:**Azione**: Avvia Batch (o Avvia Batch e attendi l'esecuzione del processo batch e attendi il completamento dell'attività in AWS)**Credenziali AWS**: se hai aggiunto un ruolo IAM all'istanza EC2, puoi lasciare questo campo vuoto. Se intendi utilizzare `AWSAccessKeyID` e`AWSSecretKey`, scegli l'icona **()** accanto al campo.**Punto finale**:**** assicurati che l'endpoint abbia la regione AWS corretta. Il valore predefinito è [https://m2.us-east-1.amazonaws.com](https://m2.us-east-1.amazonaws.com).**Regione**: entra nella regione del servizio AWS Mainframe Modernization. Il valore predefinito è `us-east-1`.**Applicazione**: scegli l'icona accanto al campo **()** e scegli **Invia** nelle scelte di **aggiornamento** dell'applicazione. Questo si connetterà al servizio AWS Mainframe Modernization e restituirà l'elenco delle applicazioni. Ora puoi selezionare l'applicazione dall'elenco a discesa. Seleziona l'applicazione su cui desideri eseguire il processo batch.**Nome file JCL**: `RUNHELLO.jcl`**Attendi esito positivo o negativo**:**** se questa opzione è selezionata, l'operazione attenderà che lo stato del processo batch sia riuscito o meno.**Intervallo di polling**: è il periodo di tempo che intercorre tra un sondaggio e l'altro.**Recupera registri di esecuzione**: se selezionata, i registri verranno recuperati automaticamente al termine del processo batch.**Formato di registro**: questo è il formato dei log da stampare. Può essere in formato testo o JSON.<br />3. Mantieni i valori predefiniti nel resto dei campi e salva l'attività. | Amministratore di Universal Controller | 
| Avvia l'operazione. | 1. Nella parte superiore del pannello di destra, scegli **Avvia attività**.<br />2. Nella finestra di **conferma**, scegli **Avvia**. Dopodiché, la Universal Controller Console visualizzerà un messaggio simile al seguente messaggio.<br />*2022-08-24 11:11:59*<br />*Lanciato con successo l'attività universale «Mainframe Modernization Start Batch» con l'istanza di attività sys\_id.* <sys id><br />3. Vai alla pagina **Istanze** Se non vedi la scheda Istanze, scegli la **freccia destra** per scorrere verso destra.<br />4. **Apri il menu contestuale (fai clic con il pulsante destro del mouse) per l'istanza dell'attività nell'elenco, scegli **Recupera output**, quindi scegli **Invia** in Recupera output**<br />5. Nella finestra **Recupera output**, vedrai l'elenco degli ambienti in STDOUT. | Amministratore di Universal Controller | 

### Crea un flusso di lavoro per più attività
<a name="create-a-workflow-for-multiple-tasks"></a>


| Operazione | Description | Competenze richieste | 
| --- | --- | --- | 
| Copia le attività. | 1. Apri il menu contestuale (clic con il pulsante destro del mouse) per l'attività di cui desideri creare copie e scegli **Copia**.<br />2. *Nella finestra **Copy AWS Mainframe Modernization Task** inserisci il seguente nuovo nome per la nuova attività: Mainframe Modernization Start Batch -. RUNAWS2*<br />3. *Copiate nuovamente l'operazione, utilizzando il seguente nome: Mainframe Modernization Start Batch -. RUNAWS3*<br />4. *Copiare nuovamente con l'operazione, utilizzando il seguente nome: Mainframe Modernization Start Batch -. RUNAWS4*<br />5. *Copiate l'operazione un'ultima volta, utilizzando il seguente nome: Mainframe Modernization Start Batch - FOOBAR.* | Amministratore di Universal Controller | 
| Attività di aggiornamento. | 1. Aprite (doppio clic) l' RUNAWS2 operazione Mainframe Modernization Start Batch -, modificate il campo **JCL File Name** in e salvate`RUNAWS2.jcl`.<br />2. *Aprite (doppio clic) l' RUNAWS3 operazione Mainframe Modernization Start Batch -, modificate il campo **JCL File Name** in e salvate`RUNAWS3.jcl`.*<br />3. *Aprite (doppio clic) l' RUNAWS4 operazione Mainframe Modernization Start Batch -, modificate il campo **JCL File Name** in e salvate`RUNAWS4.jcl`.*<br />4. *Aprire (doppio clic) l'attività Mainframe Modernization Start Batch - FOOBAR, modificare il campo **JCL File Name** in e salvare. `MISSING.jcl`* **Questa operazione avrà esito negativo perché il valore del nome del file JCL non è corretto.** | Amministratore di Universal Controller | 
| Crea un flusso di lavoro. | 1. Vai a **Servizi**, **Flussi di lavoro**.<br />2. Nel pannello di destra, inserisci **Mainframe Modernization Workflow** nel campo **Nome** e salva.<br />3. Nel pannello di destra, scegli **Modifica flusso** di lavoro.<br />4. **Nella scheda Workflow Editor**, il pulsante **Aggiungi attività** **(\+)**.<br />5. Nella finestra **Task Find**, scegli **Cerca** per visualizzare tutte le attività in Universal Controller.<br />6. Fate clic sull'icona accanto a Mainframe Modernization Start Batch Task e trascinate l'icona in una posizione vuota dell'Editor di **flussi di lavoro**.<br />7. *Ripetete la stessa azione per le altre attività di modernizzazione del mainframe e inseritele come mostrato nella sezione Informazioni aggiuntive.*<br />8. Scegli il pulsante **Connect** **()** e collega le attività tra loro. Per collegare un'attività a un'altra, fai clic al centro di un'attività e trascinala sull'attività di destinazione.<br />9. Connect le attività come mostrato nella sezione *Informazioni aggiuntive* e salva il flusso di lavoro.<br />10. Fate clic con il pulsante destro del mouse su un punto vuoto nell'Editor di flussi di **lavoro, scegliete Avvia flusso** di lavoro, quindi scegliete **OK**. | Amministratore di Universal Controller | 
| Controlla lo stato del flusso di lavoro. | 1. Nel menu a sinistra, scegli l'**Attività**<br />2. Al centro della finestra, scegli **Avvia**.<br />Nell'elenco verrà visualizzato l'elenco delle istanze di attività.<br />3. **Apri (fai doppio clic) Mainframe Modernization Workflow nell'elenco oppure apri il menu contestuale (fai clic con il pulsante destro del mouse) e scegli **Workflow Task Commands, View Workflow**.**<br />Le attività verranno visualizzate come illustrato nella sezione Informazioni aggiuntive. La seconda attività avrebbe dovuto fallire perché hai utilizzato un file JCL mancante. | Amministratore di Universal Controller | 

### Risolvi i problemi relativi ai processi batch non riusciti e rieseguili
<a name="troubleshoot-failed-batch-jobs-and-rerun"></a>


| Operazione | Description | Competenze richieste | 
| --- | --- | --- | 
| Correggi l'operazione non riuscita e riesegui. | 1. Aprite (fate doppio clic) sull'operazione non riuscita per visualizzare l'errore relativo all'operazione.<br />2. Sono disponibili due opzioni per correggere l'operazione non riuscita.Correggi il nome del file JCL e impostalo su. `FOOBAR.jcl`Aggiungi il nome file JCL corretto al nome file **JCL (Temp**). Questo campo sovrascriverà il campo Nome file **JCL**.<br />Per questo programma pilota, scegliete la seconda opzione e salvate l'istanza dell'operazione.<br />3. In **Workflow Monitor**, aprite il menu contestuale (con il pulsante destro del mouse) relativo all'operazione non riuscita e scegliete **Comandi**, **Esegui nuovamente**.<br />4. Dopodiché, tutte le attività verranno completate correttamente. | Amministratore di Universal Controller | 

### Crea le attività di avvio dell'applicazione e interrompi l'applicazione
<a name="create-start-application-and-stop-application-tasks"></a>


| Operazione | Description | Competenze richieste | 
| --- | --- | --- | 
| Crea l'azione Avvia applicazione. | 1. Passa a **Services**, **AWS Mainframe Modernization** Tasks.<br />2. Nel pannello di destra, compila i campi obbligatori.**Nome**: Applicazione Mainframe Modernization Start**Agente**: seleziona l'unico agente () AGNT0001<br />Nella sezione Dettagli sulla **modernizzazione dei mainframe di AWS**:**Azione: Avvia l'**applicazione******Credenziali AWS**: se hai aggiunto un ruolo IAM all'istanza EC2, puoi lasciare questo campo vuoto. Se intendi utilizzare `AWSAccessKeyID` e`AWSSecretKey`, seleziona la credenziale che hai creato in precedenza.**Punto finale**:**** assicurati che l'endpoint abbia la regione corretta. Il valore predefinito è `https://m2.us-east-1.amazonaws.com`.**Regione**: entra nella regione del servizio AWS Mainframe Modernization. Il valore predefinito è `us-east-1`.**Applicazione**: scegli l'icona accanto al campo **()** e scegli **Invia** nelle scelte di **aggiornamento** dell'applicazione. Questo si connetterà al servizio AWS Mainframe Modernization e restituirà l'elenco delle applicazioni. Ora puoi selezionare l'applicazione dall'elenco a discesa. Seleziona l'applicazione su cui desideri eseguire il processo batch.**Attendi esito positivo o negativo**:**** se questa opzione è selezionata, l'operazione attenderà che lo stato del processo batch sia riuscito o meno.**Intervallo di polling**: è il periodo di tempo che intercorre tra un sondaggio e l'altro.**Recupera registri di esecuzione**: se selezionata, i registri verranno recuperati automaticamente al termine del processo batch.**Formato di registro:** questo è il formato dei log da stampare. Può essere in formato testo o JSON.<br />3. Mantieni i valori predefiniti nel resto dei campi e salva l'attività.<br />4. Ora copia questa attività e crea un'attività per Stop Application. **Cambia il nome in **Mainframe Moderinization Stop Application** e modifica l'azione in Stop Application.** | Amministratore di Universal Controller | 

### Creare un'attività Annulla esecuzione Batch
<a name="create-a-cancel-batch-execution-task"></a>


| Operazione | Description | Competenze richieste | 
| --- | --- | --- | 
| Creare l'azione Annulla Batch. | 1. Passa a **Services**, **AWS Mainframe Modernization** Tasks.<br />2. Nel pannello di destra, compila i campi obbligatori.**Nome**: Modernizzazione del mainframe Annulla l'esecuzione in batch**Agente**: seleziona l'unico agente () AGNT0001<br />Nella sezione Dettagli sulla **modernizzazione dei mainframe di AWS**:**Azione**:**** Annulla l'esecuzione del Batch**Credenziali AWS**: se hai aggiunto un ruolo IAM all'istanza EC2, puoi lasciare questo campo vuoto. Se intendi utilizzare `AWSAccessKeyID` e`AWSSecretKey`, seleziona la credenziale che hai creato in precedenza.**Punto finale**:**** assicurati che l'endpoint abbia la regione corretta. Il valore predefinito è `https://m2.us-east-1.amazonaws.com`.**Regione**: entra nella regione del servizio AWS Mainframe Modernization. Il valore predefinito è `us-east-1`.**Applicazione**: scegli l'icona accanto al campo **()** e scegli **Invia** nelle scelte di **aggiornamento** dell'applicazione. Questo si connetterà al servizio AWS Mainframe Modernization e restituirà l'elenco delle applicazioni. Ora puoi selezionare l'applicazione dall'elenco a discesa. Seleziona l'applicazione su cui desideri eseguire il processo batch.**Attendi esito positivo o negativo**:**** se questa opzione è selezionata, l'operazione attenderà che lo stato del processo batch sia riuscito o meno.**Intervallo di polling**: è il periodo di tempo che intercorre tra un sondaggio e l'altro.**Recupera registri di esecuzione**: se selezionata, i registri verranno recuperati automaticamente al termine del processo batch.**Formato di registro**: questo è il formato dei log da stampare. Può essere in formato testo o JSON.<br />3. Mantieni i valori predefiniti nel resto dei campi e salva l'attività. |  | 

## Risorse correlate
<a name="integrate-stonebranch-universal-controller-with-aws-mainframe-modernization-resources"></a>
+ [Controller universale](https://stonebranchdocs.atlassian.net/wiki/spaces/UC77/overview)
+ [Agente universale](https://stonebranchdocs.atlassian.net/wiki/spaces/UA77/overview)
+ [Impostazioni LDAP](https://stonebranchdocs.atlassian.net/wiki/spaces/UC77/pages/794552355/LDAP+Settings)
+ [Single Sign-On SAML](https://stonebranchdocs.atlassian.net/wiki/spaces/UC77/pages/794553130/SAML+Single+Sign-On)
+ [Strumento di conversione Xpress](https://www.stonebranch.com/resources/xpress-conversion-windows)

## Informazioni aggiuntive
<a name="integrate-stonebranch-universal-controller-with-aws-mainframe-modernization-additional"></a>

**Icone nell'editor del flusso di lavoro**

![Attività RUNHELLO nella parte superiore, FOOBAR nella parte centrale e le attività rimanenti al terzo livello.](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/images/pattern-img/01c6f9fa-87e6-459a-b694-5e03dd7f7952/images/837430ee-3159-4fe2-8e17-65168294ef1e.png)


**Tutte le attività connesse**

![RUNHELLO si connette a FOOBAR, che si collega alle tre attività rimanenti.](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/images/pattern-img/01c6f9fa-87e6-459a-b694-5e03dd7f7952/images/fe483348-9a6f-450b-87e6-ceae6b2bdaad.png)


**Stato del flusso di lavoro**

![L'operazione FOOBAR ha esito negativo e le tre attività rimanenti sono in attesa.](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/images/pattern-img/01c6f9fa-87e6-459a-b694-5e03dd7f7952/images/5ea4e239-fbbe-4fa4-9ffa-b7a9443b7975.png)
