

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Mise à niveau d'une instance de base de données pour Amazon RDS Custom for Oracle
<a name="custom-upgrading"></a>

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 d'une version du moteur d'une instance de base de données](USER_UpgradeDBInstance.Upgrading.md).

**Topics**
+ [Présentation des mises à niveau dans RDS Custom for Oracle](#custom-upgrading.overview)
+ [Exigences pour les mises à niveau de RDS Custom for Oracle](#custom-upgrading-reqs)
+ [Considérations pour les mises à niveau de la base de données RDS Custom for Oracle](custom-upgrading-considerations.md)
+ [Considérations pour les mises à niveau du système d’exploitation de RDS Custom for Oracle](custom-upgrading-considerations-os.md)
+ [Affichage des cibles de mise à niveau de CEV valides pour les instances de base de données RDS Custom for Oracle](custom-upgrading-target.md)
+ [Mise à niveau d'une instance de base de données RDS Custom for Oracle](custom-upgrading-modify.md)
+ [Affichage des mises à niveau de base de données en attente pour les instances de base de données RDS Custom](custom-upgrading-pending.md)
+ [Dépannage d'un échec de mise à niveau pour une instance de base de données RDS Custom Oracle](custom-upgrading-failure.md)

## Présentation des mises à niveau dans RDS Custom for Oracle
<a name="custom-upgrading.overview"></a>

Avec RDS Custom for Oracle, vous pouvez appliquer des correctifs à votre base de données Oracle ou à votre système d'exploitation (OS) d'instance de base de données en créant une nouvelle instance, CEVs puis en la modifiant pour utiliser le nouveau CEV.

**Topics**
+ [Options de mise à niveau de CEV](#custom-upgrading.overview.cev-options)
+ [Appliquer des correctifs sans CEVs](#custom-upgrading.overview.no-cevs)
+ [Étapes générales pour appliquer des correctifs à votre instance de base de données avec un CEV](#custom-upgrading.overview.general-steps)

### Options de mise à niveau de CEV
<a name="custom-upgrading.overview.cev-options"></a>

Lorsque vous créez une CEV pour une mise à niveau, vous disposez des options qui s’excluent mutuellement suivantes :

**Base de données uniquement**  
Réutilisez l'Amazon Machine Image (AMI) actuellement utilisée par votre instance de base de données, mais spécifiez des fichiers binaires de base de données différents. RDS Custom alloue un nouveau volume binaire, puis l'attache à l'instance Amazon EC2 existante. RDS Custom remplace l'intégralité du volume de base de données par un nouveau volume utilisant la version de votre base de données cible.

**Système d'exploitation uniquement**  
Réutilisez les fichiers binaires de base de données actuellement utilisés par votre instance de base de données, mais spécifiez une autre AMI. RDS Custom alloue une nouvelle instance Amazon EC2, puis lui attache le volume binaire existant. Le volume de base de données existant est conservé.

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.

**Avertissement**  
Lorsque vous appliquez un correctif à votre système d'exploitation, vous perdez les données de votre volume racine ainsi que toute personnalisation existante du système d'exploitation. Par conséquent, nous vous recommandons vivement de ne pas utiliser le volume racine pour les installations ou pour le stockage de données ou de fichiers permanents. Nous vous recommandons également de sauvegarder vos données avant la mise à niveau.

### Appliquer des correctifs sans CEVs
<a name="custom-upgrading.overview.no-cevs"></a>

Nous vous recommandons vivement de mettre à niveau votre instance de base de données RDS Custom pour Oracle à l'aide CEVs de. 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 à 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 :

1. Mettez en pause l'automatisation de RDS Custom.

1. Appliquez votre correctif aux binaires de la base de données sur l'instance Amazon EC2.

1. Relancez l'automatisation de RDS Custom.

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
<a name="custom-upgrading.overview.general-steps"></a>

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

1. Créez un CEV contenant l'un des éléments suivants, selon que vous appliquez des correctifs à la base de données ou au système d'exploitation :
   + La révision de mise à jour de base de données Oracle que vous souhaitez appliquer à votre instance de base de données
   + Une autre AMI, soit la plus récente disponible, soit celle que vous spécifiez, et un CEV existant à utiliser comme source

   Suivez les étapes de [Création d'une CEV](custom-cev.create.md).

1. (Facultatif pour l'application de correctifs à la base de données) Vérifiez les mises à niveau de version du moteur disponibles en exécutant `describe-db-engine-versions`.

1. Lancez le processus d'application des correctifs en exécutant `modify-db-instance`.

   L'état de l'instance à laquelle le correctif est appliqué diffère comme suit :
   + Lorsque RDS applique des correctifs à la base de données, le statut de l'instance de base de données devient **Mise à niveau en cours**. 
   + Lorsque RDS applique des correctifs au système d'exploitation, le statut de l'instance de base de données devient **Modification en cours**.

   Lorsque l'instance de base de données a le statut **Disponible**, l'application des correctifs est terminée.

1. Vérifiez que votre instance de base de données utilise le nouveau CEV en exécutant `describe-db-instances`.

## Exigences pour les mises à niveau de RDS Custom for Oracle
<a name="custom-upgrading-reqs"></a>

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 :
+ La CEV cible vers laquelle vous effectuez la mise à niveau doit exister.
+ Vous devez mettre à niveau le système d'exploitation ou la base de données au cours d'une seule opération. La mise à niveau du système d'exploitation et de la base de données en un seul appel d'API n'est pas prise en charge.
+ La CEV cible doit utiliser les paramètres d'installation qui figurent dans le manifeste de la CEV actuelle. Par exemple, vous ne pouvez pas mettre à niveau une base de données qui utilise le répertoire de base de base de données Oracle par défaut vers une version CEV qui utilise un autre répertoire de base de base de données Oracle.
+ Pour les mises à niveau de base de données, le CEV cible doit utiliser une nouvelle version mineure de base de données, et non une nouvelle version majeure. Par exemple, vous ne pouvez pas mettre à niveau une CEV Oracle Database 12c vers une CEV Oracle Database 19c. En revanche, vous pouvez mettre à niveau la version 21.0.0.0.ru-2023-04.rur-2023-04.r1 vers la version 21.0.0.0.ru-2023-07.rur-2023-07.r1.
+ Pour les mises à niveau du système d'exploitation, le CEV cible doit utiliser une AMI différente mais disposer de la même version majeure.

# Considérations pour les mises à niveau de la base de données RDS Custom for Oracle
<a name="custom-upgrading-considerations"></a>

Si vous prévoyez de mettre à niveau votre base de données, tenez compte des éléments suivants :
+ La version du système d’exploitation actuellement prise en charge est Oracle Linux 8. Pour continuer à recevoir les dernières mises à jour de sécurité et les derniers correctifs de la part de RDS Custom for Oracle, mettez à niveau vos instances de base de données vers Oracle Linux 8 en spécifiant une CEV basée sur ce système d’exploitation. Oracle Database 12c Version 1 (12.1), Oracle Database Version 2 (12.2) et Oracle Database 19c sont les seules versions qui prennent en charge Oracle Linux 8. Pour migrer vers la dernière AMI Oracle Linux 8, mettez à niveau votre système d’exploitation vers la dernière AMI. Pour de plus amples informations, veuillez consulter [Mise à niveau d'une instance de base de données RDS Custom for Oracle](custom-upgrading-modify.md).

  Le support d’Oracle Linux 7.9 a pris fin le 31 décembre 2024. Pour continuer à exécuter Oracle Linux 7 après la fin du support, achetez une licence Oracle Extended Support. Vous êtes responsable des mises à jour de sécurité et devez corriger manuellement vos instances RDS Custom for Oracle. Pour plus d’informations, consultez [Politique de prise en charge à vie : couverture des offres de services Open Source d’Oracle](https://www.oracle.com/a/ocom/docs/elsp-lifetime-069338.pdf).
+ Lorsque vous mettez à niveau les fichiers binaires de base de données dans votre instance de base de données principale, RDS Custom for Oracle met automatiquement à niveau vos réplicas en lecture. Lorsque vous mettez à niveau le système d’exploitation, vous devez mettre à niveau les réplicas en lecture manuellement.
+ Lorsque vous mettez à niveau une base de données de conteneurs (CDB) vers une nouvelle version de base de données, RDS Custom for Oracle vérifie que toutes PDBs sont ouvertes ou pourraient être ouvertes. Si ces conditions ne sont pas remplies, RDS Custom arrête la vérification et rétablit l'état d'origine de la base de données sans tenter de procéder à la mise à niveau. Si les conditions sont remplies, RDS Custom applique d'abord des correctifs à la racine de la base de données, puis applique des correctifs à toutes les autres PDBs (y compris`PDB$SEED`) en parallèle.

  Une fois le correctif terminé, RDS Custom tente de tout ouvrir. PDBs Si l'un d'entre eux PDBs ne s'ouvre pas, vous recevez l'événement suivant :`The following PDBs failed to open: list-of-PDBs`. Si RDS Custom ne parvient pas à appliquer un correctif à la racine de la CDB ou à une autre PDBs, l'instance est mise dans l'`PATCH_DB_FAILED`état.
+ Vous souhaiterez peut-être effectuer simultanément une mise à niveau de version majeure de base de données et une conversion d'une base de données non-CDB en CDB. Dans ce cas, nous vous recommandons de procéder comme suit :

  1. Créez une nouvelle instance de base de données RDS Custom for Oracle qui utilise l’architecture multilocataire Oracle.

  1. Connectez une base de données non-CDB à votre racine CDB, en la créant en tant que PDB. Veillez à ce que la base de données non-CDB ait la même version majeure que votre CDB.

  1. Convertissez votre PDB en exécutant le script Oracle SQL `noncdb_to_pdb.sql`.

  1. Validez votre instance de CDB.

  1. Mettez à niveau votre instance de CDB.

# Considérations pour les mises à niveau du système d’exploitation de RDS Custom for Oracle
<a name="custom-upgrading-considerations-os"></a>

Lorsque vous planifiez une mise à niveau du système d’exploitation, prenez en compte les points suivants :
+ Vous ne pouvez pas fournir votre propre AMI à utiliser dans une CEV RDS Custom for Oracle. Vous pouvez spécifier soit l’AMI par défaut, qui utilise Oracle Linux 8, soit une AMI précédemment utilisée par une CEV RDS Custom for Oracle.
**Note**  
RDS Custom for Oracle publie une nouvelle AMI par défaut lorsque des vulnérabilités et des risques courants sont découverts. Aucun horaire fixe n’est disponible ou garanti. RDS Custom for Oracle a tendance à publier une nouvelle AMI par défaut tous les 30 jours.
+ Lorsque vous mettez à niveau le système d’exploitation dans votre instance de base de données principale, vous devez mettre à niveau les réplicas en lecture associés manuellement.
+ Réservez une capacité de calcul Amazon EC2 suffisante pour votre type d’instance dans votre zone de disponibilité avant de commencer à appliquer les correctifs au système d’exploitation. 

  Lorsque vous créez une réservation de capacité, vous spécifiez la zone de disponibilité, le nombre d'instances et les attributs d'instance (y compris le type d'instance). Par exemple, si votre instance de base de données utilise le type d'instance EC2 r5.large, nous vous conseillons de réserver de la capacité EC2 pour r5.large dans votre zone de disponibilité. Lors de l'application de correctifs au système d'exploitation, RDS Custom crée un nouvel hôte de type db.r5.large, qui peut rester bloqué si la zone de disponibilité ne dispose pas de capacité EC2 pour ce type d'instance. Si vous réservez de la capacité EC2, vous réduisez le risque de blocage des correctifs causé par des contraintes de capacité. Pour plus d’informations, consultez [Réserves de capacité à la demande](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-capacity-reservations.html) dans le *Guide de l’utilisateur Amazon EC2*.
+ Faites une sauvegarde de votre instance de base de données avant de mettre à niveau son système d’exploitation. La mise à niveau supprime les données de votre volume racine et toutes les personnalisations existantes du système d'exploitation.
+ Dans le modèle de responsabilité partagée, vous êtes responsable de la mise à jour de votre système d’exploitation. RDS Custom for Oracle ne précise pas les correctifs à appliquer à votre système d’exploitation. Si votre RDS Custom for Oracle est fonctionnel, vous pouvez utiliser l’AMI associée à cette CEV indéfiniment.

# Affichage des cibles de mise à niveau de CEV valides pour les instances de base de données RDS Custom for Oracle
<a name="custom-upgrading-target"></a>

Vous pouvez voir les versions existantes CEVs sur la page des **versions personnalisées du moteur** dans le AWS Management Console.

Vous pouvez également utiliser la [describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html) AWS CLI commande pour déterminer la validité CEVs à 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
<a name="custom-upgrading-modify"></a>

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. Par exemple, pour mettre à niveau votre instance de base de données Oracle Linux 7.9 vers Oracle Linux 8, spécifiez l’AMI la plus récente, qui utilise Oracle Linux 8. Si vous souhaitez mettre à niveau la base de données et le système d’exploitation, vous devez effectuer deux mises à niveau distinctes.

**Note**  
Si vous mettez à niveau la base de données, RDS Custom met automatiquement à niveau les réplicas en lecture après la mise à niveau de l'instance de base de données principale. Si vous mettez à niveau le système d'exploitation, vous devez mettre à niveau les réplicas manuellement.

Avant de commencer, consultez [Exigences pour les mises à niveau de RDS Custom for Oracle](custom-upgrading.md#custom-upgrading-reqs) et [Considérations pour les mises à niveau de la base de données RDS Custom for Oracle](custom-upgrading-considerations.md). 

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

**Pour mettre à niveau une instance de base de données RDS Custom for Oracle**

1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon RDS à l’adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Dans le panneau de navigation, sélectionnez **Bases de données**, puis l’instance de base de données RDS Custom for Oracle que vous souhaitez mettre à niveau.

1. Sélectionnez **Modify**. La page **Modifier l’instance de base de données** s’affiche.

1. Pour **Version du moteur de base de données**, choisissez un nouveau CEV. Procédez comme suit :
   + Si vous appliquez des correctifs à la base de données, assurez-vous que le CEV spécifie des fichiers binaires de base de données différents de ceux utilisés par votre instance de base de données et qu'il ne spécifie pas d'AMI différente de l'AMI actuellement utilisée par votre instance de base de données.
   + Si vous appliquez des correctifs au système d'exploitation, assurez-vous que le CEV spécifie une AMI différente de celle utilisée par votre instance de base de données et qu'il ne spécifie pas de fichiers binaires de base de données différents.
**Avertissement**  
Lorsque vous appliquez un correctif à votre système d'exploitation, vous perdez les données de votre volume racine ainsi que toute personnalisation existante du système d'exploitation.

1. Sélectionnez **Continuer** pour consulter le récapitulatif des modifications.

   Pour appliquer les modifications immédiatement, choisissez **Appliquer immédiatement**.

1. Si vos modifications sont correctes, sélectionnez **Modifier l'instance de base de données**. Ou choisissez **Retour** pour revoir vos modifications, ou choisissez **Annuler** pour les annuler.

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

Les exemples suivants montrent des scénarios de mise à niveau possibles. Les exemples supposent que vous avez créé une instance de base de données RDS Custom for Oracle présentant les caractéristiques suivantes :
+ Instance de base de données nommée `my-custom-instance`
+ CEV nommé `19.my_cev1`
+ Oracle Database 19c utilisant l'architecture non CDB
+ Oracle Linux 8 utilisant l’AMI `ami-1234`

L'AMI la plus récente fournie par le service est `ami-2345`. Vous trouverez les AMI en exécutant la commande CLI `describe-db-engine-versions`.

**Topics**
+ [Mise à niveau du système d'exploitation](#custom-upgrading-modify.CLI.os)
+ [Mise à niveau de la base de données](#custom-upgrading-modify.CLI.db)

### Mise à niveau du système d'exploitation
<a name="custom-upgrading-modify.CLI.os"></a>

Dans cet exemple, vous souhaitez effectuer une mise à niveau de `ami-1234` vers `ami-2345`, qui est l'AMI la plus récente fournie par le service. Comme il s’agit d’une mise à niveau du système d’exploitation, les fichiers binaires de base de données pour `ami-1234` et `ami-2345` doivent être identiques. Vous créez un nouveau CEV nommé `19.my_cev2` basé sur `19.my_cev1`.

**Example**  
Pour 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
```
Pour 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
```

Pour mettre à niveau une instance de base de données RDS Custom, utilisez la commande [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) d'AWS CLI avec les paramètres suivants :
+ `--db-instance-identifier` : spécifiez l'instance de base de données RDS Custom for Oracle à mettre à niveau.
+ `--engine-version` : spécifiez le CEV doté de la nouvelle AMI.
+ `--no-apply-immediately` \$1 `--apply-immediately` – Indiquez s'il faut effectuer la mise à niveau immédiatement ou attendre la fenêtre de maintenance planifiée.

Dans l'exemple suivant, l'instance `my-custom-instance` est mise à niveau vers la version `19.my_cev2`. Seul le système d'exploitation est mis à niveau.

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

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

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

### Mise à niveau de la base de données
<a name="custom-upgrading-modify.CLI.db"></a>

Dans cet exemple, vous souhaitez appliquer le correctif Oracle p35042068 à votre instance de base de données RDS for Oracle. Comme vous avez mis à niveau votre système d'exploitation dans [Mise à niveau du système d'exploitation](#custom-upgrading-modify.CLI.os), votre instance de base de données utilise actuellement `19.my_cev2`, qui est basé sur `ami-2345`. Vous créez un nouveau CEV nommé `19.my_cev3`, qui utilise également `ami-2345`, mais vous spécifiez un nouveau manifeste JSON dans la variable d'environnement `$MANIFEST`. Ainsi, seuls les fichiers binaires de base de données sont différents dans votre nouveau CEV et dans le CEV que votre instance utilise actuellement.

**Example**  
Pour 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
```
Pour 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
```

Dans l'exemple suivant, l'instance `my-custom-instance` est mise à niveau vers la version de moteur `19.my_cev3`. Seule la base de données est mise à niveau.

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

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

```
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
<a name="custom-upgrading-pending"></a>

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 [describe-pending-maintenance-actions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-pending-maintenance-actions.html) AWS CLI commande [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html)or.

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
<a name="custom-upgrading-failure"></a>

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 afficher cet état à l'aide de la commande [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html) d'AWS CLI, 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 :
+ Nouvelle tentative d'exécution de la même mise à niveau
+ Suspension et reprise de l'automatisation de RDS Custom
+ Restauration à un instant dans le passé (PITR)
+ Suppression d'une instance de base de données

**Note**  
Si l'automatisation a été suspendue pour l'instance de base de données RDS Custom, vous ne pouvez pas effectuer une nouvelle tentative de mise à niveau avant de l'avoir relancée.  
Les mêmes actions s'appliquent pour l'échec de mise à niveau d'un réplica en lecture géré par RDS et du réplica principal.

Pour de plus amples informations, veuillez consulter [Dépannage des mises à niveau de RDS Custom for Oracle](custom-troubleshooting.md#custom-troubleshooting-upgrade).