Modernice e implemente aplicaciones de mainframe con Terraform AWS Transform

Introduzca el siguiente comando para clonar el CardDemorepositorio en su estación de trabajo local:

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

Comprima la carpeta aws-mainframe-modernization-carddemo en un archivo ZIP.

Cargue el archivo ZIP en el bucket de Amazon S3 que creó. Para más instrucciones, consulte Cargar objetos en la documentación de Amazon S3.

Acceda a la aplicación AWS Transform web iniciando sesión con sus credenciales.

Cree un nuevo espacio de trabajo siguiendo las instrucciones de la AWS Transform documentación sobre cómo configurar su espacio de trabajo.

En la página de inicio de tu espacio de trabajo, selecciona AWS Transform Solicitar la creación de un trabajo.

A continuación, seleccione Modernización del mainframe como tipo de trabajo.

En la ventana de chat, introduzca Transformar código en Java.

Revise el tipo de trabajo, el nombre y el objetivo sugeridos. Para confirmarlo, introduzca Sí.

Seleccione Crear tarea.  

Configure un conector con el bucket de Amazon S3 que creó. Para obtener instrucciones, consulta Cómo configurar un conector en la AWS Transform documentación. Cuando se le solicite, escriba la ruta del archivo zip aws-mainframe-modernization-carddemo en el bucket de Amazon S3.

Espere a que el análisis finalice.

Revise los resultados del análisis de código según las instrucciones de la AWS Transform documentación sobre cómo analizar código.

Refactoriza el código del mainframe según las instrucciones de Refactorización del código de la documentación. AWS Transform Para la aplicación de CardDemo mainframe de ejemplo, puede aceptar la configuración predeterminada.

Espere a que finalice la refactorización.

Seleccione Ver resultados para ver la ruta del código refactorizado en el bucket de Amazon S3. Tome nota de esta ruta de archivo. La necesitará más adelante.

Introduzca el siguiente comando para clonar el repositorio Mainframe Transformation E2E en la estación de trabajo local:

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

Introduzca el comando siguiente para obtener la dirección IP pública actual:

curl checkip.amazonaws.com

Escriba el siguiente comando para navegar al directorio infra:

cd mainframe-transformation-e2e/infra

Abra el archivo variables.tf.

Reemplace YOUR_IP_ADDRESS_HERE por su dirección IP.

Si tiene una zona alojada pública, siga estos pasos:

Si no tiene una zona alojada pública, siga estos pasos:

Cambie aws_region por la región de destino. El valor predeterminado es us-east-1.

Guarde y cierre el archivo variables.tf.

Introduzca el comando siguiente para inicializar Terraform:

terraform init

Introduzca el comando siguiente para generar un plan de ejecución:

terraform plan

Revise el plan y valide los recursos y los componentes de infraestructura que se van a crear.

Introduzca el siguiente comando para implementar la infraestructura:

terraform apply

Cuando se le solicite, introduzca sí para confirmar la implementación.

Espere hasta que se complete la implementación.

Conéctese a su EC2 instancia de Amazon mediante AWS Systems Manager Session Manager.

Ingrese el comando siguiente para cambiar al usuario raíz:

sudo su -

Escriba el siguiente comando para navegar al directorio scripts:

cd /opt/scripts

Revise el script install_software.sh. Este script instala Java 17, Apache Maven y Apache Tomcat 10.0.23.

Actualice los scripts según sea necesario para su caso de uso.

Introduzca el siguiente comando para convertir el script en ejecutable:

chmod +x install_software.sh

Introduzca el siguiente comando para ejecutar el script:

./install_software.sh

Introduzca el siguiente comando para iniciar el servidor de Tomcat:

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

Introduzca el siguiente comando para verificar la respuesta del servidor web:

curl http://localhost:8080

La salida debe confirmar que Tomcat atiende una página HTML.

Introduzca el siguiente comando para convertir el script download_and_extract.sh en ejecutable. Este script descarga el código refactorizado y la biblioteca de tiempo de ejecución de Gapwalk almacenados en el bucket de Amazon S3:

chmod +x /opt/scripts/download_and_extract.sh

Ingrese el comando siguiente para ejecutar el script . Sustituya <file_path> por la ruta del archivo generated.zip en el bucket de Amazon S3:

./download_and_extract.sh <file_path>

Introduzca el siguiente comando para ir a la carpeta shared:

cd /opt/runtime/velocity/shared

Ingresa el siguiente comando para copiar el script deploy-velocity-runtime.sh:

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

Introduzca el siguiente comando para convertir el script copiado en ejecutable:

chmod +x deploy-velocity-runtime.sh

Ingrese el comando siguiente para ejecutar el script . Este script copia todas las dependencias del archivo de aplicaciones web (WAR) necesarias presentes en los archivos del modelo de objetos del proyecto (POM) en la carpeta del repositorio:

./deploy-velocity-runtime.sh

Verifique que la ejecución se haya realizado correctamente: compruebe que no haya errores y que las dependencias de WAR necesarias se hayan instalado en el repositorio local de Maven.

Introduzca el siguiente comando para navegar al directorio del proyecto app-pom:

cd /opt/codebase/app-pom/

Introduzca el siguiente comando para instalar Maven:

mvn clean install

Espere a que se completen la instalación y la compilación.

Tras completar correctamente la compilación, confirme la presencia de app-service/target/app-service-1.0.0.war y app-web/target/app-web-1.0.0.war.

Introduzca el siguiente comando para cambiar el nombre de la carpeta csd commands por csd_commands. Esto eliminará los espacios del nombre de la carpeta:

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

