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.
# Tutorial: AWS Transform for Mainframe Developer on WorkSpaces Applications verwenden
In diesem Tutorial erfahren Sie, wie Sie auf AWS Transform for Mainframe Developer on WorkSpaces Applications zugreifen und es mit einer Beispielanwendung verwenden, damit Sie die Funktionen ausprobieren können. Wenn Sie dieses Tutorial abgeschlossen haben, können Sie dieselben Schritte mit Ihren eigenen Anwendungen verwenden.
**Topics**
+ [Schritt 1: Erstellen einer Datenbank](#tutorial-ba-developer-create-db)
+ [Schritt 2: Greifen Sie auf die Umgebung zu](#tutorial-ba-developer-access-env)
+ [Schritt 3: Richten Sie die Laufzeit ein](#tutorial-ba-developer-set-up-runtime)
+ [Schritt 4: Starten Sie die Eclipse-IDE](#tutorial-ba-developer-start-eclipse)
+ [Schritt 5: Richten Sie ein Maven-Projekt ein](#tutorial-ba-developer-set-up-maven)
+ [Schritt 6: Konfigurieren Sie einen Tomcat-Server](#tutorial-ba-developer-config-tomcat)
+ [Schritt 7: Auf Tomcat bereitstellen](#tutorial-ba-developer-deploy-tomcat)
+ [Schritt 8: Erstellen Sie die JICS-Datenbank](#tutorial-ba-developer-create-jics)
+ [Schritt 9: Starten und testen Sie die Anwendung](#tutorial-ba-developer-test-app)
+ [Schritt 10: Debuggen Sie die Anwendung](#tutorial-ba-developer-debug)
+ [Bereinigen von Ressourcen](#tutorial-ba-developer-clean)
## Schritt 1: Erstellen einer Datenbank
In diesem Schritt verwenden Sie Amazon RDS, um eine verwaltete PostgreSQL-Datenbank zu erstellen, die die Demo-Anwendung zum Speichern von Konfigurationsinformationen verwendet.
1. Öffnen Sie die Amazon RDS-Konsole.
1. Wählen Sie **Datenbanken > Datenbank erstellen**.
1. Wählen Sie **Standard create > PostgreSQL, behalten** Sie die Standardversion bei und wählen Sie dann **Kostenloses** Kontingent.
1. Wählen Sie eine DB-Instance-ID.
1. Wählen Sie für **Credential Settings** die Option **Masteranmeldedaten verwalten in AWS Secrets Manager**. Weitere Informationen finden Sie unter [Passwortverwaltung mit Amazon RDS und AWS Secrets Manager](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html) im *Amazon-RDS-Benutzerhandbuch*.
1. Stellen Sie sicher, dass es sich bei der VPC um dieselbe handelt, die Sie für die WorkSpaces Applications Instance verwenden. Sie können Ihren Administrator nach diesem Wert fragen.
1. Wählen Sie für **VPC-Sicherheitsgruppe** die Option **Create New** aus.
1. Stellen Sie **den öffentlichen Zugriff auf** **Ja** ein.
1. Behalten Sie alle anderen Standardwerte bei. Überprüfen Sie diese Werte.
1. Wählen Sie **Datenbank erstellen** aus.
Um den Datenbankserver von Ihrer Instance aus zugänglich zu machen, wählen Sie den Datenbankserver in Amazon RDS aus. Wählen Sie unter **Konnektivität und Sicherheit** die VPC-Sicherheitsgruppe für den Datenbankserver aus. Diese Sicherheitsgruppe wurde zuvor für Sie erstellt und sollte eine Beschreibung haben, die der Beschreibung **unter Erstellt von der RDS-Managementkonsole** ähnelt. Wählen Sie **Aktion > Regeln für eingehenden Datenverkehr bearbeiten**, wählen Sie **Regel hinzufügen** und erstellen Sie eine Regel vom Typ **PostgreSQL**. Verwenden Sie als Regelquelle den **Standard** für die Sicherheitsgruppe. Sie können damit beginnen, den Quellnamen in das Feld **Quelle** einzugeben und dann die vorgeschlagene ID zu akzeptieren. Wählen Sie abschließend **Regeln speichern** aus.
## Schritt 2: Greifen Sie auf die Umgebung zu
In diesem Schritt greifen Sie unter WorkSpaces Applications auf die Entwicklungsumgebung AWS Transform for Mainframe zu.
1. Erkundigen Sie sich bei Ihrem Administrator nach der richtigen Methode für den Zugriff auf Ihre WorkSpaces Applications-Instance. Allgemeine Informationen zu möglichen Clients und Konfigurationen finden Sie unter [WorkSpaces Applications Access Methods and Clients](https://docs.aws.amazon.com/appstream2/latest/developerguide/clients-access-methods-user.html) im *Amazon WorkSpaces Applications Administration Guide*. Ziehen Sie in Betracht, den nativen Client zu verwenden, um die beste Benutzererfahrung zu erzielen.
1. Wählen Sie unter WorkSpaces Anwendungen die Option **Desktop** aus.
## Schritt 3: Richten Sie die Laufzeit ein
In diesem Schritt richten Sie AWS Transform for Mainframe Runtime ein. Sie müssen die Runtime beim ersten Start und erneut einrichten, wenn Sie über ein Runtime-Upgrade informiert werden. Durch diesen Schritt wird Ihr `.m2` Ordner aufgefüllt.
1. Wählen Sie in der Menüleiste **Anwendungen** und dann **Terminal** aus.
1. Geben Sie den folgenden Befehl ein:
```
~/_install-velocity-runtime.sh
```
## Schritt 4: Starten Sie die Eclipse-IDE
In diesem Schritt starten Sie die Eclipse-IDE und wählen einen Speicherort aus, an dem Sie einen Workspace erstellen möchten.
1. Wählen Sie unter WorkSpaces Anwendungen das Symbol „Anwendung starten“ in der Werkzeugleiste und wählen Sie dann **Eclipse JEE**.
![\[Symbol „Anwendung starten“ in der Werkzeugleiste unter „ WorkSpaces Anwendungen“. Eclipse JEE ist ausgewählt.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/aas-ba-eclipse.png)
1. Wenn der Launcher geöffnet wird, geben Sie den Ort ein, an dem Sie Ihren Workspace erstellen möchten, und wählen Sie **Launch**.
![\[AWS Transform for mainframeEclipse IDE-Launcher WorkSpaces unter Anwendungen. Workspace ist ausgewählt.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ba-eclipse-launcher.png)
Optional können Sie Eclipse wie folgt von der Befehlszeile aus starten:
```
~/eclipse &
```
## Schritt 5: Richten Sie ein Maven-Projekt ein
In diesem Schritt importieren Sie ein Maven-Projekt für die Planets-Demo-Anwendung.
1. Laden Sie [PlanetsDemo-pom.zip](https://d3lkpej5ajcpac.cloudfront.net/appstream/bluage/developer-ide/PlanetsDemo/PlanetsDemo-pom.zip) in Ihren Home-Ordner hoch. Sie können dazu die native Client-Funktion „Meine Dateien“ verwenden.
1. Verwenden Sie das `unzip` Befehlszeilentool, um die Dateien zu extrahieren.
1. Navigieren Sie in den entpackten Ordner und öffnen Sie das Stammverzeichnis `pom.xml` Ihres Projekts in einem Texteditor.
1. Bearbeiten Sie die `gapwalk.version` Eigenschaft so, dass sie der installierten AWS Transform for Mainframe-Laufzeit entspricht.
Wenn Sie sich nicht sicher sind, welche Version installiert ist, geben Sie den folgenden Befehl in einem Terminal ein:
```
cat ~/runtime-version.txt
```
Dieser Befehl druckt die aktuell verfügbare Runtime-Version, zum Beispiel`3.1.0-b3257-dev`.
**Anmerkung**
Fügen Sie das `-dev` Suffix nicht in `gapwalk.version` ein. Ein gültiger Wert wäre `3.1.0-b3257` beispielsweise.
1. Wählen Sie in Eclipse „**Datei**“ und dann **„Importieren“**. Erweitern **Sie im Dialogfenster Import** die Option **Maven und wählen Sie Existing Maven** **Projects** aus. Wählen Sie **Weiter** aus.
1. **Geben **Sie unter Maven-Projekte importieren** den Speicherort der extrahierten Dateien an und wählen Sie Fertig stellen.**
Sie können das folgende Popup getrost ignorieren. Maven lädt eine lokale Kopie von herunter`node.js`, um den Angular-Teil (\$1-Web) des Projekts zu erstellen:
![\[Warnmeldung über das Fehlen von node.js.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ba-eclipse-node-warning.png)
Warte bis zum Ende des Builds. Sie können den Build in der **Fortschrittsansicht verfolgen**.
1. Wählen Sie in Eclipse das Projekt aus und wählen Sie **Ausführen als**. Wählen Sie dann **Maven install**. Nachdem die Maven-Installation erfolgreich war, erstellt sie die `war` Datei unter. `PlanetsDemoPom/PlanetsDemo-web/target/PlanetsDemo-web-1.0.0.war`
## Schritt 6: Konfigurieren Sie einen Tomcat-Server
In diesem Schritt konfigurieren Sie einen Tomcat-Server, auf dem Sie Ihre kompilierte Anwendung bereitstellen und starten.
1. Wählen Sie in Eclipse „**Fenster“ > „Ansicht anzeigen“ > „Server**“, um die **Serveransicht** anzuzeigen:
![\[AWS Transformieren Sie für Mainframe Eclipse mit ausgewählter Serveransicht.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ba-eclipse-servers.png)
1. Wählen Sie **Keine Server sind verfügbar. Klicken Sie auf diesen Link, um einen neuen Server zu erstellen...** . Der Assistent für **neue Server** wird angezeigt. **Geben **Sie im Feld Servertyp auswählen** des Assistenten **tomcat v9 ein und wählen Sie Tomcat v9.0** Server aus.** Klicken Sie anschließend auf **Weiter**.
![\[Das Dialogfeld „Neuer Server“. Tomcat v9.0 Server ist ausgewählt.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ba-eclipse-new-server.png)
1. Wählen Sie **Durchsuchen** und wählen Sie den **Tomcat-Ordner** im Stammverzeichnis des Home-Ordners aus. **Behalten Sie für JRE den Standardwert bei und wählen Sie „Fertig stellen“.**
**Ein **Serverprojekt** wird im Workspace erstellt, und ein Tomcat v9.0-Server ist jetzt in der Serveransicht verfügbar.** Hier wird die kompilierte Anwendung bereitgestellt und gestartet:
![\[AWS Registerkarte „Transformation für Eclipse-Mainframe-Server“, auf der der neue Tomcat-Server aufgeführt ist.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ba-eclipse-server-added.png)
## Schritt 7: Auf Tomcat bereitstellen
In diesem Schritt stellen Sie die Planets-Demo-Anwendung auf dem Tomcat-Server bereit, damit Sie die Anwendung ausführen können.
1. Wählen Sie die `PlanetsDemo-web` Datei aus und wählen Sie „**Ausführen als“ > „Maven-Installation**“. Wählen Sie `PlanetsDemo-web` erneut und wählen Sie **Refresh**, um sicherzustellen, dass das npm-kompilierte Frontend ordnungsgemäß in die Datei .war kompiliert wurde und von Eclipse erkannt wird.
1. Laden Sie die [PlanetsDemoDatei -runtime.zip](https://d3lkpej5ajcpac.cloudfront.net/appstream/bluage/developer-ide/PlanetsDemo/PlanetsDemo-runtime.zip) in die Instanz hoch und entpacken Sie die Datei an einem Ort, auf den Sie zugreifen können. Dadurch wird sichergestellt, dass die Demo-Anwendung auf die benötigten Konfigurationsordner und -dateien zugreifen kann.
1. Kopieren Sie den Inhalt von `PlanetsDemo-runtime/tomcat-config` in den `Servers/Tomcat v9.0...` Unterordner, den Sie für Ihren Tomcat-Server erstellt haben:
![\[AWS Transformieren Sie den Unterordner Eclipse Tomcat v9.0 für Mainframe und die darin enthaltenen Dateien.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ba-eclipse-tomcat-subfolder.png)
1. Öffnen Sie den `tomcat v9.0` Servereintrag in der Serveransicht. Der Servereigenschaften-Editor wird angezeigt:
![\[Der Servereigenschaften-Editor. Die Registerkarte „Übersicht“ ist ausgewählt.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ba-eclipse-server-properties-editor.png)
1. Erhöhen Sie auf der Registerkarte „**Übersicht**“ die **Timeout-Werte** auf 450 Sekunden für Start und 150 Sekunden für Stopp, wie hier gezeigt:
![\[Der Wert für das Start-Timeout ist auf 450 Sekunden eingestellt. Der Wert für das Stopp-Timeout ist auf 150 Sekunden eingestellt.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ba-eclipse-timeout-values.png)
1. Wählen Sie **Startkonfiguration öffnen**. Ein Assistent wird angezeigt. Navigieren Sie im Assistenten zum Ordner **Arguments** und wählen Sie unter **Arbeitsverzeichnis** die Option **Andere** aus. Wählen Sie **Dateisystem** und navigieren Sie zu dem `PlanetsDemo-runtime` Ordner, den Sie zuvor entpackt haben. **Dieser Ordner sollte einen direkten Unterordner namens config enthalten.**
![\[Das Dialogfeld „Konfigurationen bearbeiten“ mit dem im Feld „Andere“ angegebenen Arbeitsverzeichnis.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ba-eclipse-edit-configuration.png)
1. Wählen Sie im Servereigenschaften-Editor die Registerkarte **Module** und nehmen Sie die folgenden Änderungen vor:
+ Wählen Sie „**Web-Modul hinzufügen**“ und „Hinzufügen`PlanetsDemo-service`“.
+ Wählen Sie **Externes Web-Modul hinzufügen**. Das Dialogfenster **Web-Modul hinzufügen** wird angezeigt. Nehmen Sie die folgenden Änderungen vor:
+ Wählen Sie in **Document Base** die Option **Durchsuchen** und navigieren Sie zu `~/webapps/gapwalk-application...war`
+ Geben Sie im Feld **Pfad** den Wert ein`/gapwalk-application`.
+ Wählen Sie OK aus.
+ Wählen Sie erneut **Externes Web-Modul hinzufügen** und nehmen Sie die folgenden Änderungen vor:
+ Geben Sie für **Document Base** den Pfad zum Frontend .war (in) ein `PlanetsDemo-web/target`
+ Geben Sie für **Pfad Folgendes** ein `/demo`
+ Klicken Sie auf OK
+ Speichern Sie die Editor-Änderungen (Strg \$1 S).
Der Inhalt des Editors sollte jetzt dem Folgenden ähneln.
![\[Die Registerkarte Web-Module für die Tomcat-Servereigenschaften mit den aufgelisteten Modulen.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ba-eclipse-web-modules.png)
## Schritt 8: Erstellen Sie die JICS-Datenbank
In diesem Schritt stellen Sie eine Verbindung zu der Datenbank her, in [Schritt 1: Erstellen einer Datenbank](#tutorial-ba-developer-create-db) der Sie erstellt haben.
1. Geben Sie in der WorkSpaces Anwendungsinstanz den folgenden Befehl in einem Terminal ein, um ihn zu starten`pgAdmin`:
```
./pgadmin-start.sh
```
1. Wählen Sie eine E-Mail-Adresse und ein Passwort als Login-Identifikatoren. Notieren Sie sich die angegebene URL (normalerweise http://127.0.0.1:5050). Starten Sie Google Chrome in der Instanz, kopieren Sie die URL, fügen Sie sie in den Browser ein und melden Sie sich mit Ihren Identifikatoren an.
![\[Das pgAdmin-Anmeldedialogfeld.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ba-pgadmin-login.png)
1. Nachdem Sie sich angemeldet haben, wählen Sie **Neuen Server hinzufügen** und geben Sie die Verbindungsinformationen zur zuvor erstellten Datenbank wie folgt ein.
![\[Das pgAdmin-Dialogfeld Server registrieren. Die Registerkarte Verbindung ist ausgewählt.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ba-pgadmin-register-server.png)
1. Wenn Sie eine Verbindung zum Datenbankserver herstellen, verwenden Sie **Objekt > Erstellen > Datenbank** und erstellen Sie eine neue Datenbank mit dem Namen **jics**.
1. Bearbeiten Sie die Datenbankverbindungsinformationen, die die Demo-App verwendet hat. Diese Informationen sind in definiert`PlanetsDemo-runtime/config/application-main.yml`. Suchen Sie nach dem `jicsDs` Eintrag. Um die Werte für abzurufen `username` und `password` in der Amazon RDS-Konsole zu der Datenbank zu navigieren. Wählen Sie auf der Registerkarte **Configuration** (Konfiguration) unter **Master Credentials ARN** (Master-Anmeldeinformationen-ARN) die Option **Manage in Secrets Manager** (In Secrets Manager verwalten) aus. Wählen Sie dann in der Secrets Manager Manager-Konsole im Secret die Option **Retrieve Secret Value** aus.
## Schritt 9: Starten und testen Sie die Anwendung
In diesem Schritt starten Sie den Tomcat-Server und die Demo-Anwendung, damit Sie sie testen können.
1. **Um den Tomcat-Server und die zuvor bereitgestellten Anwendungen zu starten, wählen Sie den Servereintrag in der Serveransicht aus und wählen Sie Start.** Eine Konsole wird angezeigt, in der Startprotokolle angezeigt werden.
1. Überprüfen Sie den Serverstatus in der **Serveransicht**, oder warten Sie auf die Meldung **Serverstart in [xxx] Millisekunden** in der Konsole. Überprüfen Sie nach dem Start des Servers, ob die Gapwalk-Anwendung ordnungsgemäß bereitgestellt wurde. Greifen Sie dazu in einem Google Chrome-Browser auf die URL **http://localhost:8080/gapwalk-application** zu. Sie sollten Folgendes sehen.
![\[Bestätigungsnachricht, die anzeigt, dass die Jics-Anwendung läuft.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ba-jics-run-confirm.png)
1. Greifen Sie über Google Chrome unter http://localhost:8080/demo auf das bereitgestellte Anwendungs-Frontend zu. Die folgende **Transaction Launcher-Seite** sollte angezeigt werden.
![\[Die Seite zum Starten von JICS-Transaktionen.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ba-jics-launcher.png)
1. Um die Anwendungstransaktion zu starten, geben Sie den `PINQ` Text in das Eingabefeld ein und wählen Sie **Ausführen** (oder drücken Sie die Eingabetaste).
Der Bildschirm der Demo-App sollte erscheinen.
![\[Der PlanetsDemo Anwendungsbildschirm im Einfügemodus.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ba-demo-app-screen.png)
1. Geben Sie einen Planetennamen in das entsprechende Feld ein und drücken Sie die Eingabetaste.
![\[Der PlanetsDemo Anwendungsbildschirm mit der Eingabe der Erde in das Feld Planetenname.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ba-demo-with-data.png)
## Schritt 10: Debuggen Sie die Anwendung
In diesem Schritt testen Sie mit den standardmäßigen Eclipse-Debugging-Funktionen. Diese Funktionen sind verfügbar, wenn Sie an einer modernisierten Anwendung arbeiten.
1. Um die Hauptdienstklasse zu öffnen, drücken Sie Strg \$1 Shift \$1 T. Drücken Sie dann die Eingabetaste. `PlanetsinqProcessImpl`
![\[Das Eclipse Open Type-Dialogfenster mit PlanetsinqProcessImpl eingegebener Eingabe.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ba-eclipse-open-type.png)
1. Navigieren Sie zu der `searchPlanet` Methode und fügen Sie dort einen Breakpoint ein.
1. Wählen Sie den Servernamen aus und wählen Sie **In Debug neu starten** aus.
1. Wiederholen Sie die vorherigen Schritte. Rufen Sie also die Anwendung auf, geben Sie einen Planetennamen ein und drücken Sie die Eingabetaste.
Eclipse stoppt die Anwendung in der `searchPlanet` Methode. Jetzt kannst du es untersuchen.
## 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 zusätzlichen Kosten entstehen. Führen Sie folgende Schritte aus:
+ Wenn die Planets-Anwendung noch läuft, beenden Sie sie.
+ Löschen Sie die Datenbank, in der Sie erstellt haben[Schritt 1: Erstellen einer Datenbank](#tutorial-ba-developer-create-db). Weitere Informationen finden Sie unter [Löschen einer DB-Instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteInstance.html).