Modernisieren und implementieren Sie Mainframe-Anwendungen mithilfe von Terraform AWS Transform

Geben Sie den folgenden Befehl ein, um das CardDemoRepository auf Ihre lokale Workstation zu klonen:

git clone https://github.com/aws-samples/aws-mainframe-modernization-carddemo.git

Komprimieren Sie den aws-mainframe-modernization-carddemo Ordner in eine ZIP-Datei.

Laden Sie die ZIP-Datei in den Amazon S3 S3-Bucket hoch, den Sie erstellt haben. Anweisungen finden Sie unter Objekte hochladen in der Amazon S3 S3-Dokumentation.

Greifen Sie auf die AWS Transform Webanwendung zu, indem Sie sich mit Ihren Anmeldeinformationen anmelden.

Erstellen Sie einen neuen Workspace, indem Sie den Anweisungen unter Workspace einrichten in der AWS Transform Dokumentation folgen.

Wähle auf deiner Workspace-Landingpage die Option Frage, ob du einen Job erstellen AWS Transform möchtest.

Wählen Sie als Nächstes Mainframe-Modernisierung als Auftragstyp aus.

Geben Sie im Chat-Fenster Transform Code to Java ein.

Prüfen Sie den vorgeschlagenen Jobtyp, den Namen und das Ziel. Geben Sie zur Bestätigung Ja ein.

Wählen Sie Job erstellen aus.  

Richten Sie einen Connector mit dem Amazon S3 S3-Bucket ein, den Sie erstellt haben. Anweisungen finden Sie in der AWS Transform Dokumentation unter Einen Connector einrichten. Wenn Sie dazu aufgefordert werden, geben Sie den Pfad für die aws-mainframe-modernization-carddemo ZIP-Datei im Amazon S3 S3-Bucket ein.

Warten Sie, bis die Analyse abgeschlossen ist.

Überprüfen Sie die Ergebnisse der Codeanalyse gemäß den Anweisungen unter Code analysieren in der AWS Transform Dokumentation.

Refaktorieren Sie den Mainframe-Code gemäß den Anweisungen unter Code umgestalten in der Dokumentation. AWS Transform Für die CardDemo Mainframe-Beispielanwendung können Sie die Standardeinstellungen akzeptieren.

Warten Sie, bis das Refactoring abgeschlossen ist.

Wählen Sie Ergebnisse anzeigen, um den Pfad für den umgestalteten Code im Amazon S3 S3-Bucket zu sehen. Notieren Sie sich diesen Dateipfad. Sie benötigen diese zu einem späteren Zeitpunkt.

Geben Sie den folgenden Befehl ein, um das Mainframe Transformation E2E-Repository auf Ihre lokale Workstation zu klonen:

git clone https://github.com/aws-samples/sample-mainframe-transformation-e2e.git

Geben Sie den folgenden Befehl ein, um Ihre aktuelle öffentliche IP-Adresse abzurufen:

curl checkip.amazonaws.com

Geben Sie den folgenden Befehl ein, um zum Infra-Verzeichnis zu navigieren:

cd mainframe-transformation-e2e/infra

Öffnen Sie die variables.tf Datei.

YOUR_IP_ADDRESS_HEREErsetzen Sie es durch Ihre IP-Adresse.

Wenn Sie eine öffentlich gehostete Zone haben, gehen Sie wie folgt vor:

Wenn Sie keine öffentlich gehostete Zone haben, gehen Sie wie folgt vor:

Wechseln aws_region Sie zur Zielregion. Der Standardwert ist us-east-1.

Speichern und schließen Sie die Datei variables.tf.

Geben Sie den folgenden Befehl ein, um Terraform zu initialisieren:

terraform init

Geben Sie den folgenden Befehl ein, um einen Ausführungsplan zu generieren:

terraform plan

Überprüfen Sie den Plan und validieren Sie die Ressourcen und Infrastrukturkomponenten, die erstellt werden sollen.

Geben Sie den folgenden Befehl ein, um die Infrastruktur bereitzustellen:

terraform apply

Wenn Sie dazu aufgefordert werden, geben Sie Ja ein, um die Bereitstellung zu bestätigen.

Warten Sie, bis die Bereitstellung abgeschlossen ist.

Connect zu Ihrer EC2 Amazon-Instance her, indem Sie AWS Systems Manager Session Manager

Geben Sie den folgenden Befehl ein, um zum Root-Benutzer zu wechseln:

