Tutorial: Wiederholung und Vergleich von Anwendungstests CardDemo für die AWS Mainframe-Modernisierung mithilfe von AWS Blu Age, bereitgestellt auf Amazon EC2 - AWS Mainframe-Modernisierung
Schritt 1: Besorgen Sie sich AWS Blu Age EC2 Amazon Amazon Machine Image (AMI)Schritt 2: Starten Sie eine EC2 Amazon-Instance mit dem AWS Blu Age AMISchritt 3: Laden Sie CardDemo abhängige Dateien auf S3 hochSchritt 4: Datenbanken laden und die Anwendung initialisieren CardDemoSchritt 5: Starten Sie AWS Blu Age Runtime CloudFormationSchritt 6: Testen der AWS Blu Age EC2 Amazon-InstanzSchritt 7: Stellen Sie sicher, dass die vorherigen Schritte korrekt abgeschlossen wurdenSchritt 8: Erstellen Sie den TestfallSchritt 9: Erstellen Sie eine TestsuiteSchritt 10: Erstellen Sie eine TestumgebungskonfigurationSchritt 11: Laden Sie Ihre Eingabedaten in die Testsuite hochSchritt 12: Wiedergeben und vergleichen

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: Wiederholung und Vergleich von Anwendungstests CardDemo für die AWS Mainframe-Modernisierung mithilfe von AWS Blu Age, bereitgestellt auf Amazon EC2

In diesem Tutorial führen Sie die erforderlichen Schritte aus, um Test-Workloads mit der auf Amazon bereitgestellten CardDemo Anwendung abzuspielen und zu vergleichen, die auf AWS Blu Age ausgeführt wird. EC2

Schritt 1: Besorgen Sie sich AWS Blu Age EC2 Amazon Amazon Machine Image (AMI)

Folgen Sie den Anweisungen im Setup-Tutorial für AWS Blu Age Runtime (bei AmazonEC2) für die Onboarding-Schritte, die für den Zugriff auf AWS Blu Age bei Amazon EC2 AMI erforderlich sind.

Schritt 2: Starten Sie eine EC2 Amazon-Instance mit dem AWS Blu Age AMI

  1. Richten Sie Ihre AWS Anmeldedaten ein.

  2. Identifizieren Sie den Speicherort der EC2 AMI Amazon-Binärdatei 3.5.0 (CLI AWS nur/Blu Age-Version) aus dem Amazon S3-Bucket:

    aws s3 ls s3://aws-bluage-runtime-artifacts-xxxxxxx-eu-west-1/
aws s3 ls s3://aws-bluage-runtime-artifacts-xxxxxxx-eu-west-1/3.5.0/AMI/
    Anmerkung

    Die Funktion für Anwendungstests kann nur in 4 Regionen in Prod verwendet werden (us-east-1, sa-east-1, eu-central-1 und ap-southeast-2).

  3. AMIStellen Sie das in Ihrem Konto mit dem folgenden Befehl wieder her:

    aws ec2 create-restore-image-task --object-key 3.5.0/AMI/ami-0182ffe3b9d63925b.bin --bucket aws-bluage-runtime-artifacts-xxxxxxx-eu-west-1 --region eu-west-1 --name "AWS BLUAGE RUNTIME AMI"
    Anmerkung

    Ersetzen Sie den Namen der AMI Bin-Datei und die Region, in der Sie die erstellen möchtenAMI.

  4. Nachdem Sie eine EC2 Amazon-Instance erstellt haben, finden Sie die richtige AMI ID, die AMI aus dem Amazon S3-Bucket wiederhergestellt wurde, im EC2 Amazon-Image-Katalog.

    Anmerkung

    In diesem Tutorial lautet die AMI ID ami-0d0fafcc636fd1e6d, und Sie müssen diese ID in den verschiedenen Konfigurationsdateien in die ID ändern, die Ihnen zur Verfügung gestellt wurde.

    1. Wenn der aws ec2 create-restore-image-task fehlschlägt, überprüfen Sie Ihre Version von Python und CLI verwenden Sie den folgenden Befehl:

      aws --version
      Anmerkung

      Die Python-Version muss >= 3 und die CLI Version muss >= 2 sein.

    2. Wenn diese Versionen veraltet sind, CLI müssen sie aktualisiert werden. Um das zu aktualisierenCLI:

      1. Folgen Sie den Anweisungen unter Installieren oder aktualisieren Sie die neueste Version von AWS CLI.

      2. Entfernen Sie CLI v1 mit dem folgenden Befehl:

        sudo yum remove awscli

      3. Und installiere CLI v2 mit den folgenden Befehlen:

        curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install

      4. Überprüfen Sie abschließend die Version von Python und CLI mit dem folgenden Befehl:

        aws --version

    3. Sie können dann aws create-restore-image-task ec2 wiederholen.

