Fazer upgrade de uma instância de banco de dados para o Amazon RDS Custom for Oracle

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.

Visão geral das atualizações do mecanismo RDS para Oracle

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.

Opções de atualização de CEV

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

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.

Aplicação de patches sem CEVs

É 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:

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

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

Requisitos para atualizações do RDS Custom para Oracle

Para atualizar a instância de banco de dados do RDS Custom para Oracle, os seguintes requisitos devem ser atendidos:

Considerações sobre atualizações do banco de dados do RDS Custom para Oracle

Se você planeja atualizar o banco de dados, pense no seguinte:

Considerações sobre atualizações do sistema operacional do RDS Custom para Oracle

Ao planejar uma atualização do sistema operacional, pense no seguinte:

Visualizar destinos de upgrade válidos para instâncias de banco de dados do RDS Custom for Oracle

Você pode visualizar CEVs existentes na página Custom engine versions (Versões de mecanismo personalizadas) no AWS Management Console.

Também pode utilizar o comando describe-db-engine-versions da AWS CLI para encontrar upgrades válidos para suas instâncias de banco de dados, como mostra o exemplo a seguir. Este exemplo pressupõe que você criou uma instância de banco de dados usando a versão 19.my_cev1 do mecanismo e que as versões 19.my_cev2 de upgrade 19.my_cev existem.

aws rds describe-db-engine-versions --engine custom-oracle-ee --engine-version 19.my_cev1

A saída será semelhante à seguinte. O ImageId campo mostra o ID da AMI.

{
    "DBEngineVersions": [
        {
            "Engine": "custom-oracle-ee",
            "EngineVersion": "19.my_cev1",
            ...
            "Image": {
                "ImageId": "ami-2345",
                "Status": "active"
            },
            "DBEngineVersionArn": "arn:aws:rds:us-west-2:123456789012:cev:custom-oracle-ee/19.my_cev1/12a34b5c-67d8-90e1-2f34-gh56ijk78lm9"
            "ValidUpgradeTarget": [
                {
                    "Engine": "custom-oracle-ee",
                    "EngineVersion": "19.my_cev2",
                    "Description": "19.my_cev2 description",
                    "AutoUpgrade": false,
                    "IsMajorVersionUpgrade": false
                },
                {
                    "Engine": "custom-oracle-ee",
                    "EngineVersion": "19.my_cev3",
                    "Description": "19.my_cev3 description",
                    "AutoUpgrade": false,
                    "IsMajorVersionUpgrade": false
                }
            ]
            ...

Fazer upgrade de uma instância de banco de dados para o RDS Custom for Oracle

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. Se você quiser atualizar o banco de dados e o sistema operacional, deverá realizar duas atualizações separadas.

Antes de começar, revise Requisitos para atualizações do RDS Custom para Oracle Considerações sobre atualizações do banco de dados do RDS Custom para Oracle e.

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

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

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

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

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

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

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

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

Visualizar upgrades pendentes para instâncias de banco de dados do RDS Custom

É possível ver upgrades pendentes para as instâncias de banco de dados do Amazon RDS Custom utilizando o comando describe-db-instances ou describe-pending-maintenance-actions da AWS CLI.

Contudo, essa abordagem não funcionará se você tiver usado a opção --apply-immediately ou se o upgrade estiver em andamento.

O comando describe-db-instances a seguir mostra upgrades pendentes para my-custom-instance.

aws rds describe-db-instances --db-instance-identifier my-custom-instance

A saída será semelhante à seguinte.

{
    "DBInstances": [
        {
           "DBInstanceIdentifier": "my-custom-instance",
            "EngineVersion": "19.my_cev1",
            ...
            "PendingModifiedValues": {
                "EngineVersion": "19.my_cev3"
            ...
            }
        }
    ]
}

Solucionar falha no upgrade de uma instância de banco de dados do RDS Custom para Oracle

Se um upgrade de instância de banco de dados do RDS Custom falhar, um evento do RDS será gerado, e o status da instância de banco de dados se tornará upgrade-failed.

Você pode ver esse status utilizando o comando describe-db-instances da AWS CLI, como mostra o exemplo a seguir.

aws rds describe-db-instances --db-instance-identifier my-custom-instance

A saída será semelhante à seguinte.

{
    "DBInstances": [
        {
           "DBInstanceIdentifier": "my-custom-instance",
            "EngineVersion": "19.my_cev1",
            ...
            "PendingModifiedValues": {
                "EngineVersion": "19.my_cev3"
            ...
            }
            "DBInstanceStatus": "upgrade-failed"
        }
    ]
}

Após uma falha de upgrade, todas as ações do banco de dados são bloqueadas, exceto para modificar a instância de banco de dados para realizar as seguintes tarefas:

Para obter mais informações, consulte Solucionar problemas de upgrade do RDS Custom para Oracle.