Modernisez et déployez des applications mainframe à l'aide de AWS Transform Terraform

Entrez la commande suivante pour cloner le CardDemoréférentiel sur votre station de travail locale :

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

Compressez le aws-mainframe-modernization-carddemo dossier dans un fichier ZIP.

Téléchargez le fichier ZIP dans le compartiment Amazon S3 que vous avez créé. Pour obtenir des instructions, consultez la section Chargement d'objets dans la documentation Amazon S3.

Accédez à l'application AWS Transform Web en vous connectant à l'aide de vos informations d'identification.

Créez un nouvel espace de travail en suivant les instructions de la section Configuration de votre espace de travail dans la AWS Transform documentation.

Sur la page d'accueil de votre espace de travail, choisissez Demander AWS Transform pour créer une offre d'emploi.

Ensuite, choisissez Mainframe Modernisation comme type de tâche.

Dans la fenêtre de discussion, saisissez Transform code to Java.

Passez en revue le type de travail, le nom et l'objectif proposés. Pour confirmer, saisissez Oui.

Choisissez Créer une tâche.  

Configurez un connecteur avec le compartiment Amazon S3 que vous avez créé. Pour obtenir des instructions, consultez la section Configuration d'un connecteur dans la AWS Transform documentation. Lorsque vous y êtes invité, entrez le chemin du fichier aws-mainframe-modernization-carddemo zip dans le compartiment Amazon S3.

Attendez que l’analyse se termine.

Passez en revue les résultats de l'analyse du code conformément aux instructions de la section Analyser le code de la AWS Transform documentation.

Refactorisez le code du mainframe conformément aux instructions du code Refactor de la documentation. AWS Transform Pour l'exemple d'application CardDemo mainframe, vous pouvez accepter les paramètres par défaut.

Attendez que la refactorisation soit terminée.

Choisissez Afficher les résultats pour voir le chemin du code refactorisé dans le compartiment Amazon S3. Notez le chemin de ce fichier. Vous en aurez besoin ultérieurement.

Entrez la commande suivante pour cloner le référentiel Mainframe Transformation E2E sur votre station de travail locale :

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

Entrez la commande suivante pour récupérer votre adresse IP publique actuelle :

curl checkip.amazonaws.com

Entrez la commande suivante pour accéder au répertoire infra :

cd mainframe-transformation-e2e/infra

Ouvrez le fichier variables.tf.

Remplacez YOUR_IP_ADDRESS_HERE par votre adresse IP.

Si vous disposez d'une zone hébergée par le public, procédez comme suit :

Si vous ne disposez pas d'une zone hébergée publique, procédez comme suit :

Passez aws_region à la région cible. L’argument par défaut est us-east-1.

Enregistrez et fermez le fichier variables.tf.

Entrez la commande suivante pour initialiser Terraform :

terraform init

Entrez la commande suivante pour générer un plan d'exécution :

terraform plan

Passez en revue le plan et validez les ressources et les composants d'infrastructure qui seront créés.

Entrez la commande suivante pour déployer l'infrastructure :

terraform apply

Lorsque vous y êtes invité, entrez Oui pour confirmer le déploiement.

Patientez jusqu'à ce que le déploiement soit terminé.

Connectez-vous à votre EC2 instance Amazon en utilisant AWS Systems Manager Session Manager.

Entrez la commande suivante pour passer à l'utilisateur root :

sudo su -

Entrez la commande suivante pour accéder au répertoire scripts :

cd /opt/scripts

Passez en revue le script install_software.sh. Ce script installe Java 17, Apache Maven et Apache Tomcat 10.0.23.

Mettez à jour les scripts selon les besoins de votre cas d'utilisation.

Entrez la commande suivante pour rendre le script exécutable :

chmod +x install_software.sh

Entrez la commande suivante pour exécuter le script :

./install_software.sh

Entrez la commande suivante pour démarrer le serveur Tomcat :

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

Entrez la commande suivante pour vérifier la réponse du serveur Web :

curl http://localhost:8080

La sortie doit confirmer que Tomcat diffuse une page HTML.

Entrez la commande suivante pour rendre le script download_and_extract.sh exécutable. Ce script télécharge le code refactorisé et la bibliothèque d'exécution Gapwalk stockés dans le compartiment Amazon S3 :

chmod +x /opt/scripts/download_and_extract.sh

Saisissez la commande suivante pour exécuter le script . <file_path>Remplacez-le par le chemin d'accès au fichier generated.zip dans votre compartiment Amazon S3 :

./download_and_extract.sh <file_path>

Entrez la commande suivante pour accéder au shared dossier :

cd /opt/runtime/velocity/shared

Entrez la commande suivante pour copier le script deploy-velocity-runtime.sh :

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

Entrez la commande suivante pour rendre le script copié exécutable :

chmod +x deploy-velocity-runtime.sh

Saisissez la commande suivante pour exécuter le script . Ce script copie toutes les dépendances WAR (Web Application Archive) requises présentes dans les fichiers POM (Project Object Model) dans le dossier du référentiel :

./deploy-velocity-runtime.sh

Vérifiez que l'exécution est réussie en vérifiant qu'il n'y a pas d'erreur et que les dépendances WAR requises sont installées dans votre dépôt Maven local.

Entrez la commande suivante pour accéder au répertoire du app-pom projet :

cd /opt/codebase/app-pom/

Entrez la commande suivante pour installer Maven :

mvn clean install

Attendez que l'installation et la compilation soient terminées.

Une fois la construction terminée avec succès, confirmez la présence de app-service/target/app-service-1.0.0.war etapp-web/target/app-web-1.0.0.war.