Schritt 3: Laden Sie CardDemo abhängige Dateien auf S3 hoch

Kopieren Sie den Inhalt der Ordner Datenbanken, Dateisystem und Benutzerdaten. Laden Sie die Anwendungen herunter und entpacken Sie sie. CardDemo Diese drei Ordner müssen in einen Ihrer Buckets mit dem Namen amzn-s3-demo-bucket in dieser Dokumentation kopiert werden.

Schritt 4: Datenbanken laden und die Anwendung initialisieren CardDemo

Erstellen Sie eine temporäre EC2 Amazon-Instance, die Sie als Rechenressource verwenden, um die erforderlichen Datenbank-Snapshots für die CardDemo Anwendung zu generieren. Diese EC2 Instance führt nicht die CardDemo Anwendung selbst aus, sondern generiert stattdessen die Datenbank-Snapshots, die später verwendet werden.

Bearbeiten Sie zunächst die bereitgestellte CloudFormation Vorlage mit dem Namen 'load-and-create-ba-snapshots.yml' Dies ist die CloudFormation Vorlage, die verwendet wird, um die EC2 Amazon-Instance zu erstellen, die zum Generieren der Datenbank-Snapshots verwendet wird.

  1. Generieren Sie Ihr EC2 key pair, das für die EC2 Instanz verwendet wird, und geben Sie es an. Weitere Informationen finden Sie unter Schlüsselpaare erstellen.

    Beispiel:

    Ec2KeyPair:
    Description: 'ec2 key pair'
    Default: 'm2-tests-us-west-2'
    Type: String

  2. Geben Sie den Amazon S3 S3-Pfad Ihres Ordners an, in den Sie den Datenbankordner aus dem vorherigen Schritt abgelegt haben:

    S3DBScriptsPath:
    Description: 'S3 DB scripts folder path'
    Type: String
    Default: 's3://amzn-s3-demo-bucket/databases'

  3. Geben Sie den Amazon S3 S3-Pfad Ihres Ordners an, in den Sie den Dateisystemordner aus dem vorherigen Schritt abgelegt haben:

    S3ApplicationFilesPath:
    Description: 'S3 application files folder path'
    Type: String
    Default: 's3://amzn-s3-demo-bucket/file-system'

  4. Geben Sie den Amazon S3 S3-Pfad Ihres Ordners an, in den Sie den Benutzerdatenordner aus dem vorherigen Schritt abgelegt haben:

    S3UserDataPath:
    Description: 'S3 userdata folder path'
    Type: String
    Default: 's3://amzn-s3-demo-bucket/userdata'

  5. Geben Sie auch einen Amazon S3 S3-Pfad an, in dem Sie die Ergebnisdateien speichern, die im nächsten Schritt verwendet werden sollen.

    S3SaveProducedFilesPath:
    Description: 'S3 path folder to save produced files'
    Type: String
    Default: 's3://yamzn-s3-demo-bucket/post-produced-files'

  6. Ändern Sie die AMI ID mithilfe der folgenden Vorlage durch die richtige, die Sie zuvor in diesem Tutorial erhalten haben:

    
  BaaAmiId:
    Description: 'ami id (AL2) for ba anywhere'
    Default: 'ami-0bd41245734fd20d9'
    Type: String

    1. Sie können optional den Namen der drei Snapshots ändern, die beim Ausführen der Ladedatenbanken withCloudFormation erstellt werden. Diese sind während der Erstellung im CloudFormation Stapel sichtbar und werden später in diesem Tutorial verwendet. Denken Sie daran, sich die Namen zu notieren, die für die Datenbank-Snapshots verwendet wurden.

      SnapshotPrimary:
    Description: 'Snapshot Name DB BA Primary'
    Type: String
    Default: 'snapshot-primary'

  SnapshotBluesam:
    Description: 'Snapshot Name DB BA Bluesam'
    Type: String
    Default: 'snapshot-bluesam'

  SnapshotJics:
    Description: 'Snapshot Name DB BA Jics'
    Type: String
    Default: 'snapshot-jics'
      Anmerkung

      In diesem Dokument gehen wir davon aus, dass der Name der Snapshots einheitlich bleibt.

  7. Führen Sie die AWS Konsole CloudFormation mit CLI oder mithilfe der Schaltfläche „Stack erstellen“ und des Assistenten aus. Am Ende des Vorgangs sollten in der RDS Konsole drei Snapshots mit dem von Ihnen ausgewählten Namen gefolgt von einer eindeutigen ID angezeigt werden. Sie benötigen diese Namen im nächsten Schritt.

    Anmerkung

    RDSfügt den in der Vorlage definierten Snapshot-Namen Postfixe hinzu. AWS CloudFormation Stellen Sie sicher, dass Sie den vollständigen Snapshot-Namen von erhalten haben, RDS bevor Sie mit dem nächsten Schritt fortfahren.

    CLIBeispielbefehl-

    aws cloudformation create-stack --stack-name load-and-create-ba-snapshots --template-url https://your-apptest-bucket.s3.us-west-2.amazonaws.com/load-and-create-ba-snapshots.yml --capabilities CAPABILITY_NAMED_IAM

    Sie können auch im Amazon S3 S3-Pfad, den Sie für S3 angegeben habenSaveProducedFilesPath, überprüfen, ob die Datensätze korrekt erstellt wurden.

