Modernize e implante aplicativos de mainframe usando o Terraform AWS Transform

Digite o comando a seguir para clonar o CardDemorepositório na sua estação de trabalho local:

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

Compacte a pasta aws-mainframe-modernization-carddemo em um arquivo ZIP.

Faça upload do arquivo ZIP no bucket do Amazon S3 que você criou. Para obter instruções, consulte Fazer uploads de objetos na documentação do Amazon S3.

Acesse o aplicativo AWS Transform da web fazendo login com suas credenciais.

Crie um novo espaço de trabalho seguindo as instruções em Configurando seu espaço de trabalho na AWS Transform documentação.

Na página inicial do seu espaço de trabalho, escolha Perguntar AWS Transform para criar um trabalho.

Em seguida, escolha Mainframe Modernization como o tipo de trabalho.

Na janela de chat, insira Transform code to Java.

Analise o tipo de trabalho, o nome e o objetivo sugeridos. Para confirmar, insira Sim.

Escolha Criar trabalho.  

Configure um conector com o bucket do Amazon S3 que você criou. Para obter instruções, consulte Configurar um conector na AWS Transform documentação. Quando for solicitado, insira o caminho para o arquivo zip aws-mainframe-modernization-carddemo no bucket do Amazon S3.

Aguarde a conclusão da análise.

Revise os resultados da análise do código de acordo com as instruções em Analisar código na AWS Transform documentação.

Refatore o código do mainframe de acordo com as instruções em Refactor code na documentação. AWS Transform Para o aplicativo de CardDemo mainframe de amostra, você pode aceitar as configurações padrão.

Aguarde a conclusão da refatoração.

Escolha Exibir resultados para ver o caminho do código refatorado no bucket do Amazon S3. Anote esse caminho de arquivo. Você precisará disso mais tarde.

Insira o seguinte comando para clonar o repositório Mainframe Transformation E2E em sua estação de trabalho local:

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

Insira o seguinte comando para recuperar seu endereço IP público atual:

curl checkip.amazonaws.com

Insira o seguinte comando para acessar o diretório infra:

cd mainframe-transformation-e2e/infra

Abra o arquivo variables.tf.

Substitua YOUR_IP_ADDRESS_HERE pelo seu endereço IP.

Se você tiver uma zona hospedada pública, faça o seguinte:

Se você não tiver uma zona hospedada pública, faça o seguinte:

Mude aws_region para a região de destino. O padrão é us-east-1.

Salve e feche o arquivo variables.tf.

Insira o seguinte comando para inicializar o Terraform:

terraform init

Insira o seguinte comando para gerar um plano de execução:

terraform plan

Revise o plano e valide os recursos e os componentes da infraestrutura que serão criados.

Insira o seguinte comando para implantar a infraestrutura:

terraform apply

Quando solicitado, insira sim para confirmar a implantação.

Espere até que a implantação seja concluída.

Conecte-se à sua EC2 instância da Amazon usando AWS Systems Manager Session Manager.

Insira o seguinte comando para alternar para o usuário-raiz:

sudo su -

Digite o comando a seguir para navegar para o diretório scripts:

cd /opt/scripts

Revise o script install_software.sh. Esse script instala o Java 17, o Apache Maven e o Apache Tomcat 10.0.23.

Atualize os scripts conforme necessário para seu caso de uso.

Insira o seguinte comando para tornar o script executável:

chmod +x install_software.sh

Insira o seguinte comando para executar o script:

./install_software.sh

Insira o seguinte comando para iniciar o servidor Tomcat:

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

Insira o seguinte comando para verificar a resposta do servidor da web:

curl http://localhost:8080

A saída deve confirmar que o Tomcat está veiculando uma página HTML.

Insira o comando a seguir para tornar o script download_and_extract.sh executável. Esse script baixa o código refatorado e a biblioteca de runtime do Gapwalk armazenados no bucket do Amazon S3:

chmod +x /opt/scripts/download_and_extract.sh

Insira o comando a seguir para executar o script . Substitua <file_path> pelo caminho para o arquivo generated.zip no bucket do Amazon S3:

./download_and_extract.sh <file_path>

Insira o seguinte comando para navegar até a pasta shared:

cd /opt/runtime/velocity/shared

Digite o comando a seguir para copiar o deploy-velocity-runtimescript.sh:

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

Insira o seguinte comando para tornar o script copiado executável:

chmod +x deploy-velocity-runtime.sh

Insira o comando a seguir para executar o script . Esse script copia todas as dependências necessárias do Web Application Archive (WAR) presentes nos arquivos do Project Object Model (POM) na pasta do repositório:

./deploy-velocity-runtime.sh

Verifique se a execução foi bem-sucedida verificando se não há erros e se as dependências WAR necessárias estão instaladas no seu repositório Maven local.

Insira o seguinte comando para acessar o diretório do projeto app-pom:

cd /opt/codebase/app-pom/

Insira o seguinte comando para instalar o Maven:

mvn clean install

Aguarde até que a instalação e a compilação sejam concluídas.

Após a conclusão bem-sucedida da compilação, confirme a presença de app-service/target/app-service-1.0.0.war e app-web/target/app-web-1.0.0.war.