sudo su -

Geben Sie den folgenden Befehl ein, um zum Verzeichnis scripts zu navigieren:

cd /opt/scripts

Überprüfen Sie das Skript install_software.sh. Dieses Skript installiert Java 17, Apache Maven und Apache Tomcat 10.0.23.

Aktualisieren Sie die Skripts nach Bedarf für Ihren Anwendungsfall.

Geben Sie den folgenden Befehl ein, um das Skript ausführbar zu machen:

chmod +x install_software.sh

Geben Sie den folgenden Befehl ein, um das Skript auszuführen:

./install_software.sh

Geben Sie den folgenden Befehl ein, um den Tomcat-Server zu starten:

/opt/tomcat/apache-tomcat-10.0.23/bin/startup.sh

Geben Sie den folgenden Befehl ein, um die Antwort des Webservers zu überprüfen:

curl http://localhost:8080

Die Ausgabe sollte bestätigen, dass Tomcat eine HTML-Seite bereitstellt.

Geben Sie den folgenden Befehl ein, um das Skript download_and_extract.sh ausführbar zu machen. Dieses Skript lädt den umgestalteten Code und die Gapwalk-Laufzeitbibliothek herunter, die im Amazon S3 S3-Bucket gespeichert sind:

chmod +x /opt/scripts/download_and_extract.sh

Geben Sie den folgenden Befehl ein, um das -Skript auszuführen. <file_path>Ersetzen Sie durch den Pfad zur Datei generated.zip in Ihrem Amazon S3 S3-Bucket:

./download_and_extract.sh <file_path>

Geben Sie den folgenden Befehl ein, um in den shared Ordner zu navigieren:

cd /opt/runtime/velocity/shared

Geben Sie den folgenden Befehl ein, um deploy-velocity-runtimedas.sh-Skript zu kopieren:

cp /opt/scripts/deploy-velocity-runtime.sh .

Geben Sie den folgenden Befehl ein, um das kopierte Skript ausführbar zu machen:

chmod +x deploy-velocity-runtime.sh

Geben Sie den folgenden Befehl ein, um das -Skript auszuführen. Dieses Skript kopiert alle erforderlichen Abhängigkeiten des Web Application Archive (WAR), die in den POM-Dateien (Project Object Model) vorhanden sind, in den Repository-Ordner:

./deploy-velocity-runtime.sh

Überprüfen Sie die erfolgreiche Ausführung, indem Sie überprüfen, ob keine Fehler vorliegen und ob die erforderlichen WAR-Abhängigkeiten in Ihrem lokalen Maven-Repository installiert sind.

Geben Sie den folgenden Befehl ein, um zum app-pom Projektverzeichnis zu navigieren:

cd /opt/codebase/app-pom/

Geben Sie den folgenden Befehl ein, um Maven zu installieren:

mvn clean install

Warten Sie, bis die Installation und der Build abgeschlossen sind.

Bestätigen Sie nach erfolgreichem Abschluss des Builds das Vorhandensein von app-service/target/app-service-1.0.0.war undapp-web/target/app-web-1.0.0.war.

Geben Sie den folgenden Befehl ein, um den csd commands Ordner umzubenennen. csd_commands Dadurch werden die Leerzeichen aus dem Ordnernamen entfernt:

mv /opt/codebase/extra/csd\ commands/ /opt/codebase/extra/csd_commands

Geben Sie den folgenden Befehl ein, um in das scripts Verzeichnis zu navigieren:

cd /opt/scripts

Geben Sie den folgenden Befehl ein, um das Datenbankmigrationsskript ausführbar zu machen:

chmod +x database_migration_setup.sh

Geben Sie die folgenden Befehle ein, um die folgenden Variablen als Parameter zu konfigurieren:

RDS_ENDPOINT=<database_endpoint>
SECRET_NAME=<secret_name>
JICS_SQL_SCRIPT_DIR=/opt/runtime/velocity/jics/sql/jics.sql
INIT_JICS_SQL_SCRIPT_DIR=/opt/codebase/extra/csd_commands/sql/aws-mainframe-modernization-carddemo-main/app/csd/initJics.sql

Wobei gilt:

Geben Sie den folgenden Befehl ein, um das Datenbankmigrationsskript auszuführen:

./database_migration_setup.sh $RDS_ENDPOINT $SECRET_NAME $JICS_SQL_SCRIPT_DIR $INIT_JICS_SQL_SCRIPT_DIR

