AWS Der Mainframe Modernization Service (Managed Runtime Environment Experience) steht Neukunden nicht mehr zur Verfügung. Funktionen, die dem 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 Verfügbarkeit von [AWS Mainframe Modernization](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html). 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. # AWS Transform für Mainframe-Runtime einrichten In diesem Abschnitt werden die Schritte zur Einrichtung von AWS Transform for Mainframe Runtime auf Ihrer AWS Infrastruktur erläutert. Bevor Sie AWS Transform for Mainframe Runtime for Applications einrichten, sollten Sie sich mit den Voraussetzungen, Regionen und Bereichen sowie der CloudWatch Alarmeinstellung für die Konfiguration und Verwaltung Ihrer Laufzeitumgebung vertraut machen. **Topics** + [AWS Voraussetzungen für Transform for Mainframe Runtime](ba-runtime-setup-prereq.md) + [Onboarding AWS Transform für Mainframe-Runtime](ba-runtime-setup-onboard.md) + [Anforderungen an die Einrichtung der Infrastruktur für AWS Transform for Mainframe Runtime](ba-infrastructure-setup.md) + [AWS Transformation für Mainframe-Runtime-Artefakte](ba-runtime-artifacts.md) + [Stellen Sie AWS Transform for Mainframe Runtime auf Amazon EC2 bereit](ba-deploy-ec2.md) + [Stellen Sie AWS Transform for Mainframe Runtime auf Containern auf Amazon ECS und Amazon EKS bereit](ba-deploy-container.md) + [Testen Sie die PlanetsDemo Anwendung](ba-runtime-test-planetsdemo.md) # AWS Voraussetzungen für Transform for Mainframe Runtime AWS Transform for Mainframe Runtime ist in verschiedenen [AWS Versionshinweise zu Transform for Mainframe](ba-release-notes.md) Release-Versionen verfügbar. Wenn Sie laufende Modernisierungsprojekte haben, benötigen Sie möglicherweise inkrementelle Versionen der Runtime für Implementierungs- und Testzwecke. Um Ihre Bedürfnisse zu definieren, wenden Sie sich an Ihren AWS Transform for Mainframe Delivery Manager. Bevor Sie mit der Verwendung von AWS Transform for Mainframe Runtime beginnen, gehen Sie wie folgt vor: + Stellen Sie sicher, dass Sie ein AWS Konto haben. + Stellen Sie sicher, dass Sie über eine modernisierte Anwendung verfügen, die mit AWS Transform for Mainframe überarbeitet wurde. + Wählen Sie eine AWS Region und eine der Rechenoptionen, die für Transform for AWS Mainframe Runtime unterstützt werden. + Wählen Sie die Version von AWS Transform for Mainframe Runtime aus, die Sie verwenden möchten. + Überprüfen [Anforderungen an die Einrichtung der Infrastruktur für AWS Transform for Mainframe Runtime](ba-infrastructure-setup.md) und validieren Sie die zusätzlichen Komponenten, die für die Ausführung von AWS Transform for Mainframe Runtime erforderlich sind. **Anmerkung** [Wenn Sie die Funktionen von AWS Transform for Mainframe Runtime testen möchten, können Sie die Demo-Anwendung verwenden`Planets Demo`, die Sie von PlanetsDemo -v1.zip herunterladen können.](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip) # Onboarding AWS Transform für Mainframe-Runtime **Anmerkung** Der Runtime-Zugriff auf AWS Transform for Mainframe wurde von ticketbasierten Anfragen auf direkten Download über [AWS Transform for](https://bluinsights.aws/) Mainframe Refactor umgestellt. Wir haben eine neue und vereinfachte Methode für den Zugriff auf AWS Transform for mainframe Produkte über die [AWS Transform for mainframeToolbox-Funktion](https://bluinsights.aws/docs/bluage-toolbox-introduction) in AWS Transform for Mainframe Refactor eingeführt. Erstellen Sie zunächst einen [AWS Support](https://support.console.aws.amazon.com/support/home)Fall, um das Onboarding für den Zugriff auf AWS Transform for Mainframe Runtime zu beantragen. Geben Sie in Ihrer Anfrage Ihre AWS-Konto ID, die AWS Region, die Sie verwenden möchten, und eine Rechenoption sowie die Runtime-Version von AWS Transform for Mainframe an. Wenn Sie sich nicht sicher sind, welche Version Sie benötigen, wenden Sie sich an Ihren AWS Transform for Mainframe Delivery Manager. Wenn Sie bereits über den Quellcode einer Anwendung verfügen, die mit den AWS Mainframe Modernization Refactoring-Tools generiert wurde, notieren Sie sich den `gapwalk.version` Tag-Wert in der `pom.xml` Datei in Ihrer modernisierten Codebasis. **Anmerkung** AWS Transform for Mainframe Runtime ist in zwei Hauptvarianten erhältlich: Alpha-Vorabversionen und Releases. Um herauszufinden, welche Version Sie verwenden sollten, wenden Sie sich an Ihren Transform for Mainframe [AWS Transformation für Mainframe-Versionierung](ba-versioning.md) Delivery Manager oder wenden Sie sich an Ihren AWS Transform for Mainframe Delivery Manager. ## Regionen und Bereiche für AWS Transform for Mainframe Runtime Wir speichern die AWS Transform for Mainframe-Runtime-Artefakte in verschiedenen Amazon S3 S3-Buckets, je nach Region und Rechenauswahl. Verwenden Sie den in der folgenden Tabelle aufgeführten Namen, um auf den Bucket AWS-Region für Ihren for AWS Transform for Mainframe Runtime zuzugreifen. | AWS-Region | Bucket veröffentlichen | Alpha-Vorabversions-Bucket | | --- | --- | --- | | USA Ost (Ohio) | aws-bluage-runtime-artifacts-055777665268-US-Ost-2 | aws-bluage-runtime-artifacts-dev-055777665268-us-ost-2 | | USA Ost (Nord-Virginia) | aws-bluage-runtime-artifacts-139023371234-uns-Ost-1 | aws-bluage-runtime-artifacts-dev-139023371234-uns-Ost-1 | | USA West (Nordkalifornien) | aws-bluage-runtime-artifacts-788454048782-us-west-1 | aws-bluage-runtime-artifacts-dev-788454048782-us-west-1 | | USA West (Oregon) | aws-bluage-runtime-artifacts-836771190483-uns-West-2 | aws-bluage-runtime-artifacts-dev-836771190483-us-west-2 | | Kanada (Zentral) | aws-bluage-runtime-artifacts-637423580979-ca-central-1 | aws-bluage-runtime-artifacts-dev-637423580979-ca-central-1 | | Europa (Irland) | aws-bluage-runtime-artifacts-925278190477-eu-west-1 | aws-bluage-runtime-artifacts-dev-925278190477-eu-west-1 | | Europa (London) | aws-bluage-runtime-artifacts-767397831990-eu-west-1 | aws-bluage-runtime-artifacts-dev-767397831990-eu-west-1 | | Europa (Paris) | aws-bluage-runtime-artifacts-673009995881-eu-west-3 | aws-bluage-runtime-artifacts-dev-673009995881-eu-west-3 | | Europa (Frankfurt) | aws-bluage-runtime-artifacts-485196800481-eu-central-1 | aws-bluage-runtime-artifacts-dev-485196800481-eu-central-1 | | Europa (Stockholm) | aws-bluage-runtime-artifacts-654654484534-eu-nord-1 | aws-bluage-runtime-artifacts-dev-654654484534-eu-nord-1 | | Europa (Milan) | aws-bluage-runtime-artifacts-654654328338-eu-Süd-1 | aws-bluage-runtime-artifacts-dev-654654328338-eu-süd-1 | | Europa (Spain) | aws-bluage-runtime-artifacts-905417994954-eu-Süd-2 | aws-bluage-runtime-artifacts-dev-905417994954-eu-süd-2 | | Südamerika (São Paulo) | aws-bluage-runtime-artifacts-737536804457-sa-ost-1 | aws-bluage-runtime-artifacts-dev-737536804457-sa-ost-1 | | Asien-Pazifik (Tokio) | aws-bluage-runtime-artifacts-445578176276-ap-nordost-1 | aws-bluage-runtime-artifacts-dev-445578176276-ap-nordoast-1 | | Asien-Pazifik (Seoul) | aws-bluage-runtime-artifacts-381492221498-ap-Nordost-2 | aws-bluage-runtime-artifacts-dev-381492221498-ap-Nordost-2 | | Asien-Pazifik (Osaka) | aws-bluage-runtime-artifacts-905418229615-ap-Nordost-3 | aws-bluage-runtime-artifacts-dev-905418229615-ap-nordost-3 | | Asien-Pazifik (Singapur) | aws-bluage-runtime-artifacts-767397774613-ap-Südosten-1 | aws-bluage-runtime-artifacts-dev-767397774613-ap-südosten-1 | | Asien-Pazifik (Sydney) | aws-bluage-runtime-artifacts-726160321909-ap-Südosten-2 | aws-bluage-runtime-artifacts-dev-726160321909-ap-Südosten-2 | | Asien-Pazifik (Mumbai) | aws-bluage-runtime-artifacts-905418353577-ap-süd-1 | aws-bluage-runtime-artifacts-dev-905418353577-ap-süd-1 | | Afrika (Kapstadt) | aws-bluage-runtime-artifacts-992382777663-af-Süd-1 | aws-bluage-runtime-artifacts-dev-992382777663-af-süd-1 | | Israel (Tel Aviv) | aws-bluage-runtime-artifacts-471112516508-il-central-1 | aws-bluage-runtime-artifacts-dev-471112516508-il-central-1 | ## Verwenden von, um den Inhalt des Buckets aufzulisten AWS CLI Nach dem Onboarding können Sie den Inhalt des Buckets auflisten, indem Sie den folgenden AWS CLI Befehl in einem Terminal ausführen. `aws s3 ls bucket-name ` `bucket-name`Ersetzen Sie ihn durch den Namen des Buckets für Ihren AWS-Region aus der vorherigen Tabelle. Dieser Befehl gibt eine Liste von Ordnern zurück, die verschiedenen Versionen der Runtime-Laufzeit von AWS Transform for Mainframe entsprechen, z. B. die folgende für einen Release-Bucket: ``` PRE 4.0.0/ PRE 4.10.0/ ``` Oder wie folgt für einen Build-Bucket: ``` PRE 4.11.0/ PRE 4.13.0/ ``` Wir empfehlen, dass Sie die neueste verfügbare Version verwenden. Wenn das nicht möglich ist, verwenden Sie die Runtime-Version, die während der Refactoring-Phase der Anwendung validiert wurde. Führen Sie den folgenden Befehl aus, um die verfügbaren Frameworks für eine bestimmte Version aufzulisten: `aws s3 ls s3://bucket-name/version/Framework/` `bucket-name`Ersetzen Sie es durch den Namen des Buckets für Sie AWS-Region und `version` durch die gewünschte Version. Im Folgenden finden Sie zwei Beispiele. Für einen Release-Bucket: `aws s3 ls s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.10.0/Framework/` Der Befehl gibt eine Liste von ZIP-Dateien zurück, z. B.: ``` 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 ``` Für einen Alpha-Vorabversion-Bucket: `aws s3 ls s3://aws-bluage-runtime-artifacts-dev-139023371234-us-east-1/4.11.0/Framework/` Der Befehl gibt eine Liste von ZIP-Dateien zurück, z. B.: ``` 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 ``` ## Laden Sie das Framework herunter Sie können das Framework herunterladen, um beispielsweise die Runtime-Version von AWS Transform for Mainframe auf einer vorhandenen Amazon EC2 EC2-Instance zu aktualisieren. `aws s3 cp s3://bucket-name/version/Framework/ folder-of-your-choice --recursive ` Wobei Folgendes gilt: folder-of-your-choice Ordnerpfad, in den Sie das Framework herunterladen möchten. Beispiel: `aws s3 cp s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.0.0/Framework/ . --recursive` Die Ausgabe dieses Befehls sieht wie folgt aus. ``` 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 ``` Sie können die Framework-Dateien wie folgt auflisten: `ls -l` Die Ausgabe dieses Befehls sieht wie folgt aus. ``` 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 ``` **Anmerkung** Der Zugriff auf Artefakte kann vorübergehend unterbrochen werden, und Versionen können aus Sicherheitsgründen entfernt werden. Wir empfehlen dringend, dass Sie die Artefakte, die Sie verwenden, in Ihrem eigenen Konto speichern. Die lokale Version sollte als Referenz in Ihren internen Architekturen verwendet werden. # Anforderungen an die Einrichtung der Infrastruktur für AWS Transform for Mainframe Runtime In diesem Thema wird die Mindestkonfiguration der Infrastruktur beschrieben, die für die Ausführung von AWS Transform for Mainframe Runtime erforderlich ist. In den folgenden Verfahren wird beschrieben, wie Sie AWS Transform for Mainframe Runtime auf dem Computer Ihrer Wahl einrichten, um eine modernisierte Anwendung auf AWS Transform for Mainframe Runtime bereitzustellen. Die Ressourcen, die Sie erstellen, müssen sich in einer Amazon-VPC VPC, die über ein Subnetz verfügt, das Ihrer Anwendungsdomäne zugewiesen ist. **Topics** + [Anforderungen an die Infrastruktur](#infrastructure-requirements) + [AWS Transform for Mainframe Runtime auf Amazon EC2 ausführen](#ba-running-on-ec2) + [AWS Transform for Mainframe Runtime auf Amazon ECS auf Amazon EC2 ausführen](#ba-running-on-ecs-on-ec2) + [AWS Transform for Mainframe Runtime auf Amazon EKS auf Amazon EC2 ausführen](#ba-running-on-eks-on-ec2) + [AWS Transform for Mainframe Runtime auf Amazon ECS ausführen, verwaltet von AWS Fargate](#ba-running-on-fargate) ## Anforderungen an die Infrastruktur **Eine Sicherheitsgruppe erstellen** Wenn Sie planen, an Amazon EC2 EC2-Instances auf Amazon EKS zu arbeiten, überspringen Sie dieses Verfahren, da der Amazon EKS-Clustererstellungsprozess in Ihrem Namen eine Sicherheitsgruppe erstellt. Verwenden Sie diese Sicherheitsgruppe in den folgenden Verfahren, anstatt eine neue zu erstellen. 1. Öffnen Sie die Amazon-VPC-Konsole unter [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/). 1. Wählen Sie im linken Navigationsbereich unter **Sicherheit** die Option **Sicherheitsgruppen** aus. 1. Wählen Sie im mittleren Bereich die Option **Sicherheitsgruppe erstellen** aus. 1. Geben Sie in das Feld **Name der Sicherheitsgruppe** ein**M2BluagePrivateLink-SG**. 1. Wählen Sie im Abschnitt **Eingehende Regeln** die Option **Regel hinzufügen** aus. 1. Wählen Sie als **Typ** die Option HTTPS aus. 1. Geben Sie als **Quelle** Ihre VPC CIDR ein. 1. **Wählen Sie im Abschnitt **Regeln für ausgehende Nachrichten die** Option Regel hinzufügen aus.** 1. Wählen Sie als **Typ** die Option HTTPS aus. 1. Geben Sie für **Destination** **0.0.0.0/0** ein. 1. Wählen Sie **Sicherheitsgruppe erstellen** aus. **Erstellen einer IAM-Rolle** 1. Öffnen Sie unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) die IAM-Konsole. 1. Wählen Sie im linken Navigationsbereich unter **Zugriffsverwaltung** die Option **Rollen** aus. 1. Wählen Sie im mittleren Bereich die Option **Rolle erstellen** aus. 1. Wählen **Sie im Abschnitt Anwendungsfall** je nach Ihrer Computerauswahl eine der folgenden Optionen aus: + **EC2** (für Amazon EC2 und Amazon EKS auf Amazon EC2) + **Elastic Container Service** und dann **EC2-Rolle für Elastic Container Service** (für Amazon ECS auf Amazon EC2) + **Elastic Container Service** und dann **Elastic Container Service Task** (für Amazon ECS, verwaltet von Fargate) 1. Wählen Sie **Weiter** aus. 1. Geben Sie einen Namen für die Rolle ein, wählen Sie dann **Rolle erstellen** aus. ## AWS Transform for Mainframe Runtime auf Amazon EC2 ausführen Gehen Sie wie folgt vor, um eine Amazon EC2 EC2-Instance zu erstellen. **Erstellen einer Amazon-EC2-Instance** 1. Öffnen Sie die Amazon-EC2-Konsole unter [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. Wählen Sie **Launch Instance (Instance starten)** aus. 1. Wählen Sie als **Instance-Typ** einen verfügbaren EC2-Instance-Typ aus. 1. Wählen Sie im Abschnitt **key pair** entweder ein vorhandenes Schlüsselpaar aus oder erstellen Sie ein neues. 1. Wählen Sie im Abschnitt **Netzwerkeinstellungen** die **Option Bestehende Sicherheitsgruppe auswählen aus**. 1. Wählen Sie für **Allgemeine Sicherheitsgruppen** die Option **M2 BluagePrivateLink -SG** aus. 1. Erweitern Sie den Abschnitt **Erweiterte Details**. 1. Wählen Sie für das **IAM-Instanzprofil** die IAM-Rolle aus, die Sie zuvor erstellt haben. 1. Wählen Sie **Launch Instance (Instance starten)** aus. **Installieren Sie die Anwendung auf der Amazon EC2 EC2-Instance** 1. Wenn sich der Status der Amazon EC2 EC2-Instance auf **Running** ändert, stellen Sie eine Verbindung mit der Instance her. 1. Installieren Sie die folgenden Softwarekomponenten auf der Instance (siehe die in der genannten Versionen[AWS Versionshinweise zu Transform for Mainframe](ba-release-notes.md)): + Java Runtime Environment (JRE). + Apache Tomcat. + AWS Transformation für Mainframe-Runtime (auf Amazon EC2). Installieren Sie AWS Transform for Mainframe Runtime im Stammverzeichnis des Apache Tomcat-Installationsordners (einige Dateien werden hinzugefügt, andere werden überschrieben). Um die zusätzlichen Webapps zu installieren, die zusammen mit dem AWS Transform for Mainframe Runtime-Archiv geliefert werden, richten Sie eine sekundäre Instanz des Apache Tomcat-Servers ein und dekomprimieren Sie das Webapps-Archiv an diesem Speicherort. Detaillierte Anweisungen finden Sie unter [AWS Transformation für Mainframe-Runtime-Artefakte](ba-runtime-artifacts.md). ## AWS Transform for Mainframe Runtime auf Amazon ECS auf Amazon EC2 ausführen 1. Erstellen Sie einen Amazon ECS-Cluster mit **Amazon EC2 EC2-Instances** als zugrunde liegende Infrastruktur. Weitere Informationen finden Sie unter [Erste Schritte mit Windows auf Amazon EC2](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/getting-started-ecs-ec2-v2.html#getting-started-ec2-cluster-v2) im Amazon Elastic Container Service Developer Guide. 1. Geben Sie die IAM-Rolle an, die Sie in den vorherigen Schritten erstellt haben. 1. Wählen Sie einen EC2-Instanztyp. 1. Wählen Sie **unter Netzwerkeinstellungen für Amazon EC2 EC2-Instances** die Sicherheitsgruppe aus, die Sie in den vorherigen Schritten erstellt haben. ## AWS Transform for Mainframe Runtime auf Amazon EKS auf Amazon EC2 ausführen 1. Erstellen Sie einen Amazon-EKS-Cluster. Weitere Informationen finden Sie unter [Erstellen eines Amazon EKS-Clusters](https://docs.aws.amazon.com/eks/latest/userguide/create-cluster.html) im *Amazon EKS-Benutzerhandbuch*. 1. Wie bereits erwähnt, wird in Ihrem Namen eine Sicherheitsgruppe erstellt. 1. Erstellen Sie eine Knotengruppe. Geben Sie die IAM-Rolle an, die Sie in den vorherigen Schritten erstellt haben. 1. Wählen Sie einen EC2-Instanztyp. 1. Amazon EKS weist die Sicherheitsgruppe automatisch den gestarteten Amazon EC2 EC2-Instances zu. ## AWS Transform for Mainframe Runtime auf Amazon ECS ausführen, verwaltet von AWS Fargate Erstellen Sie einen Amazon ECS-Cluster mit **AWS Fargate (serverlos)** als zugrunde liegende Infrastruktur. Weitere Informationen finden Sie unter [Erste Schritte mit Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/getting-started-fargate.html) im *Amazon Elastic Container Service Developer Guide*. # AWS Transformation für Mainframe-Runtime-Artefakte AWS Runtime-Artefakte von Transform for Mainframe sind die Komponenten für die Bereitstellung und Ausführung modernisierter Anwendungen. In diesem Dokument werden die verschiedenen verfügbaren Artefakttypen, ihre Speicherorte und der Zugriff auf sie beschrieben. ## AWS Transformation für Mainframe-Runtime-Artefakte ### Inhalt der Artefakte Sowohl im Release- als auch im Pre-Release-Bucket finden Sie: **gapwalk-x.y.z.zip** Dieses Archiv, wobei x.y.z für die Versionsnummer steht (siehe [AWS Transform für Mainframe-Versionierung), enthält die Kernkomponenten von Transform for Mainframe Runtime](https://docs.aws.amazon.com/m2/latest/userguide/ba-versioning.html), die für die Ausführung von AWS Transform für Mainframe-Anwendungen unerlässlich sind, darunter: AWS | Artefakt | Description | Typ | Distributionsordner | | --- | --- | --- | --- | | gapwalk-application-x.y.z.war | AWS Transform for mainframeHaupt-Webanwendung Gapwalk | Krieg | Webapps | | \$1.jar | AWS Transform for mainframeGemeinsam genutzte Runtime Framework-Bibliotheken (Gapwalk) | Gläser | shared | | Gapwalk-\$1-x.y.z.war | AWS Transform for mainframezusätzliche Webanwendungen (utility-pgm, hierarchische Unterstützung,...) | Krieg | Webapps-Extra | | bac-x.y.z.war/jac-x.y.z.war | AWS Transform for mainframeVerwaltungskonsolen (nicht eigenständig) | Krieg | Webapps-Konsolen | **aws-bluage-webapps-x.y.z.zip** Dieses Archiv, in dem x.y.z dem gleichen Versionsschema wie oben folgt, umfasst Verwaltungskonsolen (eigenständig) AWS Transform for mainframe + WAR-Datei (**BAC**) (BlusamKonsole), die zur Überwachung der Datenbank verwendet wird. Blusam + WAR-Datei (**JAC** Console), die zur Überwachung der JICS-Datenbank verwendet wird. + Erforderliche unterstützende Bibliotheken. ### Überprüfung der Paketsignatur Die veröffentlichten ZIP-Dateien werden als digital signierte ZIP-Archive bereitgestellt, um Sicherheit und Authentizität zu gewährleisten. Mithilfe digitaler Signaturen können Sie überprüfen, ob die heruntergeladenen Dateien echt und unverändert sind und von unserer Organisation offiziell veröffentlicht wurden. Dies verhindert Manipulationen und schützt vor Malware oder kompromittierten Dateien, die in böswilliger Absicht verbreitet werden könnten. Um die Signatur der ZIP-Datei zu überprüfen, bevor Sie sie verwenden, können Sie den folgenden Befehl verwenden: `jarsigner -verify -certs -verbose aws-bluage-runtime-x.y.z.zip` Hier das Ergebnisbeispiel für eine zertifizierte Datei: ``` ... jar verified. ``` Einzelheiten dazu, wie Sicherheitslücken behoben werden, finden Sie unter [AWS Mainframe Modernization Refactor mit AWS Transform for mainframe Versionsübersicht](https://docs.aws.amazon.com/m2/latest/userguide/lifecycle-m2.html#lifecycle-ba-overview). **Anmerkung** Wir bemühen uns zwar, unsere Produkte auch ohne Produkte auf den Markt zu bringen, aber es CVEs kann sein CVEs, dass zu einem späteren Zeitpunkt neue hinzukommen. # Stellen Sie AWS Transform for Mainframe Runtime auf Amazon EC2 bereit In den Themen in diesem Abschnitt erfahren Sie, wie Sie AWS Transform for Mainframe Runtime auf Amazon EC2 einrichten, die Runtime-Version aktualisieren, Ihre Bereitstellung mithilfe von CloudWatch Amazon-Alarmen überwachen und lizenzierte Abhängigkeiten hinzufügen. Diese Anweisungen gelten sowohl für die Erstellung von Amazon EC2-Instances als auch für die Verwendung von Amazon ECS auf Amazon EC2 oder Amazon EKS auf Amazon EC2. Ab Alpha-Version 5.60.0 umfasst die AWS Transform for Mainframe Runtime-Distribution einen Bereitstellungsordner mit einer umfassenden README.md-Datei. Dieses Handbuch enthält Anweisungen zur Bereitstellung von step-by-step Amazon EC2, Konfigurationsoptionen und Tipps zur Fehlerbehebung. **Topics** + [AWS Transform für Mainframe Runtime auf Amazon EC2 einrichten](ba-runtime-deploy-ec2.md) + [Aktualisieren Sie AWS Transform for Mainframe Runtime auf Amazon EC2](ba-runtime-maint-ec2.md) + [AWS Transform für Mainframe Runtime (auf Amazon EC2) einrichten Amazon-Alarme CloudWatch](ba-cw-alarms-ec2.md) + [Richten Sie lizenzierte Abhängigkeiten in AWS Transform for Mainframe Runtime auf Amazon EC2 ein](ba-runtime-dependencies-ec2.md) # AWS Transform für Mainframe Runtime auf Amazon EC2 einrichten In diesem Thema wird erklärt, wie Sie die PlanetsDemo Beispielanwendung mithilfe von AWS Transform for Mainframe Runtime auf Amazon EC2 einrichten und bereitstellen. **Topics** + [Voraussetzungen](#ba-runtime-deploy-prereq) + [Einrichtung](#ba-runtime-deploy-setup) + [Testen Sie die bereitgestellte Anwendung](#ba-runtime-deploy-test) ## Voraussetzungen Bevor Sie beginnen, stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllen. + Konfigurieren Sie das, AWS CLI indem Sie den Schritten [unter Konfiguration der AWS-CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) folgen. + [AWS Voraussetzungen für Transform for Mainframe Runtime](ba-runtime-setup-prereq.md)Vollständig und[Onboarding AWS Transform für Mainframe-Runtime](ba-runtime-setup-onboard.md). + Erstellen Sie eine Amazon EC2 EC2-Instance mit einem der unterstützten Instance-Typen. Weitere Informationen finden Sie unter [Erste Schritte mit Amazon-EC2-Linux-Instancen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html). + Stellen Sie sicher, dass Sie erfolgreich eine Verbindung zur Amazon EC2 EC2-Instance herstellen können, z. B. mithilfe von SSM. **Anmerkung** In diesem Handbuch wird davon ausgegangen, dass der Tomcat-Installationspfad `/m2-anywhere/tomcat-gapwalk/velocity` Stellen Sie sicher, dass Sie diesen Pfad verwenden, wenn Sie die folgenden Anweisungen befolgen, oder passen Sie die folgende Anweisung an den Pfad Ihrer Wahl an. + Laden Sie AWS Transform for Mainframe Runtime (auf Amazon EC2) herunter und extrahieren Sie es direkt in das Velocity-Verzeichnis `/m2-anywhere/tomcat-gapwalk/velocity` (den Tomcat-Installationsordner). Anweisungen zum Abrufen der Runtime-Artefakte von AWS Transform for Mainframe, einschließlich Informationen zu Speicherung, Zugriff und Inhalt, finden Sie unter. [AWS Transformation für Mainframe-Runtime-Artefakte](ba-runtime-artifacts.md) + Laden Sie das [PlanetsDemoAnwendungsarchiv](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip) herunter. + Entpacken Sie das Archiv und laden Sie die Anwendung in einen Amazon S3 S3-Bucket Ihrer Wahl hoch. + Erstellen Sie eine Amazon Aurora PostgreSQL-Datenbank für JICS. AWS Transform for Mainframe Runtime führt das `PlanetsDemo-v1/jics/sql/initJics.sql` Skript beim ersten Start automatisch aus. Informationen zum Erstellen einer Amazon Aurora PostgreSQL-Datenbank finden Sie unter [Erstellen und Herstellen einer Verbindung zu einem Aurora PostgreSQL-DB-Cluster](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster). ## Einrichtung Gehen Sie wie folgt vor, um die PlanetsDemo Beispielanwendung einzurichten. 1. Connect zu Ihrer Amazon EC2 EC2-Instance her und wechseln Sie zu dem `conf` Ordner unter Ihrem Apache Tomcat-Installationsordner. Öffnen Sie die `catalina.properties` Datei zur Bearbeitung und ersetzen Sie die Zeile, die `common.loader` mit der folgenden Zeile beginnt. ``` 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. Navigieren Sie zum Verzeichnis `/m2-anywhere/tomcat-gapwalk/velocity/webapps`. 1. Kopieren Sie mit dem folgenden Befehl die im `PlanetsDemo-v1/webapps/` Ordner verfügbaren PlanetsDemo Binärdateien aus dem Amazon S3 S3-Bucket. ``` aws s3 cp s3://path-to-demo-app-webapps/ . --recursive ``` **Anmerkung** `path-to-demo-app-webapps`Ersetzen Sie es durch die richtige Amazon S3 S3-URI für den Bucket, in den Sie das PlanetsDemo Archiv zuvor entpackt haben. 1. Kopieren Sie den Inhalt des `PlanetsDemo-v1/config/` Ordners in. `/m2-anywhere/tomcat-gapwalk/velocity/config/` 1. Geben Sie die Verbindungsinformationen für die Datenbank an, die Sie als Teil der Voraussetzungen im folgenden Codeausschnitt in der Datei erstellt haben. `/m2-anywhere/tomcat-gapwalk/velocity/config/application-main.yml` Weitere Informationen finden Sie unter [Erstellen und Herstellen einer Verbindung zu einem Aurora PostgreSQL-DB-Cluster](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. Starten Sie Ihren Apache Tomcat-Server und überprüfen Sie die Protokolle. ``` /m2-anywhere/tomcat-gapwalk/velocity/startup.sh tail -f /m2-anywhere/tomcat-gapwalk/velocity/logs/catalina.log ``` Wenn Sie Fehlercodes finden, die mit einem C gefolgt von einer Zahl beginnen, z. B. CXXXX, notieren Sie sich die Fehlermeldungen. Beispielsweise ist der Fehlercode C5102 ein häufiger Fehler, der auf eine falsche Infrastrukturkonfiguration hinweist. ## Testen Sie die bereitgestellte Anwendung Ein Beispiel für das Testen der PlanetsDemo Anwendung finden Sie unter[Testen Sie die PlanetsDemo Anwendung](ba-runtime-test-planetsdemo.md). # Aktualisieren Sie AWS Transform for Mainframe Runtime auf Amazon EC2 In diesem Handbuch wird beschrieben, wie Sie AWS Transform for Mainframe Runtime auf Amazon EC2 aktualisieren. **Topics** + [Voraussetzungen](#ba-runtime-maint-prereq) + [Führen Sie ein Upgrade von AWS Transform for Mainframe Runtime in der Amazon EC2 EC2-Instance durch](#ba-runtime-maint-copy-files) + [Führen Sie ein Upgrade der AWS Transform for Mainframe-Runtime in einem Container durch](#ba-runtime-maint-copy-files) ## Voraussetzungen Bevor Sie beginnen, stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllen. + Informationen darüber, ob es spezielle Anweisungen für Ihre Version gibt, finden Sie unter[Anweisungen zur Aktualisierung von AWS Transform for Mainframe](ba-migration-notes.md). + [AWS Voraussetzungen für Transform for Mainframe Runtime](ba-runtime-setup-prereq.md)Vollständig und[Onboarding AWS Transform für Mainframe-Runtime](ba-runtime-setup-onboard.md). + Stellen Sie sicher, dass Sie über eine Amazon EC2 EC2-Instance mit einer vorhandenen Installation von AWS Transform for Mainframe Runtime verfügen. Weitere Informationen finden Sie unter [Erste Schritte mit Amazon-EC2-Linux-Instancen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html). + Stellen Sie sicher, dass Sie erfolgreich eine Verbindung zur Amazon EC2 EC2-Instance herstellen können, z. B. mithilfe von SSM. + Laden Sie die Runtime-Version von AWS Transform for Mainframe herunter, auf die Sie ein Upgrade durchführen möchten. Das Framework besteht aus zwei Archivdateien: `gapwalk-x.y.z.zip` und`aws-bluage-webapps-x.y.z.zip`. Weitere Informationen finden Sie unter [AWS Transformation für Mainframe-Runtime-Artefakte](ba-runtime-artifacts.md). ## Führen Sie ein Upgrade von AWS Transform for Mainframe Runtime in der Amazon EC2 EC2-Instance durch Führen Sie die folgenden Schritte aus, um die AWS Transform for Mainframe-Runtime zu aktualisieren. 1. Connect zu Ihrer Amazon EC2 EC2-Instance her und ändern Sie den Benutzer in **su, indem Sie** den folgenden Befehl ausführen. ``` sudo su ``` Sie benötigen Superuser-Rechte, um die Befehle in diesem Tutorial ausführen zu können. 1. Verwenden Sie die folgenden Befehle, um die Binärdateien zu extrahieren. Führen Sie die Befehle in jedem Ordner aus. ``` unzip gapwalk-x.y.z.zip unzip aws-bluage-webapps-x.y.z.zip ``` 1. Stoppen Sie die Apache Tomcat-Dienste mit den folgenden Befehlen. ``` systemctl stop tomcat.service systemctl stop tomcat-webapps.service ``` 1. Ersetzen Sie den Inhalt von `/shared/` durch den Inhalt von. `gapwalk-x.y.z/shared/` 1. Ersetzen Sie `/webapps/gapwalk-application.war` durch `gapwalk-x.y.z/webapps/gapwalk-application.war`. 1. Ersetzen Sie die Kriegsdateien in`/webapps/`, nämlich `bac.war` und`jac.war`, durch dieselben Dateien von`aws-bluage-webapps-x.y.z/velocity/webapps/`. 1. Starten Sie die Apache Tomcat-Dienste, indem Sie die folgenden Befehle ausführen. ``` systemctl start tomcat.service systemctl start tomcat-webapps.service ``` 1. Überprüfen Sie die Protokolle. Führen Sie die folgenden Befehle aus, um den Status der bereitgestellten Anwendung zu überprüfen. ``` curl http://localhost:8080/gapwalk-application/ ``` Die folgende Meldung sollte angezeigt werden. ``` Jics application is running ``` ``` curl http://localhost:8181/jac/api/services/rest/jicsservice/ ``` Die folgende Meldung sollte angezeigt werden. ``` Jics application is running ``` ``` curl http://localhost:8181/bac/api/services/rest/bluesamserver/serverIsUp ``` Die Antwort sollte leer sein. Die Laufzeit von AWS Transform for Mainframe wurde erfolgreich aktualisiert. ## Führen Sie ein Upgrade der AWS Transform for Mainframe-Runtime in einem Container durch Führen Sie die folgenden Schritte aus, um AWS Transform for Mainframe Runtime zu aktualisieren. 1. Erstellen Sie Ihr Docker-Image mit der gewünschten Runtime-Version von AWS Transform for Mainframe neu. Detaillierte Anweisungen finden Sie unter [AWS Transform für Mainframe Runtime auf Amazon EC2 einrichten](ba-runtime-deploy-ec2.md). 1. Übertragen Sie Ihr Docker-Image in Ihr Amazon ECR-Repository. 1. Beenden Sie Ihren Amazon ECS- oder Amazon EKS-Service und starten Sie ihn neu. 1. Überprüfen Sie die Protokolle. Die AWS Transform for Mainframe-Runtime wurde erfolgreich aktualisiert. # AWS Transform für Mainframe Runtime (auf Amazon EC2) einrichten Amazon-Alarme CloudWatch Sie können CloudWatch den Empfang Ihres Anwendungsprotokolls einrichten und einen Alarm hinzufügen, der Sie vor möglichen Fehlern warnt. Auf diese Weise erhalten Sie besser sichtbare Benachrichtigungen, wenn Ihre bereitgestellten Anwendungen auf Ausnahmen stoßen. Die folgenden Abschnitte helfen Ihnen, die Konfiguration der CloudWatch Protokollierung und die Einrichtung von Alarmen zu verstehen und mehr darüber zu erfahren. ## Aktivieren Sie die CloudWatch Protokollierung Um die CloudWatch Protokollierung zu aktivieren, erstellen Sie mithilfe der im folgenden Abschnitt bereitgestellten Konfigurationsvorlage eine `logback-cloudwatch.xml` Datei im Konfigurationsordner. Verweisen Sie dann in der Datei auf diese `application-main.yml` Datei, indem Sie die folgenden Zeilen auskommentieren: ``` # logging: # config: classpath:logback-cloudwatch.xml ``` Nach dem Auskommentieren dieser Zeilen wird die CloudWatch Protokollierung aktiviert und kann weiter konfiguriert werden, wie in den folgenden Abschnitten beschrieben. ## Konfiguration der Protokollierung CloudWatch Verwenden Sie die folgende Vorlage, um die `logback-cloudwatch.xml` Datei zu erstellen: ``` %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 ``` Alles außerhalb des Elements ist die Standard-Logback-Konfiguration. Diese Datei enthält zwei Appender: einen Konsolen-Appender zum Senden von Protokollen an die Konsole und einen CloudWatch Appender zum Senden von Protokollen. CloudWatch Das `level` Attribut im `root` Element gibt die Protokollierungsebene der gesamten Anwendung an. Die erforderlichen Werte innerhalb des Tags sind: + :Legt den Namen der Protokollgruppe fest. CloudWatch Wenn der Wert nicht angegeben ist, ist er standardmäßig. `BluAgeRuntimeOnEC2-Logs` Wenn die Protokollgruppe nicht existiert, wird sie automatisch erstellt. Dieses Verhalten kann durch die Konfiguration geändert werden, auf die weiter unten eingegangen wird. + : Legt den Namen des LogStream (innerhalb der Protokollgruppe) fest. CloudWatch Optionale Werte: + : Überschreibt die Region, in die der Log-Stream geschrieben wird. Standardmäßig werden Protokolle in dieselbe Region wie die EC2-Instance gesendet. + : Das Muster, das die Protokollnachrichten verwenden werden. + : Die maximale Anzahl von Protokollnachrichten, an die CloudWatch pro Vorgang gesendet werden können. + : Die Zeit in Millisekunden, die für das Schreiben von CloudWatch Protokollen benötigt wird. + : Die Zeit in Millisekunden, in der versucht wird, Anfragen in die interne Protokollwarteschlange einzufügen. + : Die maximale Größe der internen Warteschlange. + : Erstellt eine Protokollgruppe und einen Protokollstream, falls sie nicht existieren. + : Die Zeitspanne, für die der Thread beim Start in den Ruhezustand versetzt werden soll. Diese anfängliche Wartezeit ermöglicht das anfängliche Sammeln von Protokollen. + : Die maximale Größe eines Protokollereignisses. Protokolle, die diese Größe überschreiten, werden nicht gesendet. + : Kürzt zu lange Nachrichten. + : Aktivieren Sie den Notfall-Appender. ## CloudWatch einrichten Damit die obige Konfiguration Logs korrekt überträgt CloudWatch, aktualisieren Sie Ihre Amazon EC2 IAM-Instance-Profilrolle, um ihr zusätzliche Berechtigungen für die Protokollgruppe `BluAgeRuntimeOnEC2-Logs` und ihre Protokollstreams zu gewähren: + `logs:CreateLogStream` + `logs:DescribeLogStreams` + `logs:CreateLogGroup` + `logs:PutLogEvents` + `logs:DescribeLogGroups` ## Einrichtung des Alarms Dank der CloudWatch Protokolle können Sie dann je nach Ihrer Anwendung und Ihren Anforderungen verschiedene Metriken und Alarme konfigurieren. Insbesondere können Sie proaktive Alarme für Nutzungswarnungen einrichten, um bei Fehlern gewarnt zu werden, die Ihre Anwendung in eine Übergangszeit bringen könnten (und letztendlich verhindern, dass sie überhaupt funktioniert). Um dies zu erreichen, können Sie den Protokollen eine Metrik zur Zeichenfolge „Fehler C5001" hinzufügen, die Fehler in der Verbindung mit dem AWS Transform for Mainframe-Steuerungssystem hervorhebt. Anschließend können Sie einen Alarm definieren, der auf diese Metrik reagiert. # Richten Sie lizenzierte Abhängigkeiten in AWS Transform for Mainframe Runtime auf Amazon EC2 ein In diesem Handbuch wird beschrieben, wie Sie zusätzliche lizenzierte Abhängigkeiten einrichten, die Sie mit AWS Transform for Mainframe Runtime auf Amazon EC2 verwenden können. **Topics** + [Voraussetzungen](#ba-runtime-dependencies-prereq) + [Schritte zur Installation](#ba-runtime-dependencies-overview) ## Voraussetzungen Bevor Sie beginnen, stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllen. + [AWS Voraussetzungen für Transform for Mainframe Runtime](ba-runtime-setup-prereq.md)Vollständig und[Onboarding AWS Transform für Mainframe-Runtime](ba-runtime-setup-onboard.md). + Stellen Sie sicher, dass Sie eine Amazon EC2-Instance mit AWS Transform for Mainframe Runtime (auf Amazon EC2) installiert haben. Weitere Informationen finden Sie unter [Erste Schritte mit Amazon-EC2-Linux-Instancen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html). + Stellen Sie sicher, dass Sie erfolgreich eine Verbindung zur Amazon EC2 EC2-Instance herstellen können, z. B. mithilfe von SSM. + Holen Sie sich die folgenden Abhängigkeiten aus ihren Quellen. ### Oracle-Datenbank Stellen Sie einen [Oracle-Datenbanktreiber bereit](https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html). Wir haben die Funktionalität AWS Transform for Mainframe Runtime (auf Amazon EC2) mit Version **ojdbc11-23.3.0.23.09.jar** getestet, aber eine neuere Version könnte kompatibel sein. ### IBM MQ-Verbindung Stellen Sie einen [IBM MQ-Client bereit](https://www.ibm.com/support/pages/mqc91-ibm-mq-clients). Wir haben die Funktionalität AWS Transform for Mainframe Runtime (auf Amazon EC2) mit Version **com.ibm.mq.jakarta.client-9.3.4.1.jar** getestet, aber eine neuere Version könnte kompatibel sein. Stellen Sie mit dieser Abhängigkeitsversion auch die folgenden transitiven Abhängigkeiten bereit: + bcprov-jdk15to18-1.76.jar + bcpkix-jdk15to18-1.76.jar + bcutil-jdk15to18-1.76.jar ### DDS-Druckerdateien Stellen Sie die Jasper-Berichtsbibliothek bereit (munity.jaspersoft)https://com. com/download-jaspersoft/community-Ausgabe). Wir haben die Funktionalität AWS Transform for Mainframe Runtime (auf Amazon EC2) mit **jasperreports-6.16.0.jar** getestet, aber eine neuere Version könnte kompatibel sein. Stellen Sie mit dieser Abhängigkeitsversion auch die folgenden transitiven Abhängigkeiten bereit: + 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-sammlungen-3.2.2.jar ## Schritte zur Installation Gehen Sie wie folgt vor, um die Abhängigkeiten zu installieren. 1. Connect zu Ihrer Amazon EC2 EC2-Instance her und ändern Sie den Benutzer in **su, indem Sie** den folgenden Befehl ausführen. ``` sudo su ``` Sie benötigen Superuser-Rechte, um die Befehle in diesem Tutorial ausführen zu können. 1. Navigieren Sie zum Verzeichnis `/extra/`. ``` cd /extra/ ``` 1. Kopieren Sie alle oben genannten Abhängigkeiten nach Bedarf in diesen Ordner. **Anmerkung** Stellen Sie bei JAC- und BAC-Webapps mit von Oracle gehosteten Datenbanken sicher, dass Sie den Oracle-Datenbanktreiber (ojdbc) in diesen Ordner aufnehmen. 1. Stoppen und starten Sie den tomcat.service, indem Sie die folgenden Befehle ausführen. ``` systemctl stop tomcat.service ``` ``` systemctl start tomcat.service ``` 1. Überprüfen Sie den Status des Dienstes, um sicherzustellen, dass er ausgeführt wird. ``` systemctl status tomcat.service ``` 1. Überprüfen Sie die Protokolle. # Stellen Sie AWS Transform for Mainframe Runtime auf Containern auf Amazon ECS und Amazon EKS bereit Anhand der Themen in diesem Abschnitt erfahren Sie, wie Sie AWS Transform for Mainframe Runtime auf Containern einrichten, um es auf Amazon ECS (verwaltet von Amazon EC2 oder AWS Fargate) und Amazon EKS, verwaltet von Amazon EC2, zu installieren, wie Sie die Runtime-Version aktualisieren, wie Sie Ihre Bereitstellung mithilfe von CloudWatch Amazon-Alarmen überwachen und wie Sie lizenzierte Abhängigkeiten hinzufügen. **Anmerkung** Dies ist nicht kompatibel mit Amazon EKS, verwaltet von AWS Fargate. **Topics** + [AWS Transform für Mainframe-Runtime auf dem Container einrichten](ba-runtime-deploy-container.md) + [Aktualisieren Sie die AWS Transform for Mainframe-Runtime auf dem Container](ba-runtime-maint-container.md) + [CloudWatch Amazon-Alarme für AWS Transform for Mainframe Runtime auf dem Container einrichten](ba-cw-alarms-container.md) + [Richten Sie lizenzierte Abhängigkeiten in AWS Transform for Mainframe Runtime auf dem Container ein](ba-runtime-dependencies-container.md) # AWS Transform für Mainframe-Runtime auf dem Container einrichten In diesem Thema wird erklärt, wie Sie die PlanetsDemo Beispielanwendung mithilfe von AWS Transform for Mainframe Runtime auf einem Docker-Container einrichten und bereitstellen. AWS Transform for Mainframe Runtime on Container ist für Amazon ECS verfügbar, das von Amazon EC2 verwaltet wird, Amazon ECS verwaltet von und Amazon EKS AWS Fargate, das von Amazon EC2 verwaltet wird. Es ist nicht kompatibel mit Amazon EKS, verwaltet von AWS Fargate. **Topics** + [Voraussetzungen](#ba-runtime-deploy-prereq) + [Einrichtung](#ba-runtime-deploy-setup) + [Testen Sie die bereitgestellte Anwendung](#ba-runtime-deploy-test) ## Voraussetzungen Bevor Sie beginnen, stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllen. + Konfigurieren Sie das, AWS CLI indem Sie den Schritten [unter Konfiguration der AWS-CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) folgen. + [AWS Voraussetzungen für Transform for Mainframe Runtime](ba-runtime-setup-prereq.md)Vollständig und[Onboarding AWS Transform für Mainframe-Runtime](ba-runtime-setup-onboard.md). + Laden Sie die AWS Transform for Mainframe-Runtime-Binärdateien herunter. Detaillierte Anweisungen finden Sie unter [Onboarding AWS Transform für Mainframe-Runtime](ba-runtime-setup-onboard.md). + Laden Sie die Apache Tomcat-Binärdateien herunter. + Laden Sie das [PlanetsDemoAnwendungsarchiv](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip) herunter. + Erstellen Sie eine Amazon Aurora PostgreSQL-Datenbank für JICS und führen Sie die `PlanetsDemo-v1/jics/sql/initJics.sql` Abfrage darauf aus. Informationen zum Erstellen einer Amazon Aurora PostgreSQL-Datenbank finden Sie unter [Erstellen und Herstellen einer Verbindung zu einem Aurora PostgreSQL-DB-Cluster](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster). ## Einrichtung Gehen Sie wie folgt vor, um die PlanetsDemo Beispielanwendung einzurichten. 1. Extrahieren Sie nach dem Herunterladen der Apache Tomcat-Binärdateien den Inhalt und wechseln Sie in den `conf` Ordner. Öffnen Sie die `catalina.properties` Datei zur Bearbeitung und ersetzen Sie die Zeile, die `common.loader` mit der folgenden Zeile beginnt. ``` 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. Komprimieren Sie den Apache Tomcat-Ordner, indem Sie den Befehl tar verwenden, um ein `tar.gz`-Archiv zu erstellen. 1. Bereiten Sie ein [Dockerfile](https://docs.docker.com/engine/reference/builder/) vor, um Ihr benutzerdefiniertes Image auf der Grundlage der bereitgestellten Runtime-Binärdateien und der Apache Tomcat-Server-Binärdateien zu erstellen. Sehen Sie sich das folgende Dockerfile-Beispiel an. Das Ziel besteht darin, Apache Tomcat zu installieren, gefolgt von AWS Transform for mainframe Runtime (für Amazon ECS, verwaltet von AWS Fargate), die im Stammverzeichnis des Apache Tomcat-Installationsverzeichnisses extrahiert wurde, und dann die modernisierte Beispielanwendung mit dem Namen zu installieren. PlanetsDemo **Anmerkung** Der Inhalt der Skripts install-gapwalk.sh und install-app.sh, die in diesem Dockerfile-Beispiel verwendet werden, wird nach dem Dockerfile aufgeführt. ``` 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"] ``` Im Folgenden sind die Inhalte von `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} ``` Der Inhalt von `install-app.sh` ist wie folgt: ``` #!/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. Geben Sie die Verbindungsinformationen für die Datenbank, die Sie als Teil der Voraussetzungen im folgenden Codeausschnitt erstellt haben, in die `application-main.yml` Datei ein, die sich im Ordner befindet. `{TOMCAT_GAPWALK_DIR}/config` Weitere Informationen finden Sie unter [Erstellen eines Aurora PostgreSQL-DB-Clusters und Herstellen einer Verbindung zu](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster) diesem. ``` datasource: jicsDs: driver-class-name : url: username: password: type : ``` 1. Erstellen Sie das Image und übertragen Sie es in Ihr Amazon ECR-Repository. Anweisungen finden Sie unter [Pushing a Docker-Image](https://docs.aws.amazon.com/AmazonECR/latest/userguide/docker-push-ecr-image.html) im Amazon Elastic Container Registry-Benutzerhandbuch. Erstellen Sie dann je nach Situation entweder einen Amazon EKS-Pod oder eine Amazon ECS-Aufgabendefinition mit Ihrem Amazon ECR-Image und stellen Sie es in Ihrem Cluster bereit. Beispiele für deren Erstellung finden Sie unter [Erstellen einer Aufgabendefinition mithilfe der Konsole](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-task-definition.html) im *Amazon Elastic Container Service (Amazon ECS) Developer Guide* und [Deploy a sample application](https://docs.aws.amazon.com/eks/latest/userguide/sample-deployment.html) im *Amazon EKS-Benutzerhandbuch*. 1. Insbesondere für **Amazon ECS Managed by AWS Fargate** Case sollten Sie bei der Erstellung der Aufgabendefinition die IAM-Rolle verwenden, die Sie im Rahmen der anfänglichen Einrichtung der Infrastruktur erstellt haben. Erweitern Sie dann bei der Erstellung des Dienstes den Abschnitt **Netzwerk** und konfigurieren Sie die VPC, die Subnetze und die Sicherheitsgruppe, die Sie im Rahmen der ersten Einrichtung der Infrastruktur erstellt haben. Weitere Informationen finden Sie unter [Anforderungen an die Infrastruktureinrichtung für AWS Transform for mainframe Runtime](https://docs.aws.amazon.com/m2/latest/userguide/ba-infrastructure-setup.html). ## Testen Sie die bereitgestellte Anwendung Ein Beispiel für das Testen der PlanetsDemo Anwendung finden Sie unter[Testen Sie die PlanetsDemo Anwendung](ba-runtime-test-planetsdemo.md). # Aktualisieren Sie die AWS Transform for Mainframe-Runtime auf dem Container In diesem Handbuch wird beschrieben, wie Sie AWS Transform for Mainframe Runtime auf einem Container aktualisieren. Dazu müssen Sie zunächst einige Voraussetzungen erfüllen und dann mit dem Docker-Image arbeiten, um die AWS Transform for Mainframe-Runtime zu aktualisieren. **Topics** + [Voraussetzungen](#ba-runtime-maint-prereq) + [Führen Sie ein Upgrade der AWS Transform für Mainframe-Runtime durch](#ba-runtime-maint-copy-files) ## Voraussetzungen Bevor Sie beginnen, stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllen. + [AWS Voraussetzungen für Transform for Mainframe Runtime](ba-runtime-setup-prereq.md)Vollständig und[Onboarding AWS Transform für Mainframe-Runtime](ba-runtime-setup-onboard.md). + Laden Sie die Version von AWS Transform for Mainframe Runtime herunter, auf die Sie ein Upgrade durchführen möchten. Weitere Informationen finden Sie unter [Onboarding AWS Transform für Mainframe-Runtime](ba-runtime-setup-onboard.md). Das Framework besteht aus zwei Binärdateien: `aws-bluage-runtime-x.y.z.zip` und`aws-bluage-webapps-x.y.z.zip`. ## Führen Sie ein Upgrade der AWS Transform für Mainframe-Runtime durch Gehen Sie wie folgt vor, um AWS Transform for Mainframe Runtime zu aktualisieren. 1. Erstellen Sie Ihr Docker-Image mit der gewünschten Runtime-Version von AWS Transform for Mainframe neu. Detaillierte Anweisungen finden Sie unter [AWS Transform für Mainframe-Runtime auf dem Container einrichten](ba-runtime-deploy-container.md). 1. Pushen Sie Ihr Docker-Image in Ihr Amazon ECR-Repository. 1. Beenden Sie Ihren Amazon ECS- oder Amazon EKS-Service und starten Sie ihn neu. 1. Überprüfen Sie die Protokolle. Die AWS Transform for Mainframe-Runtime wurde erfolgreich aktualisiert. # CloudWatch Amazon-Alarme für AWS Transform for Mainframe Runtime auf dem Container einrichten Sie können festlegen CloudWatch , dass Benachrichtigungen besser sichtbar sind, wenn bei Ihren bereitgestellten Anwendungen Ausnahmen auftreten. Auf diese Weise können Sie Ihr Anwendungsprotokoll überwachen CloudWatch, an das umgeleitet wird, und einen Alarm hinzufügen, der Sie vor möglichen Fehlern warnt. ## Einrichtung des Alarms Mithilfe von CloudWatch Protokollen können Sie je nach Ihrer Anwendung und Ihren Anforderungen eine beliebige Anzahl von Metriken und Alarmen konfigurieren. Insbesondere können Sie direkt bei der Clustererstellung proaktive Alarme für Nutzungswarnungen einrichten, sodass Sie benachrichtigt werden, wenn Fehler auftreten. Um Fehler in der Verbindung mit dem AWS Transform for Mainframe-Steuerungssystem hervorzuheben, fügen Sie den Protokollen eine Metrik hinzu, die sich auf die Zeichenfolge „Fehler C“ bezieht. Anschließend können Sie einen Alarm definieren, der auf diese Metrik reagiert. # Richten Sie lizenzierte Abhängigkeiten in AWS Transform for Mainframe Runtime auf dem Container ein In diesem Thema wird beschrieben, wie Sie zusätzliche lizenzierte Abhängigkeiten einrichten, die Sie mit AWS Transform for Mainframe Runtime auf einem Container verwenden können. **Topics** + [Voraussetzungen](#ba-runtime-dependencies-prereq) + [-Übersicht](#ba-runtime-dependencies-overview) ## Voraussetzungen Bevor Sie beginnen, stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllen. + [AWS Voraussetzungen für Transform for Mainframe Runtime](ba-runtime-setup-prereq.md)Vollständig und[Onboarding AWS Transform für Mainframe-Runtime](ba-runtime-setup-onboard.md). + Holen Sie sich die folgenden Abhängigkeiten aus ihrer Quelle. ### Oracle-Datenbank Stellen Sie einen [Oracle-Datenbanktreiber bereit]( https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html). Zum Beispiel **ojdbc11-23.3.0.23.09.jar**. ### IBM MQ-Verbindung Stellen Sie einen [IBM MQ-Client bereit](https://www.ibm.com/support/pages/mqc91-ibm-mq-clients). Zum Beispiel **com.ibm.mq.jakarta.client-9.3.4.1.jar**. Geben Sie mit dieser Abhängigkeitsversion auch die folgenden transitiven Abhängigkeiten an: + bcprov-jdk15to18-1.76.jar + bcpkix-jdk15to18-1.76.jar + bcutil-jdk15to18-1.76.jar ### DDS-Druckerdateien Stellen Sie die Jasper-Berichtsbibliothek bereit (munity.jaspersoft)https://com. com/download-jaspersoft/community-Ausgabe). Zum Beispiel **jasperreports-6.16.0.jar**, aber eine neuere Version könnte kompatibel sein. Geben Sie mit dieser Abhängigkeitsversion auch die folgenden transitiven Abhängigkeiten an: + 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-sammlungen-3.2.2.jar ## -Übersicht Gehen Sie wie folgt vor, um die Abhängigkeiten zu installieren. 1. Kopieren Sie nach Bedarf eine der oben genannten Abhängigkeiten in Ihren Docker-Image-Build-Ordner. 1. Wenn Ihre JICS-Datenbank auf Oracle gehostet wird, stellen Sie den Oracle-Datenbanktreiber unter bereit. `your-tomcat-path/extra` 1. Kopieren Sie diese Abhängigkeiten in Ihrem Dockerfile nach. `your-tomcat-path/extra` 1. Erstellen Sie Ihr Docker-Image und übertragen Sie es dann auf Amazon ECR. 1. Beenden Sie Ihren Amazon ECS- oder Amazon EKS-Service und starten Sie ihn neu. 1. Überprüfen Sie die Protokolle. # Testen Sie die PlanetsDemo Anwendung Um den Status der bereitgestellten PlanetsDemo Anwendung zu überprüfen, führen Sie die folgenden Befehle aus, nachdem Sie`load-balancer-DNS-name`,, ersetzt haben`listener-port`, und `web-binary-name` zwar mit den richtigen Werten für Ihr Setup. ``` curl http://load-balancer-DNS-name:listener-port/gapwalk-application/ ``` Wenn die Anwendung ausgeführt wird, wird die folgende Ausgabemeldung angezeigt:`Jics application is running`. Führen Sie als Nächstes den folgenden Befehl aus. ``` curl http://load-balancer-DNS-name:listener-port/jac/api/services/rest/jicsservice/ ``` Wenn die Anwendung ausgeführt wird, wird die folgende Ausgabenachricht angezeigt:`Jics application is running`. ``` Jics application is running ``` Wenn Sie konfiguriert habenBlusam, können Sie mit einer leeren Antwort rechnen, wenn Sie den folgenden Befehl ausführen. ``` curl http://load-balancer-DNS-name:listener-port/bac/api/services/rest/bluesamserver/serverIsUp ``` Notieren Sie sich den Namen der Web-Binärdatei (PlanetsDemo-web-1.0.0, falls unverändert). Verwenden Sie eine URL des PlanetsDemo folgenden Formats, um auf die Anwendung zuzugreifen. ``` https://load-balancer-DNS-name:listener-port/web-binary-name ``` Nach dem Start der PlanetsDemo Anwendung wird die Startseite angezeigt. ![\[Homepage\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/PlanetsDemo-homepage.png) Geben Sie PINQ in das Textfeld ein und drücken Sie dann die Eingabetaste. Die Datenabfrageseite wird angezeigt. ![\[Seite zur Datenanfrage\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/PlanetsDemo-app.png) Geben Sie beispielsweise EARTH in das PlanetsDemo Namensfeld ein, und drücken Sie dann die EINGABETASTE. Die Seite für den Planeten, den Sie eingegeben haben, wird angezeigt. ![\[Seite EARTH\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/PlanetsDemo-EARTH.png)