Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Integrieren Sie Stonebranch Universal Controller in AWS Mainframe Modernization
*Vaidy Sankaran und Pablo Alonso Prieto, Amazon Web Services*
*Robert Lemieux und Hüseyin Gomleksizoglu, Stonebranch*
## Zusammenfassung
Hinweis: AWS Mainframe Modernization Der Service (Managed Runtime Environment Experience) steht Neukunden nicht mehr zur Verfügung. Funktionen, die AWS Mainframe Modernization Service (Managed Runtime Environment-Erfahrung) ähneln, finden Sie unter AWS Mainframe Modernization Service (Self-Managed Experience). Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter [Änderung der AWS Mainframe Modernization Verfügbarkeit](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).
Dieses Muster erklärt, wie die [Workload-Orchestrierung des Stonebranch Universal Automation Center (UAC)](https://www.stonebranch.com/stonebranch-platform/universal-automation-center) in den Mainframe-Modernisierungsservice von [Amazon Web Services (AWS)](https://aws.amazon.com/mainframe-modernization/) integriert wird. Der AWS Mainframe Modernization Service migriert und modernisiert Mainframe-Anwendungen in die AWS-Cloud. Es bietet zwei Muster: [AWS Mainframe Modernization Replatform](https://aws.amazon.com/mainframe-modernization/patterns/replatform/) mit Micro Focus Enterprise-Technologie und [AWS Mainframe Modernization Automated Refactor mit 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 ist eine Echtzeit-IT-Automatisierungs- und Orchestrierungsplattform. UAC wurde entwickelt, um Jobs, Aktivitäten und Workflows in hybriden IT-Systemen zu automatisieren und zu orchestrieren, von On-Premise bis hin zu AWS. Unternehmenskunden, die Mainframe-Systeme verwenden, stellen auf Cloud-zentrierte, modernisierte Infrastrukturen und Anwendungen um. Die Tools und professionellen Services von Stonebranch erleichtern die Migration vorhandener Scheduler und Automatisierungsfunktionen in die AWS-Cloud.
Wenn Sie Ihre Mainframe-Programme mithilfe des AWS Mainframe Modernization Service in die AWS-Cloud migrieren oder modernisieren, können Sie diese Integration nutzen, um die Batch-Planung zu automatisieren, die Agilität zu erhöhen, die Wartung zu verbessern und die Kosten zu senken.
Dieses Muster enthält Anweisungen für die Integration von [Stonebranch Scheduler](https://www.stonebranch.com/) in Mainframe-Anwendungen, die zur Laufzeit des AWS Mainframe Modernization Service Micro Focus Enterprise migriert wurden. Dieses Muster richtet sich an Lösungsarchitekten, Entwickler, Berater, Migrationsspezialisten und andere Personen, die in den Bereichen Migrationen, Modernisierungen, Betrieb oder tätig sind. DevOps
**Angestrebtes Ergebnis**
Dieses Muster konzentriert sich auf die Erzielung der folgenden Zielergebnisse:
+ Die Möglichkeit, Mainframe-Batch-Jobs, die im AWS Mainframe Modernization Service (Microfocus Runtime) ausgeführt werden, von Stonebranch Universal Controller aus zu planen, zu automatisieren und auszuführen.
+ Überwachen Sie die Batch-Prozesse der Anwendung vom Stonebranch Universal Controller aus.
+ Start/Restart/Rerun/StopBatch-Prozesse automatisch oder manuell vom Stonebranch Universal Controller aus.
+ Rufen Sie die Ergebnisse der Batch-Prozesse für die AWS Mainframe-Modernisierung ab.
+ Erfassen Sie die [ CloudWatchAWS-Protokolle](https://aws.amazon.com/cloudwatch/) der Batch-Jobs in Stonebranch Universal Controller.
## Voraussetzungen und Einschränkungen
**Voraussetzungen**
+ Ein aktives AWS-Konto
+ Eine Micro Focus [Bank-Demo-Anwendung](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo_runtime.zip) mit Job Control Language (JCL) -Dateien und einem Batch-Prozess, der in einer AWS Mainframe Modernization Service-Umgebung (Micro Focus Runtime) bereitgestellt wird
+ [Grundkenntnisse zum Erstellen und Bereitstellen einer Mainframe-Anwendung, die auf Micro Focus Enterprise Server läuft](https://www.microfocus.com/media/data-sheet/enterprise_server_ds.pdf)
+ Grundkenntnisse über Stonebranch Universal Controller
+ [Stonebranch-Testlizenz (wenden Sie sich an Stonebranch)](https://www.stonebranch.com/)
+ Windows- oder Linux-Instances von Amazon Elastic Compute Cloud (Amazon EC2) (z. B. xlarge) mit mindestens vier Kernen, 8 GB Arbeitsspeicher und 2 GB Festplattenspeicher
+ Apache Tomcat Version 8.5.x oder 9.0.x
+ Oracle Java Runtime Environment (JRE) oder OpenJDK Version 8 oder 11
+ [Amazon Aurora MySQL-kompatible Edition](https://aws.amazon.com/rds/aurora/)
+ [Amazon Simple Storage Service (Amazon S3)](https://aws.amazon.com/s3/) -Bucket für das Export-Repository
+ [Amazon Elastic File System (Amazon EFS)](https://aws.amazon.com/efs/) für Agenten Stonebranch Universal Message Service (OMS) -Verbindungen für Hochverfügbarkeit (HA)
+ Installationsdateien für Stonebranch Universal Controller 7.2 Universal Agent 7.2
+ [Vorlage für die Aufgabenplanung](https://github.com/aws-samples/aws-mainframe-modernization-stonebranch-integration/releases) von AWS Mainframe Modernization (neueste veröffentlichte Version der ZIP-Datei)
**Einschränkungen**
+ Das Produkt und die Lösung wurden nur mit OpenJDK 8 und 11 getestet und ihre Kompatibilität validiert.
+ Die Aufgabenplanungsvorlage [aws-mainframe-modernization-stonebranch-integration](https://github.com/aws-samples/aws-mainframe-modernization-stonebranch-integration/releases) funktioniert nur mit dem AWS Mainframe Modernization Service.
+ Diese Vorlage zur Aufgabenplanung funktioniert nur auf einer Unix-, Linux- oder Windows-Edition von Stonebranch-Agenten.
+ Einige AWS-Services sind nicht in allen AWS-Regionen verfügbar. Informationen zur Verfügbarkeit in den einzelnen Regionen finden Sie unter [AWS-Services nach Regionen](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/). Informationen zu bestimmten Endpunkten finden Sie auf der Seite [Service-Endpunkte und Kontingente](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html). Wählen Sie dort den Link für den Service.
## Architektur
**Architektur des Zielzustands**
Das folgende Diagramm zeigt die AWS-Beispielumgebung, die für dieses Pilotprojekt erforderlich ist.
1. Das Stonebranch Universal Automation Center (UAC) umfasst zwei Hauptkomponenten: Universal Controller und Universal Agents. Stonebranch OMS wird als Nachrichtenbus zwischen dem Controller und einzelnen Agenten verwendet.
1. Die Stonebranch UAC-Datenbank wird von Universal Controller verwendet. Die Datenbank kann mit MySQL, Microsoft SQL Server, Oracle oder Aurora MySQL kompatibel sein.
1. AWS Mainframe Modernization Service — Micro Focus-Laufzeitumgebung mit der [bereitgestellten BankDemo Anwendung](https://aws.amazon.com/blogs/aws/modernize-your-mainframe-applications-deploy-them-in-the-cloud/). Die BankDemo Anwendungsdateien werden in einem S3-Bucket gespeichert. Dieser Bucket enthält auch die Mainframe-JCL-Dateien.
1. Stonebranch UAC kann die folgenden Funktionen für den Batchlauf ausführen:
1. Starten Sie einen Batch-Job mit dem JCL-Dateinamen, der im S3-Bucket vorhanden ist, der mit dem AWS-Mainframe-Modernisierungsservice verknüpft ist.
1. Rufen Sie den Status des ausgeführten Batch-Jobs ab.
1. Warten Sie, bis die Batch-Job-Ausführung abgeschlossen ist.
1. Ruft die Protokolle der Batch-Job-Ausführung ab.
1. Führen Sie die fehlgeschlagenen Batch-Jobs erneut aus.
1. Brechen Sie den Batch-Job ab, während der Job ausgeführt wird.
1. Stonebranch UAC kann die folgenden Funktionen für die Anwendung ausführen:
1. Anwendung starten
1. Status der Bewerbung abrufen
1. Warten Sie, bis die Anwendung gestartet oder gestoppt ist
1. Anwendung beenden
1. Protokolle des Anwendungsbetriebs abrufen
**Konvertierung von Stonebranch-Jobs**
Das folgende Diagramm zeigt den Prozess der Umstellung von Arbeitsplätzen bei Stonebranch während der Modernisierung. Es wird beschrieben, wie die Jobpläne und Aufgabendefinitionen in ein kompatibles Format konvertiert werden, mit dem Batch-Aufgaben von AWS Mainframe Modernization ausgeführt werden können.
1. Für den Konvertierungsprozess werden die Jobdefinitionen aus dem vorhandenen Mainframe-System exportiert.
1. JCL-Dateien können in den S3-Bucket für die Mainframe-Modernisierungsanwendung hochgeladen werden, sodass diese JCL-Dateien vom AWS Mainframe Modernization Service bereitgestellt werden können.
1. Das Konvertierungstool konvertiert die exportierten Auftragsdefinitionen in UAC-Aufgaben.
1. Nachdem alle Aufgabendefinitionen und Jobpläne erstellt wurden, werden diese Objekte in den Universal Controller importiert. Die konvertierten Aufgaben führen dann die Prozesse im AWS Mainframe Modernization Service aus, anstatt sie auf dem Mainframe auszuführen.
**Stonebranch UAC-Architektur**
Das folgende Architekturdiagramm stellt ein active-active-passive Modell eines Universal Controllers mit hoher Verfügbarkeit (HA) dar. Stonebranch UAC wird in mehreren Availability Zones eingesetzt, um hohe Verfügbarkeit zu gewährleisten und Disaster Recovery (DR) zu unterstützen.
*Universeller Controller*
Zwei Linux-Server werden als Universal Controller bereitgestellt. Beide stellen eine Verbindung zum selben Datenbankendpunkt her. Jeder Server beherbergt eine Universal Controller-Anwendung und OMS. Zum Zeitpunkt der Bereitstellung wird die neueste Version von Universal Controller verwendet.
Die Universal Controller werden in der Tomcat-Webapp als Dokument ROOT bereitgestellt und auf Port 80 bereitgestellt. Diese Bereitstellung erleichtert die Konfiguration des Frontend-Load Balancers.
HTTP über TLS oder HTTPS wird mithilfe des Stonebranch-Platzhalterzertifikats aktiviert (z. B.). `https://customer.stonebranch.cloud` Dadurch wird die Kommunikation zwischen dem Browser und der Anwendung gesichert.
*OMS*
Ein Universal Agent und OMS (Opswise Message Service) befinden sich auf jedem Universal Controller-Server. Alle vom Kunden bereitgestellten Universal Agents sind so eingerichtet, dass sie eine Verbindung zu beiden OMS-Diensten herstellen. OMS fungiert als gemeinsamer Messaging-Dienst zwischen den Universal Agents und dem Universal Controller.
Amazon EFS mountet auf jedem Server ein Spool-Verzeichnis. OMS verwendet dieses gemeinsam genutzte Spool-Verzeichnis, um die Verbindungs- und Aufgabeninformationen von Controllern und Agenten zu speichern. OMS arbeitet in einem Hochverfügbarkeitsmodus. Wenn das aktive OMS ausfällt, hat das passive OMS Zugriff auf alle Daten und nimmt den aktiven Betrieb automatisch wieder auf. Universal Agents erkennen diese Änderung und stellen automatisch eine Verbindung zum neuen aktiven OMS her.
*Datenbank*
Amazon Relational Database Service (Amazon RDS) beherbergt die UAC-Datenbank, deren Engine mit Amazon Aurora MySQL kompatibel ist. Amazon RDS hilft bei der Verwaltung und Bereitstellung von geplanten Backups in regelmäßigen Abständen. Beide Universal Controller-Instances stellen eine Verbindung mit demselben Datenbank-Endpunkt her.
*Load Balancer*
Für jede Instanz wird ein Application Load Balancer eingerichtet. Der Load Balancer leitet den Datenverkehr zu einem bestimmten Zeitpunkt an den aktiven Controller weiter. Ihre Instance-Domainnamen verweisen auf die jeweiligen Load Balancer-Endpunkte.
*URLs*
Jede Ihrer Instances hat eine URL, wie im folgenden Beispiel gezeigt.
|
|
| Umgebung | Instance |
| --- |--- |
| **Produktion** | `customer.stonebranch.cloud` |
| **Entwicklung (Nichtproduktion)** | `customerdev.stonebranch.cloud` |
| **Testen (außerhalb der Produktion)** | `customertest.stonebranch.cloud` |
**Anmerkung**
Instanznamen, die nicht zur Produktion verwendet werden, können Ihren Anforderungen entsprechend festgelegt werden.
*Hohe Verfügbarkeit*
Hochverfügbarkeit (HA) ist die Fähigkeit eines Systems, über einen bestimmten Zeitraum kontinuierlich ohne Ausfall zu arbeiten. Zu diesen Ausfällen gehören unter anderem Speicher, Reaktionsverzögerungen bei der Serverkommunikation aufgrund von CPU- oder Speicherproblemen und Netzwerkkonnektivität.
Um die HA-Anforderungen zu erfüllen:
+ Alle EC2-Instances, Datenbanken und anderen Konfigurationen werden in zwei separaten Availability Zones innerhalb derselben AWS-Region gespiegelt.
+ Der Controller wird über ein Amazon Machine Image (AMI) auf zwei Linux-Servern in den beiden Availability Zones bereitgestellt. Wenn Sie beispielsweise in der Region Europa eu-west-1 bereitgestellt werden, haben Sie einen Universal Controller in der Availability Zone eu-west-1a und der Availability Zone eu-west-1c.
+ Jobs dürfen nicht direkt auf den Anwendungsservern ausgeführt werden und es dürfen keine Daten auf diesen Servern gespeichert werden.
+ Der Application Load Balancer führt Integritätsprüfungen auf jedem Universal Controller durch, um den aktiven Controller zu identifizieren und den Datenverkehr an ihn weiterzuleiten. Falls bei einem Server Probleme auftreten, versetzt der Load Balancer den passiven Universal Controller automatisch in einen aktiven Status. Der Load Balancer identifiziert dann die neue aktive Universal Controller-Instanz anhand der Integritätsprüfungen und leitet den Datenverkehr weiter. Der Failover erfolgt innerhalb von vier Minuten ohne Jobverlust, und die Frontend-URL bleibt unverändert.
+ Der Aurora MySQL-kompatible Datenbankdienst speichert Universal Controller-Daten. Für Produktionsumgebungen wird ein Datenbankcluster mit zwei Datenbank-Instances in zwei verschiedenen Availability Zones innerhalb einer einzigen AWS-Region erstellt. Beide Universal Controller verwenden eine Java Database Connectivity (JDBC) -Schnittstelle, die auf einen einzelnen Datenbankcluster-Endpunkt verweist. Falls bei einer Datenbankinstanz Probleme auftreten, verweist der Datenbankcluster-Endpunkt dynamisch auf die fehlerfreie Instanz. Es ist kein manueller Eingriff erforderlich.
*Backup und Löschen*
Stonebranch Universal Controller ist so eingestellt, dass alte Daten nach dem in der Tabelle angegebenen Zeitplan gesichert und gelöscht werden.
|
|
| Typ | Plan |
| --- |--- |
| **Aktivität** | 7 Tage |
| **Prüfung** | 90 Tage |
| **Verlauf** | 60 Tage |
Backup-Daten, die älter als die angegebenen Daten sind, werden in das XML-Format exportiert und im Dateisystem gespeichert. Nach Abschluss des Sicherungsvorgangs werden ältere Daten aus der Datenbank gelöscht und für Produktionsinstanzen bis zu einem Jahr in einem S3-Bucket archiviert.
Sie können diesen Zeitplan in Ihrer Universal Controller-Oberfläche anpassen. Eine Verlängerung dieser Zeitrahmen kann jedoch zu längeren Ausfallzeiten während der Wartung führen.
## Tools
**AWS-Services**
+ [AWS Mainframe Modernization](https://docs.aws.amazon.com/m2/latest/userguide/what-is-m2.html) ist eine Cloud-native AWS-Plattform, mit der Sie Ihre Mainframe-Anwendungen auf von AWS verwaltete Laufzeitumgebungen modernisieren können. Er bietet Tools und Ressourcen, die Sie bei der Planung und Implementierung von Migration und Modernisierung unterstützen.
+ [Amazon Elastic Block Store (Amazon EBS)](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AmazonEBS.html) bietet Volumes für die Speicherung auf Blockebene, die in Verbindung mit Amazon-EC2-Instances verwendet werden.
+ [Amazon Elastic File System (Amazon EFS)](https://docs.aws.amazon.com/efs/latest/ug/whatisefs.html) unterstützt Sie bei der Erstellung und Konfiguration gemeinsam genutzter Dateisysteme in der AWS-Cloud.
+ [Amazon Relational Database Service (Amazon RDS)](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Welcome.html) unterstützt Sie bei der Einrichtung, dem Betrieb und der Skalierung einer relationalen Datenbank in der AWS-Cloud. Dieses Muster verwendet Amazon Aurora MySQL-Compatible Edition.
+ [Amazon Simple Storage Service (Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html) ist ein cloudbasierter Objektspeicherservice, der Sie beim Speichern, Schützen und Abrufen beliebiger Datenmengen unterstützt.
+ [Elastic Load Balancing (ELB)](https://docs.aws.amazon.com/elasticloadbalancing/latest/userguide/what-is-load-balancing.html) verteilt eingehenden Anwendungs- oder Netzwerkverkehr auf mehrere Ziele. Sie können beispielsweise den Datenverkehr auf Amazon EC2 EC2-Instances, Container und IP-Adressen in einer oder mehreren Availability Zones verteilen. Dieses Muster verwendet einen Application Load Balancer.
**Stonebranch**
+ Das [Universal Automation Center (UAC)](https://stonebranchdocs.atlassian.net/wiki/spaces/SD/pages/239239169/Universal+Automation+Center) ist ein System von Produkten zur Workload-Automatisierung für Unternehmen. Dieses Muster verwendet die folgenden UAC-Komponenten:
+ [Universal Controller](https://www.stonebranch.com/documentation-universal-controller), eine Java-Webanwendung, die in einem Tomcat-Webcontainer ausgeführt wird, ist die Lösung für Enterprise Job Scheduler und Workload Automation Broker von Universal Automation Center. Der Controller bietet eine Benutzeroberfläche zum Erstellen, Überwachen und Konfigurieren von Controller-Informationen, verwaltet die Planungslogik, verarbeitet alle Nachrichten an und von Universal Agents und synchronisiert einen Großteil des Hochverfügbarkeitsbetriebs von Universal Automation Center.
+ [Universal Agent](https://www.stonebranch.com/documentation-universal-agent) ist ein herstellerunabhängiger Planungsagent, der mit dem vorhandenen Job Scheduler auf allen wichtigen Computerplattformen zusammenarbeitet, sowohl auf älteren als auch auf verteilten Computerplattformen. Alle Scheduler, die unter Unixz/Series, i/Series, Linux oder Windows laufen, werden unterstützt.
+ [Universal Agent](https://www.stonebranch.com/documentation-universal-agent) ist ein herstellerunabhängiger Scheduling-Agent, der mit bestehenden Job-Schedulern auf allen wichtigen Computerplattformen zusammenarbeitet, sowohl auf älteren als auch auf verteilten Computerplattformen. Alle Scheduler, die unter Unixz/Series, i/Series, Linux oder Windows laufen, werden unterstützt.
+ [Stonebranch aws-mainframe-modernization-stonebranch -integration AWS Mainframe Modernization Universal Extension](https://github.com/aws-samples/aws-mainframe-modernization-stonebranch-integration/releases) ist die Integrationsvorlage zum Ausführen, Überwachen und erneuten Ausführen von Batch-Jobs auf der AWS Mainframe Modernization Platform.
**Code**
[Der Code für dieses Muster ist im Repository -integration verfügbar. aws-mainframe-modernization-stonebranch](https://github.com/aws-samples/aws-mainframe-modernization-stonebranch-integration/releases/) GitHub
## Epen
### Installieren Sie Universal Controller und Universal Agent auf Amazon EC2
| Aufgabe | Description | Erforderliche Fähigkeiten |
| --- | --- | --- |
| Laden Sie die Installationsdateien herunter. | Laden Sie die Installation von den Stonebranch-Servern herunter. Wenden Sie sich an Stonebranch, um die Installationsdateien zu erhalten. | Cloud-Architekt |
| Starten Sie die EC2-Instanz. | Sie benötigen etwa 3 GB zusätzlichen Speicherplatz für die Universal Controller- und Universal Agent-Installationen. Stellen Sie also mindestens 30 GB Festplattenspeicher für die Instanz bereit.
Fügen Sie der Sicherheitsgruppe Port 8080 hinzu, damit darauf zugegriffen werden kann. | Cloud-Architekt |
| Überprüfen Sie die Voraussetzungen. | Gehen Sie vor der Installation wie folgt vor:1. Installieren Sie Java wie unter [Java Runtime Environment herunterladen](https://www.stonebranch.com/documentation-java-runtime) beschrieben.$ sudo yum -y update
$ sudo yum install java-11-amazon-corretto
Stellen Sie sicher, dass Sie eine der unterstützten JAVA-Versionen verwenden. Der vorherige Befehl sollte Java-11 installieren. Überprüfen Sie die Java-Version und stellen Sie sicher, dass Sie Version 11 verwenden, bevor Sie fortfahren.
2. Führen Sie, wie unter [Apache Tomcat installieren](https://www.stonebranch.com/documentation-apache-tomcat) beschrieben, die folgenden Befehle aus.$ sudo yum install tomcat tomcat-admin-webapps
$ sudo systemctl enable tomcat
$ sudo systemctl start tomcat
3. Erstellen Sie eine Amazon Aurora Aurora-Datenbank, wie unter [Erstellen und Herstellen einer Verbindung zu einem Aurora MySQL-DB-Cluster](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.Aurora.html) beschrieben. Verwenden Sie die Amazon Aurora MySQL-kompatible Edition.
Wählen Sie einen Master-Benutzernamen und ein Master-Passwort. Behalten Sie die Standardwerte für die restlichen Einstellungen bei. | Cloud-Administrator, Linux-Administrator |
| Installieren Sie Universal Controller. | 1. Laden Sie die `universal-controller-7.2.0.0.tar`**** Installationsdatei auf die EC2-Instanz hoch.
2. Entarchivieren Sie die Installationsdateien in einem `temp` Ordner.$ tar -xvf universal-controller-7.2.0.0.tar
3. Erteilen Sie dem Installationsskript die Ausführungsberechtigung.$ chmod a+x install-controller.sh
4. Installieren Sie den Controller. In diesem Beispiel wird der folgende Befehl verwendet, um Universal Controller unter `/usr/share/tomca` t zu installieren. Verwenden Sie die Amazon Aurora Aurora-Datenbank, die Sie in den vorherigen Schritten erstellt haben.$ 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/
Die letzte Zeile der Skriptausgabe sollte „Installation abgeschlossen“ lauten.
5. Navigieren Sie in der EC2-Instanz zur folgenden URL.http://:8080/uc
6. Geben Sie auf dem Anmeldebildschirm im Bereich **Nutzername** **ops.admin** ein und lassen Sie das Feld **Passwort** leer.
7. Legen Sie ein neues Passwort für den `ops.admin` Benutzer fest. | Cloud-Architekt, Linux-Administrator |
| Installieren Sie Universal Agent. | 1. Laden Sie die `sb-7.2.0.1-linux-3.10-x86_64.tar.Z` Installationsdatei auf die EC2-Instance hoch.
2. Melden Sie sich bei der EC2-Instance an.
3. Entarchivieren Sie das Universal Agent-Installationspaket.$ zcat sb-7.2.0.1-linux-3.10-x86_64.tar.Z | tar xvf –
4. Führen Sie den folgenden Befehl aus.$ sudo ./unvinst --oms_servers 7878@localhost --oms_autostart yes --python yes
5. Erstellen Sie eine PAM-Datei.$ cp /etc/pam.d/login /etc/pam.d/ucmd
6. Aktivieren Sie Autostart für Universal Agent.$ /sbin/restorecon -v /etc/rc.d/init.d/ubrokerd
| Cloud-Administrator, Linux-Administrator |
| Fügen Sie OMS zu Universal Controller hinzu. | 1. Melden Sie sich mit dem `ops.admin` Benutzer bei Universal Controller an.
2. Wählen Sie in der oberen linken Ecke des Bildschirms das Menü **Dienste** und anschließend im **System** das Menü **OMS-Server**
3. Geben Sie im Feld OMS-Serveradresse den Text ein`localhost`, und speichern Sie dann.
4. Der Status des OMS-Servers wird als **Verbunden** und der **Sitzungsstatus** als **Betriebsbereit** angezeigt. | Universeller Controller-Administrator |
### Importieren Sie AWS Mainframe Modernization Universal Extension und erstellen Sie eine Aufgabe
| Aufgabe | Description | Erforderliche Fähigkeiten |
| --- | --- | --- |
| Integrationsvorlage importieren. | Für diesen Schritt benötigen Sie die [AWS Mainframe Modernization Universal Extension](https://github.com/aws-samples/aws-mainframe-modernization-stonebranch-integration/releases). Stellen Sie sicher, dass die neueste veröffentlichte Version der ZIP-Datei heruntergeladen wurde.1. Melden Sie sich mit dem `ops.admin` Benutzer am Universal Controller an.
2. Navigieren Sie zu **Dienste**, **Integrationsvorlage importieren**.
3. Wählen Sie die ZIP-Datei (`aws_mainframe_modernization_stonebranch_extension.zip`) der Integrationsvorlage aus und klicken Sie auf **Importieren**.
Nachdem die Integrationsvorlage importiert wurde, werden unter **Verfügbare Services** **AWS Mainframe Modernization Tasks** angezeigt. | Universeller Controller-Administrator |
| Aktivieren Sie auflösbare Anmeldeinformationen. | 1. Navigieren Sie zu **Services**, **AWS Mainframe Modernization Tasks**.
2. Füllen Sie im rechten Bereich die erforderlichen Felder aus:**Name**: Neue Aufgabe zur Mainframe-Modernisierung**Agent**: Wählen Sie den einzigen Agenten aus (AGNT0001).
Unter **Details zur AWS-Mainframe-Modernisierung**:**Aktion**: Umgebungen auflisten**AWS-Anmeldeinformationen**: Wenn Sie der EC2-Instance eine AWS Identity and Access Management (IAM) -Rolle hinzugefügt haben, können Sie dieses Feld leer lassen. Wenn Sie `AWSAccessKeyID` und verwenden möchten`AWSSecretKey`, wählen Sie das Symbol **()** neben dem Feld.
Geben Sie in dem sich öffnenden Fenster mit den **Anmeldeinformationen** die folgenden Informationen ein und speichern Sie dann.**Name: Anmeldeinformationen** für die AWS-Mainframe-Modernisierung**Runtime-Benutzer**: Schreiben Sie die AWS-Zugriffsschlüssel-ID in dieses Feld.**Runtime-Passwort**: Schreiben Sie den geheimen AWS-Schlüssel in dieses Feld.**Endpunkt**: Stellen Sie**** sicher, dass der Endpunkt die richtige AWS-Region hat. Der Standardwert ist `https://m2.us-east-1.amazonaws.com`.**Region**: Geben Sie die Region des AWS Mainframe Modernization Service ein. Der Standardwert ist `us-east-1`.
3. Behalten Sie die Standardwerte in den übrigen Feldern bei und speichern Sie die Aufgabe. | Universeller Controller-Administrator |
| Starten Sie die Aufgabe. | 1. Wählen Sie oben im rechten Bereich die Option „**Aufgabe starten**“.
2. Wählen **Sie im Bestätigungsfenster** die Option **Starten** aus. Danach zeigt die Universal Controller Console eine Meldung an, die der folgenden Meldung ähnelt.
*24.08.2022 10:11:49 Uhr*
*Die Universalaufgabe „New Mainframe Modernization Task“ mit der Task-Instanz sys\_id 1661291493634146313 E38 OZJY wurde erfolgreich gestartet. NC8 DB8*
3. **Navigieren Sie zur Registerkarte „Instances“. Wenn Sie den Tab „**Instances**“ nicht sehen, klicken Sie auf den Rechtspfeil, um nach rechts zu scrollen.**
4. Öffnen Sie das Kontextmenü (Rechtsklick) für die Task-Instanz in der Liste, wählen Sie „**Ausgabe abrufen**“ und dann unter „**Ausgabe abrufen**“ die Option „**Absenden**“
5. Im Fenster „**Ausgabe abrufen**“ sehen Sie die Liste der Umgebungen in STDOUT. | Universeller Controller-Administrator |
### Testen Sie das Starten eines Batch-Jobs
| Aufgabe | Description | Erforderliche Fähigkeiten |
| --- | --- | --- |
| Erstellen Sie eine Aufgabe für den Batch-Job. | 1. Navigieren Sie zu **Services**, **AWS Mainframe Modernization Tasks**.
2. Füllen Sie im rechten Bereich die erforderlichen Felder aus:**Name**: Neue Aufgabe zur Mainframe-Modernisierung**Agent**: Wählen Sie den einzigen Agenten aus (AGNT0001).
Unter **Details zur AWS-Mainframe-Modernisierung**:**Aktion**: Batch starten (oder Batch starten und warten, bis der Batch-Job ausgeführt wird und bis die Aufgabe in AWS abgeschlossen ist)**AWS-Anmeldeinformationen**: Wenn Sie der EC2-Instance eine IAM-Rolle hinzugefügt haben, können Sie dieses Feld leer lassen. Wenn Sie `AWSAccessKeyID` und verwenden möchten`AWSSecretKey`, wählen Sie das Symbol **()** neben dem Feld.**Endpunkt**: Stellen Sie**** sicher, dass der Endpunkt die richtige AWS-Region hat. Der Standardwert ist [https://m2.us-east-1.amazonaws.com](https://m2.us-east-1.amazonaws.com).**Region**: Geben Sie die Region des AWS Mainframe Modernization Service ein. Der Standardwert ist `us-east-1`.**Anwendung**: Wählen Sie das Symbol neben dem Feld **()** und wählen Sie unter „**Refresh Application Choices**“ die Option „**Senden**“ aus. Dadurch wird eine Verbindung zum AWS Mainframe Modernization Service hergestellt und die Liste der Anwendungen zurückgegeben. Jetzt können Sie die Anwendung aus der Drop-down-Liste auswählen. Wählen Sie die Anwendung aus, mit der Sie den Batch-Job ausführen möchten.**JCL-Dateiname:** `RUNHELLO.jcl`Auf **Erfolg oder Fehler warten**:**** Wenn diese Option ausgewählt ist, wartet die Aufgabe, bis der Batch-Job den Status „Erfolg“ oder „Fehlschlag“ hat.**Abfrageintervall**: Dies ist der Zeitraum zwischen den einzelnen Abfragen.**Ausführungsprotokolle abrufen**: Wenn diese Option ausgewählt ist, werden Protokolle automatisch abgerufen, wenn der Batch-Job abgeschlossen ist.**Protokollformat**: Dies ist das Format der Protokolle, die ausgedruckt werden sollen. Es kann im Text- oder JSON-Format sein.
3. Behalten Sie die Standardwerte in den übrigen Feldern bei und speichern Sie die Aufgabe. | Universeller Controller-Administrator |
| Starten Sie die Aufgabe. | 1. Wählen Sie oben im rechten Bereich die Option „**Aufgabe starten**“.
2. Wählen **Sie im Bestätigungsfenster** die Option **Starten** aus. Danach zeigt die Universal Controller Console eine Meldung an, die der folgenden Meldung ähnelt.
*24.08.2022 11:11:59 Uhr*
*Die Universalaufgabe „Mainframe Modernization Start Batch“ wurde erfolgreich mit der Taskinstanz sys\_id gestartet.*
3. Navigieren Sie zur Registerkarte „**Instances**“. Wenn Sie den Tab „**Instances**“ nicht sehen, klicken Sie auf den Rechtspfeil, um nach rechts zu blättern.
4. Öffnen Sie das Kontextmenü (Rechtsklick) für die Task-Instanz in der Liste, wählen Sie „**Ausgabe abrufen**“ und dann unter „**Ausgabe abrufen**“ die Option „**Absenden**“
5. Im Fenster „**Ausgabe abrufen**“ sehen Sie die Liste der Umgebungen in STDOUT. | Universeller Controller-Administrator |
### Erstellen Sie einen Workflow für mehrere Aufgaben
| Aufgabe | Description | Erforderliche Fähigkeiten |
| --- | --- | --- |
| Kopieren Sie die Aufgaben. | 1. Öffnen Sie das Kontextmenü (Rechtsklick) für die Aufgabe, von der Sie Kopien erstellen möchten, und wählen Sie **Kopieren**.
2. *Geben **Sie im Fenster Copy AWS Mainframe Modernization Task** den folgenden neuen Namen für die neue Aufgabe ein: Mainframe Modernization Start Batch -. RUNAWS2*
3. *Kopieren Sie die Aufgabe erneut und verwenden Sie dabei den folgenden Namen: Mainframe Modernization Start Batch -RUNAWS3.*
4. *Kopieren Sie erneut mit der Aufgabe und verwenden Sie dabei den folgenden Namen: Mainframe Modernization Start Batch -RUNAWS4.*
5. Kopieren Sie die Aufgabe ein letztes Mal und verwenden Sie dabei den folgenden Namen: Mainframe Modernization Start Batch - *FOOBAR*. | Universeller Controller-Administrator |
| Aufgaben aktualisieren. | 1. Öffnen Sie die Aufgabe Mainframe Modernization Start Batch — RUNAWS2 Task (Doppelklicken), ändern Sie das Feld **JCL-Dateiname** in und `RUNAWS2.jcl` speichern Sie.
2. Öffnen Sie die Aufgabe Mainframe Modernization Start Batch — RUNAWS3 Task (Doppelklicken), ändern Sie das Feld **JCL-Dateiname** in und `RUNAWS3.jcl` *speichern* Sie.
3. Öffnen Sie die Aufgabe Mainframe Modernization Start Batch — RUNAWS4 Task (Doppelklicken), ändern Sie das Feld **JCL-Dateiname** in und `RUNAWS4.jcl` *speichern* Sie.
4. *Öffnen (doppelklicken) Sie die Aufgabe Mainframe Modernization Start Batch — FOOBAR, ändern Sie das Feld **JCL-Dateiname** in und speichern Sie`MISSING.jcl`.* **Diese Aufgabe schlägt fehl, weil der Wert für den JCL-Dateinamen falsch ist.** | Universeller Controller-Administrator |
| Erstellen Sie einen Workflow. | 1. Navigieren Sie zu **Dienste**, **Workflows**.
2. Geben Sie im rechten Bereich **Mainframe Modernization Workflow** in das Feld **Name** ein und speichern Sie.
3. Wählen Sie im rechten Bereich die Option **Workflow bearbeiten** aus.
4. Klicken Sie auf der **Registerkarte Workflow-Editor** auf die Schaltfläche „**Aufgabe hinzufügen**“ **(\+)**.
5. Wählen **Sie im Fenster „Aufgaben** suchen“ die Option „**Suchen**“, um alle Aufgaben im Universal Controller anzuzeigen.
6. Klicken Sie auf das Symbol neben Mainframe Modernization Start Batch Task und ziehen Sie das Symbol an eine leere Stelle im **Workflow-Editor**.
7. Wiederholen Sie dieselbe Aktion für die anderen Mainframe-Modernisierungsaufgaben und platzieren Sie sie wie im Abschnitt *Zusätzliche Informationen* gezeigt.
8. Wählen Sie die Schaltfläche **Connect** **()** und verbinden Sie die Aufgaben miteinander. Um eine Aufgabe mit einer anderen zu verbinden, klicken Sie in die Mitte einer Aufgabe und ziehen Sie sie auf die Zielaufgabe.
9. Connect die Aufgaben wie im Abschnitt *Zusätzliche Informationen* gezeigt, und speichern Sie den Workflow.
10. Klicken Sie mit der rechten Maustaste auf eine leere Stelle im Workflow-Editor, wählen Sie **Workflow starten** und dann **OK**. | Universeller Controller-Administrator |
| Überprüfen Sie den Status des Workflows. | 1. Wählen Sie im linken Menü die **Aktivität**
2. Wählen Sie in der Mitte des Fensters **Start**.
Sie sehen die Liste der Task-Instanzen in der Liste.
3. Öffnen Sie den Mainframe Modernization Workflow in der Liste (doppelklicken Sie darauf) oder öffnen Sie das Kontextmenü (mit der rechten Maustaste) und wählen Sie **Workflow-Aufgabenbefehle**, **Workflow anzeigen** aus.
Sie sehen die Aufgaben so, wie sie im Abschnitt Zusätzliche Informationen dargestellt sind. Es wurde erwartet, dass die zweite Aufgabe fehlschlagen würde, weil Sie eine fehlende JCL-Datei verwendet haben. | Universeller Controller-Administrator |
### Beheben Sie fehlgeschlagene Batch-Jobs und führen Sie sie erneut aus
| Aufgabe | Description | Erforderliche Fähigkeiten |
| --- | --- | --- |
| Korrigieren Sie die fehlgeschlagene Aufgabe und führen Sie sie erneut aus. | 1. Öffnen Sie die fehlgeschlagene Aufgabe (doppelklicken Sie darauf), um den Fehler für die Aufgabe zu sehen.
2. Sie haben zwei Möglichkeiten, die fehlgeschlagene Aufgabe zu reparieren.Korrigieren Sie den Namen der JCL-Datei und setzen Sie ihn auf`FOOBAR.jcl`.Fügen Sie dem JCL-Dateinamen **(Temp) den richtigen JCL-Dateinamen hinzu**. Dieses Feld überschreibt das Feld **JCL-Dateiname**.
Wählen Sie für dieses Pilotprojekt die zweite Option und speichern Sie die Task-Instanz.
3. Öffnen Sie im **Workflow-Monitor** das Kontextmenü (Rechtsklick) für die fehlgeschlagene Aufgabe und wählen Sie **Befehle**, **Erneut ausführen**.
4. Danach werden alle Aufgaben erfolgreich abgeschlossen. | Universeller Controller-Administrator |
### Aufgaben „Anwendung starten“ und „Anwendung beenden“ erstellen
| Aufgabe | Description | Erforderliche Fähigkeiten |
| --- | --- | --- |
| Erstellen Sie die Aktion „Anwendung starten“. | 1. Navigieren Sie zu **Services**, **AWS Mainframe Modernization Tasks**.
2. Füllen Sie im rechten Bereich die erforderlichen Felder aus.**Name**: Anwendung zur Mainframe-Modernisierung starten**Agent**: Wählen Sie den einzigen Agenten aus () AGNT0001
Unter **Details zur AWS-Mainframe-Modernisierung**:**Aktion**: Anwendung**** starten**AWS-Anmeldeinformationen**: Wenn Sie der EC2-Instance eine IAM-Rolle hinzugefügt haben, können Sie dieses Feld leer lassen. Wenn Sie `AWSAccessKeyID` und verwenden möchten`AWSSecretKey`, wählen Sie die Anmeldeinformationen aus, die Sie zuvor erstellt haben.**Endpunkt**: Stellen Sie**** sicher, dass der Endpunkt die richtige Region hat. Der Standardwert ist `https://m2.us-east-1.amazonaws.com`.**Region**: Geben Sie die Region des AWS Mainframe Modernization Service ein. Der Standardwert ist `us-east-1`.**Anwendung**: Wählen Sie das Symbol neben dem Feld **()** und wählen Sie unter „**Refresh Application Choices**“ die Option „**Senden**“ aus. Dadurch wird eine Verbindung zum AWS Mainframe Modernization Service hergestellt und die Liste der Anwendungen zurückgegeben. Jetzt können Sie die Anwendung aus der Drop-down-Liste auswählen. Wählen Sie die Anwendung aus, mit der Sie den Batch-Job ausführen möchten.Auf **Erfolg oder Fehler warten**:**** Wenn diese Option ausgewählt ist, wartet die Aufgabe, bis der Status des Batch-Jobs erfolgreich oder fehlgeschlagen ist.**Abfrageintervall**: Dies ist der Zeitraum zwischen den einzelnen Abfragen.**Ausführungsprotokolle abrufen**: Wenn diese Option ausgewählt ist, werden Protokolle automatisch abgerufen, wenn der Batch-Job abgeschlossen ist.**Protokollformat:** Dies ist das Format der Protokolle, die ausgedruckt werden sollen. Es kann im Text- oder JSON-Format sein.
3. Behalten Sie die Standardwerte in den übrigen Feldern bei und speichern Sie die Aufgabe.
4. Kopieren Sie nun diese Aufgabe und erstellen Sie eine Aufgabe für „Anwendung beenden“. **Ändern Sie den Namen in **Mainframe Moderinization Stop Application** und ändern Sie die Aktion in Stop Application.** | Universeller Controller-Administrator |
### Eine Aufgabe zum Abbrechen der Batch-Ausführung erstellen
| Aufgabe | Description | Erforderliche Fähigkeiten |
| --- | --- | --- |
| Erstellen Sie die Aktion Batch stornieren. | 1. Navigieren Sie zu **Services**, **AWS Mainframe Modernization Tasks**.
2. Füllen Sie im rechten Bereich die erforderlichen Felder aus.**Name**: Mainframe-Modernisierung Batch-Ausführung abbrechen**Agent**: Wählen Sie den einzigen Agenten aus () AGNT0001
Unter **Details zur AWS-Mainframe-Modernisierung**:**Aktion**: Batch-Ausführung**** abbrechen**AWS-Anmeldeinformationen**: Wenn Sie der EC2-Instance eine IAM-Rolle hinzugefügt haben, können Sie dieses Feld leer lassen. Wenn Sie `AWSAccessKeyID` und verwenden möchten`AWSSecretKey`, wählen Sie die Anmeldeinformationen aus, die Sie zuvor erstellt haben.**Endpunkt**: Stellen Sie**** sicher, dass der Endpunkt die richtige Region hat. Der Standardwert ist `https://m2.us-east-1.amazonaws.com`.**Region**: Geben Sie die Region des AWS Mainframe Modernization Service ein. Der Standardwert ist `us-east-1`.**Anwendung**: Wählen Sie das Symbol neben dem Feld **()** und wählen Sie unter „**Refresh Application Choices**“ die Option „**Senden**“ aus. Dadurch wird eine Verbindung zum AWS Mainframe Modernization Service hergestellt und die Liste der Anwendungen zurückgegeben. Jetzt können Sie die Anwendung aus der Drop-down-Liste auswählen. Wählen Sie die Anwendung aus, mit der Sie den Batch-Job ausführen möchten.Auf **Erfolg oder Fehler warten**:**** Wenn diese Option ausgewählt ist, wartet die Aufgabe, bis der Status des Batch-Jobs erfolgreich oder fehlgeschlagen ist.**Abfrageintervall**: Dies ist der Zeitraum zwischen den einzelnen Abfragen.**Ausführungsprotokolle abrufen**: Wenn diese Option ausgewählt ist, werden Protokolle automatisch abgerufen, wenn der Batch-Job abgeschlossen ist.**Protokollformat**: Dies ist das Format der Protokolle, die ausgedruckt werden sollen. Es kann im Text- oder JSON-Format sein.
3. Behalten Sie die Standardwerte in den übrigen Feldern bei und speichern Sie die Aufgabe. | |
## Zugehörige Ressourcen
+ [Universeller Controller](https://stonebranchdocs.atlassian.net/wiki/spaces/UC77/overview)
+ [Universeller Agent](https://stonebranchdocs.atlassian.net/wiki/spaces/UA77/overview)
+ [LDAP-Einstellungen](https://stonebranchdocs.atlassian.net/wiki/spaces/UC77/pages/794552355/LDAP+Settings)
+ [SAML-Single-Sign-On](https://stonebranchdocs.atlassian.net/wiki/spaces/UC77/pages/794553130/SAML+Single+Sign-On)
+ [Xpress-Konvertierungstool](https://www.stonebranch.com/resources/xpress-conversion-windows)
## Zusätzliche Informationen
**Symbole im Workflow-Editor**
**Alle Aufgaben sind miteinander verbunden**
**Status des Workflows**
