Mise à niveau d'une instance de base de données pour Amazon RDS Custom for Oracle

Vous pouvez mettre à niveau une instance de base de données Amazon RDS Custom en la modifiant pour qu'elle utilise une nouvelle version de moteur personnalisée (CEV). Pour des informations générales sur les mises à niveau, consultez Mise à niveau de la version du moteur d'une instance de base de données.

Présentation des mises à niveau dans RDS Custom for Oracle

Avec RDS Custom for Oracle, vous pouvez appliquer des correctifs à votre base de données Oracle ou à votre système d'exploitation (SE) d'instance de base de données en créant de nouveaux CEV, puis en modifiant votre instance pour qu'elle utilise le nouveau CEV.

Options de mise à niveau de CEV

Lorsque vous créez un CEV pour une mise à niveau, les options suivantes s'excluent mutuellement :

Si vous souhaitez mettre à niveau à la fois le système d'exploitation et la base de données, vous devez mettre à niveau le CEV deux fois. Vous pouvez mettre à niveau le système d'exploitation puis la base de données, ou inversement.

Application de correctifs sans CEV

Nous vous recommandons vivement de mettre à niveau votre instance de base de données RDS Custom for Oracle à l'aide des CEV. L'automatisation de RDS Custom for Oracle synchronise les métadonnées du correctif avec le binaire de la base de données sur votre instance de base de données.

Dans des circonstances particulières, RDS Custom prend en charge l'application d'un correctif de base de données « unique » directement sur l'instance Amazon EC2 sous-jacente à l'aide de l'utilitaire OPatch. Un cas d'utilisation valide pourrait être un correctif de base de données que vous voulez appliquer immédiatement, mais l'équipe de RDS Custom est en train de mettre à jour la fonctionnalité CEV, ce qui entraîne un retard. Pour appliquer un correctif de base de données manuellement, procédez comme suit :

L'inconvénient de la technique précédente est que vous devez appliquer le correctif de base de données manuellement à chaque instance que vous souhaitez mettre à niveau. En revanche, lorsque vous créez un nouveau CEV, vous pouvez créer ou mettre à niveau plusieurs instances de base de données en utilisant le même CEV.

Étapes générales pour appliquer des correctifs à votre instance de base de données avec un CEV

Effectuez les étapes de base suivantes, que vous appliquiez des correctifs au système d'exploitation ou à votre base de données :

Exigences pour les mises à niveau de RDS Custom for Oracle

Lors de la mise à niveau de votre instance de base de données RDS Custom for Oracle vers une CEV cible, vérifiez que les conditions suivantes sont respectées :

Considérations relatives aux mises à niveau des bases de données RDS Custom for Oracle

Si vous envisagez de mettre à niveau votre base de données, tenez compte des points suivants :

Considérations relatives aux mises à niveau de RDS Custom pour le système d'exploitation Oracle

Lorsque vous planifiez une mise à niveau du système d'exploitation, tenez compte des points suivants :

Affichage des cibles de mise à niveau de CEV valides pour les instances de base de données RDS Custom for Oracle

Vous pouvez consulter les CEV existantes sur la page Versions de moteur personnalisées de la AWS Management Console.

Vous pouvez également utiliser la AWS CLI commande describe-db-engine-versions pour trouver des CEV valides à utiliser lors de la mise à niveau de vos instances de base de données, comme illustré dans l'exemple suivant. Cet exemple suppose que vous avez créé une instance de base de données à l'aide de la version de moteur 19.my_cev1 et que les versions de mise à niveau 19.my_cev2 et 19.my_cev existent.

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

La sortie se présente comme suit : Le champ ImageId indique l'ID d'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
                }
            ]
            ...

Mise à niveau d'une instance de base de données RDS Custom for Oracle

Pour mettre à niveau votre instance de base de données RDS Custom for Oracle, modifiez-la pour qu'elle utilise un nouveau CEV. Ce CEV peut contenir de nouveaux fichiers binaires de base de données ou une nouvelle AMI. Si vous souhaitez mettre à niveau la base de données et le système d'exploitation, vous devez effectuer deux mises à niveau distinctes.

Avant de commencer, consultez Exigences pour les mises à niveau de RDS Custom for Oracle et Considérations relatives aux mises à niveau des bases de données RDS Custom for Oracle.

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

Affichage des mises à niveau de base de données en attente pour les instances de base de données RDS Custom

Vous pouvez voir les mises à niveau de base de données en attente pour vos instances de base de données personnalisées Amazon RDS à l'aide de la commande describe-db-instances ou describe-pending-maintenance-actions. AWS CLI

Notez toutefois que cette méthode ne fonctionne pas si vous avez utilisé l'option --apply-immediately ou si la mise à niveau est en cours.

La commande describe-db-instances suivante affiche les mises à niveau de base de données en attente pour my-custom-instance.

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

La sortie se présente comme suit :

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

Dépannage d'un échec de mise à niveau pour une instance de base de données RDS Custom Oracle

En cas d'échec de la mise à niveau d'une instance de base de données RDS Custom, un événement RDS est généré et l'état de l'instance est défini sur upgrade-failed.

Vous pouvez voir cet état à l'aide de la AWS CLI commande describe-db-instances, comme illustré dans l'exemple suivant.

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

La sortie se présente comme suit :

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

Après un échec de mise à niveau, toutes les actions de base de données sont bloquées, à l'exception de la modification de l'instance de base de données pour effectuer les tâches suivantes :

Pour de plus amples informations, veuillez consulter Dépannage des mises à niveau de RDS Custom for Oracle.