Schritt 5: Starten Sie AWS Blu Age Runtime CloudFormation

Wird verwendet CloudFormation , um die EC2 Amazon-Instance mit der CardDemo AWS Blu Age-Anwendung auszuführen. Sie müssen einige Variablen im CloudFormation Namen ersetzen, m2-with-ba-using-snapshots-https-authentication.yml indem Sie die YAML Datei bearbeiten oder die Werte in der Konsole beim Start von ändernCFN.

  1. Ändern Sie denAllowedVpcEndpointPrincipals, um anzugeben, welches Konto den VPC Endpunkt für den Zugriff auf die AWS Blu Age-Laufzeit erreicht. Verwenden Sie dazu die folgenden Befehle:

    AllowedVpcEndpointPrincipals:
    Description: 'comma-separated list of IAM users, IAM roles, or AWS accounts'
    Default: 'apptest.amazonaws.com'
    Type: String

  2. Ändern Sie den Wert der Variablen SnapshotPrimaryDb und SnapshotJicsDb in den Namen der Snapshots. SnapshotBlusamDb Rufen Sie auch die Namen der Schnappschüsse ab, RDS nachdem sie im vorherigen Schritt erstellt wurden.

    SnapshotPrimary:
    Description: 'Snapshot DB cluster for DB Primary'
    Type: String
    Default: 'snapshot-primary87d067b0'

  SnapshotBluesam:
    Description: 'Snapshot DB cluster for DB Bluesam'
    Type: String
    Default: 'snapshot-bluesam87d067b0'

  SnapshotJics:
    Description: 'Snapshot DB cluster for DB Jics'
    Type: String
    Default: 'snapshot-jics87d067b0'
    Anmerkung

    RDSfügt den Snapshot-Namen ein eigenes Postfix hinzu.

  3. Geben Sie Ihr EC2 Amazon-Schlüsselpaar für die EC2 Instance mit diesem Befehl an:

    Ec2KeyPair:
    Description: 'ec2 key pair'
    Default: 'm2-tests-us-west-2'
    Type: String

  4. Geben Sie die AMI ID ein, die Sie während des AMI Registrierungsprozesses für die Variable erhalten haben BaaAmiId, und verwenden Sie:

    BaaAmiId:
    Description: 'ami id (AL2) for ba anywhere'
    Default: 'ami-0d0fafcc636fd1e6d'
    Type: String

  5. Geben Sie mit dem folgenden Befehl den Amazon S3 S3-Ordnerpfad an, den Sie im vorherigen Schritt zum Speichern der produzierten Dateien verwendet haben:

    S3ApplicationFilesPath:
    Description: 'bucket name'
    Type: String
    Default: 's3://amzn-s3-demo-bucket/post-produced-files'

  6. Geben Sie abschließend den Ordnerpfad von s3- anuserdata-folder-path:

    S3UserDataPath:
    Description: 'S3 userdata folder path'
    Type: String
    Default: 's3://amzn-s3-demo-bucket/userdata'

    • (Optional) Sie können den HTTPSModus und die HTTPStandardauthentifizierung für Tomcat aktivieren. Obwohl die Standardeinstellungen auch funktionieren würden.

      Anmerkung

      Standardmäßig ist der HTTPS Modus deaktiviert und HTTP im Parameter auf Modus eingestellt BacHttpsMode:

      Beispielsweise:

      BacHttpsMode:
    Description: 'http or https for Blue Age Runtime connection mode '
    Default: 'http'
    Type: String
    AllowedValues: [http, https]

    • (Optional) Um den HTTPS Modus zu aktivieren, müssen Sie den Wert in die Variable ändern HTTPS und Ihr ACM Zertifikat bereitstellen, ARN indem Sie den Wert der Variablen ändern ACMCertArn:

      ACMCertArn:
    Type: String
    Description: 'ACM certificate ARN'
    Default: 'your arn certificate'

    • (Optional) Die Standardauthentifizierung ist standardmäßig deaktiviert und der Parameter ist auf false WithBacBasicAuthenticationgesetzt. Sie können sie aktivieren, indem Sie den Wert auf true setzen.

      WithBacBasicAuthentication:
    Description: 'false or true for Blue Age Runtime Basic Authentication '
    Default: false
    Type: String
    AllowedValues: [true, false]

  7. Wenn Sie die Konfiguration abgeschlossen haben, können Sie den Stack mithilfe der bearbeiteten CloudFormation Vorlage erstellen.

