

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

**nota**  
Aviso de fim do suporte: em 31 de março de 2027, a AWS encerrará o suporte para o Amazon RDS Custom para Oracle. Depois de 31 de março de 2027, você não poderá mais acessar o console nem os recursos do RDS Custom para Oracle. Para obter mais informações, consulte [Fim do suporte do RDS Custom para Oracle](RDS-Custom-for-Oracle-end-of-support.md).

Você pode fazer upgrade de uma instância de banco de dados do Amazon RDS Custom modificando-a para utilizar uma nova versão de mecanismo personalizada (CEV). Para obter informações gerais sobre upgrades, consulte [Atualizar a versão de mecanismo de uma instância de banco de dados ](USER_UpgradeDBInstance.Upgrading.md).

**Topics**
+ [Visão geral das atualizações do mecanismo RDS para Oracle](#custom-upgrading.overview)
+ [Requisitos para atualizações do RDS Custom para Oracle](#custom-upgrading-reqs)
+ [Considerações sobre atualizações do banco de dados do RDS Custom para Oracle](custom-upgrading-considerations.md)
+ [Considerações sobre atualizações do sistema operacional do RDS Custom para Oracle](custom-upgrading-considerations-os.md)
+ [Visualizar destinos de upgrade válidos para instâncias de banco de dados do RDS Custom for Oracle](custom-upgrading-target.md)
+ [Fazer upgrade de uma instância de banco de dados para o RDS Custom for Oracle](custom-upgrading-modify.md)
+ [Visualizar upgrades pendentes para instâncias de banco de dados do RDS Custom](custom-upgrading-pending.md)
+ [Solucionar falha no upgrade de uma instância de banco de dados do RDS Custom para Oracle](custom-upgrading-failure.md)

## Visão geral das atualizações do mecanismo RDS para Oracle
<a name="custom-upgrading.overview"></a>

Com o RDS Custom for Oracle, você pode corrigir seu banco de dados Oracle ou seu sistema operacional (OS) de instância de banco de dados criando novos CEVs e modificando sua instância para usar o novo CEV.

**Topics**
+ [Opções de atualização de CEV](#custom-upgrading.overview.cev-options)
+ [Aplicação de patches sem CEVs](#custom-upgrading.overview.no-cevs)
+ [Etapas gerais para corrigir sua instância de banco de dados com um CEV](#custom-upgrading.overview.general-steps)

### Opções de atualização de CEV
<a name="custom-upgrading.overview.cev-options"></a>

Ao criar uma CEV para uma atualização, existem as seguintes opções mutuamente exclusivas:

**Somente banco de dados**  
Reutilize a Amazon Machine Image (AMI) atualmente em uso pela sua instância de banco de dados, mas especifique diferentes binários de banco de dados. O RDS Custom aloca um novo volume binário e o anexa à instância existente do Amazon EC2. O RDS Custom substituem o volume completo do banco de dados por um novo volume que usa a versão do banco de dados de destino.

**Somente sistema operacional**  
Reutilize os binários do banco de dados atualmente em uso pela sua instância de banco de dados, mas especifique uma AMI diferente. O RDS Custom aloca uma nova instância do Amazon EC2 e, em seguida, anexa o volume binário existente à nova instância. O volume do banco de dados existente é mantido.

Se você quiser atualizar o sistema operacional e o banco de dados, deverá atualizar o CEV duas vezes. Você pode atualizar o sistema operacional e depois o banco de dados ou atualizar o banco de dados e depois o sistema operacional.

**Atenção**  
Ao corrigir seu sistema operacional, você perde os dados do volume raiz e qualquer personalização existente do sistema operacional. Portanto, é altamente recomendável não usar o volume para instalações ou para armazenar dados ou arquivos permanentes. Recomendamos também que você faça backup dos dados antes da atualização.

### Aplicação de patches sem CEVs
<a name="custom-upgrading.overview.no-cevs"></a>

É altamente recomendável que você faça upgrade de sua instância de banco de dados do RDS Custom para Oracle usando CEVs. A automação do RDS Custom para Oracle sincroniza os metadados do patch com o binário do banco de dados na instância de banco de dados

Em circunstâncias especiais, o RDS Custom oferece suporte à aplicação de um patch “único” diretamente na instância subjacente do Amazon EC2 usando OPATCH. Um caso de uso válido pode ser um patch que você queira aplicar imediatamente, mas a equipe do RDS Custom está atualizando o recurso de CEV, causando um atraso. Para aplicar um patch manualmente, realize as seguintes etapas:

1. Pause a automação do RDS Custom.

1. Aplique seu patch nos binários de banco de dados na instância do Amazon EC2.

1. Retome a automação do RDS Custom.

Uma desvantagem da técnica anterior é que você deve aplicar o patch manualmente em cada instância que deseja atualizar. Por outro lado, ao criar uma CEV, você pode criar ou fazer upgrade de várias instâncias de banco de dados usando a mesma CEV.

### Etapas gerais para corrigir sua instância de banco de dados com um CEV
<a name="custom-upgrading.overview.general-steps"></a>

Se você aplicar patches no SO ou no banco de dados, execute as seguintes etapas básicas:

1. Crie um CEV que contenha um dos itens a seguir, dependendo se você está corrigindo o banco de dados ou o sistema operacional:
   + A Oracle Database RU que deseja aplicar à instância de banco de dados
   + Uma AMI diferente — a mais recente disponível ou a que você especificar — e um CEV existente para usar como fonte

   Siga as etapas em [Criar um CEV](custom-cev.create.md).

1. (Opcional para aplicação de patches no banco de dados) Verifique as atualizações disponíveis da versão do mecanismo executando. `describe-db-engine-versions`

1. Inicie o processo de aplicação de patches executando`modify-db-instance`.

   O status da instância que está sendo corrigida difere da seguinte forma:
   + **Enquanto o RDS aplica patches no banco de dados, o status da instância de banco de dados muda para Atualização.** 
   + **Enquanto o RDS aplica patches no SO, o status da instância de banco de dados muda para Modificando.**

   Quando a instância de banco de dados tem o status **Disponível**, a correção é concluída.

1. Confirme se sua instância de banco de dados usa o novo CEV executando`describe-db-instances`.

## Requisitos para atualizações do RDS Custom para Oracle
<a name="custom-upgrading-reqs"></a>

Para atualizar a instância de banco de dados do RDS Custom para Oracle, os seguintes requisitos devem ser atendidos:
+ A CEV de destino para o qual você está fazendo a atualização deve existir.
+ Você deve atualizar o sistema operacional ou o banco de dados em uma única operação. Não há suporte para atualizar o sistema operacional e o banco de dados em uma única chamada de API.
+ A CEV de destino deve usar as configurações dos parâmetros de instalação que estão no manifesto da CEV atual. Por exemplo, não é possível atualizar um banco de dados que use o Oracle home padrão para uma CEV que use um Oracle home não padrão.
+ A CEV de destino deve usar uma nova versão secundária do banco de dados, não uma nova versão principal. Por exemplo, não é possível fazer atualização de uma CEV do Oracle Database 12c para uma CEV do Oracle Database 19c. Mas é possível atualizar da versão 2.,0.0.0.ru-2023-04.rur-2023-04.r1 para a versão 21.0.0.0.ru-2023-07.rur-2023-07.r1.
+ Para atualizações do sistema operacional, o CEV de destino deve usar uma AMI diferente, mas ter a mesma versão principal.