Geben Sie den folgenden Befehl ein, um von Ihrer EC2 Amazon-Instance aus eine Verbindung zur Datenbank herzustellen:

psql -h <Your Amazon RDS Endpoint> -U foo -p 5432 postgres

Wenn Sie dazu aufgefordert werden, geben Sie Ihre Datenbankanmeldedaten ein.

Geben Sie den folgenden Befehl ein, um alle Datenbanken anzuzeigen:

\l

Geben Sie den folgenden Befehl ein, um zur jics Datenbank zu wechseln:

\c jics

Geben Sie den folgenden Befehl ein, um eine Liste der erstellten Tabellen zu überprüfen:

\dt

Geben Sie den folgenden Befehl ein, um das Skript execute_listcat_sql.sh ausführbar zu machen:

chmod +x execute_listcat_sql.sh

Geben Sie den folgenden Befehl ein, um die PATH_TO_LISTCAT_SQL_FILES Variable zu konfigurieren. Dabei handelt es sich um das Verzeichnis, das Ihre LISTCAT-SQL-Dateien enthält:

PATH_TO_LISTCAT_SQL_FILES=/opt/codebase/extra/listcat/sql/cluster/aws-mainframe-modernization-carddemo-main/app/catlg

Stellen Sie sicherRDS_ENDPOINT, dass die PATH_TO_LISTCAT_SQL_FILES VariablenSECRET_NAME, und gemäß den vorherigen Anweisungen richtig gesetzt sind.

Geben Sie den folgenden Befehl ein, um das Skript execute_listcat_sql.sh auszuführen:

./execute_listcat_sql.sh $RDS_ENDPOINT $SECRET_NAME $PATH_TO_LISTCAT_SQL_FILES

Dieses Skript aktualisiert die Eigenschaften der VSAM-Datei in der JICS-Datenbank und führt die erforderlichen Abfragen aus, um die Datenbank zu ändern.

Geben Sie den folgenden Befehl ein, um das Skript application_installer.sh ausführbar zu machen:

chmod +x /opt/scripts/application_installer.sh

Geben Sie die folgenden Befehle ein, um die folgenden Variablen als Parameter zu konfigurieren:

RDS_ENDPOINT=<database_endpoint>
SECRET_NAME=<secret_name>
AIX_JSON_FILE_PATH=/opt/codebase/extra/csd_commands/json/aws-mainframe-modernization-carddemo-main/jicsFileAix.json
LISTCAT_JSON_FILES_DIR=/opt/codebase/extra/listcat/json/cluster/default/aws-mainframe-modernization-carddemo-main/app/catlg
S3_PATH_FOR_EBCDIC_DATA_FILES=s3://<bucket_name>/transform-output/<job_id>/inputs/aws-mainframe-modernization-carddemo-main/app/data/EBCDIC

Wobei gilt:

Geben Sie den folgenden Befehl ein, um das Skript application_installer.sh auszuführen:

./application_installer.sh $RDS_ENDPOINT $SECRET_NAME $AIX_JSON_FILE_PATH $LISTCAT_JSON_FILES_DIR $S3_PATH_FOR_EBCDIC_DATA_FILES

Ändern /opt/tomcat/apache-tomcat-10.0.23/workingdir/config Sie im Ordner in der application-utility-pgmYML-Datei den Kodierungsparameter wie folgt:

encoding : CP1047

Geben Sie den folgenden Befehl ein, um in das Arbeitsverzeichnis zu navigieren:

cd /opt/tomcat/apache-tomcat-10.0.23/workingdir

Geben Sie die folgenden Befehle ein, um den Tomcat-Server zu beenden und zu starten:

/opt/tomcat/apache-tomcat-10.0.23/bin/shutdown.sh
/opt/tomcat/apache-tomcat-10.0.23/bin/startup.sh

Geben Sie den folgenden Befehl ein, um die Startprotokolle des Tomcat-Dienstes zu überwachen:

tail -f /opt/tomcat/apache-tomcat-10.0.23/logs/catalina.out

Öffnen Sie die EC2 Amazon-Konsole.

Klicken Sie im Navigationsbereich auf Load balancers (Load Balancer).

Wählen Sie den Load Balancer aus, der über Terraform erstellt wurde.

