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. # Tutorials für Rocket Software (ehemals Micro Focus) Die Tutorials in diesem Abschnitt helfen Ihnen beim Einstieg in die Einrichtung verschiedener Aufgaben in der Runtime-Engine von Rocket Software für den AWS Mainframe Modernization Service. Diese Tutorials dienen der Einrichtung einer Beispielanwendung, der Verwendung von Vorlagen mit Rocket Enterprise Developer und der Einrichtung von Enterprise Analyzer. **Topics** + [ # Tutorial: Den Build von Rocket Software (ehemals Micro Focus) für die BankDemo Beispielanwendung einrichten ](tutorial-build-mf.md) + [ # Tutorial: WorkSpaces Anwendungen für die Verwendung mit Rocket Enterprise Analyzer und Rocket Enterprise Developer einrichten ](set-up-appstream-mf.md) + [ # Tutorial: Vorlagen mit Rocket Enterprise Developer (ehemals Micro Focus Enterprise Developer) verwenden ](tutorial-templates-ed.md) + [ # Tutorial: Enterprise Analyzer für WorkSpaces Anwendungen einrichten ](set-up-ea.md) + [ # Tutorial: Rocket Enterprise Developer für WorkSpaces Anwendungen einrichten ](set-up-ed.md) # Tutorial: Den Build von Rocket Software (ehemals Micro Focus) für die BankDemo Beispielanwendung einrichten AWS Mainframe-Modernisierung bietet Ihnen die Möglichkeit, Builds und Continuous integration/continuous Delivery (CI/CD) -Pipelines für Ihre migrierten Anwendungen einzurichten. Diese Builds und Pipelines verwenden AWS CodeBuild, AWS CodeCommit und stellen diese Funktionen bereit. AWS CodePipeline CodeBuild ist ein vollständig verwalteter Build-Service, der Ihren Quellcode kompiliert, Komponententests durchführt und Artefakte erzeugt, die sofort einsatzbereit sind. CodeCommit ist ein Versionskontrolldienst, mit dem Sie Git-Repositorys privat in der Cloud speichern und verwalten können. AWS CodePipeline ist ein Dienst zur kontinuierlichen Bereitstellung, mit dem Sie die zur Veröffentlichung Ihrer Software erforderlichen Schritte modellieren, visualisieren und automatisieren können. In diesem Tutorial wird gezeigt, wie Sie AWS CodeBuild den Quellcode der BankDemo Beispielanwendung aus Amazon S3 kompilieren und den kompilierten Code anschließend zurück nach Amazon S3 exportieren. AWS CodeBuild ist ein vollständig verwalteter Continuous Integration-Service, der Quellcode kompiliert, Tests durchführt und Softwarepakete erstellt, die sofort einsatzbereit sind. Mit CodeBuild können Sie vorgefertigte Build-Umgebungen verwenden oder benutzerdefinierte Build-Umgebungen erstellen, die Ihre eigenen Build-Tools verwenden. In diesem Demo-Szenario wird die zweite Option verwendet. Es besteht aus einer CodeBuild Build-Umgebung, die ein vorgefertigtes Docker-Image verwendet. **Wichtig** Bevor Sie mit Ihrem Mainframe-Modernisierungsprojekt beginnen, empfehlen wir Ihnen, sich über das [AWS Migration Acceleration Program (MAP) für Mainframe zu informieren oder sich an [AWS Mainframe-Spezialisten](mailto: mainframe@amazon.com)](https://aws.amazon.com/migration-acceleration-program/mainframe/) zu wenden, um mehr über die zur Modernisierung einer Mainframe-Anwendung erforderlichen Schritte zu erfahren. **Topics** + [ ## Voraussetzungen ](#tutorial-build-mf-prerequisites) + [ ## Schritt 1: Teilen Sie die Build-Assets mit AWS Ihrem Konto ](#tutorial-build-mf-assets) + [ ## Schritt 2: Amazon S3 S3-Buckets erstellen ](#tutorial-build-mf-s3) + [ ## Schritt 3: Erstellen Sie die Build-Spezifikationsdatei ](#tutorial-build-mf-spec) + [ ## Schritt 4: Laden Sie die Quelldateien hoch ](#tutorial-build-mf-upload) + [ ## Schritt 5: IAM-Richtlinien erstellen ](#tutorial-build-mf-IAM-policy) + [ ## Schritt 6: Erstellen Sie eine IAM-Rolle ](#tutorial-build-mf-IAM-role) + [ ## Schritt 7: Hängen Sie die IAM-Richtlinien an die IAM-Rolle an ](#tutorial-build-mf-attach) + [ ## Schritt 8: Erstellen Sie das CodeBuild Projekt ](#tutorial-build-mf-create-project) + [ ## Schritt 9: Starten Sie den Build ](#tutorial-build-mf-start) + [ ## Schritt 10: Laden Sie die Ausgabeartefakte herunter ](#tutorial-build-mf-download-output) + [ ## Bereinigen von Ressourcen ](#tutorial-build-mf-clean) ## Voraussetzungen Bevor Sie mit diesem Tutorial beginnen, müssen Sie die folgenden Voraussetzungen erfüllen. + Laden Sie die [BankDemo Beispielanwendung](https://d3lkpej5ajcpac.cloudfront.net/demo/mf/BANKDEMO-build.zip) herunter und entpacken Sie sie in einen Ordner. Der Quellordner enthält COBOL-Programme und Copybooks sowie Definitionen. Er enthält auch einen JCL-Ordner als Referenz, obwohl Sie JCL nicht erstellen müssen. Der Ordner enthält auch die für den Build erforderlichen Metadateien. + Wählen Sie in der AWS Mainframe Modernization Console die Option **Tools** aus. Wählen Sie unter **Analysis, Development and Build Assets** die Option **Assets mit meinem AWS-Konto teilen** aus. ## Schritt 1: Teilen Sie die Build-Assets mit AWS Ihrem Konto In diesem Schritt stellen Sie sicher, dass Sie die Build-Assets mit Ihrem AWS Konto teilen, insbesondere in der Region, in der die Assets verwendet werden. 1. Öffnen Sie die AWS Mainframe-Modernisierungskonsole unter [https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/). 1. Wählen Sie in der linken Navigationsleiste **Tools** aus. 1. Wählen Sie unter **Assets analysieren, entwickeln und erstellen** die Option **Assets mit meinem AWS Konto teilen** aus. **Wichtig** Sie müssen diesen Schritt in jeder AWS Region, in der Sie Builds erstellen möchten, einmal ausführen. ## Schritt 2: Amazon S3 S3-Buckets erstellen In diesem Schritt erstellen Sie zwei Amazon S3 S3-Buckets. Der erste ist ein Eingabe-Bucket für den Quellcode und der andere ist ein Ausgabe-Bucket für die Build-Ausgabe. Weitere Informationen finden Sie unter [Erstellen, Konfigurieren und Arbeiten mit Amazon S3 S3-Buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html) im *Amazon S3 S3-Benutzerhandbuch*. 1. Um den Eingabe-Bucket zu erstellen, melden Sie sich bei der Amazon S3 S3-Konsole an und wählen Sie **Create Bucket**. 1. Geben Sie in der **allgemeinen Konfiguration** einen Namen für den Bucket an und geben Sie an AWS-Region , wo Sie den Bucket erstellen möchten. Ein Beispiel für den Namen ist `codebuild-regionId-accountId-input-bucket` Where `regionId` is the AWS-Region of the Bucket und `accountId` ist Ihre AWS-Konto ID. **Anmerkung** Wenn Sie den Bucket in einer anderen Region als USA AWS-Region Ost (Nord-Virginia) erstellen, geben Sie den `LocationConstraint` Parameter an. Weitere Informationen finden Sie unter [Create Bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html) in der *Amazon Simple Storage Service API-Referenz*. 1. Behalten Sie alle anderen Einstellungen bei und wählen Sie **Create Bucket**. 1. Wiederholen Sie die Schritte 1—3, um den Ausgabe-Bucket zu erstellen. Ein Beispiel für den Namen ist `codebuild-regionId-accountId-output-bucket` where `regionId` is the AWS-Region of the Bucket und `accountId` ist Ihre AWS-Konto ID. Welche Namen Sie auch immer für diese Buckets wählen, achten Sie darauf, sie in diesem Tutorial zu verwenden. ## Schritt 3: Erstellen Sie die Build-Spezifikationsdatei In diesem Schritt erstellen Sie eine Build-Spezifikationsdatei,. Diese Datei enthält Build-Befehle und zugehörige Einstellungen im YAML-Format CodeBuild zum Ausführen des Builds. Weitere Informationen finden Sie unter [Referenz zur Build-Spezifikation für CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html) im *AWS CodeBuild Benutzerhandbuch*. 1. Erstellen Sie als Voraussetzung eine Datei mit dem Namen `buildspec.yml` in dem Verzeichnis, das Sie entpackt haben. 1. Fügen Sie der Datei den folgenden Inhalt hinzu und speichern Sie sie. Für diese Datei sind keine Änderungen erforderlich. ``` version: 0.2 env: exported-variables: - CODEBUILD_BUILD_ID - CODEBUILD_BUILD_ARN phases: install: runtime-versions: python: 3.7 pre_build: commands: - echo Installing source dependencies... - ls -lR $CODEBUILD_SRC_DIR/source build: commands: - echo Build started on `date` - /start-build.sh -Dbasedir=$CODEBUILD_SRC_DIR/source -Dloaddir=$CODEBUILD_SRC_DIR/target post_build: commands: - ls -lR $CODEBUILD_SRC_DIR/target - echo Build completed on `date` artifacts: files: - $CODEBUILD_SRC_DIR/target/** ``` Hier `$CODEBUILD_SRC_DIR/target` sind Umgebungsvariablen `CODEBUILD_BUILD_ID` `CODEBUILD_BUILD_ARN``$CODEBUILD_SRC_DIR/source`, und innerhalb verfügbar CodeBuild. Weitere Informationen finden Sie unter [Umgebungsvariablen in Build-Umgebungen](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html). Zu diesem Zeitpunkt sollte Ihr Verzeichnis so aussehen. ``` (root directory name) |-- build.xml |-- buildspec.yml |-- LICENSE.txt |-- source |... etc. ``` 1. Komprimieren Sie den Inhalt des Ordners in eine Datei mit dem Namen`BankDemo.zip`.. Für dieses Tutorial können Sie den Ordner nicht komprimieren. Stattdessen komprimieren Sie den Inhalt des Ordners in die Datei`BankDemo.zip`. ## Schritt 4: Laden Sie die Quelldateien hoch In diesem Schritt laden Sie den Quellcode für die BankDemo Beispielanwendung in Ihren Amazon S3 S3-Eingabe-Bucket hoch. 1. Melden Sie sich bei der Amazon S3 S3-Konsole an und wählen Sie im linken Navigationsbereich **Buckets** aus. Wählen Sie dann den Eingabe-Bucket aus, den Sie zuvor erstellt haben. 1. Wählen Sie unter **Objekte** die Option **Hochladen** aus. 1. Wählen Sie im Bereich **Dateien und Ordner** die Option **Dateien hinzufügen** aus. 1. Navigieren Sie zu Ihrer `BankDemo.zip` Datei und wählen Sie sie aus. 1. Klicken Sie auf **Upload**. ## Schritt 5: IAM-Richtlinien erstellen In diesem Schritt erstellen Sie zwei [IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html). Eine Richtlinie gewährt AWS Mainframe Modernization die Erlaubnis, auf das Docker-Image zuzugreifen und es zu verwenden, das die Build-Tools von Rocket Software enthält. Diese Richtlinie ist nicht auf Kunden zugeschnitten. Die andere Richtlinie gewährt AWS Mainframe Modernization die Erlaubnis, mit den Eingabe- und Ausgabe-Buckets sowie mit den generierten [ CloudWatch Amazon-Protokollen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html) zu interagieren. CodeBuild *Weitere Informationen zum Erstellen einer IAM-Richtlinie finden Sie unter [Bearbeiten von IAM-Richtlinien im IAM-Benutzerhandbuch](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html).* **So erstellen Sie eine Richtlinie für den Zugriff auf Docker-Images** 1. Kopieren Sie in der IAM-Konsole das folgende Richtliniendokument und fügen Sie es in den Richtlinien-Editor ein. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ecr:GetAuthorizationToken" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "ecr:BatchCheckLayerAvailability", "ecr:GetDownloadUrlForLayer", "ecr:BatchGetImage" ], "Resource": "arn:aws:ecr:*:673918848628:repository/m2-enterprise-build-tools" }, { "Effect": "Allow", "Action": [ "s3:PutObject" ], "Resource": "arn:aws:s3:::aws-m2-repo-*--prod" } ] } ``` ------ 1. Geben Sie einen Namen für die Richtlinie ein, z. B. `m2CodeBuildPolicy` **Um eine Richtlinie zu erstellen, die es AWS Mainframe Modernization ermöglicht, mit Buckets und Logs zu interagieren** 1. Kopieren Sie in der IAM-Konsole das folgende Richtliniendokument und fügen Sie es in den Policy-Editor ein. Stellen Sie sicher, dass Sie `regionId` auf die AWS-Region und `accountId` auf Ihre AWS-Konto aktualisieren. 1. Geben Sie einen Namen für die Richtlinie ein, `BankdemoCodeBuildRolePolicy` z. B. ## Schritt 6: Erstellen Sie eine IAM-Rolle In diesem Schritt erstellen Sie eine neue [IAM-Rolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html), mit der Sie für Sie mit AWS Ressourcen interagieren können CodeBuild , nachdem Sie die zuvor erstellten IAM-Richtlinien mit dieser neuen IAM-Rolle verknüpft haben. Informationen zum Erstellen einer Servicerolle finden Sie unter [Creating a Role to Delegate Permissions to an AWS Service](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) im *IAM-Benutzerhandbuch*,. 1. Melden Sie sich bei der IAM-Konsole an und wählen Sie im linken **Navigationsbereich Rollen** aus. 1. Wählen Sie **Rolle erstellen** aus. 1. Wählen Sie unter **Vertrauenswürdiger Entitätstyp** die Option **AWS-Service** aus. 1. Wählen **Sie unter Anwendungsfälle für andere AWS-Services** die Option aus **CodeBuild**, und wählen Sie dann **CodeBuild**erneut. 1. Wählen Sie **Weiter** aus. 1. Wählen Sie auf der Seite **Add permissions** (Berechtigungen hinzufügen) die Option **Next** (Weiter) aus. Sie weisen der Rolle später eine Richtlinie zu. 1. Geben Sie unter **Rollendetails** einen Namen für die Rolle ein, `BankdemoCodeBuildServiceRole` z. B. 1. Stellen **Sie unter Vertrauenswürdige Entitäten auswählen** sicher, dass das Richtliniendokument wie folgt aussieht: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "codebuild.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` ------ 1. Wählen Sie **Rolle erstellen** aus. ## Schritt 7: Hängen Sie die IAM-Richtlinien an die IAM-Rolle an In diesem Schritt fügen Sie die beiden IAM-Richtlinien, die Sie zuvor erstellt haben, der `BankdemoCodeBuildServiceRole` IAM-Rolle hinzu. 1. Melden Sie sich bei der IAM-Konsole an und wählen Sie im linken **Navigationsbereich Rollen** aus. 1. Wählen Sie **unter Rollen** die Rolle aus, die Sie zuvor erstellt haben, `BankdemoCodeBuildServiceRole` z. B. 1. Wählen Sie unter **Berechtigungsrichtlinien die** Option **Berechtigungen hinzufügen** und dann **Richtlinien anhängen** aus. 1. Wählen Sie **unter Andere Berechtigungsrichtlinien** die Richtlinien aus, die Sie zuvor erstellt haben, z. B. `m2CodeBuildPolicy` und`BankdemoCodeBuildRolePolicy`. 1. Wählen Sie **Richtlinien anfügen**. ## Schritt 8: Erstellen Sie das CodeBuild Projekt In diesem Schritt erstellen Sie das CodeBuild Projekt. 1. Melden Sie sich bei der CodeBuild Konsole an und wählen Sie **Build-Projekt erstellen**. 1. Geben Sie im Abschnitt **Projektkonfiguration** einen Namen für das Projekt ein, `codebuild-bankdemo-project` z. B. 1. Wählen Sie im Abschnitt **Quelle** für **Quellanbieter** **Amazon S3** und dann den Eingabe-Bucket aus, den Sie zuvor erstellt haben, zum Beispiel`codebuild-regionId-accountId-input-bucket`. 1. Geben Sie im Feld **S3-Objektschlüssel oder S3-Ordner** den Namen der ZIP-Datei ein, die Sie in den S3-Bucket hochgeladen haben. In diesem Fall lautet der Dateiname`bankdemo.zip`. 1. Wählen Sie im Bereich **Umgebung** die Option **Benutzerdefiniertes Bild** aus. 1. Wählen Sie im Feld **Umgebungstyp** die Option **Linux** aus. 1. Wählen Sie unter **Image-Registrierung** die Option **Andere Registrierung** aus. 1. Im Feld **Externe Registrierungs-URL** + Für Rocket Software v9: Geben Sie ein`673918848628.dkr.ecr.us-west-1.amazonaws.com/m2-enterprise-build-tools:9.0.7.R1`. Wenn Sie eine andere AWS Region mit Rocket Software v9 verwenden, können Sie auch angeben` 673918848628.dkr.ecr..amazonaws.com/m2-enterprise-build-tools:9.0.7.R1`, in welcher AWS Region der AWS Mainframe-Modernisierungsservice verfügbar ist (z. B.). `eu-west-3` + Für Rocket Software v8: Geben Sie ein `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:8.0.9.R1` + Für Rocket Software v7: Geben Sie ein `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:7.0.R10` 1. Wählen Sie unter **Servicerolle** die Option **Bestehende Servicerolle** und wählen Sie im Feld **Rollen-ARN** die Servicerolle aus, die Sie zuvor erstellt haben, zum Beispiel`BankdemoCodeBuildServiceRole`. 1. Wählen Sie im Abschnitt **Buildspec** die Option Buildspec-Datei **verwenden** aus. 1. Wählen Sie im Abschnitt **Artifacts** unter **Type** **Amazon S3** und dann Ihren Output-Bucket aus, zum Beispiel`codebuild-regionId-accountId-output-bucket`. 1. Geben Sie im Feld **Name** den Namen eines Ordners im Bucket ein, der die Build-Ausgabeartefakte enthalten soll, `bankdemo-output.zip` z. B. 1. Wählen Sie unter **Verpackung von Artefakten** die Option **Zip** aus. 1. Wählen Sie **Create build project (Build-Projekt erstellen)** aus. ## Schritt 9: Starten Sie den Build In diesem Schritt starten Sie den Build. 1. Loggen Sie sich in die CodeBuild Konsole ein. 1. Wählen Sie im linken Navigationsbereich die Option **Projekte erstellen** aus. 1. Wählen Sie das Build-Projekt aus, das Sie zuvor erstellt haben, `codebuild-bankdemo-project` z. B. 1. Wählen Sie **Start build (Build starten)**. Mit diesem Befehl wird der Build gestartet. Der Build wird asynchron ausgeführt. Die Ausgabe des Befehls ist eine JSON-Datei, die das Attribut id enthält. Diese Attribut-ID ist ein Verweis auf die CodeBuild Build-ID des Builds, den Sie gerade gestartet haben. Sie können den Status des Builds in der CodeBuild Konsole einsehen. Sie können auch detaillierte Protokolle zur Build-Ausführung in der Konsole einsehen. Weitere Informationen finden Sie im *AWS CodeBuild Benutzerhandbuch* unter [Anzeigen detaillierter Build-Informationen](https://docs.aws.amazon.com/codebuild/latest/userguide/getting-started-build-log-console.html). Wenn die aktuelle Phase ABGESCHLOSSEN ist, bedeutet dies, dass Ihr Build erfolgreich abgeschlossen wurde und Ihre kompilierten Artefakte auf Amazon S3 bereit sind. ## Schritt 10: Laden Sie die Ausgabeartefakte herunter In diesem Schritt laden Sie die Ausgabeartefakte von Amazon S3 herunter. Das Build-Tool von Rocket Software kann verschiedene Typen von ausführbaren Dateien erstellen. In diesem Tutorial generiert es gemeinsam genutzte Objekte. 1. Melden Sie sich bei der Amazon S3 S3-Konsole an. 1. Wählen Sie im Abschnitt **Buckets** role="bold"> den Namen Ihres Ausgabe-Buckets aus, zum Beispiel. `codebuild-regionId-accountId-output-bucket` 1. **Wählen Sie „Herunterladen“ role="bold">.** 1. Entpacken Sie die heruntergeladene -Datei. Navigieren Sie zum Zielordner, um die Build-Artefakte zu sehen. Dazu gehören die gemeinsam genutzten `.so` Linux-Objekte. ## Bereinigen von Ressourcen Wenn Sie die Ressourcen, die Sie für dieses Tutorial erstellt haben, nicht mehr benötigen, löschen Sie sie, um zusätzliche Kosten zu vermeiden. Führen Sie dazu die folgenden Schritte aus: + Löschen Sie die S3-Buckets, die Sie für dieses Tutorial erstellt haben. Weitere Informationen finden Sie unter [Löschen eines Buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html) im *Amazon Simple Storage Service-Benutzerhandbuch*. + Löschen Sie die IAM-Richtlinien, die Sie für dieses Tutorial erstellt haben. Weitere Informationen finden Sie unter [Löschen von IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-delete.html) im *IAM-Benutzerhandbuch*. + Löschen Sie die IAM-Rolle, die Sie für dieses Tutorial erstellt haben. Weitere Informationen zum Löschen von Rollen finden Sie unter [Löschen von Rollen oder Instance-Profilen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_delete.html) im *IAM-Benutzerhandbuch*. + Löschen Sie das CodeBuild Projekt, das Sie für dieses Tutorial erstellt haben. Weitere Informationen finden Sie [ CodeBuildim *AWS CodeBuild Benutzerhandbuch* unter Löschen eines Build-Projekts](https://docs.aws.amazon.com/codebuild/latest/userguide/delete-project.html). # Tutorial: WorkSpaces Anwendungen für die Verwendung mit Rocket Enterprise Analyzer und Rocket Enterprise Developer einrichten AWS Mainframe Modernization bietet mehrere Tools über Amazon WorkSpaces Applications. WorkSpaces Applications ist ein vollständig verwalteter, sicherer Anwendungs-Streaming-Dienst, mit dem Sie Desktop-Anwendungen an Benutzer streamen können, ohne Anwendungen neu schreiben zu müssen. WorkSpaces Applications bietet Benutzern sofortigen Zugriff auf die Anwendungen, die sie benötigen, und bietet eine reaktionsschnelle, flüssige Benutzererfahrung auf dem Gerät ihrer Wahl. Die Verwendung von WorkSpaces Anwendungen zum Hosten von Runtime Engine-spezifischen Tools gibt den Anwendungsteams von Kunden die Möglichkeit, die Tools direkt von ihren Webbrowsern aus zu verwenden und mit Anwendungsdateien zu interagieren, die entweder in Amazon S3 S3-Buckets oder Repositorys gespeichert sind. CodeCommit Informationen zur Browserunterstützung in WorkSpaces Anwendungen finden Sie unter [Systemanforderungen und Funktionsunterstützung (Webbrowser)](https://docs.aws.amazon.com/appstream2/latest/developerguide/requirements-and-features-web-browser-admin.html) im *Amazon WorkSpaces Applications Administration Guide*. Wenn Sie Probleme bei der Verwendung von WorkSpaces Anwendungen haben, finden Sie weitere Informationen unter [Troubleshooting AppStream 2.0-Benutzerprobleme](https://docs.aws.amazon.com/appstream2/latest/developerguide/troubleshooting-user-issues.html) im *Amazon WorkSpaces Applications Administration Guide*. Dieses Dokument richtet sich an Mitglieder des Kundenserviceteams. Es beschreibt, wie Sie Flotten und Stacks von Amazon WorkSpaces Applications einrichten, um die Tools Rocket Enterprise Analyzer und Rocket Enterprise Developer zu hosten, die bei der AWS Mainframe-Modernisierung verwendet werden. Rocket Enterprise Analyzer wird normalerweise während der Assess-Phase und Rocket Enterprise Developer normalerweise während der Migrate- und Modernisierungsphase des Mainframe-Modernisierungsansatzes verwendet. AWS Wenn Sie sowohl Enterprise Analyzer als auch Enterprise Developer verwenden möchten, müssen Sie für jedes Tool separate Flotten und Stacks erstellen. Jedes Tool benötigt eine eigene Flotte und einen eigenen Stack, da die Lizenzbedingungen unterschiedlich sind. **Wichtig** Die Schritte in diesem Tutorial basieren auf der herunterladbaren CloudFormation Vorlage [cfn-m2- appstream-fleet-ea-ed](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) .yml. **Topics** + [ ## Voraussetzungen ](#tutorial-aas-prerequisites) + [ ## Schritt 1: Holen Sie sich die WorkSpaces Anwendungs-Images ](#tutorial-aas-step1) + [ ## Schritt 2: Erstellen Sie den Stapel mithilfe der CloudFormation Vorlage ](#tutorial-aas-step2) + [ ## Schritt 3: Erstellen Sie einen Benutzer in WorkSpaces Applications ](#tutorial-aas-step3) + [ ## Schritt 4: Melden Sie sich bei WorkSpaces Applications an ](#tutorial-aas-step4) + [ ## Schritt 5: Buckets in Amazon S3 verifizieren (optional) ](#tutorial-aas-step5) + [ ## Nächste Schritte ](#tutorial-aas-next-steps) + [ ## Bereinigen von Ressourcen ](#tutorial-aas-cleanup) ## Voraussetzungen + [Laden Sie die Vorlage herunter: cfn-m2- .yml. appstream-fleet-ea-ed](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) + Rufen Sie die ID Ihrer Standard-VPC und Sicherheitsgruppe ab. Weitere Informationen zur Standard-VPC finden Sie unter [Standard VPCs](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html) im *Amazon VPC-Benutzerhandbuch*. Weitere Informationen zur Standardsicherheitsgruppe finden Sie unter [Standard- und benutzerdefinierte Sicherheitsgruppen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/default-custom-security-groups.html) im *Amazon EC2 EC2-Benutzerhandbuch*. + Stellen Sie sicher, dass Sie über die folgenden Berechtigungen verfügen: + Erstellen Sie Stacks, Flotten und Benutzer in WorkSpaces Anwendungen. + Erstellen Sie Stacks CloudFormation mithilfe einer Vorlage. + Erstellen Sie Buckets und laden Sie Dateien in Buckets in Amazon S3 hoch. + Anmeldeinformationen (`access_key_id`und`secret_access_key`) von IAM herunterladen. ## Schritt 1: Holen Sie sich die WorkSpaces Anwendungs-Images In diesem Schritt teilen Sie die WorkSpaces Anwendungs-Images für Enterprise Analyzer und Enterprise Developer mit Ihrem AWS Konto. 1. Öffnen Sie die AWS Mainframe Modernization Console unter [https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/). 1. Wählen Sie in der linken Navigationsleiste **Tools** aus. 1. Wählen Sie unter **Assets analysieren, entwickeln und erstellen** die Option **Assets mit meinem AWS Konto teilen** aus. ## Schritt 2: Erstellen Sie den Stapel mithilfe der CloudFormation Vorlage In diesem Schritt verwenden Sie die heruntergeladene CloudFormation Vorlage, um einen WorkSpaces Anwendungsstapel und eine Flotte für die Ausführung von Rocket Enterprise Analyzer zu erstellen. Sie können diesen Schritt später wiederholen, um einen weiteren WorkSpaces Anwendungsstapel und eine weitere Flotte für die Ausführung von Rocket Enterprise Developer zu erstellen, da jedes Tool eine eigene Flotte und einen eigenen Stack in WorkSpaces Applications benötigt. Weitere Informationen zu CloudFormation Stacks finden Sie unter [Arbeiten mit Stacks](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html) im *AWS CloudFormation Benutzerhandbuch*. **Anmerkung** AWS Die Mainframe-Modernisierung erhöht die Preise für WorkSpaces Standardanwendungen um eine zusätzliche Gebühr für die Nutzung von Enterprise Analyzer und Enterprise Developer. Weitere Informationen finden Sie unter Preise für die [AWS Mainframe-Modernisierung](https://aws.amazon.com/mainframe-modernization/pricing/). 1. Laden Sie bei Bedarf die [Vorlage cfn-m2- appstream-fleet-ea-ed .yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) herunter. 1. Öffnen Sie die CloudFormation Konsole und wählen Sie **Create Stack** and **with new resources** (Standard). 1. Wählen Sie **unter Voraussetzung — Vorlage vorbereiten** die Option **Vorlage ist bereit** aus. 1. Wählen **Sie unter Vorlage angeben** die Option **Vorlagendatei hochladen** aus. 1. Wählen Sie unter **Vorlagendatei hochladen** die Option **Datei auswählen aus** und laden Sie die Vorlage [cfn-m2- appstream-fleet-ea-ed .yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) hoch. 1. Wählen Sie **Weiter** aus. ![\[Die Seite „Stack CloudFormation erstellen“ mit der ausgewählten Vorlage cfn-m2- .yml. appstream-fleet-ea-ed\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/cfn-create-stack.png) 1. **Geben Sie unter Stack-Details angeben** die folgenden Informationen ein: + Geben Sie im Feld **Stackname** einen Namen Ihrer Wahl ein. Beispiel, **m2-ea**. + In **AppStreamApplication**, wähle **ea** aus. + Wählen Sie in **AppStreamFleetSecurityGroup**die Standardsicherheitsgruppe Ihrer Standard-VPC aus. + Wählen Sie **AppStreamFleetVpcSubnet**unter ein Subnetz innerhalb Ihrer Standard-VPC aus. + Wählen Sie **AppStreamImageName**unter das Bild aus, das mit beginnt. `m2-enterprise-analyzer` Dieses Bild enthält die derzeit unterstützte Version des Rocket Enterprise Analyzer-Tools. + Akzeptieren Sie die Standardwerte für die anderen Felder und wählen Sie dann **Weiter**. ![\[Die Seite „Stack-Details CloudFormation angeben“ mit den ausgefüllten Enterprise Analyzer-Optionen.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/cfn-specify-stack-details.png) 1. Akzeptieren Sie alle Standardwerte und wählen Sie dann erneut **Weiter**. 1. Stellen Sie bei der **Überprüfung** sicher, dass alle Parameter Ihren Vorstellungen entsprechen. 1. Scrollen Sie nach unten, wählen Sie **Ich bestätige, dass AWS IAM-Ressourcen mit benutzerdefinierten Namen erstellen CloudFormation könnte**, und wählen Sie **Create Stack** aus. Es dauert zwischen 20 und 30 Minuten, bis der Stack und die Flotte erstellt sind. Sie können „**Aktualisieren**“ wählen, um die CloudFormation Ereignisse zu sehen, sobald sie eintreten. ## Schritt 3: Erstellen Sie einen Benutzer in WorkSpaces Applications Während Sie darauf warten, CloudFormation dass die Erstellung des Stacks abgeschlossen ist, können Sie in WorkSpaces Applications einen oder mehrere Benutzer erstellen. Diese Benutzer sind diejenigen, die Enterprise Analyzer in WorkSpaces Applications verwenden werden. Sie müssen für jeden Benutzer eine E-Mail-Adresse angeben und sicherstellen, dass jeder Benutzer über ausreichende Berechtigungen verfügt, um Buckets in Amazon S3 zu erstellen, Dateien in einen Bucket hochzuladen und einen Link zu einem Bucket zu erstellen, um dessen Inhalt zuzuordnen. 1. Öffnen Sie die WorkSpaces Anwendungskonsole. 1. Wählen Sie in der linken Navigationsleiste **Benutzerpool** aus. 1. Wählen Sie **Create user** (Benutzer erstellen) aus. 1. Geben Sie eine E-Mail-Adresse, an die der Benutzer eine E-Mail-Einladung zur Nutzung von WorkSpaces Anwendungen erhalten kann, sowie einen Vor- und Nachnamen an und wählen Sie **Benutzer erstellen** aus. 1. Wiederholen Sie den Vorgang bei Bedarf, um weitere Benutzer zu erstellen. Die E-Mail-Adresse für jeden Benutzer muss eindeutig sein. Weitere Informationen zum Erstellen von WorkSpaces Anwendungsbenutzern finden Sie unter [WorkSpaces Applications User Pools](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool.html) im *Amazon WorkSpaces Applications Administration Guide*. Wenn Sie mit der Erstellung des Stacks CloudFormation fertig sind, können Sie den Benutzer, den Sie erstellt haben, dem Stack wie folgt zuweisen: 1. Öffnen Sie die WorkSpaces Anwendungskonsole. 1. Wählen Sie den Benutzernamen. 1. Wählen Sie **Aktion** und dann **Stapel zuweisen**. 1. Wählen **Sie unter Stapel zuweisen** den Stapel aus, der mit beginnt`m2-appstream-stack-ea`. 1. Wählen Sie **Assign stack**. ![\[Auf der Seite WorkSpaces Applications Assign Stack werden ein Benutzer und der Enterprise Analyzer-Stack angezeigt, der zugewiesen werden soll.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/aas-assign-stack.png) Wenn Sie einem Stack einen Benutzer zuweisen, sendet WorkSpaces Applications eine E-Mail an den Benutzer an die von Ihnen angegebene Adresse. Diese E-Mail enthält einen Link zur Anmeldeseite WorkSpaces für Anwendungen. ## Schritt 4: Melden Sie sich bei WorkSpaces Applications an In diesem Schritt melden Sie sich über den Link in der E-Mail, die WorkSpaces Applications an den Benutzer gesendet hat, den Sie erstellt haben, bei WorkSpaces Applications an[Schritt 3: Erstellen Sie einen Benutzer in WorkSpaces Applications](#tutorial-aas-step3). 1. Melden Sie sich über den Link in der von WorkSpaces Applications gesendeten E-Mail bei WorkSpaces Applications an. 1. Ändern Sie Ihr Passwort, wenn Sie dazu aufgefordert werden. Der Bildschirm „ WorkSpaces Anwendungen“, der Ihnen angezeigt wird, ähnelt dem folgenden: ![\[Ein Beispiel WorkSpaces für einen Anwendungs-Anmeldebildschirm mit dem Desktop-Symbol.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/aas-login-screen.png) 1. Wählen Sie **Desktop**. 1. Wählen Sie in der Taskleiste **Suchen** und geben Sie die Eingabetaste ein**D:**, um zum Home-Ordner zu navigieren. **Anmerkung** Wenn Sie diesen Schritt überspringen, wird möglicherweise eine `Device not ready` Fehlermeldung angezeigt, wenn Sie versuchen, auf den Basisordner zuzugreifen. Wenn Sie Probleme bei der Anmeldung bei WorkSpaces Anwendungen haben, können Sie Ihre WorkSpaces Anwendungsflotte jederzeit neu starten und versuchen, sich mithilfe der folgenden Schritte erneut anzumelden. 1. Öffnen Sie die WorkSpaces Anwendungskonsole. 1. Wählen Sie in der linken Navigationsleiste **Flotten** aus. 1. Wählen Sie die Flotte aus, die Sie verwenden möchten. 1. Wählen Sie „**Aktion“** und anschließend „**Stopp**“. 1. Warten Sie, bis die Flotte stoppt. 1. Wählen Sie „**Aktion“** und anschließend „**Start**“. Dieser Vorgang kann etwa 10 Minuten dauern. ## Schritt 5: Buckets in Amazon S3 verifizieren (optional) Eine der Aufgaben, die durch die CloudFormation Vorlage, die Sie zur Erstellung des Stacks verwendet haben, erledigt wurde, bestand darin, zwei Buckets in Amazon S3 zu erstellen, die zum Speichern und Wiederherstellen von Benutzerdaten und Anwendungseinstellungen über Arbeitssitzungen hinweg erforderlich sind. Diese Buckets lauten wie folgt: + Der Name beginnt mit`appstream2-`. Dieser Bucket ordnet Daten Ihrem Home-Ordner in WorkSpaces Applications (`D:\PhotonUser\My Files\Home Folder`) zu. **Anmerkung** Der Home-Ordner ist für eine bestimmte E-Mail-Adresse eindeutig und wird von allen Flotten und Stacks eines bestimmten AWS Kontos gemeinsam genutzt. Der Name des Home-Ordners ist ein SHA256 Hash der E-Mail-Adresse des Benutzers und wird in einem Pfad gespeichert, der auf diesem Hash basiert. + Der Name beginnt mit`appstream-app-settings-`. Dieser Bucket enthält Benutzersitzungsinformationen für WorkSpaces Anwendungen und umfasst Einstellungen wie Browser-Favoriten, IDE- und Anwendungsverbindungsprofile sowie Anpassungen der Benutzeroberfläche. Weitere Informationen finden Sie unter [How Application Settings Persistence Works](https://docs.aws.amazon.com/appstream2/latest/developerguide/how-it-works-app-settings-persistence.html) im *Amazon WorkSpaces Applications Administration Guide*. Gehen Sie wie folgt vor, um zu überprüfen, ob die Buckets erstellt wurden: 1. Öffnen Sie die Amazon S3-Konsole. 1. Wählen Sie in der linken Navigationsleiste **Buckets** aus. 1. Geben **Sie im Feld Buckets nach Namen** suchen ein, um die **appstream** Liste zu filtern. Wenn Sie die Buckets sehen, sind keine weiteren Maßnahmen erforderlich. Seien Sie sich nur bewusst, dass die Buckets existieren. Wenn Sie die Buckets nicht sehen, ist entweder die Ausführung der CloudFormation Vorlage noch nicht abgeschlossen, oder es ist ein Fehler aufgetreten. Gehen Sie zur CloudFormation Konsole und überprüfen Sie die Meldungen zur Stack-Erstellung. ## Nächste Schritte Nachdem die WorkSpaces Anwendungsinfrastruktur eingerichtet ist, können Sie Enterprise Analyzer einrichten und mit der Nutzung beginnen. Weitere Informationen finden Sie unter [Tutorial: Enterprise Analyzer für WorkSpaces Anwendungen einrichten](set-up-ea.md). Sie können Enterprise Developer auch einrichten. Weitere Informationen finden Sie unter [Tutorial: Rocket Enterprise Developer für WorkSpaces Anwendungen einrichten](set-up-ed.md). ## Bereinigen von Ressourcen Das Verfahren zum Bereinigen des erstellten Stacks und der erstellten Flotten ist unter [ WorkSpaces Anwendungsflotte und -stapel erstellen](https://docs.aws.amazon.com/appstream2/latest/developerguide/set-up-stacks-fleets.html) beschrieben. Wenn die WorkSpaces Anwendungsobjekte gelöscht wurden, kann der Kontoadministrator gegebenenfalls auch die Amazon S3 S3-Buckets für Anwendungseinstellungen und Basisordner bereinigen. **Anmerkung** Der Basisordner für einen bestimmten Benutzer ist für alle Flotten einzigartig. Daher müssen Sie ihn möglicherweise behalten, wenn andere WorkSpaces Anwendungsstapel in demselben Konto aktiv sind. Und schließlich erlaubt WorkSpaces Applications derzeit nicht, Benutzer über die Konsole zu löschen. Stattdessen müssen Sie die Service-API mit der CLI verwenden. Weitere Informationen finden Sie unter [Benutzerpool-Administration](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool-admin.html) im *Amazon WorkSpaces Applications Administration Guide*. # Tutorial: Vorlagen mit Rocket Enterprise Developer (ehemals Micro Focus Enterprise Developer) verwenden Dieses Tutorial beschreibt, wie Sie Vorlagen und vordefinierte Projekte mit Rocket Enterprise Developer verwenden. Es deckt drei Anwendungsfälle ab. In allen Anwendungsfällen wird der im Beispiel enthaltene BankDemo Beispielcode verwendet. Um das Beispiel herunterzuladen, wählen Sie [https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip). **Wichtig** Wenn Sie die Version von Enterprise Developer für Windows verwenden, können die vom Compiler generierten Binärdateien nur auf dem Enterprise Server ausgeführt werden, der im Lieferumfang von Enterprise Developer enthalten ist. Sie können sie nicht unter der AWS Mainframe Modernization Runtime ausführen, die auf Linux basiert. **Topics** + [ ## Anwendungsfall 1 — Verwendung der COBOL-Projektvorlage, die Quellkomponenten enthält ](#tutorial-templates-ed-step1) + [ ## Anwendungsfall 2 — Verwendung der COBOL-Projektvorlage ohne Quellkomponenten ](#tutorial-templates-ed-step2) + [ ## Anwendungsfall 3 — Verwendung des vordefinierten COBOL-Projekts, das auf die Quellordner verweist ](#tutorial-templates-ed-step3) + [ ## Verwenden der JSON-Vorlage für die Regionsdefinition ](#tutorial-templates-ed-step4) ## Anwendungsfall 1 — Verwendung der COBOL-Projektvorlage, die Quellkomponenten enthält Bei diesem Anwendungsfall müssen Sie die Quellkomponenten als Teil der Schritte vor der Einrichtung der Demo in die Verzeichnisstruktur des Templates kopieren. In der wurde [https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip)dies gegenüber der ursprünglichen `AWSTemplates.zip` Lieferung geändert, um zu vermeiden, dass zwei Kopien der Quelle vorhanden sind. 1. Starten Sie Enterprise Developer und geben Sie den ausgewählten Workspace an. ![\[Der Eclipse-Launcher mit einem ausgewählten Workspace.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc1-step1.png) 1. Wählen Sie in der Ansicht des **Application Explorers** in der Strukturansicht des **Enterprise Development-Projekts** **im Kontextmenü die Option Neues Projekt aus Vorlage** aus. ![\[Das Kontextmenü der Strukturansicht des Enterprise Development-Projekts.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc1-step2.png) 1. Geben Sie die Vorlagenparameter wie in der Abbildung gezeigt ein. **Anmerkung** Der Vorlagenpfad bezieht sich darauf, wo die ZIP-Datei extrahiert wurde. ![\[Das Feld Vorlagenparameter eingeben, in dem der Pfad und der Projektname ausgefüllt sind.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc1-step3.png) 1. Wenn Sie OK wählen, wird auf der Grundlage der bereitgestellten Vorlage ein lokales Eclipse-Entwicklungsprojekt mit einer vollständigen Quell- und Ausführungsumgebungsstruktur erstellt. ![\[Das Eclipse-Projekt für die lokale Entwicklung zeigt seine Struktur.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc1-step4.png) Die `System` Struktur enthält eine vollständige Ressourcendefinitionsdatei mit den erforderlichen Einträgen für BANKDEMO, den erforderlichen Katalog mit hinzugefügten Einträgen und den entsprechenden ASCII-Datendateien. Da die Quellvorlagenstruktur alle Quellelemente enthält, werden diese Dateien in das lokale Projekt kopiert und daher automatisch in Enterprise Developer erstellt. ## Anwendungsfall 2 — Verwendung der COBOL-Projektvorlage ohne Quellkomponenten Die Schritte 1 bis 3 sind identisch mit. [Anwendungsfall 1 — Verwendung der COBOL-Projektvorlage, die Quellkomponenten enthält](#tutorial-templates-ed-step1) Die `System` Struktur in diesem Anwendungsfall enthält auch eine vollständige Ressourcendefinitionsdatei mit den erforderlichen Einträgen für BankDemo, den erforderlichen Katalog mit hinzugefügten Einträgen und den entsprechenden ASCII-Datendateien. Die Quellstruktur der Vorlage enthält jedoch keine Komponenten. Sie müssen diese aus dem Quell-Repository, das Sie verwenden, in das Projekt importieren. 1. Wählen Sie den Projektnamen. Wählen Sie im entsprechenden Kontextmenü die Option **Import**. ![\[Das Projekt-Kontextmenü mit ausgewähltem Import.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc2-step4.png) 1. Wählen Sie im daraufhin angezeigten Dialogfeld im Bereich **Allgemein die** Option **Dateisystem** und dann Weiter. ![\[Das Importfeld mit ausgewähltem Dateisystem.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc2-step5.png) 1. Füllen Sie das Feld **Aus dem Verzeichnis aus**, indem Sie das Dateisystem so durchsuchen, dass es auf den Repository-Ordner verweist. Wählen Sie alle Ordner aus, die Sie importieren möchten, z. B. `sources` Das `Into folder` Feld wird vorab ausgefüllt. Wählen Sie **Finish** (Abschließen). ![\[Das Dateisystem-Feld mit dem erweiterten BankDemo Verzeichnis.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc2-step6.png) Nachdem die Quellvorlagenstruktur alle Quellelemente enthält, werden sie automatisch in Enterprise Developer erstellt. ## Anwendungsfall 3 — Verwendung des vordefinierten COBOL-Projekts, das auf die Quellordner verweist 1. Starten Sie Enterprise Developer und geben Sie den ausgewählten Workspace an. ![\[Der Eclipse-Launcher mit einem ausgewählten Workspace.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc3-step1.png) 1. Wählen Sie im Menü **Datei** die Option **Import** aus. ![\[Das Datei-Menü mit ausgewähltem Import.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc3-step2.png) 1. Wählen Sie im daraufhin angezeigten Dialogfeld unter **Allgemein die** Option **Projekte aus Ordner oder Archiv** und **dann Weiter**. ![\[Das Importfeld mit ausgewählten Projekten aus einem Ordner oder Archiv.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc3-step3.png) 1. Füllen Sie die **Importquelle** aus, wählen Sie **Verzeichnis** und durchsuchen Sie das Dateisystem, um den vordefinierten Projektordner auszuwählen. Das darin enthaltene Projekt enthält Links zu den Quellordnern im selben Repository. ![\[Die Importprojekte aus dem Dateisystem oder der Archivbox mit dem eingegebenen Pfad zur Importquelle.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc3-step4.png) Wählen Sie **Finish** (Abschließen). Da das Projekt durch die Links zum Quellordner aufgefüllt wird, wird der Code automatisch erstellt. ## Verwenden der JSON-Vorlage für die Regionsdefinition 1. Wechseln Sie zur Server Explorer-Ansicht. Wählen Sie im entsprechenden Kontextmenü die Option **Administrationsseite öffnen**, wodurch der Standardbrowser gestartet wird. ![\[Das Server-Explorer-Kontextmenü mit ausgewählter geöffneter Administrationsseite.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-json-admin-page.png) 1. Wählen Sie im daraufhin angezeigten Fenster Enterprise Server Common Web Administration (ESCWA) die Option **Import** aus. ![\[Das Fenster Enterprise Server Common Web Administration mit ausgewähltem Import.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-json-import.png) 1. Wählen Sie den **JSON-Importtyp** und **dann Weiter**. ![\[Das Feld „Importtyp auswählen“ mit ausgewähltem JSON.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-json-import-type.png) 1. Laden Sie die bereitgestellte `BANKDEMO.JSON` Datei hoch. ![\[Das Feld „Datei zum Hochladen auswählen“ mit der ausgewählten BANKDEMO-Datei.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-json-upload.png) Sobald Sie die Auswahl getroffen haben, wählen Sie **Weiter**. ![\[Das Feld „Regionen auswählen“ enthält die Option „Ports von Endpunkten löschen“, die nicht ausgewählt sind.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-json-next.png) Stellen Sie sicher, dass im Bereich **„Regionen auswählen**“ die Option „**Anschlüsse von Endpunkten löschen**“ nicht aktiviert ist, und wählen Sie dann in den Bedienfeldern „**Weiter**“, bis der Bereich „**Import durchführen**“ angezeigt wird. Wählen Sie dann im linken Navigationsbereich **Import** aus. Klicken Sie abschließend auf **Fertig stellen**. Die BANKDEMO-Region wird dann der Serverliste hinzugefügt. ![\[Die Region und die Serverliste BankDemo wurden hinzugefügt.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-json-server-list.png) 1. Navigieren Sie zu den **Allgemeinen Eigenschaften** für die Region BANKDEMO. 1. Scrollen Sie zum Abschnitt **Konfiguration**. 1. Die ESP-Umgebungsvariable muss auf den `System` Ordner gesetzt werden, der für das in den vorherigen Schritten erstellte Eclipse-Projekt relevant ist. Das sollte sein`workspacefolder/projectname/System`. ![\[Der Konfigurationsabschnitt mit der angezeigten ESP-Variablen.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-json-ESP.png) 1. Klicken Sie auf **Apply (Anwenden)**. Die Region ist jetzt vollständig für die Ausführung in Verbindung mit dem Eclipse-COBOL-Projekt konfiguriert. 1. Verknüpfen Sie abschließend wieder in Enterprise Developer die importierte Region mit dem Projekt. ![\[Im Kontextmenü des Projekts ist die Option Dem Projekt zugeordnet ausgewählt.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-json-associate.png) Die Enterprise Developer-Umgebung ist jetzt mit einer vollständigen, funktionierenden Version von einsatzbereit BankDemo. Sie können Code für die Region bearbeiten, kompilieren und debuggen. **Wichtig** Wenn Sie die Version von Enterprise Developer für Windows verwenden, können die vom Compiler generierten Binärdateien nur auf dem Enterprise Server ausgeführt werden, der im Lieferumfang von Enterprise Developer enthalten ist. Sie können sie nicht unter der AWS Mainframe Modernization Runtime ausführen, die auf Linux basiert. # Tutorial: Enterprise Analyzer für WorkSpaces Anwendungen einrichten Dieses Tutorial beschreibt, wie Sie Rocket Enterprise Analyzer (früher Micro Focus Enterprise Analyzer) einrichten, um eine oder mehrere Mainframe-Anwendungen zu analysieren. Das Enterprise Analyzer-Tool bietet mehrere Berichte, die auf der Analyse des Anwendungsquellcodes und der Systemdefinitionen basieren. Dieses Setup wurde entwickelt, um die Zusammenarbeit im Team zu fördern. Bei der Installation wird ein Amazon S3 S3-Bucket verwendet, um den Quellcode mit virtuellen Laufwerken zu teilen. Dabei wird [Rclone](https://rclone.org/) () auf dem Windows-Computer verwendet. Mit einer gemeinsamen Amazon RDS-Instance, auf der [PostgreSQL](https://www.postgresql.org/) ausgeführt wird, kann jedes Mitglied des Teams auf alle angeforderten Berichte zugreifen. Teammitglieder können die virtuelle Amazon S3 S3-gesicherte Festplatte auch auf ihren persönlichen Computern mounten und den Quell-Bucket von ihren Workstations aus aktualisieren. Sie können möglicherweise Skripts oder jede andere Form der Automatisierung auf ihren Computern verwenden, wenn sie mit anderen internen Systemen vor Ort verbunden sind. Das Setup basiert auf den WorkSpaces Windows-Anwendungsabbildern, die AWS Mainframe Modernization dem Kunden zur Verfügung stellt. Die Einrichtung basiert auch auf der Erstellung von WorkSpaces Anwendungsflotten und -stapeln, wie unter beschrieben. [Tutorial: WorkSpaces Anwendungen für die Verwendung mit Rocket Enterprise Analyzer und Rocket Enterprise Developer einrichten](set-up-appstream-mf.md) **Wichtig** Bei den Schritten in diesem Tutorial wird davon ausgegangen, dass Sie WorkSpaces Anwendungen mit der herunterladbaren CloudFormation Vorlage [cfn-m2](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) - .yml einrichten. appstream-fleet-ea-ed Weitere Informationen finden Sie unter [Tutorial: WorkSpaces Anwendungen für die Verwendung mit Rocket Enterprise Analyzer und Rocket Enterprise Developer einrichten](set-up-appstream-mf.md). Um die Schritte in diesem Tutorial ausführen zu können, müssen Sie Ihre Enterprise Analyzer-Flotte und Ihren Enterprise Analyzer-Stack eingerichtet haben und diese müssen laufen. Eine vollständige Beschreibung der Funktionen und Leistungen von Enterprise Analyzer finden Sie in der [Enterprise Analyzer-Dokumentation](https://www.microfocus.com/documentation/enterprise-analyzer/) auf der Website von Rocket Software (ehemals Micro Focus). ## Inhalt des Bildes Neben der Enterprise Analyzer-Anwendung selbst enthält das Image die folgenden Tools und Bibliotheken. Tools von Drittanbietern + [Python](https://www.python.org/) + [Rclone](https://rclone.org/) + [pgAdmin](https://www.pgadmin.org/) + [git-scm](https://git-scm.com/) + [PostgreSQL ODBC-Treiber](https://odbc.postgresql.org/) Bibliotheken in `C:\Users\Public` + BankDemo Quellcode und Projektdefinition für Enterprise Developer:`m2-bankdemo-template.zip`. + MFA-Installationspaket für den Mainframe:. `mfa.zip` Weitere Informationen finden Sie unter [Mainframe Access Overview](https://www.microfocus.com/documentation/enterprise-developer/30pu12/ED-VS2012/BKMMMMINTRS001.html) in der *Micro Focus Enterprise* Developer-Dokumentation. + Befehls- und Konfigurationsdateien für Rclone (Anweisungen zu deren Verwendung in den Tutorials): `m2-rclone.cmd` und. `m2-rclone.conf` **Topics** + [ ## Inhalt des Bildes ](#set-up-ea-image-contents) + [ ## Voraussetzungen ](#tutorial-ea-prerequisites) + [ ## Schritt 1: Einrichtung ](#tutorial-ea-step1) + [ ## Schritt 2: Erstellen Sie den Amazon S3 S3-basierten virtuellen Ordner unter Windows ](#tutorial-ea-step2) + [ ## Schritt 3: Erstellen Sie eine ODBC-Quelle für die Amazon RDS-Instance ](#tutorial-ea-step3) + [ ## Nachfolgende Sitzungen ](#tutorial-ea-step4) + [ ## Problembehandlung bei der Workspace-Verbindung ](#tutorial-ea-step5) + [ ## Bereinigen von Ressourcen ](#tutorial-ea-clean) ## Voraussetzungen + Laden Sie den Quellcode und die Systemdefinitionen für die Kundenanwendung, die Sie analysieren möchten, in einen S3-Bucket hoch. Zu den Systemdefinitionen gehören CICS CSD, DB2 Objektdefinitionen usw. Sie können innerhalb des Buckets eine Ordnerstruktur erstellen, die für die Organisation der Anwendungsartefakte sinnvoll ist. Wenn Sie das BankDemo Beispiel beispielsweise entpacken, hat es die folgende Struktur: ``` demo |--> jcl |--> RDEF |--> transaction |--> xa ``` + Erstellen und starten Sie eine Amazon RDS-Instance, auf der PostgreSQL ausgeführt wird. Diese Instance speichert die von Enterprise Analyzer erstellten Daten und Ergebnisse. Sie können diese Instanz mit allen Mitgliedern des Anwendungsteams teilen. Erstellen Sie außerdem ein leeres Schema mit dem Namen `m2_ea` (oder einem anderen geeigneten Namen) in der Datenbank. Definieren Sie Anmeldeinformationen für autorisierte Benutzer, die es ihnen ermöglichen, Elemente in diesem Schema zu erstellen, einzufügen, zu aktualisieren und zu löschen. Sie können den Datenbanknamen, die URL des Serverendpunkts und den TCP-Port von der Amazon RDS-Konsole oder vom Kontoadministrator abrufen. + Stellen Sie sicher, dass Sie den programmatischen Zugriff auf Ihre AWS-Konto eingerichtet haben. *Weitere Informationen finden Sie unter [Programmgesteuerter Zugriff](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys) in der.Allgemeine Amazon Web Services-Referenz* ## Schritt 1: Einrichtung 1. Starten Sie eine Sitzung mit WorkSpaces Applications mit der URL, die Sie in der Willkommens-E-Mail von WorkSpaces Applications erhalten haben. 1. Verwenden Sie Ihre E-Mail-Adresse als Benutzer-ID und definieren Sie Ihr permanentes Passwort. 1. Wählen Sie den Enterprise Analyzer-Stack aus. 1. Wählen Sie auf der Menüseite „ WorkSpaces Anwendungen“ die Option **Desktop** aus, um den Windows-Desktop aufzurufen, auf dem die Flotte streamt. ## Schritt 2: Erstellen Sie den Amazon S3 S3-basierten virtuellen Ordner unter Windows **Anmerkung** Wenn Sie Rclone bereits in der Vorschauversion der AWS Mainframe-Modernisierung verwendet haben, müssen Sie `m2-rclone.cmd` auf die neuere Version aktualisieren, die sich unter befindet. `C:\Users\Public` 1. Kopieren Sie die bereitgestellten `m2-rclone.cmd` Dateien `m2-rclone.conf` und mit `C:\Users\Public` dem `C:\Users\PhotonUser\My Files\Home Folder` Datei-Explorer in Ihren Home-Ordner. 1. Aktualisieren Sie die `m2-rclone.conf` Konfigurationsparameter mit Ihrem AWS Zugriffsschlüssel und dem entsprechenden Geheimnis sowie Ihrem AWS-Region. ``` [m2-s3] type = s3 provider = AWS access_key_id = YOUR-ACCESS-KEY secret_access_key = YOUR-SECRET-KEY region = YOUR-REGION acl = private server_side_encryption = AES256 ``` 1. Nehmen Sie in `m2-rclone.cmd` die folgenden Änderungen vor: + Wechseln Sie `amzn-s3-demo-bucket` zu Ihrem Amazon S3 S3-Bucket-Namen. Beispiel, `m2-s3-mybucket`. + Wechseln Sie `your-s3-folder-key` zu Ihrem Amazon S3 S3-Bucket-Key. Beispiel, `myProject`. + Wechseln Sie `your-local-folder-path` zum Pfad des Verzeichnisses, in das die Anwendungsdateien aus dem Amazon S3 S3-Bucket synchronisiert werden sollen, der sie enthält. Beispiel, `D:\PhotonUser\My Files\Home Folder\m2-new`. Dieses synchronisierte Verzeichnis muss ein Unterverzeichnis des Home-Ordners sein, damit WorkSpaces Anwendungen es beim Start und Ende der Sitzung ordnungsgemäß sichern und wiederherstellen können. ``` :loop timeout /T 10 "C:\Program Files\rclone\rclone.exe" sync m2-s3:amzn-s3-demo-bucket/your-s3-folder-key "D:\PhotonUser\My Files\Home Folder\your-local-folder-path" --config "D:\PhotonUser\My Files\Home Folder\m2-rclone.conf" goto :loop ``` 1. Öffnen Sie eine Windows-Eingabeaufforderung, geben Sie bei `C:\Users\PhotonUser\My Files\Home Folder` Bedarf eine CD ein und führen Sie den Befehl aus. `m2-rclone.cmd` Dieses Befehlsskript führt eine Endlosschleife aus und synchronisiert Ihren Amazon S3 S3-Bucket und Ihren Schlüssel alle 10 Sekunden mit dem lokalen Ordner. Sie können das Timeout nach Bedarf anpassen. Sie sollten den Quellcode der Anwendung sehen, der sich im Amazon S3 S3-Bucket im Windows-Datei-Explorer befindet. Um dem Set, an dem Sie gerade arbeiten, neue Dateien hinzuzufügen oder bestehende zu aktualisieren, laden Sie die Dateien in den Amazon S3 S3-Bucket hoch. Sie werden dann bei der nächsten unter definierten Iteration mit Ihrem Verzeichnis synchronisiert. `m2-rclone.cmd` Wenn Sie einige Dateien löschen möchten, löschen Sie sie ebenfalls aus dem Amazon S3 S3-Bucket. Beim nächsten Synchronisierungsvorgang werden sie aus Ihrem lokalen Verzeichnis gelöscht. ## Schritt 3: Erstellen Sie eine ODBC-Quelle für die Amazon RDS-Instance 1. **Um das EA\$1Admin-Tool zu starten, navigieren Sie zum Anwendungsauswahlmenü in der oberen linken Ecke des Browserfensters und wählen Sie MF EA\$1Admin.** 1. ****Wählen Sie im Menü „**Verwalten**“ die Option „**ODBC-Datenquellen**“ und anschließend auf der Registerkarte „Benutzer-DSN“ die Option „Hinzufügen“.**** 1. **Wählen Sie im Dialogfeld Neue Datenquelle erstellen den **PostgreSQL-Unicode-Treiber** aus, und klicken Sie dann auf Fertig stellen.** 1. Definieren Sie im Dialogfeld **PostgreSQL Unicode ODBC Driver (psqlODBC) Setup** den gewünschten Datenquellennamen und notieren Sie sich diesen. Vervollständigen Sie die folgenden Parameter mit den Werten aus der RDS-Instanz, die Sie zuvor erstellt haben: **Description** Optionale Beschreibung, die Ihnen hilft, diese Datenbankverbindung schnell zu identifizieren. **Datenbank** Die Amazon RDS-Datenbank, die Sie zuvor erstellt haben. **Server** Der Amazon RDS-Endpunkt. **Port** Der Amazon RDS-Port. **Benutzername** Wie in der Amazon RDS-Instance definiert. **Passwort** Wie in der Amazon RDS-Instance definiert. 1. Wählen Sie **Test**, um zu überprüfen, ob die Verbindung zu Amazon RDS erfolgreich ist, und wählen Sie dann **Speichern**, um Ihren neuen Benutzer-DSN zu speichern. 1. Warten Sie, bis Sie die Meldung sehen, die bestätigt, dass der richtige Workspace erstellt wurde, und wählen Sie dann **OK**, um mit ODBC-Datenquellen fertig zu werden und das EA\$1Admin-Tool zu schließen. 1. Navigieren Sie erneut zum Anwendungsauswahlmenü und wählen Sie Enterprise Analyzer, um das Tool zu starten. Wählen Sie „**Neu erstellen**“. 1. Geben Sie im Fenster Workspace-Konfiguration Ihren Workspace-Namen ein und definieren Sie dessen Speicherort. Der Arbeitsbereich kann die Amazon S3 S3-basierte Festplatte sein, wenn Sie mit dieser Konfiguration arbeiten, oder Ihr Home-Ordner, wenn Sie dies bevorzugen. 1. **Wählen Sie „Andere Datenbank** auswählen“, um eine Verbindung zu Ihrer Amazon RDS-Instance herzustellen. 1. Wählen Sie das **Postgre-Symbol** aus den Optionen und klicken Sie dann **auf OK**. 1. Geben Sie für die Windows-Einstellungen unter **Optionen — Verbindungsparameter definieren** den Namen der Datenquelle ein, die Sie erstellt haben. Geben Sie außerdem den Datenbanknamen, den Schemanamen, den Benutzernamen und das Passwort ein. Wählen Sie **OK** aus. 1. Warten Sie, bis Enterprise Analyzer alle Tabellen, Indizes usw. erstellt hat, die zum Speichern der Ergebnisse benötigt werden. Dieser Vorgang kann einige Minuten dauern. Enterprise Analyzer bestätigt, wann die Datenbank und der Workspace einsatzbereit sind. 1. Navigieren Sie erneut zum Anwendungsauswahlmenü und wählen Sie Enterprise Analyzer, um das Tool zu starten. 1. Das Enterprise Analyzer-Startfenster wird am neuen, ausgewählten Workspace-Speicherort angezeigt. Wählen Sie **OK** aus. 1. Navigieren Sie im linken Bereich zu Ihrem Repository, wählen Sie den Repository-Namen und wählen Sie **Dateien/Ordner zu Ihrem Workspace hinzufügen**. Wählen Sie den Ordner aus, in dem Ihr Anwendungscode gespeichert ist, um ihn dem Workspace hinzuzufügen. Sie können den vorherigen BankDemo Beispielcode verwenden, wenn Sie möchten. Wenn Enterprise Analyzer Sie auffordert, diese Dateien zu verifizieren, wählen Sie **Verify**, um den ersten Enterprise Analyzer-Bestätigungsbericht zu starten. Je nach Größe Ihrer Anwendung kann es einige Minuten dauern, bis der Vorgang abgeschlossen ist. 1. Erweitere deinen Workspace, um die Dateien und Ordner zu sehen, die du dem Workspace hinzugefügt hast. Die Objekttypen und zyklomatischen Komplexitätsberichte sind auch im oberen Quadranten des **Chart Viewer-Fensters** sichtbar. Sie können Enterprise Analyzer jetzt für alle erforderlichen Aufgaben verwenden. ## Nachfolgende Sitzungen 1. Starten Sie eine Sitzung mit WorkSpaces Applications mit der URL, die Sie in der Willkommens-E-Mail von WorkSpaces Applications erhalten haben. 1. Melden Sie sich mit Ihrer E-Mail-Adresse und Ihrem permanenten Passwort an. 1. Wählen Sie den Enterprise Analyzer-Stack aus. 1. Starten Sie`Rclone`, um eine Verbindung zur Amazon S3 S3-gesicherten Festplatte herzustellen, wenn Sie diese Option verwenden, um die Workspace-Dateien gemeinsam zu nutzen. 1. Starten Sie Enterprise Analyzer, um Ihre Aufgaben zu erledigen. ## Problembehandlung bei der Workspace-Verbindung Wenn Sie versuchen, erneut eine Verbindung zu Ihrem Enterprise Analyzer-Workspace herzustellen, wird möglicherweise ein Fehler wie dieser angezeigt: ``` Cannot access the workspace directory D:\PhotonUser\My Files\Home Folder\EA_BankDemo. The workspace has been created on a non-shared disk of the EC2AMAZ-E6LC33H computer. Would you like to correct the workspace directory location? ``` Um dieses Problem zu beheben, wählen Sie **OK**, um die Meldung zu löschen, und führen Sie dann die folgenden Schritte aus. 1. Wählen Sie unter WorkSpaces Anwendungen in der Werkzeugleiste das Symbol „**Anwendung starten**“ und anschließend „**EA\$1Admin**“, um das Enterprise Analyzer-Administrationstool zu starten. ![\[Wählen Sie im Auswahlmenü für den WorkSpaces Anwendungsstart das Rocket Enterprise Developer-Administrationstool aus.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/aas-launch-selector.png) 1. Wählen Sie im Menü „**Verwalten**“ die Option „**Workspace-Pfad aktualisieren...“** . ![\[Menü „Verwalten“ des Rocket Enterprise Analyzer-Administrationstools, wobei die Option Workspace-Pfad aktualisieren ausgewählt ist.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ea_admin-administer-refresh.png) 1. **Wählen Sie unter Arbeitsbereich** auswählen den gewünschten Arbeitsbereich aus und klicken Sie dann **auf OK**. ![\[Das Dialogfeld „Workspace auswählen“ des Rocket Enterprise Analyzer-Verwaltungstools mit einem ausgewählten Projekt.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ea_admin-select-workspace.png) 1. Wählen Sie **OK**, um die Fehlermeldung zu bestätigen. ![\[Die Enterprise Analyzer-Fehlermeldung „Zugriff auf das Workspace-Verzeichnis ist nicht möglich“, wenn OK ausgewählt ist.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ea_admin-select-workspace-error.png) 1. Geben Sie unter **Netzwerkpfad für das Workspace-Verzeichnis** den richtigen Pfad zu Ihrem Workspace ein, `D:\PhotonUser\My Files\Home Folder\EA\MyWorkspace3` z. B. ![\[Netzwerkpfad des Workspace-Verzeichnisses im Enterprise Analyzer-Dialogfeld mit einem Beispielpfad.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ea_admin-workspace-directory-network-path.png) 1. Schließen Sie das Micro Focus Enterprise Analyzer Administration Tool. ![\[Das Micro Focus Enterprise Analyzer Administrationstool, bei dem die Schaltfläche Schließen ausgewählt ist.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ea_admin-close.png) 1. Wählen Sie unter WorkSpaces Anwendungen in der Werkzeugleiste das Symbol „**Anwendung starten**“ und anschließend „**EA**“, um Micro Focus Enterprise Analyzer zu starten. ![\[Klicken Sie auf das Symbol „ WorkSpaces Anwendungen starten“, wenn EA ausgewählt ist.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/aas-launch-ea.png) 1. Wiederhole die Schritte 3 bis 5. Micro Focus Enterprise Analyzer sollte jetzt mit dem vorhandenen Workspace geöffnet werden. ## Bereinigen von Ressourcen Wenn Sie die Ressourcen, die Sie für dieses Tutorial erstellt haben, nicht mehr benötigen, löschen Sie sie, damit Ihnen keine weiteren Kosten entstehen. Führen Sie folgende Schritte aus: + Verwenden Sie das **EA\$1Admin-Tool**, um den Workspace zu löschen. + Löschen Sie die S3-Buckets, die Sie für dieses Tutorial erstellt haben. Weitere Informationen finden Sie unter [Löschen eines Bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html) im *Amazon-S3-Benutzerhandbuch*. + Löschen Sie die Datenbank, die Sie für dieses Tutorial erstellt haben. Weitere Informationen finden Sie unter [Löschen einer DB-Instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL). # Tutorial: Rocket Enterprise Developer für WorkSpaces Anwendungen einrichten Dieses Tutorial beschreibt, wie Sie Rocket Enterprise Developer (ehemals Micro Focus Enterprise Developer) für eine oder mehrere Mainframe-Anwendungen einrichten, um sie mithilfe der Enterprise Developer-Funktionen zu warten, zu kompilieren und zu testen. Das Setup basiert auf den WorkSpaces Windows-Anwendungsabbildern, die AWS Mainframe Modernization dem Kunden zur Verfügung stellt, und auf der Erstellung von WorkSpaces Anwendungsflotten und -stapeln, wie unter beschrieben. [Tutorial: WorkSpaces Anwendungen für die Verwendung mit Rocket Enterprise Analyzer und Rocket Enterprise Developer einrichten](set-up-appstream-mf.md) **Wichtig** Bei den Schritten in diesem Tutorial wird davon ausgegangen, dass Sie WorkSpaces Anwendungen mithilfe der herunterladbaren CloudFormation Vorlage [cfn-m2](https://d1vi4vxke6c2hu.cloudfront.net/tutorial/cfn-m2-appstream-fleet-ea-ed.yaml) - .yaml einrichten. appstream-fleet-ea-ed Weitere Informationen finden Sie unter [Tutorial: WorkSpaces Anwendungen für die Verwendung mit Rocket Enterprise Analyzer und Rocket Enterprise Developer einrichten](set-up-appstream-mf.md). Sie müssen die Schritte dieses Setups durchführen, wenn die Enterprise Developer-Flotte und der Enterprise Developer-Stack betriebsbereit sind. Eine vollständige Beschreibung der Funktionen und Leistungen von Enterprise Developer v7 finden Sie in der [up-to-date Online-Dokumentation (v7.0)](https://www.microfocus.com/documentation/enterprise-developer/ed70/ED-Eclipse/GUID-8D6B7358-AC35-4DAF-A445-607D8D97EBB2.html) auf der Website von Rocket Software (ehemals Micro Focus). ## Inhalt des Bildes Zusätzlich zu Enterprise Developer selbst enthält das Image Rumba (einen TN3270 Emulator). Es enthält auch die folgenden Tools und Bibliotheken. Tools von Drittanbietern + [Python](https://www.python.org/) + [Rclone](https://rclone.org/) + [pgAdmin](https://www.pgadmin.org/) + [git-scm](https://git-scm.com/) + [PostgreSQL ODBC-Treiber](https://odbc.postgresql.org/) Bibliotheken in `C:\Users\Public` + BankDemo Quellcode und Projektdefinition für Enterprise Developer:`m2-bankdemo-template.zip`. + MFA-Installationspaket für den Mainframe:. `mfa.zip` Weitere Informationen finden Sie unter [Mainframe Access Overview](https://www.microfocus.com/documentation/enterprise-developer/30pu12/ED-VS2012/BKMMMMINTRS001.html) in der *Micro Focus Enterprise* Developer-Dokumentation. + Befehls- und Konfigurationsdateien für Rclone (Anweisungen zu deren Verwendung in den Tutorials): `m2-rclone.cmd` und. `m2-rclone.conf` Wenn Sie auf Quellcode zugreifen müssen, der noch nicht in CodeCommit Repositorys geladen wurde, der aber in einem Amazon S3 S3-Bucket verfügbar ist, um beispielsweise das erste Laden des Quellcodes in Git durchzuführen, gehen Sie wie unter beschrieben vor, um eine virtuelle Windows-Festplatte zu erstellen. [Tutorial: Enterprise Analyzer für WorkSpaces Anwendungen einrichten](set-up-ea.md) **Topics** + [ ## Inhalt des Bildes ](#set-up-ed-image-contents) + [ ## Voraussetzungen ](#tutorial-ed-prerequisites) + [ ## Schritt 1: Einrichtung durch einzelne Enterprise Developer-Benutzer ](#tutorial-ed-step1) + [ ## Schritt 2: Erstellen Sie den Amazon S3-basierten virtuellen Ordner unter Windows (optional) ](#tutorial-ed-step2) + [ ## Schritt 3: Klonen Sie das Repository ](#tutorial-ed-step3) + [ ## Nachfolgende Sitzungen ](#tutorial-ed-step4) + [ ## Bereinigen von Ressourcen ](#tutorial-ed-clean) ## Voraussetzungen + Ein oder mehrere CodeCommit Repositorys, die mit dem Quellcode der zu verwaltenden Anwendung geladen wurden. Das Repository-Setup sollte den Anforderungen der oben genannten CI/CD Pipeline entsprechen, um durch die Kombination beider Tools Synergien zu schaffen. + Jeder Benutzer muss über Anmeldeinformationen für das CodeCommit Repository oder die Repositorys verfügen, die vom Kontoadministrator gemäß den Informationen unter [Authentifizierung und Zugriffskontrolle für AWS CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html) definiert wurden. Die Struktur dieser Anmeldeinformationen wird unter [Authentifizierung und Zugriffskontrolle für AWS](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html) überprüft, CodeCommit und die vollständige Referenz zu den IAM-Autorisierungen für CodeCommit finden Sie in der [CodeCommit Berechtigungsreferenz](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-permissions-reference.html): Der Administrator kann unterschiedliche IAM-Richtlinien für verschiedene Rollen mit rollenspezifischen Anmeldeinformationen für jedes Repository definieren und seine Benutzerberechtigungen auf die spezifischen Aufgaben beschränken, die er in einem bestimmten Repository ausführen muss. Daher generiert der Kontoadministrator für jeden Betreuer des CodeCommit Repositorys einen Hauptbenutzer und erteilt diesem Benutzer Berechtigungen für den Zugriff auf das oder die erforderlichen Repositorys, indem er die richtige (n) IAM-Richtlinie (n) für den CodeCommit Zugriff auswählt. ## Schritt 1: Einrichtung durch einzelne Enterprise Developer-Benutzer 1. Besorgen Sie sich Ihre IAM-Anmeldeinformationen: 1. Connect zur AWS Konsole unter her [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Folgen Sie dem Verfahren, das in Schritt 3 von [Setup für HTTPS-Benutzer mithilfe von Git-Anmeldeinformationen](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html) im *AWS CodeCommit Benutzerhandbuch* beschrieben wird. 1. Kopieren Sie die CodeCommit spezifischen Anmeldeinformationen, die IAM für Sie generiert hat, indem Sie diese Informationen entweder anzeigen, kopieren und dann in eine sichere Datei auf Ihrem lokalen Computer einfügen oder indem Sie **Anmeldeinformationen herunterladen** wählen, um diese Informationen als CSV-Datei herunterzuladen. Sie benötigen diese Informationen für die Verbindung mit CodeCommit. 1. Starten Sie eine Sitzung mit WorkSpaces Anwendungen, die auf der URL basieren, die Sie in der Willkommens-E-Mail erhalten haben. Verwenden Sie Ihre E-Mail-Adresse als Benutzernamen und erstellen Sie Ihr Passwort. 1. Wählen Sie Ihren Enterprise Developer-Stack aus. 1. Wählen Sie auf der Menüseite **Desktop** aus, um zum Windows-Desktop zu gelangen, der von der Flotte gestreamt wird. ## Schritt 2: Erstellen Sie den Amazon S3-basierten virtuellen Ordner unter Windows (optional) Wenn Rclone benötigt wird (siehe oben), erstellen Sie den Amazon S3-basierten virtuellen Ordner unter Windows: (optional, wenn alle Anwendungsartefakte ausschließlich aus Access stammen). CodeCommit **Anmerkung** Wenn Sie Rclone bereits in der Vorschauversion der AWS Mainframe-Modernisierung verwendet haben, müssen Sie auf die neuere Version aktualisieren, die `m2-rclone.cmd` sich unter befindet. `C:\Users\Public` 1. Kopieren Sie die bereitgestellten `m2-rclone.cmd` Dateien `m2-rclone.conf` und mit `C:\Users\Public` dem `C:\Users\PhotonUser\My Files\Home Folder` Datei-Explorer in Ihren Home-Ordner. 1. Aktualisieren Sie die `m2-rclone.conf` Konfigurationsparameter mit Ihrem AWS Zugriffsschlüssel und dem entsprechenden Geheimnis sowie Ihrem AWS-Region. ``` [m2-s3] type = s3 provider = AWS access_key_id = YOUR-ACCESS-KEY secret_access_key = YOUR-SECRET-KEY region = YOUR-REGION acl = private server_side_encryption = AES256 ``` 1. Nehmen Sie in `m2-rclone.cmd` die folgenden Änderungen vor: + Wechseln Sie `amzn-s3-demo-bucket` zu Ihrem Amazon S3 S3-Bucket-Namen. Beispiel, `m2-s3-mybucket`. + Wechseln Sie `your-s3-folder-key` zu Ihrem Amazon S3 S3-Bucket-Key. Beispiel, `myProject`. + Wechseln Sie `your-local-folder-path` zum Pfad des Verzeichnisses, in das die Anwendungsdateien aus dem Amazon S3 S3-Bucket synchronisiert werden sollen, der sie enthält. Beispiel, `D:\PhotonUser\My Files\Home Folder\m2-new`. Dieses synchronisierte Verzeichnis muss ein Unterverzeichnis des Home-Ordners sein, damit WorkSpaces Anwendungen es beim Start und Ende der Sitzung ordnungsgemäß sichern und wiederherstellen können. ``` :loop timeout /T 10 "C:\Program Files\rclone\rclone.exe" sync m2-s3:amzn-s3-demo-bucket/your-s3-folder-key "D:\PhotonUser\My Files\Home Folder\your-local-folder-path" --config "D:\PhotonUser\My Files\Home Folder\m2-rclone.conf" goto :loop ``` 1. Öffnen Sie eine Windows-Eingabeaufforderung, geben Sie bei `C:\Users\PhotonUser\My Files\Home Folder` Bedarf eine CD ein und führen Sie den Befehl aus. `m2-rclone.cmd` Dieses Befehlsskript führt eine Endlosschleife aus und synchronisiert Ihren Amazon S3 S3-Bucket und Ihren Schlüssel alle 10 Sekunden mit dem lokalen Ordner. Sie können das Timeout nach Bedarf anpassen. Sie sollten den Quellcode der Anwendung sehen, der sich im Amazon S3 S3-Bucket im Windows-Datei-Explorer befindet. Um dem Set, an dem Sie gerade arbeiten, neue Dateien hinzuzufügen oder bestehende zu aktualisieren, laden Sie die Dateien in den Amazon S3 S3-Bucket hoch. Sie werden dann bei der nächsten unter definierten Iteration mit Ihrem Verzeichnis synchronisiert. `m2-rclone.cmd` Wenn Sie einige Dateien löschen möchten, löschen Sie sie ebenfalls aus dem Amazon S3 S3-Bucket. Beim nächsten Synchronisierungsvorgang werden sie aus Ihrem lokalen Verzeichnis gelöscht. ## Schritt 3: Klonen Sie das Repository 1. Navigieren Sie zum Anwendungsauswahlmenü in der oberen linken Ecke des Browserfensters und wählen Sie Enterprise Developer aus. 1. Schließe die von Enterprise Developer benötigte Workspace-Erstellung in deinem Home-Ordner ab, indem du `C:\Users\PhotonUser\My Files\Home Folder` (aka`D: \PhotonUser\My Files\Home Folder`) als Speicherort für den Workspace auswählst. 1. Klonen Sie in Enterprise Developer Ihr CodeCommit Repository, indem Sie zum Project Explorer gehen, mit der rechten Maustaste klicken und **Import, Import****...**, **Git**, **Projekte** aus **Git** **Clone URI** wählen. Geben Sie dann Ihre CodeCommit spezifischen Anmeldedaten ein und füllen Sie den Eclipse-Dialog aus, um den Code zu importieren. Das CodeCommit Git-Repository ist jetzt in deinem lokalen Workspace geklont. Ihr Enterprise Developer-Workspace ist jetzt bereit, mit den Wartungsarbeiten an Ihrer Anwendung zu beginnen. Insbesondere können Sie die in Enterprise Developer integrierte lokale Instanz von Enterprise Server (ES) verwenden, um Ihre Anwendung interaktiv zu debuggen und auszuführen, um Ihre Änderungen lokal zu validieren. **Anmerkung** Die lokale Enterprise Developer-Umgebung, einschließlich der lokalen Enterprise Server-Instanz, läuft unter Windows, während AWS Mainframe Modernization unter Linux ausgeführt wird. Wir empfehlen, dass Sie ergänzende Tests in der von AWS Mainframe Modernization bereitgestellten Linux-Umgebung durchführen, nachdem Sie die neue Anwendung für dieses Ziel übernommen CodeCommit und für dieses Ziel neu erstellt haben und bevor Sie die neue Anwendung in der Produktionsumgebung einführen. ## Nachfolgende Sitzungen Wenn Sie einen Ordner auswählen, der sich unter der WorkSpaces Anwendungsverwaltung befindet, z. B. den Home-Ordner für das Klonen Ihres CodeCommit Repositorys, wird er sitzungsübergreifend transparent gespeichert und wiederhergestellt. Führen Sie die folgenden Schritte aus, wenn Sie das nächste Mal mit der Anwendung arbeiten müssen: 1. Starten Sie eine Sitzung mit WorkSpaces Anwendungen auf der Grundlage der URL, die Sie in der Willkommens-E-Mail erhalten haben. 1. Melden Sie sich mit Ihrer E-Mail-Adresse und Ihrem permanenten Passwort an. 1. Wählen Sie den Enterprise Developer-Stack aus. 1. Starten Sie`Rclone`, um eine Verbindung zur Amazon S3-gestützten Festplatte herzustellen (siehe oben), wenn diese Option zur gemeinsamen Nutzung der Workspace-Dateien verwendet wird. 1. Starten Sie Enterprise Developer, um Ihre Arbeit zu erledigen. ## Bereinigen von Ressourcen Wenn Sie die Ressourcen, die Sie für dieses Tutorial erstellt haben, nicht mehr benötigen, löschen Sie sie, damit sie Ihnen nicht weiter in Rechnung gestellt werden. Führen Sie folgende Schritte aus: + Löschen Sie das CodeCommit Repository, das Sie für dieses Tutorial erstellt haben. Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* unter [Löschen eines CodeCommit Repositorys](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-delete-repository.html). + Löschen Sie die Datenbank, die Sie für dieses Tutorial erstellt haben. Weitere Informationen finden Sie unter [Löschen einer DB-Instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL).