

# Fazer upgrade de uma instância de banco de dados para o RDS Custom for Oracle
<a name="custom-upgrading-modify"></a>

Para fazer upgrade da sua instância de banco de dados do RDS Custom, você a modifica para utilizar uma nova CEV. Esse CEV pode conter novos binários de banco de dados ou uma nova AMI. Por exemplo, para atualizar sua instância de banco de dados Oracle Linux 7.9 para o Oracle Linux 8, especifique a AMI mais recente, que usa o Oracle Linux 8. Para atualizar o banco de dados e o sistema operacional, deverá realizar duas atualizações separadas.

**nota**  
Se você atualizar o banco de dados, o RDS Custom atualizará automaticamente as réplicas de leitura após atualizar a instância de banco de dados primária. Se você atualizar o SO, deverá atualizar as réplicas manualmente.

Antes de começar, revise [Requisitos para atualizações do RDS Custom para Oracle](custom-upgrading.md#custom-upgrading-reqs) [Considerações sobre atualizações do banco de dados do RDS Custom para Oracle](custom-upgrading-considerations.md) e. 

## Console
<a name="custom-upgrading-modify.CON"></a>

**Como modificar uma instância de banco de dados do RDS Custom para Oracle**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. No painel de navegação, escolha **Databases** (Bancos de dados) e a instância de banco de dados do RDS Custom para SQL Server que você deseja excluir.

1. Selecione **Modify**. A página **Modify DB instance (Modificar instância de banco de dados)** será exibida.

1. Em **DB engine version** (Versão do mecanismo de banco de dados), selecione outra CEV. Faça o seguinte:
   + Se você estiver corrigindo o banco de dados, certifique-se de que o CEV especifique binários de banco de dados diferentes daqueles usados pela sua instância de banco de dados e não especifique uma AMI diferente da AMI usada atualmente pela sua instância de banco de dados.
   + Se você estiver corrigindo o sistema operacional, certifique-se de que o CEV especifique uma AMI diferente da AMI usada atualmente pela sua instância de banco de dados e não especifique binários de banco de dados diferentes.
**Atenção**  
Ao corrigir seu sistema operacional, você perde os dados do volume raiz e qualquer personalização existente do sistema operacional.

1. Escolha **Continue** (Continuar) e verifique o resumo de modificações.

   Escolha **Apply immediately (Aplicar imediatamente)** para aplicar as alterações imediatamente.

1. Se estiverem corretas, escolha **Modify DB Instance** (Modificar instância de banco de dados). Ou escolha **Back (Voltar)** para editar as alterações ou **Cancel (Cancelar)** para cancelar as alterações.

## AWS CLI
<a name="custom-upgrading-modify.CLI"></a>

Os exemplos a seguir mostram possíveis cenários de atualização. Os exemplos pressupõem que você criou uma instância de banco de dados do RDS Custom for Oracle com as seguintes características:
+ Nome da instância de banco de dados
+ CEV chamado `19.my_cev1`
+ Oracle Database 19c usando a arquitetura não CDB
+ Oracle Linux 8 usando AMI `ami-1234`

A AMI mais recente fornecida pelo serviço é. `ami-2345` Você pode encontrar o endpoint executando o comando `describe-db-engine-versions` da CLI:

**Topics**
+ [Atualizando o SO](#custom-upgrading-modify.CLI.os)
+ [Atualizando o banco de dados](#custom-upgrading-modify.CLI.db)

### Atualizando o SO
<a name="custom-upgrading-modify.CLI.os"></a>

Neste exemplo, você deseja fazer o upgrade `ami-1234` para`ami-2345`, que é a AMI mais recente fornecida pelo serviço. Como essa é uma atualização do sistema operacional, os binários do banco de dados para `ami-1234` e `ami-2345` devem ser os mesmos. Você cria um novo CEV chamado `19.my_cev2` com base em. `19.my_cev1`

**Example**  
Para Linux, macOS ou Unix:  

```
aws rds create-custom-db-engine-version \
    --engine custom-oracle-ee \
    --engine-version 19.my_cev2 \
    --description "Non-CDB CEV based on ami-2345" \
    --kms-key-id key-name \
    --source-custom-db-engine-version-identifer arn:aws:rds:us-west-2:123456789012:cev:custom-oracle-ee/19.my_cev1/12345678-ab12-1234-cde1-abcde123456789 \
    --image-id ami-2345
```
Para Windows:  

```
aws rds create-custom-db-engine-version ^
    --engine custom-oracle-ee ^
    --engine-version 19.my_cev2 ^
    --description "Non-CDB CEV based on ami-2345" ^
    --kms-key-id key-name ^
    --source-custom-db-engine-version-identifer arn:aws:rds:us-west-2:123456789012:cev:custom-oracle-ee/19.my_cev1/12345678-ab12-1234-cde1-abcde123456789 ^
    --image-id ami-2345
```

Para fazer upgrade de uma instância de banco de dados do RDS Custom, utilize o comando [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) da AWS CLI com os seguintes parâmetros:
+ `--db-instance-identifier`— Especifique a instância de banco de dados do RDS Custom for Oracle a ser atualizada.
+ `--engine-version`— Especifique o CEV que tem a nova AMI.
+ `--no-apply-immediately` \$1 `--apply-immediately` – Se você deseja realizar o upgrade imediatamente ou aguardar até a janela de manutenção agendada

O exemplo a seguir faz upgrade do `my-custom-instance` para a versão `19.my_cev2`. Somente o sistema operacional é atualizado.

**Example**  
Para Linux, macOS ou Unix:  

```
aws rds modify-db-instance \
    --db-instance-identifier my-custom-instance \
    --engine-version 19.my_cev2 \
    --apply-immediately
```
Para Windows:  

```
aws rds modify-db-instance ^
    --db-instance-identifier my-custom-instance ^
    --engine-version 19.my_cev2 ^
    --apply-immediately
```

### Atualizando o banco de dados
<a name="custom-upgrading-modify.CLI.db"></a>

Neste exemplo, convém aplicar o patch Oracle p35042068 à instância de banco de dados do RDS para Oracle. Como você atualizou seu sistema operacional em[Atualizando o SO](#custom-upgrading-modify.CLI.os), sua instância de banco de dados está sendo usada atualmente`19.my_cev2`, com base em`ami-2345`. Você cria um novo CEV chamado `19.my_cev3` que também usa`ami-2345`, mas especifica um novo manifesto JSON na variável de `$MANIFEST` ambiente. Portanto, somente os binários do banco de dados são diferentes em seu novo CEV e no CEV que sua instância está usando atualmente.

**Example**  
Para Linux, macOS ou Unix:  

```
aws rds create-custom-db-engine-version \
    --engine custom-oracle-ee \
    --engine-version 19.my_cev3 \
    --description "Non-CDB CEV with p35042068 based on ami-2345" \
    --kms-key-id key-name \
    --image-id ami-2345 \
    --manifest $MANIFEST
```
Para Windows:  

```
aws rds create-custom-db-engine-version ^
    --engine custom-oracle-ee ^
    --engine-version 19.my_cev3 ^
    --description "Non-CDB CEV with p35042068 based on ami-2345" ^
    --kms-key-id key-name ^
    --image-id ami-2345 ^
    --manifest $MANIFEST
```

O exemplo a seguir faz upgrade do `my-custom-instance` para a versão `19.my_cev3`. Somente o banco de dados é atualizado.

**Example**  
Para Linux, macOS ou Unix:  

```
aws rds modify-db-instance \
    --db-instance-identifier my-custom-instance \
    --engine-version 19.my_cev3 \
    --apply-immediately
```
Para Windows:  

```
aws rds modify-db-instance ^
    --db-instance-identifier my-custom-instance ^
    --engine-version 19.my_cev3 ^
    --apply-immediately
```