

# Implantar o RDS Custom para Oracle com o AWS CloudFormation
<a name="custom-oracle-multiaz-deployment"></a>

Automatize a implantação do RDS Custom para Oracle usando o modelo do AWS CloudFormation fornecido. Atenda aos pré-requisitos a seguir antes de implantar os recursos.

## Pré-requisitos
<a name="custom-oracle-prerequisites"></a><a name="custom-oracle-required-files"></a>

**Baixar os arquivos necessários do Oracle**

Você precisa de arquivos de instalação específicos do Oracle para criar o modelo do CloudFormation. Baixe esses arquivos antes da implantação.

1. Navegue até [Oracle Database 19c (19.3)](https://www.oracle.com/database/technologies/oracle19c-linux-downloads.html).

1. Localize e baixe o arquivo `LINUX.X64_193000_db_home.zip`.

1. Renomeie o arquivo para `V982063-01.zip`.

1. Baixe os patches restantes, selecionando **Plataforma ou idioma** como `Linux x86-64`.

### Utilitário OPatch mais recente
<a name="custom-oracle-opatch"></a>

[Patch 6880880](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=6880880)

### Patches da PSU de janeiro de 2023
<a name="custom-oracle-jan-2023-patches"></a>

**Patches da PSU e da RU do banco de dados**
+ [Patch 34765931](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=34765931)
+ [Patch 34786990](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=34786990)

**Patches adicionais necessários**
+ [Patch 35099667](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=35099667)
+ [Patch 35099674](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=35099674)
+ [Patch 28730253](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=28730253)
+ [Patch 29213893](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=29213893)
+ [Patch 35012866](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=35012866)

### Patches da PSU de abril de 2023
<a name="custom-oracle-apr-2023-patches"></a>

**Patches da PSU e da RU do banco de dados**
+ [Patch 35042068](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=35042068)
+ [Patch 35050341](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=35050341)

**Patches adicionais necessários**
+ [Patch 28730253](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=28730253)
+ [Patch 29213893](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=29213893)
+ [Patch 33125873](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=33125873)
+ [Patch 35220732](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=35220732)
+ [Patch 35239280](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=35239280)

### Configuração de bucket do Amazon S3
<a name="custom-oracle-s3-setup"></a>

1. Crie um bucket do Amazon S3 no sua Conta da AWS ou escolha um bucket existente.

1. Crie uma estrutura de pastas no bucket semelhante ao exemplo abaixo.

   ```
   <bucket-name>/
   └── oracle_cev/
       ├── V982063-01.zip
       ├── p6880880_190000_Linux-x86-64.zip
       ├── p34765931_190000_Linux-x86-64.zip
       ├── p34786990_190000_Linux-x86-64.zip
       ├── p35099667_190000_Linux-x86-64.zip
       ├── p35099674_190000_Generic.zip
       ├── p28730253_190000_Linux-x86-64.zip
       ├── p29213893_1918000DBRU_Generic.zip
       ├── p35012866_1918000DBRU_Linux-x86-64.zip
       ├── p35042068_190000_Linux-x86-64.zip
       ├── p35050341_190000_Linux-x86-64.zip
       ├── p29213893_1919000DBRU_Generic.zip
       ├── p33125873_1919000DBRU_Linux-x86-64.zip
       ├── p35220732_190000_Linux-x86-64.zip
       └── p35239280_190000_Generic.zip
   ```

1. Faça upload de todos os arquivos do Oracle que você baixou anteriormente nas pastas apropriadas.

## Implantar o RDS Custom para Oracle usando o AWS CloudFormation
<a name="custom-oracle-deployment-steps"></a>

### Etapa 1: preparar o modelo do CloudFormation
<a name="custom-oracle-step1-prereqs"></a>

Antes de implantar o RDS Custom para Oracle, você precisa baixar e configurar o modelo do CloudFormation que cria os pré-requisitos que devem ser atendidos. 

**Copie e salve o modelo**

1. Acesse [Deploying RDS Custom for Oracle with single and multiple Availability Zones](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-rds-dbinstance.html#aws-resource-rds-dbinstance--examples--Deploying_RDS_Custom_for_Oracle_with_single_and_multiple_Availability_Zones).

1. Copie o modelo no formato de sua preferência (YAML ou JSON).

1. Salve o arquivo no formato YAML ou JSON. Por exemplo, ., `rds-custom-oracle-prereqs.yaml`

**Inicie a pilha no Console da AWS**

1. Abra o Console da AWS e navegue até o AWS CloudFormation.

1. Escolha **Criar pilha** > **Com novos recursos (padrão)**.

1. Selecione **Escolher um modelo existente**. 

1. Selecione **Fazer upload de um arquivo de modelo** > **Escolher arquivo**.

1. Selecione o arquivo de modelo que você baixou anteriormente.

1. Mantenha os valores padrão dos parâmetros.

1. Selecione **Próximo** para criar a pilha.

**Alternativa: usar a AWS CLI**

Em vez de usar o console, você pode criar a pilha usando a AWS CLI:

```
aws cloudformation create-stack \
  --stack-name rds-custom-oracle \
  --template-body file://rds-custom-oracle-prereqs.yaml \
  --capabilities CAPABILITY_NAMED_IAM
```

### Etapa 2: criar as versões personalizadas do mecanismo (CEVs) e as instâncias do Amazon RDS
<a name="custom-oracle-step2-cev-rds"></a>

**Copie e salve o modelo**

1. Acesse [Deploying RDS Custom for Oracle with single and multiple Availability Zones](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-rds-dbinstance.html#aws-resource-rds-dbinstance--examples--Deploying_RDS_Custom_for_Oracle_with_single_and_multiple_Availability_Zones).

1. Copie o modelo no formato de sua preferência (YAML ou JSON).

1. Atualize os seguintes parâmetros no modelo, se necessário:
   + `BucketName`
   + `CEVS3Prefix`
   + Senha principal do banco de dados (substitua \$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1).

1. Salve o arquivo no formato YAML ou JSON.

### Etapa 3: implantar usando o Console da AWS
<a name="custom-oracle-step3-console-deploy"></a>

1. Abra o Console da AWS e navegue até o AWS CloudFormation.

1. Escolha **Criar pilha** > **Com novos recursos (padrão)**.

1. Selecione **Escolher um modelo existente**. 

1. Selecione **Fazer upload de um arquivo de modelo** > **Escolher arquivo**.

1. Selecione o arquivo de modelo que você baixou anteriormente.

1. Deixe os parâmetros como valores padrão.

1. Preencha os parâmetros da seguinte forma:

   ```
   BucketName: rds-custom-id
   CEVS3Prefix: oracle_cev
   CEVCreation: Yes
   ```

1. Analise a configuração e selecione **Próximo** para criar a pilha.

**Opcional: implantar usando a AWS CLI**

```
aws cloudformation create-stack \
  --stack-name rds-custom-oracle \
  --template-body file://rds-custom-oracle.yaml \
  --parameters \
    ParameterKey=BucketName,ParameterValue=rds-custom-id \
    ParameterKey=CEVS3Prefix,ParameterValue=oracle_cev \
    ParameterKey=CEVCreation,ParameterValue=Yes \
  --capabilities CAPABILITY_NAMED_IAM
```

## Recursos de implantação criados
<a name="custom-oracle-deployment-resources"></a>

O modelo de cria os seguintes recursos:
+ Amazon VPC com sub-redes públicas e privadas
+ Grupos de segurança
+ Endpoints da Amazon VPC
+ Perfis e políticas do IAM
+ Chave do KMS para criptografia
+ Versões personalizadas do mecanismo
+ Instâncias do RDS Custom para Oracle para configurações single-AZ e multi-AZ

## Monitorar o andamento da implantação
<a name="custom-oracle-monitoring-deployment"></a>

Depois de criar a pilha do CloudFormation, monitore o andamento para garantir uma implantação bem-sucedida. O processo de implantação inclui a criação de versões personalizadas do mecanismo (CEVs) e instâncias do RDS.

Para monitorar o andamento da implantação:

1. Abra o CloudFormation Console.

1. Escolha o nome da pilha.

1. Escolha a guia **Eventos** para visualizar o andamento e identificar erros.

**nota**  
A criação de uma CEV normalmente requer de duas a três horas. Após a conclusão bem-sucedida da criação da CEV, o Amazon RDS começa automaticamente a criar a instância do Amazon RDS.

## Pós-implantação
<a name="custom-oracle-post-deployment"></a>

Após a conclusão do processo de criação da pilha, execute as seguintes etapas de verificação e configuração pós-implantação:

1. Na página do console do Amazon RDS, navegue até **Versões personalizadas do mecanismo** para verificar a criação da CEV.

1. Confirme se as instâncias do Amazon RDS foram criadas e estão disponíveis.

1. Teste a conectividade com as instâncias do Amazon RDS.

1. Configure estratégias de monitoramento e backup conforme necessário.

## Limpeza
<a name="custom-oracle-cleanup"></a>

Para remover todos os recursos, execute o seguinte comando da AWS CLI:

```
aws cloudformation delete-stack --stack-name rds-custom-oracle
```

## Solução de problemas
<a name="custom-oracle-troubleshooting"></a>

Se você encontrar problemas durante a implantação, use as soluções a seguir para resolver problemas comuns.

Falha na criação da CEV  
+ Verifique se todos os patches necessários foram enviados ao Amazon S3.
+ Confira as suas permissões do IAM.
+ Verifique se as versões do patch estão corretas. Consulte os [Pré-requisitos](#custom-oracle-prerequisites) para ver a lista dos patches necessários.

Falha na criação da instância do Amazon RDS  
+ Confira as configurações de VPC/sub-rede.
+ Verifique as regras de grupo de segurança.
+ Confirme se a CEV está disponível.