Insira o comando a seguir para renomear a pasta csd commands como csd_commands. Isso remove os espaços do nome da pasta:

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

Insira o seguinte comando para navegar até o diretório scripts:

cd /opt/scripts

Insira o seguinte comando para tornar o script de migração do banco de dados executável:

chmod +x database_migration_setup.sh

Insira os seguintes comandos para configurar as seguintes variáveis 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

Em que:

Insira o seguinte comando para executar o script de migração do banco de dados:

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

Digite o seguinte comando para se conectar ao banco de dados da sua EC2 instância Amazon:

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

Quando solicitado, insira as credenciais do seu banco de dados.

Insira o seguinte comando para exibir todos os bancos de dados:

\l

Insira o seguinte comando para alternar para o banco de dados jics:

\c jics

Insira o seguinte comando para analisar uma lista das tabelas criadas:

\dt

Insira o seguinte comando para tornar o script execute_listcat_sql.sh executável:

chmod +x execute_listcat_sql.sh

Insira o seguinte comando para configurar a variável PATH_TO_LISTCAT_SQL_FILES, que é o diretório que contém seus arquivos LISTCAT SQL:

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

Certifique-se de que as variáveis RDS_ENDPOINT, SECRET_NAME e PATH_TO_LISTCAT_SQL_FILES estejam definidas corretamente de acordo com as instruções anteriores.

Insira o seguinte comando para executar o script execute_listcat_sql.sh:

./execute_listcat_sql.sh $RDS_ENDPOINT $SECRET_NAME $PATH_TO_LISTCAT_SQL_FILES

Esse script atualiza as propriedades do arquivo VSAM no banco de dados JICS e executa as consultas necessárias para modificar o banco de dados.

Insira o seguinte comando para tornar o script application_installer.sh executável:

chmod +x /opt/scripts/application_installer.sh

Insira os seguintes comandos para configurar as seguintes variáveis 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

Em que:

Insira o seguinte comando para executar o 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

Na /opt/tomcat/apache-tomcat-10.0.23/workingdir/config pasta, no application-utility-pgmarquivo.yml, altere o parâmetro de codificação para o seguinte:

encoding : CP1047

Insira o seguinte comando para navegar até o diretório de trabalho:

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

Insira os seguintes comandos para interromper e iniciar o servidor Tomcat:

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

Insira o seguinte comando para monitorar os logs de startup do servidor Tomcat:

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

Abra o EC2 console da Amazon.

No painel de navegação, escolha Load balancers.

Escolha o balanceador de carga que foi criado por meio do Terraform.

Localize o nome do Sistema de Nomes de Domínio (DNS) do Application Load Balancer, como application-load-balancer-<id>.<region>.elb.amazonaws.com.

No seu navegador, navegue até http://<dns_name>/gapwalk-application/scripts/data-load, onde <dns_name> é o nome do DSN do Application Load Balancer. Isso inicia o script de carregamento de dados.

Aguarde a conclusão do script. Quando terminar, o navegador exibirá DONE.

Na EC2 instância da Amazon, abra um novo terminal.

Insira o seguinte comando para se conectar ao banco de dados do Amazon RDS, substituindo <database_endpoint> pelo seu valor:

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

Quando for solicitado, insira as credenciais para se conectar ao banco de dados.

Insira o seguinte comando para exibir todos os bancos de dados:

\l

Insira o seguinte comando para alternar para o banco de dados bluesam:

\c bluesam

Insira o seguinte comando para analisar uma lista das tabelas criadas:

\dt

Insira o seguinte comando para validar o carregamento dos dados:

SELECT * FROM public.aws_m2_carddemo_usrsec_vsam_ksds;

A saída deve mostrar dez registros retornados.

Insira o seguinte comando para navegar até o diretório de scripts:

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

Em todos os arquivos do Groovy que contêm referência a arquivos simples, atualize as seguintes configurações de arquivo:

Para referência, consulte o exemplo do script DUSRSECJ.jcl.groovy no repositório de código.

Salve e feche os arquivos.

Acesse a aplicação on-line por meio do Application Load Balancer (http://<your-load-balancer-dns>) ou da zona hospedada (https://myhostedzone.dev/).

Para o ID da transação, insira CC00.

Para o nome do usuário, insira USER0001.

Para a senha, insira PASSWORD.

Após o login bem-sucedido, o menu principal é exibido.

Acesse a interface de scripts por meio do Application Load Balancer (http://<your-load-balancer-dns>/gapwalk-application/scripts) ou da zona hospedada (https://myhostedzone.dev/gapwalk-application/scripts).

Escolha um script para ser executado, como o script DUSRSECJ.jcl.groovy.

Verifique se o script foi executado com êxito Este é um exemplo de saída após uma execução bem-sucedida.

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

Insira o seguinte comando para remover a proteção contra exclusão da instância do Amazon RDS:

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

Insira o seguinte comando para remover a proteção contra exclusão do Application Load Balancer:

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

Insira os seguintes comandos para excluir o conteúdo dos buckets do 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

Insira o seguinte comando para navegar até a pasta infra:

cd /mainframe-transformation-e2e/infra

Insira o seguinte comando para excluir a infraestrutura:

terraform destroy --auto-approve