Schritt 6: Testen der AWS Blu Age EC2 Amazon-Instanz

Führen Sie die CloudFormation Vorlage manuell aus, um die AWS Blu Age EC2 Amazon-Instance für die CardDemo Anwendung zu erstellen, um sicherzustellen, dass sie fehlerfrei gestartet wird. Auf diese Weise wird überprüft, ob die CloudFormation Vorlage und alle Voraussetzungen gültig sind, bevor die CloudFormation Vorlage mit der Funktion für Anwendungstests verwendet wird. Anschließend können Sie Application Testing verwenden, um die AWS Blu Age EC2 Amazon-Zielinstanz während der Wiedergabe und des Vergleichs automatisch zu erstellen.

  1. Führen CloudFormation Sie den Befehl create stack aus, um die AWS Blu Age EC2 Amazon-Instance zu erstellen, und geben Sie dabei die CloudFormation Vorlage m2- with-ba-using-snapshots -https-authentication.yml an, die Sie im vorherigen Schritt bearbeitet haben:

    aws cloudformation create-stack --stack-name load-and-create-ba-snapshots —-template-url https://apptest-ba-demo.s3.us-west-2.amazonaws.com/m2-with-ba-using-snapshots-https-authentication.yml --capabilities CAPABILITY_NAMED_IAM --region us-west-2
    Anmerkung

    Denken Sie daran, die richtige Region anzugeben, in der Blu Age wiederhergestellt wurde. AWS AMI

  2. Stellen Sie sicher, dass alles ordnungsgemäß funktioniert, indem Sie in der Konsole nach der laufenden EC2 Amazon-Instance suchen. Stellen Sie mit dem Sitzungsmanager eine Connect.

  3. Nachdem Sie mit der EC2 Amazon-Instance verbunden sind, verwenden Sie die folgenden Befehle:

    sudo su
cd /m2-anywhere/tomcat.gapwalk/velocity/logs
cat catalina.log

  4. Stellen Sie sicher, dass das Protokoll keine Ausnahmen oder Fehler enthält.

  5. Überprüfen Sie als Nächstes, ob die Anwendung reagiert, indem Sie diesen Befehl verwenden:

    curl http://localhost:8080/gapwalk-application/

Sie werden die Meldung „Die Jics-Anwendung läuft“ sehen.

Schritt 7: Stellen Sie sicher, dass die vorherigen Schritte korrekt abgeschlossen wurden

In den nächsten Schritten werden wir AWS Mainframe Modernization Application Testing verwenden, um die von der Anwendung erstellten Datensätze erneut abzuspielen und zu vergleichen. CardDemo Diese Schritte setzen den erfolgreichen Abschluss aller vorherigen Schritte in diesem Tutorial voraus. Überprüfen Sie Folgendes, bevor Sie fortfahren:

  1. Sie haben die AWS Blu Age on EC2 Amazon-Instance erfolgreich über die AWS CloudFormation Vorlage erstellt.

  2. Der Tomcat-Service auf dem AWS Blu Age bei Amazon EC2 ist ausnahmslos in Betrieb.

Wenn Sie die EC2 Instance mit der CardDemo Anwendung zum Laufen gebracht haben, führen Sie die folgenden Schritte in der Application-Testing-Konsole durch, um die Wiedergabe und den Vergleich von Batch-Datensätzen durchzuführen.

Schritt 8: Erstellen Sie den Testfall

In diesem Schritt erstellen Sie den Testfall, der zum Vergleich der in der Card Demo-Anwendung erstellten Datensätze verwendet wird.

  1. Erstellen Sie einen neuen Testfall. Geben Sie ihm einen Namen und eine Beschreibung.

  2. Geben Sie CREASTMT.JCL als JCL Namen an.

  3. Fügen Sie der Testfalldefinition die folgenden Datensätze hinzu:

    Name

    CCSID

    RecordFormat

    RecordLength

    AWS.M2. CARDDEMO. STATEMNT. PS

    „037"

    FB

    80

    AWSM.2. CARDDEMO. STATEMNT. HTML

    „037"

    FB

    100
    Anmerkung

    Ihr JCL Name und die Datensatzdetails müssen übereinstimmen.