Suchen Sie den DNS-Namen (Domain Name System) Ihres Application Load Balancer, z. B. application-load-balancer-<id>.<region>.elb.amazonaws.com

Navigieren Sie in Ihrem Browser zuhttp://<dns_name>/gapwalk-application/scripts/data-load, wo <dns_name> sich der DSN-Name des Application Load Balancer befindet. Dadurch wird das Datenladeskript gestartet.

Warten Sie, bis das Skript abgeschlossen ist. Wenn Sie fertig sind, zeigt der Browser FERTIG an.

Öffnen Sie auf der EC2 Amazon-Instance ein neues Terminal.

Geben Sie den folgenden Befehl ein, um eine Verbindung zur Amazon RDS-Datenbank herzustellen, und <database_endpoint> ersetzen Sie ihn durch Ihren Wert:

psql -h <database_endpoint> -U foo -p 5432 postgres

Wenn Sie dazu aufgefordert werden, geben Sie Ihre Anmeldeinformationen ein, um eine Verbindung zur Datenbank herzustellen.

Geben Sie den folgenden Befehl ein, um alle Datenbanken anzuzeigen:

\l

Geben Sie den folgenden Befehl ein, um zur bluesam Datenbank zu wechseln:

\c bluesam

Geben Sie den folgenden Befehl ein, um eine Liste der erstellten Tabellen zu überprüfen:

\dt

Geben Sie den folgenden Befehl ein, um das Laden der Daten zu überprüfen:

SELECT * FROM public.aws_m2_carddemo_usrsec_vsam_ksds;

In der Ausgabe sollten 10 zurückgegebene Datensätze angezeigt werden.

Geben Sie den folgenden Befehl ein, um in das Skriptverzeichnis zu navigieren:

cd /opt/tomcat/apache-tomcat-10.0.23/webapps/workingdir/scripts

Aktualisieren Sie in allen Groovy-Dateien, die Verweise auf Flatfiles enthalten, die folgenden Dateikonfigurationen:

Als Referenz sehen Sie sich das Beispielskript dusrsecj.jcl.Groovy im Code-Repository an.

Speichern und schließen Sie die Dateien.

Greifen Sie über den Application Load Balancer (http://<your-load-balancer-dns>) oder über die gehostete Zone (https://myhostedzone.dev/) auf die Online-Anwendung zu.

Geben CC00 Sie für die Transaktions-ID ein.

Geben Sie für den Benutzernamen einUSER0001.

Geben Sie für das Passwort einPASSWORD.

Nach erfolgreicher Anmeldung wird das Hauptmenü angezeigt.

Greifen Sie entweder über den Application Load Balancer (http://<your-load-balancer-dns>/gapwalk-application/scripts) oder über die gehostete Zone (https://myhostedzone.dev/gapwalk-application/scripts) auf die Skriptschnittstelle zu.

Wählen Sie ein auszuführendes Skript aus, z. B. das Skript dusrsecj.jcl.Groovy.

Stellen Sie sicher, dass das Skript erfolgreich ausgeführt wird. Im Folgenden finden Sie eine Beispielausgabe nach erfolgreicher Ausführung.

{ "exitCode": 0, "stepName": "STEP03", "program": "IDCAMS", "status": "Succeeded" }

Geben Sie den folgenden Befehl ein, um den Löschschutz von der Amazon RDS-Instance zu entfernen:

aws rds modify-db-instance \
  --db-instance-identifier <your-db-instance-name> \
  --no-deletion-protection \
  --apply-immediately

Geben Sie den folgenden Befehl ein, um den Löschschutz aus dem Application Load Balancer zu entfernen:

aws elbv2 modify-load-balancer-attributes \
  --load-balancer-arn <your-load-balancer-arn> \
  --attributes Key=deletion_protection.enabled,Value=false

Geben Sie die folgenden Befehle ein, um den Inhalt der Amazon S3 S3-Buckets zu löschen:

ACCOUNT_NUMBER=$(aws sts get-caller-identity --query Account --output text)
aws s3 rm s3://mf-carddemo-$ACCOUNT_NUMBER --recursive
aws s3 rm s3://mf-carddemo-logs-$ACCOUNT_NUMBER --recursive

Geben Sie den folgenden Befehl ein, um in den infra Ordner zu navigieren:

cd /mainframe-transformation-e2e/infra

Geben Sie den folgenden Befehl ein, um die Infrastruktur zu löschen:

terraform destroy --auto-approve