

AWS O Mainframe Modernization Service (experiência em Managed Runtime Environment) não está mais aberto a novos clientes. Para recursos semelhantes ao AWS Mainframe Modernization Service (experiência em Managed Runtime Environment), explore o AWS Mainframe Modernization Service (experiência autogerenciada). Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte Alteração na [disponibilidade AWS da modernização do mainframe](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configure o AWS Transform para mainframe Runtime no Amazon EC2
<a name="ba-runtime-deploy-ec2"></a>

Este tópico explica como configurar e implantar o aplicativo de PlanetsDemo amostra usando o AWS Transform for mainframe Runtime no Amazon EC2.

**Topics**
+ [Pré-requisitos](#ba-runtime-deploy-prereq)
+ [Configurar](#ba-runtime-deploy-setup)
+ [Testar a aplicação implantada](#ba-runtime-deploy-test)

## Pré-requisitos
<a name="ba-runtime-deploy-prereq"></a>

Antes de começar, certifique-se de que você concluiu os seguintes pré-requisitos.
+ Configure o AWS CLI seguindo as etapas em [Configuração da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html).
+ Preencha [AWS Pré-requisitos do Transform for mainframe Runtime](ba-runtime-setup-prereq.md), e [AWS Transformação de integração para o mainframe Runtime](ba-runtime-setup-onboard.md).
+ Crie uma instância do Amazon EC2 usando um dos tipos de instância aceitos. Para obter mais informações, consulte [Introdução às instâncias do Amazon EC2 Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html).
+ Certifique-se de que você possa se conectar à instância do Amazon EC2 com sucesso, por exemplo, usando SSM.
**nota**  
Ao longo deste guia, presume-se que o caminho de instalação do Tomcat seja`/m2-anywhere/tomcat-gapwalk/velocity`. Certifique-se de usar esse caminho ao seguir as instruções abaixo ou adapte as instruções a seguir ao caminho de sua escolha.
+ Baixe e extraia o AWS Transform for mainframe Runtime (no Amazon EC2) diretamente no `/m2-anywhere/tomcat-gapwalk/velocity` diretório de velocidade (a pasta de instalação do Tomcat). Para obter instruções sobre como recuperar os artefatos do AWS Transform for mainframe Runtime, incluindo informações sobre armazenamento, acesso e conteúdo, consulte. [AWS Transformação para artefatos do mainframe Runtime](ba-runtime-artifacts.md)
+ Baixe o [arquivo do PlanetsDemo aplicativo](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip).
+ Descompacte o arquivo e faça o upload da aplicação para um bucket do Amazon S3 de sua escolha.
+ Crie um banco de dados Amazon Aurora PostgreSQL para JICS. O AWS Transform for mainframe Runtime executará automaticamente o `PlanetsDemo-v1/jics/sql/initJics.sql` script durante a primeira inicialização. Para ter informações sobre como criar um banco de dados do Amazon Aurora PostgreSQL, consulte [Criar um cluster de banco de dados do Aurora PostgreSQL e se conectar a ele](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster).

## Configurar
<a name="ba-runtime-deploy-setup"></a>

Para configurar o aplicativo de PlanetsDemo amostra, conclua as etapas a seguir.

1. Conecte-se à sua instância do Amazon EC2 e vá até a `conf` pasta abaixo da pasta de instalação do Apache Tomcat. Abra o arquivo `catalina.properties` para edição e substitua a linha que começa com `common.loader` com a linha a seguir.

   ```
   common.loader="${catalina.base}/lib","${catalina.base}/lib/*.jar","${catalina.home}/lib","${catalina.home}/lib/*.jar","${catalina.home}/shared","${catalina.home}/shared/*.jar","${catalina.home}/extra","${catalina.home}/extra/*.jar"
   ```

1. Navegue para a pasta `/m2-anywhere/tomcat-gapwalk/velocity/webapps`.

1. Copie os PlanetsDemo binários disponíveis na `PlanetsDemo-v1/webapps/` pasta do bucket do Amazon S3 usando o comando a seguir.

   ```
   aws s3 cp s3://path-to-demo-app-webapps/ . --recursive
   ```
**nota**  
`path-to-demo-app-webapps`Substitua pelo URI correto do Amazon S3 para o bucket em que você descompactou o arquivo anteriormente. PlanetsDemo 

1. Copie o conteúdo da pasta `PlanetsDemo-v1/config/` para `/m2-anywhere/tomcat-gapwalk/velocity/config/`.

1. Forneça as informações de conexão do banco de dados que você criou como parte dos pré-requisitos no trecho a seguir, no arquivo `/m2-anywhere/tomcat-gapwalk/velocity/config/application-main.yml`. Para obter mais informações, consulte [Criação e conexão a um cluster Aurora PostgreSQL DB](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster).

   ```
   datasource:
      jicsDs:
        driver-class-name :  
        url: 
        username: 
        password: 
        type :
   ```

1. Inicie o servidor Apache Tomcat e verifique os logs.

   ```
   /m2-anywhere/tomcat-gapwalk/velocity/startup.sh
   
   tail -f /m2-anywhere/tomcat-gapwalk/velocity/logs/catalina.log
   ```

   Se você encontrar códigos de erro que comecem com C seguido por um número, como CXXXX, anote as mensagens de erro. Por exemplo, o código de erro C5102 é um erro comum que indica uma configuração incorreta da infraestrutura.

## Testar a aplicação implantada
<a name="ba-runtime-deploy-test"></a>

Para obter um exemplo de como testar o PlanetsDemo aplicativo, consulte[Teste o PlanetsDemo aplicativo](ba-runtime-test-planetsdemo.md).