Schritt 9: Erstellen Sie eine Testsuite

  1. Erstellen Sie eine neue Testsuite und geben Sie einen Namen und eine Beschreibung dafür ein.

  2. Fügen Sie den Testfall, den Sie im vorherigen Schritt erstellt haben, zu Ihrer Testsuite hinzu.

  3. Sobald die Testsuite erstellt ist, erfassen Sie die Testfälle auf dem Mainframe und laden Sie die Mainframe-Referenzdaten in AWS Application Testing hoch.

  4. Wählen Sie Testsuite erstellen aus.

Schritt 10: Erstellen Sie eine Testumgebungskonfiguration

  1. Erstellen Sie eine neue Testumgebungskonfiguration und geben Sie einen Namen und eine Beschreibung dafür ein.

  2. Fügen Sie Ihre CloudFormation Vorlage hinzu. Sie können auch den Namen und den Wert des Eingabeparameters aus Ihrer CloudFormation Vorlage hinzufügen.

  3. Wählen Sie den AWS Mainframe Modernization Service AWS Blu Age non-managed als Runtime.

  4. Fügen Sie den Namen der Ausgabevariablen als Namen für die Anwendungs-ID der AWS Mainframe-Modernisierung, den Namen der Ausgabevariablen für die VPC Endpunktdienst-ID, den Namen der Ausgabevariablen für den Listener-Port und den Namen der Ausgabevariablen als Namen hinzu. WebApp

    Anmerkung

    Die Namen dieser Felder sollten mit den Namen der Ausgabevariablen aus der CloudFormation Vorlage übereinstimmen, die bei der Stack-Erstellung von AWS Mainframe Modernization zurückgegeben wird.

  5. (Optional) Wählen Sie den Namen der Ausgabevariablen für die Aufgabe DMS (Database Migration Service) ARN und den URI S3-Speicherort der Quelldatenbank DDL (Datenbankdefinitionssprache).

  6. (Optional) Passen Sie Ihren Key Management Service (KMS) -Schlüssel an. Weitere Informationen finden Sie unter Verwalten des Zugriffs auf kundenverwaltete Schlüssel im Entwicklerhandbuch zum AWS Key Management Service .

  7. Wählen Sie Testumgebungskonfiguration erstellen aus.

Schritt 11: Laden Sie Ihre Eingabedaten in die Testsuite hoch

In diesem Schritt führen Sie Testfälle auf der Quelle aus. Um das zu tun:

  1. Laden Sie die Datensätze herunter, die aus der Mainframe-Ausführung der Anwendung stammen, und führen Sie sie aus. CardDemo

  2. Laden Sie den entpackten Ordner in Ihren Amazon S3 S3-Bucket hoch. Dieser Amazon S3 S3-Bucket muss sich in derselben Region befinden wie Ihre anderen Ressourcen für Anwendungstests.

    Anmerkung

    Es sollten zwei Dateien vorhanden sein, deren Namen den im vorherigen Testfall übergebenen Datensatznamen entsprechen.

  3. Wählen Sie auf der Übersichtsseite der Testsuite die Schaltfläche Hochladen aus.

  4. Geben Sie auf der Seite Referenzdaten hochladen den Amazon S3 S3-Speicherort an, an den Sie die vom Quell-Mainframe abgerufenen Datensätze hochgeladen haben.

  5. Wählen Sie Upload, um den Upload-Vorgang zu starten.

    Anmerkung

    Warten Sie, bis die Aufnahme abgeschlossen ist, bevor Sie die Wiedergabe und den Vergleich durchführen.

Schritt 12: Wiedergeben und vergleichen

Führen Sie die Testsuite und die Testfälle in der EC2 Zielumgebung von AWS AWS Blu Age on Amazon aus. Beim Anwendungstest werden die in der Wiedergabe erstellten Datensätze erfasst und mit den Referenzdatensätzen verglichen, die auf dem Mainframe aufgezeichnet wurden.

  1. Wählen Sie Replay und vergleichen Sie. Es sollte ungefähr drei Minuten dauern, den CloudFormation Stack zu erstellen und den Vergleich durchzuführen.

Sobald alles abgeschlossen ist, sollten Sie Vergleichsergebnisse mit einigen Unterschieden haben, die absichtlich für diese Demo erstellt wurden.