Entrez la commande suivante pour renommer le csd commands dossier encsd_commands. Cela supprime les espaces du nom du dossier :

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

Entrez la commande suivante pour accéder au scripts répertoire :

cd /opt/scripts

Entrez la commande suivante pour rendre le script de migration de base de données exécutable :

chmod +x database_migration_setup.sh

Entrez les commandes suivantes pour configurer les variables suivantes en tant que paramètres :

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

Où :

Entrez la commande suivante pour exécuter le script de migration de base de données :

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

Entrez la commande suivante pour vous connecter à la base de données depuis votre EC2 instance Amazon :

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

Lorsque vous y êtes invité, entrez les informations d'identification de votre base de données.

Entrez la commande suivante pour afficher toutes les bases de données :

\l

Entrez la commande suivante pour passer à la jics base de données :

\c jics

Entrez la commande suivante pour consulter la liste des tables créées :

\dt

Entrez la commande suivante pour rendre le script execute_listcat_sql.sh exécutable :

chmod +x execute_listcat_sql.sh

Entrez la commande suivante pour configurer la PATH_TO_LISTCAT_SQL_FILES variable, qui est le répertoire contenant vos fichiers SQL LISTCAT :

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

Assurez-vous que les PATH_TO_LISTCAT_SQL_FILES variables RDS_ENDPOINTSECRET_NAME, et sont correctement définies conformément aux instructions précédentes.

Entrez la commande suivante pour exécuter le script execute_listcat_sql.sh :

./execute_listcat_sql.sh $RDS_ENDPOINT $SECRET_NAME $PATH_TO_LISTCAT_SQL_FILES

Ce script met à jour les propriétés du fichier VSAM dans la base de données JICS et exécute les requêtes nécessaires pour modifier la base de données.

Entrez la commande suivante pour rendre le script application_installer.sh exécutable :

chmod +x /opt/scripts/application_installer.sh

Entrez les commandes suivantes pour configurer les variables suivantes en tant que paramètres :

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

Où :

Entrez la commande suivante pour exécuter le script application_installer.sh :

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

Dans le /opt/tomcat/apache-tomcat-10.0.23/workingdir/config dossier, dans le fichier application-utility-pgm.yml, modifiez le paramètre de codage comme suit :

encoding : CP1047

Entrez la commande suivante pour accéder au répertoire de travail :

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

Entrez les commandes suivantes pour arrêter et démarrer le serveur Tomcat :

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

Entrez la commande suivante pour surveiller les journaux de démarrage du service Tomcat :

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

Ouvrez la EC2 console Amazon.

Dans le volet de navigation, choisissez Load Balancers (Équilibreurs de charge).

Choisissez l'équilibreur de charge créé via Terraform.

Recherchez le nom DNS (Domain Name System) de votre Application Load Balancer, par exemple. application-load-balancer-<id>.<region>.elb.amazonaws.com

Dans votre navigateur, accédez àhttp://<dns_name>/gapwalk-application/scripts/data-load, où se <dns_name> trouve le nom DSN de l'Application Load Balancer. Cela lance le script de chargement de données.

Attendez que le script soit terminé. Lorsque vous avez terminé, le navigateur affiche OK.

Sur l' EC2 instance Amazon, ouvrez un nouveau terminal.

Entrez la commande suivante pour vous connecter à la base de données Amazon RDS, en <database_endpoint> remplaçant par votre valeur :

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

Lorsque vous y êtes invité, entrez vos informations d'identification pour vous connecter à la base de données.

Entrez la commande suivante pour afficher toutes les bases de données :

\l

Entrez la commande suivante pour passer à la bluesam base de données :

\c bluesam

Entrez la commande suivante pour consulter la liste des tables créées :

\dt

Entrez la commande suivante pour valider le chargement des données :

SELECT * FROM public.aws_m2_carddemo_usrsec_vsam_ksds;

La sortie doit afficher 10 enregistrements renvoyés.

Entrez la commande suivante pour accéder au répertoire des scripts :

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

Dans tous les fichiers Groovy contenant des références à des fichiers plats, mettez à jour les configurations de fichier suivantes :

Pour référence, consultez l'exemple de script DUsrsecj.jcl.groovy dans le référentiel de code.

Enregistrez et fermez les fichiers.

Accédez à l'application en ligne via l'Application Load Balancer (http://<your-load-balancer-dns>) ou via la zone hébergée (https://myhostedzone.dev/).

Pour le numéro de transaction, entrezCC00.

Pour le nom d'utilisateur, entrezUSER0001.

Pour le mot de passe, entrezPASSWORD.

Une fois la connexion établie, le menu principal s'affiche.

Accédez à l'interface des scripts via l'Application Load Balancer (http://<your-load-balancer-dns>/gapwalk-application/scripts) ou via la zone hébergée (https://myhostedzone.dev/gapwalk-application/scripts).

Choisissez un script à exécuter, tel que le script DUSRSecj.jcl.Groovy.

Vérifiez que le script s'exécute correctement. Voici un exemple de sortie après une exécution réussie.

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

Entrez la commande suivante pour supprimer la protection contre la suppression de l'instance Amazon RDS :

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

Entrez la commande suivante pour supprimer la protection contre la suppression de l'Application Load Balancer :

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

Entrez les commandes suivantes pour supprimer le contenu des compartiments Amazon S3 :

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

Entrez la commande suivante pour accéder au infra dossier :

cd /mainframe-transformation-e2e/infra

Entrez la commande suivante pour supprimer l'infrastructure :

terraform destroy --auto-approve