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.
# Utilisation de versions de moteurs personnalisées pour Amazon RDS Custom for Oracle
Une *version cd moteur personnalisée (CEV)* pour Amazon RDS Custom for Oracle est un instantané de volume binaire d'un moteur de base de données et d'une Amazon Machine Image (AMI) spécifique. Par défaut, RDS Custom for Oracle utilise la dernière AMI disponible gérée par RDS Custom, mais vous pouvez spécifier une AMI utilisée dans une CEV précédente. Vous stockez les fichiers d'installation de vos bases de données dans Amazon S3. RDS Custom utilise les fichiers d'installation et l'image AMI pour créer votre version CEV pour vous.
**Topics**
+ [Préparation de la création d'une CEV](custom-cev.preparing.md)
+ [Création d'une CEV](custom-cev.create.md)
+ [Modification de l'état de la CEV](custom-cev.modify.md)
+ [Affichage des détails de version CEV pour Amazon RDS Custom for Oracle](custom-cev.view.md)
+ [Suppression d'une CEV](custom-cev.delete.md)
# Préparation de la création d'une CEV
Pour créer un CEV, accédez aux fichiers d'installation et aux correctifs qui sont stockés dans votre compartiment Amazon S3 pour l'une des versions suivantes :
+ Oracle Database 19c
+ Oracle Database 18c
+ Oracle Database 12c version 2 (12.2)
+ Oracle Database 12c version 1 (12.1)
Par exemple, vous pouvez utiliser le mois d'avril 2021 RU/RUR pour Oracle Database 19c, ou toute combinaison valide de fichiers d'installation et de correctifs. Pour plus d'informations sur les régions et les versions prises en charge par RDS Custom for Oracle, consultez [RDS Custom avec RDS for Oracle](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RDS_Fea_Regions_DB-eng.Feature.RDSCustom.html#Concepts.RDS_Fea_Regions_DB-eng.Feature.RDSCustom.ora).
**Topics**
+ [Étape 1 (Facultative) : Télécharger les modèles de manifeste](#custom-cev.preparing.templates)
+ [Étape 2 : Télécharger des fichiers d'installation de votre base de données et des correctifs à partir d'Oracle Software Delivery Cloud](#custom-cev.preparing.download)
+ [Étape 3 : Charger vos fichiers d'installation dans Amazon S3](#custom-cev.preparing.s3)
+ [Étape 4 (facultative) : partagez votre support d'installation dans S3 entre Comptes AWS](#custom-cev.preparing.accounts)
+ [Étape 5 : Préparer le manifeste CEV](#custom-cev.preparing.manifest)
+ [Étape 6 (Facultative) : Valider le manifeste CEV](#custom-cev.preparing.validating)
+ [Étape 7 : Ajouter les autorisations IAM nécessaires](#custom-cev.preparing.iam)
## Étape 1 (Facultative) : Télécharger les modèles de manifeste
Un *manifeste CEV* est un document JSON qui inclut la liste des fichiers .zip d'installation de base de données pour votre CEV. Pour créer une CEV, procédez comme suit :
1. Identifiez les fichiers d'installation de la base de données Oracle que vous souhaitez inclure dans votre CEV.
1. Téléchargez les fichiers d'installation.
1. Créez un manifeste JSON répertoriant les fichiers d'installation.
RDS Custom for Oracle fournit des modèles de manifeste JSON avec les fichiers .zip recommandés pour chaque version d'Oracle Database prise en charge. Par exemple, le modèle suivant concerne le 19.17.0.0.0 RU.
```
{
"mediaImportTemplateVersion": "2020-08-14",
"databaseInstallationFileNames": [
"V982063-01.zip"
],
"opatchFileNames": [
"p6880880_190000_Linux-x86-64.zip"
],
"psuRuPatchFileNames": [
"p34419443_190000_Linux-x86-64.zip",
"p34411846_190000_Linux-x86-64.zip"
],
"otherPatchFileNames": [
"p28852325_190000_Linux-x86-64.zip",
"p29997937_190000_Linux-x86-64.zip",
"p31335037_190000_Linux-x86-64.zip",
"p32327201_190000_Linux-x86-64.zip",
"p33613829_190000_Linux-x86-64.zip",
"p34006614_190000_Linux-x86-64.zip",
"p34533061_190000_Linux-x86-64.zip",
"p34533150_190000_Generic.zip",
"p28730253_190000_Linux-x86-64.zip",
"p29213893_1917000DBRU_Generic.zip",
"p33125873_1917000DBRU_Linux-x86-64.zip",
"p34446152_1917000DBRU_Linux-x86-64.zip"
]
}
```
Chaque modèle est associé à un fichier readme qui inclut des instructions pour télécharger les correctifs, URLs les fichiers .zip et les checksums des fichiers. Vous pouvez utiliser ces modèles tels quels ou les modifier avec vos propres correctifs. Pour consulter les modèles, téléchargez le fichier [custom-oracle-manifest.zip](samples/custom-oracle-manifest.zip) sur votre disque local, puis ouvrez-le à l'aide d'une application d'archivage de fichiers. Pour de plus amples informations, veuillez consulter [Étape 5 : Préparer le manifeste CEV](#custom-cev.preparing.manifest).
## Étape 2 : Télécharger des fichiers d'installation de votre base de données et des correctifs à partir d'Oracle Software Delivery Cloud
Lorsque vous avez identifié les fichiers d'installation que vous souhaitez pour votre CEV, téléchargez-les sur votre système local. Les fichiers d'installation et les correctifs d'installation d'Oracle Database sont hébergés sur Oracle Software Delivery Cloud. Chaque CEV nécessite une version de base, telle qu'Oracle Database 19c ou Oracle Database 12c version 2 (12.2) et une liste de correctifs facultative.
**Pour télécharger les fichiers d'installation de la base de données pour Oracle Database**
1. Accédez à [https://edelivery.oracle.com/](https://edelivery.oracle.com/) et connectez-vous.
1. Dans la zone de recherche, saisissez **Oracle Database Enterprise Edition** ou **Oracle Database Standard Edition 2**, puis choisissez **Rechercher**.
1. Choisissez l'une des versions de base suivantes :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/custom-cev.preparing.html)
1. Sélectionnez **Continuer**.
1. Désélectionnez la case à cocher **Download Queue** (Queue de téléchargement).
1. Choisissez l'option qui correspond à votre version de base :
+ **Oracle Database 19.3.0.0.0 : version à long terme.**.
+ **Oracle Database 18.0.0.0.0**
+ **Oracle Database 12.2.0.1.0**.
+ **Oracle Database 12.1.0.2.0**.
1. Choisissez **Linux x86-64** dans **Platform/Languages** (Plateforme/Langues).
1. Choisissez **Continuer**, puis signez le contrat de licence Oracle.
1. Choisissez le fichier .zip qui correspond à votre version de base de données :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/custom-cev.preparing.html)
1. Téléchargez les correctifs Oracle souhaités depuis `updates.oracle.com` ou `support.oracle.com` vers votre système local. Vous pouvez trouver URLs les correctifs aux emplacements suivants :
+ Les fichiers readme dans le fichier .zip que vous avez téléchargé dans [Étape 1 (Facultative) : Télécharger les modèles de manifeste](#custom-cev.preparing.templates)
+ Les correctifs sont répertoriés dans chaque dernière mise à jour (RU) dans [Notes de mise à jour d’Amazon Relational Database Service (Amazon RDS) for Oracle](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes).
## Étape 3 : Charger vos fichiers d'installation dans Amazon S3
Chargement de vos fichiers d'installation et de fichiers correctifs Oracle dans Amazon S3 en utilisant la AWS CLI. Le compartiment S3 qui contient vos fichiers d'installation doit se trouver dans la même AWS région que votre CEV.
Les exemples de cette section utilisent les espaces réservés suivants :
+ `install-or-patch-file.zip` – Fichier multimédia d'installation Oracle. Par exemple, p32126828\$1190000\$1Linux-x86-64.zip est un correctif.
+ `amzn-s3-demo-destination-bucket` – Votre compartiment Amazon S3 désigné pour vos fichiers d'installation chargés.
+ `123456789012/cev1` : préfixe facultatif dans votre compartiment Simple Storage Service (Amazon S3).
+ `amzn-s3-demo-source-bucket` : compartiment Simple Storage Service (Amazon S3) dans lequel vous pouvez éventuellement déposer des fichiers.
**Topics**
+ [Étape 3a : Vérifiez que votre compartiment S3 est dans le bon Région AWS](#custom-cev.preparing.s3.verify-region)
+ [Étape 3b : Assurez-vous que votre politique de compartiment S3 dispose des autorisations appropriées](#custom-cev.preparing.s3.verify-policy)
+ [Étape 3c : Téléchargez vos fichiers à l'aide des commandes cp ou sync](#custom-cev.preparing.s3.upload)
+ [Étape 3d : Répertoriez les fichiers de votre compartiment S3](#custom-cev.preparing.s3.list)
### Étape 3a : Vérifiez que votre compartiment S3 est dans le bon Région AWS
Vérifiez que votre compartiment S3 se trouve dans la AWS région dans laquelle vous prévoyez d'exécuter la `create-custom-db-engine-version` commande.
```
aws s3api get-bucket-location --bucket amzn-s3-demo-destination-bucket
```
### Étape 3b : Assurez-vous que votre politique de compartiment S3 dispose des autorisations appropriées
Vous pouvez créer un CEV à partir de zéro ou à partir d'un CEV source. Si vous envisagez de créer un nouveau CEV à partir de la source CEVs, assurez-vous que votre politique de compartiment S3 dispose des autorisations appropriées :
1. Identifiez le compartiment S3 réservé par RDS Custom. Le nom du compartiment est au format `do-not-delete-rds-custom-account-region-string`. Par exemple, le nom du compartiment peut être `do-not-delete-rds-custom-123456789012-us-east-1-abc123EXAMPLE`.
1. Assurez-vous que l'autorisation suivante est ajoutée à votre politique de compartiment S3. Remplacez `do-not-delete-rds-custom-123456789012-us-east-1-abc123EXAMPLE` par le nom de votre compartiment.
```
{
"Sid": "AWSRDSCustomForOracleCustomEngineVersionGetObject",
"Effect": "Allow",
"Principal": {
"Service": "custom.rds.amazonaws.com"
},
"Action": [
"s3:GetObject",
"s3:GetObjectTagging"
],
"Resource": "arn:aws:s3:::do-not-delete-rds-custom-123456789012-us-east-1-abc123EXAMPLE/CustomEngineVersions/*"
}, ...
```
### Étape 3c : Téléchargez vos fichiers à l'aide des commandes cp ou sync
Choisissez l'une des options suivantes :
+ Utilisez `aws s3 cp` pour charger un fichier .zip unique.
Chargez chaque fichier .zip d'installation séparément. Ne combinez pas les fichiers .zip en un seul fichier .zip.
+ Utilisez `aws s3 sync` pour charger un répertoire.
**Example**
L'exemple suivant permet de charger `install-or-patch-file.zip` vers le répertoire `123456789012/cev1` dans le compartiment Amazon S3 RDS Custom. Exécutez une commande `aws s3` séparée pour chaque fichier .zip que vous souhaitez charger.
Pour Linux, macOS ou Unix :
```
1. aws s3 cp install-or-patch-file.zip \
2. s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
Pour Windows :
```
1. aws s3 cp install-or-patch-file.zip ^
2. s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
**Example**
L'exemple suivant télécharge les fichiers de votre *cev1* dossier local vers le *123456789012/cev1* dossier de votre compartiment Amazon S3.
Pour Linux, macOS ou Unix :
```
aws s3 sync cev1 \
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
Pour Windows :
```
aws s3 sync cev1 ^
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
**Example**
L'exemple suivant permet de charger tous les fichiers dans `amzn-s3-demo-source-bucket` vers le dossier **`123456789012/cev1`** de votre compartiment Simple Storage Service (Amazon S3).
Pour Linux, macOS ou Unix :
```
aws s3 sync s3://amzn-s3-demo-source-bucket/ \
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
Pour Windows :
```
aws s3 sync s3://amzn-s3-demo-source-bucket/ ^
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
### Étape 3d : Répertoriez les fichiers de votre compartiment S3
L'exemple suivant utilise la commande `s3 ls` pour répertorier les fichiers de votre compartiment Custom Amazon S3.
```
aws s3 ls \
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
## Étape 4 (facultative) : partagez votre support d'installation dans S3 entre Comptes AWS
Aux fins de cette section, le compartiment Amazon S3 qui contient vos fichiers d'installation Oracle chargés est votre *compartiment média*. Votre organisation peut en utiliser plusieurs Comptes AWS dans un Région AWS. Si tel est le cas, vous souhaiterez peut-être en utiliser un Compte AWS pour remplir votre compartiment multimédia et un autre Compte AWS pour le créer CEVs. Si vous n'avez pas l'intention de partager votre compartiment média, passez à la section suivante.
Cette section suppose ce qui suit :
+ Vous pouvez accéder au compte qui a créé votre compartiment multimédia et à un autre compte dans lequel vous souhaitez le créer CEVs.
+ Vous avez l'intention de créer CEVs en un seul Région AWS. Si vous avez l'intention d'utiliser plusieurs régions, créez un compartiment média dans chaque région.
+ Vous utilisez le CLI. Si vous utilisez la console Amazon S3, adaptez les étapes suivantes.
**Pour configurer votre compartiment multimédia afin de le partager entre Comptes AWS**
1. Connectez-vous à Compte AWS celui qui contient le compartiment S3 dans lequel vous avez chargé votre support d'installation.
1. Commencez par un modèle de politique JSON vierge ou une politique existante que vous pouvez adapter.
La commande suivante permet de récupérer une politique existante et de l'enregistrer sous*my-policy.json*. Dans cet exemple, le compartiment S3 contenant vos fichiers d'installation est nommé*amzn-s3-demo-bucket*.
```
aws s3api get-bucket-policy \
--bucket amzn-s3-demo-bucket \
--query Policy \
--output text > my-policy.json
```
1. Modifiez les autorisations du compartiment média comme suit :
+ Dans l'élément `Resource` de votre modèle, indiquez le compartiment S3 dans lequel vous avez chargé vos fichiers d'installation de la base de données Oracle.
+ Dans l'`Principal`élément, spécifiez le ARNs pour tout Comptes AWS ce que vous souhaitez utiliser pour créer CEVs. Vous pouvez ajouter la racine, un utilisateur ou un rôle à la liste des autorisations du compartiment S3. Pour plus d'informations, consultez [Identifiants IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html) dans le *Gestion des identités et des accès AWS Guide de l'utilisateur *.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "GrantAccountsAccess",
"Effect": "Allow",
"Principal": {
"AWS": [
"arn:aws:iam::111122223333:root",
"arn:aws:iam::444455556666:user/user-name-with-path",
"arn:aws:iam::123456789012:role/role-name-with-path"
]
},
"Action": [
"s3:GetObject",
"s3:GetObjectAcl",
"s3:GetObjectTagging",
"s3:ListBucket",
"s3:GetBucketLocation"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
------
1. Attachez la politique à votre compartiment de médias.
Dans l'exemple suivant, *amzn-s3-demo-bucket* il s'agit du nom du compartiment S3 qui contient vos fichiers d'installation et *my-policy.json* du nom de votre fichier JSON.
```
aws s3api put-bucket-policy \
--bucket amzn-s3-demo-bucket \
--policy file://my-policy.json
```
1. Connectez-vous à un Compte AWS dans lequel vous avez l'intention de créer CEVs.
1. Vérifiez que ce compte peut accéder au compartiment multimédia dans le compartiment Compte AWS qui l'a créé.
```
aws s3 ls --query "Buckets[].Name"
```
Pour obtenir plus d’informations, consultez [aws s3 ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) dans la *référence de commande AWS CLI *.
1. Créez un CEV en suivant les étapes indiquées dans [Création d'une CEV](custom-cev.create.md).
## Étape 5 : Préparer le manifeste CEV
Un manifeste CEV est un document JSON qui inclut les éléments suivants :
+ (Obligatoire) La liste des fichiers .zip d'installation que vous avez chargés sur Amazon S3. RDS Custom applique les correctifs dans l'ordre dans lequel ils sont listés dans le manifeste.
+ (Facultatif) Paramètres d'installation qui définissent des valeurs autres que celles par défaut pour la base Oracle, le répertoire d'origine Oracle Home, ainsi que l'ID et le nom de l' UNIX/Linux utilisateur et du groupe. Sachez que vous ne pouvez pas modifier les paramètres d'installation d'une version CEV existante ou d'une instance de base de données existante. Vous ne pouvez pas non plus effectuer une mise à niveau d'une version CEV vers une autre lorsque les paramètres d'installation ont des paramètres différents.
Pour obtenir des exemples de manifestes CEV, consultez les modèles JSON dans que vous avez téléchargés dans [Étape 1 (Facultative) : Télécharger les modèles de manifeste](#custom-cev.preparing.templates). Vous pouvez également examiner les exemples dans [Exemples de manifeste CEV](#custom-cev.preparing.manifest.examples).
**Topics**
+ [Champs JSON dans le manifeste CEV](#custom-cev.preparing.manifest.fields)
+ [Création du manifeste CEV](#custom-cev.preparing.manifest.creating)
+ [Exemples de manifeste CEV](#custom-cev.preparing.manifest.examples)
### Champs JSON dans le manifeste CEV
Le tableau suivant décrit les champs JSON dans le fichier manifeste.
| Champ JSON | Description |
| --- | --- |
| `MediaImportTemplateVersion` | Version du manifeste CEV. La date doit être au format `YYYY-MM-DD`. |
| `databaseInstallationFileNames` | Liste ordonnée des fichiers d'installation de la base de données. |
| `opatchFileNames` | Liste ordonnée des OPatch programmes d'installation utilisés pour le moteur de base de données Oracle. Une seule valeur est valide. Les valeurs de `opatchFileNames` doivent commencer par `p6880880_`. |
| `psuRuPatchFileNames` | Les correctifs PSU et RU pour cette base de données. Si vous incluez `psuRuPatchFileNames`, la valeur `opatchFileNames` est obligatoire. Les valeurs de `opatchFileNames` doivent commencer par `p6880880_`. |
| `OtherPatchFileNames` | Les correctifs qui ne figurent pas dans la liste des correctifs PSU et RU. RDS Custom applique ces correctifs après avoir appliqué les correctifs PSU et RU. Si vous incluez `OtherPatchFileNames`, la valeur `opatchFileNames` est obligatoire. Les valeurs de `opatchFileNames` doivent commencer par `p6880880_`. |
| `installationParameters` | Paramètres autres que ceux par défaut pour la base Oracle, le répertoire d'origine Oracle Home, ainsi que l'ID et le nom de l' UNIX/Linux utilisateur et du groupe. Vous pouvez définir les paramètres suivants : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/custom-cev.preparing.html) |
Chaque version d'Oracle Database possède une liste différente de fichiers d'installation pris en charge. Lorsque vous créez votre manifeste CEV, veillez à ne spécifier que les fichiers pris en charge par RDS Custom for Oracle. Sinon, la création du CEV échoue et renvoie une erreur. Les correctifs répertoriés dans [Notes de mise à jour d’Amazon Relational Database Service (Amazon RDS) for Oracle](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes) sont pris en charge.
### Création du manifeste CEV
**Pour créer un manifeste CEV**
1. Dressez la liste de tous les fichiers d'installation que vous prévoyez d'appliquer, dans l'ordre dans lequel vous voulez les appliquer.
1. Corrélez les fichiers d'installation avec les champs JSON décrits dans [Champs JSON dans le manifeste CEV](#custom-cev.preparing.manifest.fields).
1. Effectuez l’une des actions suivantes :
+ Créez le manifeste CEV sous la forme d'un fichier texte JSON.
+ Modifiez le modèle de manifeste CEV lorsque vous créez le CEV dans la console. Pour plus d’informations, consultez [Création d'une CEV](custom-cev.create.md).
### Exemples de manifeste CEV
Les exemples suivants montrent des fichiers manifestes CEV pour différentes versions de la base de données Oracle. Si vous incluez un champ JSON dans votre manifeste, assurez-vous qu'il n'est pas vide. Par exemple, le manifeste CEV suivant n'est pas valide car `otherPatchFileNames` est vide.
```
{
"mediaImportTemplateVersion": "2020-08-14",
"databaseInstallationFileNames": [
"V982063-01.zip"
],
"opatchFileNames": [
"p6880880_190000_Linux-x86-64.zip"
],
"psuRuPatchFileNames": [
"p32126828_190000_Linux-x86-64.zip"
],
"otherPatchFileNames": [
]
}
```
**Rubriques**
+ [Sample CEV manifest for Oracle Database 12c Release 1 (12.1)](#oracle-cev-manifest-12.1)
+ [Sample CEV manifest for Oracle Database 12c Release 2 (12.2)](#oracle-cev-manifest-12.2)
+ [Sample CEV manifest for Oracle Database 18c](#oracle-cev-manifest-18c)
+ [Sample CEV manifest for Oracle Database 19c](#oracle-cev-manifest-19c)
**Example Exemple de manifeste CEV pour Oracle Database 12c Version 1 (12.1)**
Dans l'exemple suivant pour le PSU de juillet 2021 pour Oracle Database 12c Release 1 (12.1), RDS Custom applique les correctifs dans l'ordre indiqué. Ainsi, RDS Custom applique p32768233, puis p32876425, puis p18759211, etc. L'exemple définit de nouvelles valeurs pour l'utilisateur et le groupe UNIX/Linux, ainsi que pour le répertoire de base de base de données Oracle et la base Oracle.
```
{
"mediaImportTemplateVersion":"2020-08-14",
"databaseInstallationFileNames":[
"V46095-01_1of2.zip",
"V46095-01_2of2.zip"
],
"opatchFileNames":[
"p6880880_121010_Linux-x86-64.zip"
],
"psuRuPatchFileNames":[
"p32768233_121020_Linux-x86-64.zip"
],
"otherPatchFileNames":[
"p32876425_121020_Linux-x86-64.zip",
"p18759211_121020_Linux-x86-64.zip",
"p19396455_121020_Linux-x86-64.zip",
"p20875898_121020_Linux-x86-64.zip",
"p22037014_121020_Linux-x86-64.zip",
"p22873635_121020_Linux-x86-64.zip",
"p23614158_121020_Linux-x86-64.zip",
"p24701840_121020_Linux-x86-64.zip",
"p25881255_121020_Linux-x86-64.zip",
"p27015449_121020_Linux-x86-64.zip",
"p28125601_121020_Linux-x86-64.zip",
"p28852325_121020_Linux-x86-64.zip",
"p29997937_121020_Linux-x86-64.zip",
"p31335037_121020_Linux-x86-64.zip",
"p32327201_121020_Linux-x86-64.zip",
"p32327208_121020_Generic.zip",
"p17969866_12102210119_Linux-x86-64.zip",
"p20394750_12102210119_Linux-x86-64.zip",
"p24835919_121020_Linux-x86-64.zip",
"p23262847_12102201020_Linux-x86-64.zip",
"p21171382_12102201020_Generic.zip",
"p21091901_12102210720_Linux-x86-64.zip",
"p33013352_12102210720_Linux-x86-64.zip",
"p25031502_12102210720_Linux-x86-64.zip",
"p23711335_12102191015_Generic.zip",
"p19504946_121020_Linux-x86-64.zip"
],
"installationParameters": {
"unixGroupName": "dba",
"unixGroupId": 12345,
"unixUname": "oracle",
"unixUid": 12345,
"oracleHome": "/home/oracle/oracle.12.1.0.2",
"oracleBase": "/home/oracle"
}
}
```
**Example Exemple de manifeste CEV pour Oracle Database 12c Version 2 (12.2)**
Dans l'exemple suivant pour le PSU d'octobre 2021 pour Oracle Database 12c Version 2 (12.2), RDS Custom applique p33261817, puis p33192662, puis p29213893, et ainsi de suite. L'exemple définit de nouvelles valeurs pour l'utilisateur et le groupe UNIX/Linux, ainsi que pour le répertoire de base de base de données Oracle et la base Oracle.
```
{
"mediaImportTemplateVersion":"2020-08-14",
"databaseInstallationFileNames":[
"V839960-01.zip"
],
"opatchFileNames":[
"p6880880_122010_Linux-x86-64.zip"
],
"psuRuPatchFileNames":[
"p33261817_122010_Linux-x86-64.zip"
],
"otherPatchFileNames":[
"p33192662_122010_Linux-x86-64.zip",
"p29213893_122010_Generic.zip",
"p28730253_122010_Linux-x86-64.zip",
"p26352615_12201211019DBOCT2021RU_Linux-x86-64.zip",
"p23614158_122010_Linux-x86-64.zip",
"p24701840_122010_Linux-x86-64.zip",
"p25173124_122010_Linux-x86-64.zip",
"p25881255_122010_Linux-x86-64.zip",
"p27015449_122010_Linux-x86-64.zip",
"p28125601_122010_Linux-x86-64.zip",
"p28852325_122010_Linux-x86-64.zip",
"p29997937_122010_Linux-x86-64.zip",
"p31335037_122010_Linux-x86-64.zip",
"p32327201_122010_Linux-x86-64.zip",
"p32327208_122010_Generic.zip"
],
"installationParameters": {
"unixGroupName": "dba",
"unixGroupId": 12345,
"unixUname": "oracle",
"unixUid": 12345,
"oracleHome": "/home/oracle/oracle.12.2.0.1",
"oracleBase": "/home/oracle"
}
}
```
**Example Exemple de manifeste CEV pour Oracle Database 18c**
Dans l'exemple suivant pour le PSU d'octobre 2021 pour Oracle Database 18c, RDS Custom applique p32126855, puis p28730253, puis p27539475, et ainsi de suite. L'exemple définit de nouvelles valeurs pour l'utilisateur et le groupe UNIX/Linux, ainsi que pour le répertoire de base de base de données Oracle et la base Oracle.
```
{
"mediaImportTemplateVersion":"2020-08-14",
"databaseInstallationFileNames":[
"V978967-01.zip"
],
"opatchFileNames":[
"p6880880_180000_Linux-x86-64.zip"
],
"psuRuPatchFileNames":[
"p32126855_180000_Linux-x86-64.zip"
],
"otherPatchFileNames":[
"p28730253_180000_Linux-x86-64.zip",
"p27539475_1813000DBRU_Linux-x86-64.zip",
"p29213893_180000_Generic.zip",
"p29374604_1813000DBRU_Linux-x86-64.zip",
"p29782284_180000_Generic.zip",
"p28125601_180000_Linux-x86-64.zip",
"p28852325_180000_Linux-x86-64.zip",
"p29997937_180000_Linux-x86-64.zip",
"p31335037_180000_Linux-x86-64.zip",
"p31335142_180000_Generic.zip"
]
"installationParameters": {
"unixGroupName": "dba",
"unixGroupId": 12345,
"unixUname": "oracle",
"unixUid": 12345,
"oracleHome": "/home/oracle/18.0.0.0.ru-2020-10.rur-2020-10.r1",
"oracleBase": "/home/oracle/"
}
}
```
**Example Exemple de manifeste CEV pour Oracle Database 19c**
Dans l'exemple suivant pour Oracle Database 19c, RDS Custom applique p32126828, puis p29213893, puis p29782284, et ainsi de suite. L'exemple définit de nouvelles valeurs pour l'utilisateur et le groupe UNIX/Linux, ainsi que pour le répertoire de base de base de données Oracle et la base Oracle.
```
{
"mediaImportTemplateVersion": "2020-08-14",
"databaseInstallationFileNames": [
"V982063-01.zip"
],
"opatchFileNames": [
"p6880880_190000_Linux-x86-64.zip"
],
"psuRuPatchFileNames": [
"p32126828_190000_Linux-x86-64.zip"
],
"otherPatchFileNames": [
"p29213893_1910000DBRU_Generic.zip",
"p29782284_1910000DBRU_Generic.zip",
"p28730253_190000_Linux-x86-64.zip",
"p29374604_1910000DBRU_Linux-x86-64.zip",
"p28852325_190000_Linux-x86-64.zip",
"p29997937_190000_Linux-x86-64.zip",
"p31335037_190000_Linux-x86-64.zip",
"p31335142_190000_Generic.zip"
],
"installationParameters": {
"unixGroupName": "dba",
"unixGroupId": 12345,
"unixUname": "oracle",
"unixUid": 12345,
"oracleHome": "/home/oracle/oracle.19.0.0.0.ru-2020-04.rur-2020-04.r1.EE.1",
"oracleBase": "/home/oracle"
}
}
```
## Étape 6 (Facultative) : Valider le manifeste CEV
Vous pouvez également vérifier que le manifeste est un fichier JSON valide en exécutant le script Python `json.tool`. Par exemple, si vous changez vers le répertoire contenant un manifeste CEV nommé `manifest.json`, exécutez la commande suivante.
```
python -m json.tool < manifest.json
```
## Étape 7 : Ajouter les autorisations IAM nécessaires
Assurez-vous que le principal IAM qui crée la CEV possède les politiques nécessaires décrites dans [Étape 5 : octroi des autorisations requises à votre utilisateur ou rôle IAM](custom-setup-orcl.md#custom-setup-orcl.iam-user).
# Création d'une CEV
Vous pouvez créer une CEV à l'aide de la AWS Management Console ou de la AWS CLI. Spécifiez l'architecture multilocataire ou non multilocataire. Pour plus d’informations, consultez [Considérations relatives à l'architecture multilocataire](custom-creating.md#custom-creating.overview).
En général, la création d'une CEV prend environ deux heures. Après avoir créé la CEV, vous pouvez l’utiliser pour créer ou mettre à niveau une instance de base de données RDS Custom. Pour plus d’informations, consultez [Création d'une instance de base de données RDS Custom for Oracle](custom-creating.md#custom-creating.create) et [Mise à niveau d'une instance de base de données RDS Custom for Oracle](custom-upgrading-modify.md).
**Note**
Si votre instance de base de données utilise actuellement Oracle Linux 7.9, créez une nouvelle CEV qui utilise la dernière AMI, qui utilise Oracle Linux 8. Modifiez ensuite votre instance pour utiliser la nouvelle CEV.
Prenez note des exigences et limitations suivantes pour créer une CEV :
+ Le compartiment Amazon S3 contenant vos fichiers d’installation doit se trouver dans la même Région AWS que votre CEV. Sinon, le processus de création échoue.
+ Le nom de la CEV doit être au format `major-engine-version.customized_string`, comme dans `19.cdb_cev1`.
+ Le nom de la CEV doit contenir entre 1 et 50 caractères alphanumériques, des traits de soulignement, des tirets ou des points.
+ Le nom de la CEV ne peut pas contenir de points consécutifs, comme dans `19..cdb_cev1`.
## Console
**Pour créer une CEV**
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, choisissez **Custom engine versions** (Versions de moteur personnalisées).
La page **Custom engine versions** (Versions de moteur personnalisées) affiche toutes les CEV qui existent actuellement. Si vous n'avez pas créé de CEV, la page est vide.
1. Choisissez **Create custom engine version** (Créer une version de moteur personnalisée).
1. Dans **Options de moteur**, procédez comme suit :
1. Pour **Engine type** (Type de moteur), choisissez **Oracle**.
1. Pour **Paramètres d’architecture**, vous pouvez choisir **Architecture à locataires multiples** pour créer une CEV à locataires multiples Oracle qui utilise le moteur de base de données `custom-oracle-ee-cdb` ou `custom-oracle-se2-cdb`. Vous pouvez créer une base de données CDB RDS Custom for Oracle avec une version CEV multi-locataire. Si vous ne choisissez pas cette option, votre CEV est une base de données non CDB, qui utilise le moteur `custom-oracle-ee` ou `custom-oracle-se2`.
**Note**
L'architecture que vous choisissez est une caractéristique permanente de votre version CEV. Vous ne pouvez pas modifier votre CEV pour utiliser une architecture différente ultérieurement.
1. Choisissez l’une des options suivantes :
+ **Créer un nouveau CEV** — Créez un CEV à partir de zéro. Dans ce cas, vous devez spécifier un manifeste JSON indiquant les fichiers binaires de la base de données.
+ **Créer CEV à partir de la source** — Dans **Spécifiez le CEV que vous souhaitez copier**, choisissez un CEV existant à utiliser comme CEV source. Dans ce cas, vous pouvez spécifier une nouvelle Amazon Machine Image (AMI), mais vous ne pouvez pas spécifier de fichiers binaires de base de données différents.
1. Pour **Version du moteur**, choisissez la version majeure du moteur.
1. Dans **Détails de la version**, procédez comme suit :
1. Saisissez un nom valide dans **Nom de version de moteur personnalisée**. Par exemple, vous pouvez saisir le nom **19.cdb\$1cev1**.
1. (Facultatif) Saisissez une description pour votre CEV.
1. Dans **Média d'installation**, procédez comme suit :
1. (Facultatif) Dans le champ **ID d'AMI**, laissez le champ vide pour utiliser la dernière AMI fournie par le service ou saisissez une AMI que vous avez utilisée précédemment pour créer un CEV. Pour obtenir des ID d'AMI valides, utilisez l'une des techniques suivantes :
+ Dans la console, choisissez **Versions de moteur personnalisées** dans le panneau de navigation de gauche, puis choisissez le nom d’une CEV. L'ID AMI utilisé par la CEV apparaît dans l'onglet **Configuration**.
+ Dans l'AWS CLI, utilisez la commande `describe-db-engine-versions`. Recherchez la sortie pour `ImageID`.
1. Pour **S3 location of manifest files** (Emplacement S3 des fichiers manifestes), saisissez l'emplacement du compartiment Amazon S3 que vous avez spécifié dans [Étape 3 : Charger vos fichiers d'installation dans Amazon S3](custom-cev.preparing.md#custom-cev.preparing.s3). Par exemple, saisissez **s3://my-custom-installation-files/123456789012/cev1/**.
**Note**
La Région AWS dans laquelle vous créer le CEV doit se trouver dans la même région que le compartiment S3.
1. (Créer un nouveau CEV uniquement) Pour **Manifeste CEV**, saisissez le manifeste JSON que vous avez créé dans [Création du manifeste CEV](custom-cev.preparing.md#custom-cev.preparing.manifest.creating).
1. Dans la section **Clé KMS**, sélectionnez **Entrez un ARN de clé** pour répertorier les clés AWS KMS disponibles. Sélectionnez ensuite votre clé KMS dans la liste.
Une clé AWS KMS est nécessaire pour RDS Custom. Pour plus d’informations, consultez [Étape 1 : créer ou réutiliser une clé de chiffrement AWS KMS symétrique](custom-setup-orcl.md#custom-setup-orcl.cmk).
1. (Facultatif) Choisissez **Ajouter une nouvelle balise** pour créer une paire clé-valeur pour votre CEV.
1. Choisissez **Create custom engine version** (Créer une version de moteur personnalisée).
Si le manifeste JSON n'est pas dans un format valide, la console affiche **Erreur lors de la validation du manifeste CEV**. Résolvez les problèmes et réessayez.
La page **Custom engine versions** (Versions de moteur personnalisées) s'affiche. Votre CEV s'affiche avec le statut **Creating** (Création). Le processus de création d'un CEV prend environ deux heures.
## AWS CLI
Pour créer une CEV à l'aide de la AWS CLI, exécutez la commande [create custom-db-engine version](https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html).
Les options suivantes sont requises :
+ `--engine` – Spécifier le type de moteur. Pour une CDB, spécifiez `custom-oracle-ee-cdb` ou `custom-oracle-se2-cdb`. Pour un objet autre qu’une CDB, spécifiez `custom-oracle-ee` ou `custom-oracle-se2`. Vous pouvez créer des CDB uniquement à partir d’une CEV créée avec `custom-oracle-ee-cdb` ou `custom-oracle-se2-cdb`. Vous pouvez créer des bases de données non CDB uniquement à partir d’une CEV créée avec `custom-oracle-ee` ou `custom-oracle-se2`.
+ `--engine-version` : spécifiez la version du moteur. Le format est *version-majeure-moteur*.*chaîne\$1personnalisée*. Le nom de la CEV doit contenir entre 1 et 50 caractères alphanumériques, des traits de soulignement, des tirets ou des points. Le nom de la CEV ne peut pas contenir de points consécutifs, comme dans `19..cdb_cev1`.
+ `--kms-key-id` : spécifiez une AWS KMS key.
+ `--manifest` : spécifiez `manifest_json_string` ou `--manifest file:file_name`. Les caractères de saut de ligne ne sont pas autorisés dans `manifest_json_string`. Assurez-vous d'échapper les guillemets doubles (") dans le code JSON en les faisant précéder d'une barre oblique inversée (\$1).
L'exemple suivant illustre la `manifest_json_string` pour 19c à partir de [Étape 5 : Préparer le manifeste CEV](custom-cev.preparing.md#custom-cev.preparing.manifest). L'exemple définit de nouvelles valeurs pour la base Oracle, le répertoire de base de base de données Oracle, ainsi que l'ID et le nom de l'utilisateur et du groupe UNIX/Linux. Si vous copiez cette chaîne, supprimez tous les caractères de saut de ligne avant de la coller dans votre commande.
`"{\"mediaImportTemplateVersion\": \"2020-08-14\",\"databaseInstallationFileNames\": [\"V982063-01.zip\"],\"opatchFileNames\": [\"p6880880_190000_Linux-x86-64.zip\"],\"psuRuPatchFileNames\": [\"p32126828_190000_Linux-x86-64.zip\"],\"otherPatchFileNames\": [\"p29213893_1910000DBRU_Generic.zip\",\"p29782284_1910000DBRU_Generic.zip\",\"p28730253_190000_Linux-x86-64.zip\",\"p29374604_1910000DBRU_Linux-x86-64.zip\",\"p28852325_190000_Linux-x86-64.zip\",\"p29997937_190000_Linux-x86-64.zip\",\"p31335037_190000_Linux-x86-64.zip\",\"p31335142_190000_Generic.zip\"]\"installationParameters\":{ \"unixGroupName\":\"dba\", \ \"unixUname\":\"oracle\", \ \"oracleHome\":\"/home/oracle/oracle.19.0.0.0.ru-2020-04.rur-2020-04.r1.EE.1\", \ \"oracleBase\":\"/home/oracle/\"}}"`
+ `--database-installation-files-s3-bucket-name` : spécifiez le même nom de compartiment que celui que vous avez indiqué dans [Étape 3 : Charger vos fichiers d'installation dans Amazon S3](custom-cev.preparing.md#custom-cev.preparing.s3). La Région AWS dans laquelle vous exécutez `create-custom-db-engine-version` doit être dans la même région que votre compartiment Amazon S3.
Vous pouvez également spécifier les options suivantes :
+ `--description` : spécifiez une description de votre CEV.
+ `--database-installation-files-s3-prefix` : spécifiez le nom de dossier que celui que vous avez indiqué dans [Étape 3 : Charger vos fichiers d'installation dans Amazon S3](custom-cev.preparing.md#custom-cev.preparing.s3).
+ `--image-id` : spécifiez un ID d'AMI que vous souhaitez réutiliser. Pour trouver des ID valides, exécutez la commande `describe-db-engine-versions`, puis recherchez la sortie pour `ImageID`. Par défaut, RDS Custom for Oracle utilise l'AMI disponible la plus récente.
L'exemple suivant crée un CEV multi-locataire Oracle nommé `19.cdb_cev1`. L'exemple réutilise une AMI existante plutôt que d'utiliser la dernière AMI disponible. Assurez-vous que le nom de votre CEV commence par le numéro de version du moteur principal.
**Example**
Pour Linux, macOS ou Unix :
```
1. aws rds create-custom-db-engine-version \
2. --engine custom-oracle-se2-cdb \
3. --engine-version 19.cdb_cev1 \
4. --database-installation-files-s3-bucket-name us-east-1-123456789012-custom-installation-files \
5. --database-installation-files-s3-prefix 123456789012/cev1 \
6. --kms-key-id my-kms-key \
7. --description "test cev" \
8. --manifest manifest_string \
9. --image-id ami-012a345678901bcde
```
Pour Windows :
```
1. aws rds create-custom-db-engine-version ^
2. --engine custom-oracle-se2-cdb ^
3. --engine-version 19.cdb_cev1 ^
4. --database-installation-files-s3-bucket-name us-east-1-123456789012-custom-installation-files ^
5. --database-installation-files-s3-prefix 123456789012/cev1 ^
6. --kms-key-id my-kms-key ^
7. --description "test cev" ^
8. --manifest manifest_string ^
9. --image-id ami-012a345678901bcde
```
**Example**
Obtenez des détails sur votre CEV en utilisant la commande `describe-db-engine-versions`.
```
1. aws rds describe-db-engine-versions \
2. --engine custom-oracle-se2-cdb \
3. --include-all
```
L'exemple de sortie partielle suivant affiche le moteur, les groupes de paramètres, le manifeste et d'autres informations.
```
1. {
2. "DBEngineVersions": [
3. {
4. "Engine": "custom-oracle-se2-cdb",
5. "EngineVersion": "19.cdb_cev1",
6. "DBParameterGroupFamily": "custom-oracle-se2-cdb-19",
7. "DBEngineDescription": "Containerized Database for Oracle Custom SE2",
8. "DBEngineVersionDescription": "test cev",
9. "Image": {
10. "ImageId": "ami-012a345678901bcde",
11. "Status": "active"
12. },
13. "ValidUpgradeTarget": [],
14. "SupportsLogExportsToCloudwatchLogs": false,
15. "SupportsReadReplica": true,
16. "SupportedFeatureNames": [],
17. "Status": "available",
18. "SupportsParallelQuery": false,
19. "SupportsGlobalDatabases": false,
20. "MajorEngineVersion": "19",
21. "DatabaseInstallationFilesS3BucketName": "us-east-1-123456789012-custom-installation-files",
22. "DatabaseInstallationFilesS3Prefix": "123456789012/cev1",
23. "DBEngineVersionArn": "arn:aws:rds:us-east-1:123456789012:cev:custom-oracle-se2-cdb/19.cdb_cev1/abcd12e3-4f5g-67h8-i9j0-k1234l56m789",
24. "KMSKeyId": "arn:aws:kms:us-east-1:732027699161:key/1ab2345c-6d78-9ef0-1gh2-3456i7j89k01",
25. "CreateTime": "2023-03-07T19:47:58.131000+00:00",
26. "TagList": [],
27. "SupportsBabelfish": false,
28. ...
```
## Échec de la création d'une CEV
Si la création d'une CEV échoue, RDS Custom émet `RDS-EVENT-0198` avec le message `Creation failed for custom engine version major-engine-version.cev_name` et ajoute des détails sur l'échec. Par exemple, l'événement imprime les fichiers manquants.
Vous ne pouvez pas modifier une CEV qui a échoué. Vous pouvez seulement la supprimer, puis réessayer de créer une CEV après avoir corrigé les causes de l'échec. Pour plus d'informations concernant le dépannage des raisons de l'échec de création de CEV, voir [Résolution des problèmes liés à la création d'une version de moteur personnalisée pour RDS Custom for Oracle](custom-troubleshooting.md#custom-troubleshooting.cev).
# Modification de l'état de la CEV
Vous pouvez modifier une CEV à l'aide de la AWS Management Console ou de la AWS CLI. Vous pouvez modifier la description de la CEV ou son état de disponibilité. Votre CEV possède l'une des valeurs d'état suivantes :
+ `available` – Vous pouvez utiliser cette CEV pour créer une nouvelle instance de base de données RDS Custom ou mettre à niveau une instance de base de données. Il s'agit de l'état par défaut d'une nouvelle CEV.
+ `inactive` – Vous ne pouvez pas créer ou mettre à niveau une instance RDS Custom avec cette CEV. Vous ne pouvez pas restaurer un instantané de base de données pour créer une nouvelle instance de base de données RDS Custom avec cette CEV.
Vous pouvez changer la CEV de n'importe quel état pris en charge vers n'importe quel autre état pris en charge. Vous pouvez modifier l'état pour empêcher l'utilisation accidentelle d'une CEV ou rendre une CEV abandonnée à nouveau éligible à l'utilisation. Par exemple, vous pouvez modifier l'état de votre CEV de `available`en `inactive`, et à nouveau de `inactive` en `available`.
## Console
**Pour modifier une CEV**
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, choisissez **Custom engine versions** (Versions de moteur personnalisées).
1. Choisissez une CEV dont vous souhaitez modifier la description ou l'état.
1. Pour **Actions**, choisissez **Modifier**.
1. Effectuez une ou plusieurs des modifications suivantes :
+ Pour **Paramètres d'état de CEV** (CEV status settings), choisissez un nouvel état de disponibilité.
+ Sur la page **Version description** (Description de la version), saisissez une nouvelle description.
1. Choisissez **Modify CEV** (Modifier la CEV).
Si la CEV est en cours d'utilisation, la console affiche **You can't modify the CEV status** (Vous ne pouvez pas modifier l'état de la CEV). Résolvez les problèmes et réessayez.
La page **Custom engine versions** (Versions de moteur personnalisées) s'affiche.
## AWS CLI
Pour modifier une CEV à l'aide de la AWS CLI, exécutez la commande [modify-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-custom-db-engine-version.html). Vous pouvez trouver des CEV à modifier en exécutant la commande[describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html).
Les options suivantes sont requises :
+ `--engine engine-type`, où *engine-type* est `custom-oracle-ee`, `custom-oracle-se2`, `custom-oracle-ee-cdb` ou `custom-oracle-se2-cdb`
+ `--engine-version cev`, où *`cev`* représente le nom de la version de moteur personnalisée que vous souhaitez modifier
+ `--status`` status`, où *`status`* représente l'état de disponibilité que vous souhaitez attribuer à la CEV
L'exemple suivant modifie une CEV nommée `19.my_cev1` de son état actuel vers `inactive`.
**Example**
Pour Linux, macOS ou Unix :
```
1. aws rds modify-custom-db-engine-version \
2. --engine custom-oracle-se2 \
3. --engine-version 19.my_cev1 \
4. --status inactive
```
Pour Windows :
```
1. aws rds modify-custom-db-engine-version ^
2. --engine custom-oracle-se2 ^
3. --engine-version 19.my_cev1 ^
4. --status inactive
```
# Affichage des détails de version CEV pour Amazon RDS Custom for Oracle
Vous pouvez consulter les détails de votre manifeste CEV et de la commande utilisée pour créer votre version CEV en utilisant la AWS Management Console ou AWS CLI.
## Console
**Pour afficher les détails de la version CEV**
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, choisissez **Custom engine versions** (Versions de moteur personnalisées).
La page **Custom engine versions** (Versions de moteur personnalisées) affiche toutes les CEV qui existent actuellement. Si vous n'avez pas créé de CEV, la page est vide.
1. Choisissez le nom de la version CEV que vous souhaitez consulter.
1. Choisissez **Configuration** pour afficher les paramètres d'installation spécifiés dans votre manifeste.
![\[Affichez les paramètres d'installation d'une version CEV.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/cev-configuration-tab.png)
1. Choisissez **Manifest** (Manifeste) pour afficher les paramètres d'installation spécifiés dans l'option `--manifest` de la commande `create-custom-db-engine-version`. Vous pouvez copier ce texte, remplacer des valeurs selon vos besoins et les utiliser dans une nouvelle commande.
![\[Affichez la commande utilisée pour créer la version CEV.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/cev-manifest-tab.png)
## AWS CLI
Pour afficher les détails d'une version CEV à l'aide d'AWS CLI, exécutez la commande [describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html).
Les options suivantes sont requises :
+ `--engine engine-type`, où *engine-type* est `custom-oracle-ee`, `custom-oracle-se2`, `custom-oracle-ee-cdb` ou `custom-oracle-se2-cdb`
+ `--engine-version major-engine-version.customized_string`
L’exemple suivant crée une CEV non CDB qui utilise Enterprise Edition. Le nom de la CEV `19.my_cev1` commence par le numéro de version majeure du moteur, qui est obligatoire.
**Example**
Pour Linux, macOS ou Unix :
```
1. aws rds describe-db-engine-versions \
2. --engine custom-oracle-ee \
3. --engine-version 19.my_cev1
```
Pour Windows :
```
1. aws rds describe-db-engine-versions ^
2. --engine custom-oracle-ee ^
3. --engine-version 19.my_cev1
```
L'exemple de sortie partielle suivant affiche le moteur, les groupes de paramètres, le manifeste et d'autres informations.
```
1. "DBEngineVersions": [
2. {
3. "Engine": "custom-oracle-ee",
4. "MajorEngineVersion": "19",
5. "EngineVersion": "19.my_cev1",
6. "DatabaseInstallationFilesS3BucketName": "us-east-1-123456789012-cev-customer-installation-files",
7. "DatabaseInstallationFilesS3Prefix": "123456789012/cev1",
8. "CustomDBEngineVersionManifest": "{\n\"mediaImportTemplateVersion\": \"2020-08-14\",\n\"databaseInstallationFileNames\": [\n\"V982063-01.zip\"\n],\n\"installationParameters\": {\n\"oracleBase\":\"/tmp\",\n\"oracleHome\":\"/tmp/Oracle\"\n},\n\"opatchFileNames\": [\n\"p6880880_190000_Linux-x86-64.zip\"\n],\n\"psuRuPatchFileNames\": [\n\"p32126828_190000_Linux-x86-64.zip\"\n],\n\"otherPatchFileNames\": [\n\"p29213893_1910000DBRU_Generic.zip\",\n\"p29782284_1910000DBRU_Generic.zip\",\n\"p28730253_190000_Linux-x86-64.zip\",\n\"p29374604_1910000DBRU_Linux-x86-64.zip\",\n\"p28852325_190000_Linux-x86-64.zip\",\n\"p29997937_190000_Linux-x86-64.zip\",\n\"p31335037_190000_Linux-x86-64.zip\",\n\"p31335142_190000_Generic.zip\"\n]\n}\n",
9. "DBParameterGroupFamily": "custom-oracle-ee-19",
10. "DBEngineDescription": "Oracle Database server EE for RDS Custom",
11. "DBEngineVersionArn": "arn:aws:rds:us-west-2:123456789012:cev:custom-oracle-ee/19.my_cev1/0a123b45-6c78-901d-23e4-5678f901fg23",
12. "DBEngineVersionDescription": "test",
13. "KMSKeyId": "arn:aws:kms:us-east-1:123456789012:key/ab1c2de3-f4g5-6789-h012-h3ijk4567l89",
14. "CreateTime": "2022-11-18T09:17:07.693000+00:00",
15. "ValidUpgradeTarget": [
16. {
17. "Engine": "custom-oracle-ee",
18. "EngineVersion": "19.cev.2021-01.09",
19. "Description": "test",
20. "AutoUpgrade": false,
21. "IsMajorVersionUpgrade": false
22. }
23. ]
```
# Suppression d'une CEV
Vous pouvez supprimer une CEV à l'aide de la AWS Management Console ou de la AWS CLI. La suppression prend généralement quelques minutes.
Pour supprimer une CEV, elle ne peut être utilisée par aucun des éléments suivants :
+ Une instance de base de données RDS Custom
+ Un instantané d'une instance de base de données RDS Custom
+ Une sauvegarde automatisée de votre instance de base de données RDS Custom
## Console
**Pour supprimer une CEV**
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, choisissez **Custom engine versions** (Versions de moteur personnalisées).
1. Choisissez une CEV dont vous souhaitez supprimer la description ou l'état.
1. Pour **Actions**, choisissez **Supprimer**.
La boîte de dialogue **Delete *cev\$1name*?** (Supprimer cev\$1name ?) s'affiche.
1. Entrez **delete me**, puis choisissez **Delete (Supprimer)**.
Dans **Custom engine versions** (Versions de moteur personnalisées), la bannière indique que votre CEV est en cours de suppression.
## AWS CLI
Pour supprimer une CEV à l'aide de la AWS CLI, exécutez la commande [delete-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-custom-db-engine-version.html).
Les options suivantes sont requises :
+ `--engine engine-type`, où *engine-type* est `custom-oracle-ee`, `custom-oracle-se2`, `custom-oracle-ee-cdb` ou `custom-oracle-se2-cdb`
+ `--engine-version cev`, où *cev* représente le nom de la version de moteur personnalisée à supprimer
L'exemple suivant supprime une CEV nommée `19.my_cev1`.
**Example**
Pour Linux, macOS ou Unix :
```
1. aws rds delete-custom-db-engine-version \
2. --engine custom-oracle-ee \
3. --engine-version 19.my_cev1
```
Pour Windows :
```
1. aws rds delete-custom-db-engine-version ^
2. --engine custom-oracle-ee ^
3. --engine-version 19.my_cev1
```