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 aws-mainframe-modernization-carddemo carpeta 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, elija Modernización de la unidad central como tipo de trabajo.

En la ventana de chat, introduzca Transform code to Java.

Revisa el tipo de trabajo, el nombre y el objetivo sugeridos. Para confirmar, escriba Sí.

Seleccione Crear tarea.  

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

Espere a que el análisis finalice.

Revise los resultados del análisis del código de acuerdo con las instrucciones de Analice el código de la AWS Transform documentación.

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 se complete la refactorización.

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

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

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

Introduzca el siguiente comando para recuperar su dirección IP pública actual:

curl checkip.amazonaws.com

Introduzca el siguiente comando para ir al directorio infra:

cd mainframe-transformation-e2e/infra

Abra el archivo variables.tf.

YOUR_IP_ADDRESS_HERESustitúyala por tu dirección IP.

Si tiene una zona alojada pública, haga lo siguiente:

Si no tiene una zona alojada pública, haga lo siguiente:

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

Guarde y cierre el archivo variables.tf.

Introduzca el siguiente comando para inicializar Terraform:

terraform init

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

terraform plan

Revise el plan y valide los recursos y los componentes de infraestructura que se crearán.

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.

Ingresa el siguiente comando para cambiar al usuario root:

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 hacer que el script sea 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 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

El resultado debe confirmar que Tomcat está publicando una página HTML.

Introduzca el siguiente comando para hacer que el script download_and_extract.sh sea 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 . <file_path>Sustitúyala por la ruta al archivo generated.zip de tu bucket de Amazon S3:

./download_and_extract.sh <file_path>

Introduzca el siguiente comando para acceder a la shared carpeta:

cd /opt/runtime/velocity/shared

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

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

Introduzca el siguiente comando para hacer ejecutable el script copiado:

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

Compruebe que la ejecución se ha realizado correctamente comprobando que no haya errores y que las dependencias WAR necesarias estén instaladas en su repositorio local de Maven.

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

cd /opt/codebase/app-pom/

Ingresa 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 construcción, confirme la presencia de app-service/target/app-service-1.0.0.war yapp-web/target/app-web-1.0.0.war.

Introduzca el siguiente comando para cambiar el nombre de la csd commands carpeta a. csd_commands Esto elimina los espacios del nombre de la carpeta:

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

Introduzca el siguiente comando para acceder al scripts directorio:

cd /opt/scripts

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

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 te pida, introduce las credenciales de tu base de datos.

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

\l

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

\c jics

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

\dt

Introduzca el siguiente comando para hacer que el script execute_listcat_sql.sh sea ejecutable:

chmod +x execute_listcat_sql.sh

Introduzca el siguiente comando para configurar la PATH_TO_LISTCAT_SQL_FILES variable, 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 PATH_TO_LISTCAT_SQL_FILES variables RDS_ENDPOINTSECRET_NAME, y 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 JICS y ejecuta las consultas necesarias para modificar la base de datos.

Ingresa el siguiente comando para hacer que el script application_installer.sh sea 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 acceder al directorio de trabajo:

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

Introduzca los siguientes comandos para detener e iniciar el servidor 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 inicio del servicio 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).

Elige el balanceador de carga que se creó a través de Terraform.

Busque el nombre del Sistema de nombres de dominio (DNS) de su Application Load Balancer, por ejemplo. application-load-balancer-<id>.<region>.elb.amazonaws.com

En su navegador, navegue hastahttp://<dns_name>/gapwalk-application/scripts/data-load, donde <dns_name> está el nombre DSN de Application Load Balancer. Esto inicia el script de carga de datos.

Espere a que se complete el script. Cuando termine, el navegador mostrará DONE.

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 <database_endpoint> sustitúyalo por su valor:

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

Cuando se le solicite, introduzca sus 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 bluesam base de datos:

\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;

El resultado debe mostrar 10 registros devueltos.

Introduzca el siguiente comando para acceder al directorio de scripts:

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

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

Como referencia, consulta el ejemplo del script 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 de Application Load Balancer (http://<your-load-balancer-dns>) o a través de la zona alojada (https://myhostedzone.dev/).

Para el identificador de la transacción, introduzcaCC00.

Para el nombre de usuario, introduzcaUSER0001.

Para la contraseña, introduzcaPASSWORD.

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

Acceda a la interfaz de scripts a través de Application Load Balancer (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 ejecuta correctamente. El siguiente es un ejemplo de resultado después de una ejecución correcta.

{ "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 de Application Load Balancer:

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 acceder a la infra carpeta:

cd /mainframe-transformation-e2e/infra

Introduzca el siguiente comando para eliminar la infraestructura:

terraform destroy --auto-approve