Introduzca el siguiente comando para ir al directorio scripts:

cd /opt/scripts

Introduzca el siguiente comando para convertir el script de migración de la base de datos en ejecutable:

chmod +x database_migration_setup.sh

Introduzca los siguientes comandos para configurar las siguientes variables como parámetros:

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

Donde:

Introduzca el siguiente comando para ejecutar el script de migración de la base de datos:

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

Introduce el siguiente comando para conectarte a la base de datos desde tu EC2 instancia de Amazon:

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

Cuando se le solicite, introduzca las credenciales de la base de datos.

Introduzca el siguiente comando para ver todas las bases de datos:

\l

Introduzca el siguiente comando para cambiar a la base de datos jics:

\c jics

Introduzca el siguiente comando para revisar una lista de las tablas creadas:

\dt

Introduzca el siguiente comando para convertir el script execute_listcat_sql.sh en ejecutable:

chmod +x execute_listcat_sql.sh

Introduzca el siguiente comando para configurar la variable PATH_TO_LISTCAT_SQL_FILES, que es el directorio que contiene los archivos SQL de LISTCAT:

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

Asegúrese de que las variables RDS_ENDPOINT, SECRET_NAME y PATH_TO_LISTCAT_SQL_FILES estén configuradas correctamente de acuerdo con las instrucciones anteriores.

Introduzca el siguiente comando para ejecutar el script execute_listcat_sql.sh:

./execute_listcat_sql.sh $RDS_ENDPOINT $SECRET_NAME $PATH_TO_LISTCAT_SQL_FILES

Este script actualiza las propiedades del archivo VSAM en la base de datos de JICS y ejecuta las consultas necesarias para modificar la base de datos.

Introduzca el siguiente comando para convertir el script application_installer.sh en ejecutable:

chmod +x /opt/scripts/application_installer.sh

Introduzca los siguientes comandos para configurar las siguientes variables como parámetros:

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

Donde:

Introduzca el siguiente comando para ejecutar el 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

En la /opt/tomcat/apache-tomcat-10.0.23/workingdir/config carpeta, en el application-utility-pgmarchivo.yml, cambie el parámetro de codificación por el siguiente:

encoding : CP1047

Introduzca el siguiente comando para ir al directorio de trabajo:

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

Introduzca los siguientes comandos para detener e iniciar el servidor de Tomcat:

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

Introduzca el siguiente comando para supervisar los registros de arranque del servicio de Tomcat:

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

Abre la EC2 consola de Amazon.

En el panel de navegación, elija Load balancers (Balanceadores de carga).

Seleccione el equilibrador de carga que se creó a través de Terraform.

Busque el nombre del sistema de nombres de dominio (DNS) del equilibrador de carga de aplicación, como application-load-balancer-<id>.<region>.elb.amazonaws.com.

En el navegador, navegue hasta http://<dns_name>/gapwalk-application/scripts/data-load, donde <dns_name> es el nombre de DNS del equilibrador de carga de aplicación. Esto inicia el script de carga de datos.

Espere a que el script finalice. Cuando termine, el navegador mostrará LISTO.

En la EC2 instancia de Amazon, abre una nueva terminal.

Introduzca el siguiente comando para conectarse a la base de datos de Amazon RDS y sustituya <database_endpoint> por su valor:

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

Cuando se le solicite, escriba las credenciales para conectarse a la base de datos.

Introduzca el siguiente comando para ver todas las bases de datos:

\l

Introduzca el siguiente comando para cambiar a la base de datos bluesam:

\c bluesam

Introduzca el siguiente comando para revisar una lista de las tablas creadas:

\dt

Introduzca el siguiente comando para validar la carga de datos:

SELECT * FROM public.aws_m2_carddemo_usrsec_vsam_ksds;

La salida debe mostrar 10 registros devueltos.

Introduzca el siguiente comando para ir al directorio del script:

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

En todos los archivos de Groovy que contengan referencias a archivos planos, actualice las siguientes configuraciones de archivos:

Como referencia, consulte el script de ejemplo DUSRSECJ.jcl.groovy en el repositorio de código.

Guardar y cerrar los archivos.

Acceda a la aplicación en línea a través del equilibrador de carga de aplicación (http://<your-load-balancer-dns>) o a través de la zona alojada (https://myhostedzone.dev/).

Para el ID de transacción, introduzca CC00.

Para el nombre de usuario, introduzca USER0001.

Para la contraseña, introduzca PASSWORD.

Tras iniciar sesión correctamente, aparece el menú principal.

Acceda a los scripts a través del equilibrador de carga de aplicación (http://<your-load-balancer-dns>/gapwalk-application/scripts) o a través de la zona alojada (https://myhostedzone.dev/gapwalk-application/scripts).

Elija un script para ejecutarlo, como el script DUSRSECJ.jcl.groovy.

Compruebe que el script se ejecute correctamente. A continuación, se presenta una salida de muestra tras ejecutar el script correctamente.

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

Introduzca el siguiente comando para eliminar la protección de eliminación de la instancia de Amazon RDS:

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

Introduzca el siguiente comando para eliminar la protección de eliminación del equilibrador de carga de aplicación:

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

Introduzca los siguientes comandos para eliminar el contenido de los buckets de 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

Introduzca el siguiente comando para ir a la carpeta infra:

cd /mainframe-transformation-e2e/infra

Introduzca el siguiente comando para eliminar la infraestructura:

terraform destroy --auto-approve