Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Arbeiten mit benutzerdefinierten Engine-Versionen für Amazon RDS Custom für Oracle
EIN*benutzerdefinierte Engine-Version (CEV)*für Amazon RDS Custom for Oracle ist ein binärer Volume-Snapshot eines Datenbankmoduls und eines bestimmten Amazon Machine Image (AMI). RDS Custom für Oracle verwendet standardmäßig das neueste verfügbare AMI, das von RDS Custom verwaltet wird. Sie können jedoch auch ein AMI angeben, das in einer vorherigen CEV verwendet wurde. Sie speichern Ihre Datenbankinstallationsdateien in Amazon S3. RDS Custom verwendet die Installationsdateien und das AMI, um Ihre CEV für Sie zu erstellen.
**Topics**
+ [Vorbereiten der Erstellung einer CEV](custom-cev.preparing.md)
+ [Erstellen einer CEV](custom-cev.create.md)
+ [Ändern des CEV-Status](custom-cev.modify.md)
+ [Anzeigen von CEV-Details zu Amazon RDS Custom für Oracle](custom-cev.view.md)
+ [Löschen einer CEV](custom-cev.delete.md)
# Vorbereiten der Erstellung einer CEV
Um eine CEV zu erstellen, greifen Sie auf die Installationsdateien und Patches zu, die in Ihrem Amazon S3-Bucket für eine der folgenden Releases gespeichert sind:
+ Oracle Database 19c
+ Oracle Database 18c
+ Oracle Database 12c Release 2 (12.2)
+ Oracle Database 12c Release 1 (12.1)
Sie können beispielsweise April 2021 RU/RUR für Oracle Database 19c oder eine beliebige gültige Kombination von Installationsdateien und Patches verwenden. Weitere Informationen zu den von RDS Custom fü Oracle unterstützten Versionen und Regionen finden Sie unter [RDS Custom mit RDS für 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**
+ [Schritt 1 (optional): Herunterladen der Manifestvorlagen](#custom-cev.preparing.templates)
+ [Schritt 2: Herunterladen Ihrer Datenbankinstallationsdateien und Patches von Oracle Software Delivery Cloud](#custom-cev.preparing.download)
+ [Schritt 3: Hochladen Ihrer Installationsdateien in Amazon S3](#custom-cev.preparing.s3)
+ [Schritt 4 (optional): Teilen Sie Ihre Installationsmedien in S3 AWS-Konten](#custom-cev.preparing.accounts)
+ [Schritt 5: Vorbereiten des CEV-Manifests](#custom-cev.preparing.manifest)
+ [Schritt 6 (optional): Validieren des CEV-Manifests](#custom-cev.preparing.validating)
+ [Schritt 7: Hinzufügen der erforderlichen IAM-Berechtigungen](#custom-cev.preparing.iam)
## Schritt 1 (optional): Herunterladen der Manifestvorlagen
Ein *CEV-Manifest* ist ein JSON-Dokument, das die Liste der .zip-Dateien zur Datenbankinstallation für Ihre CEV enthält. Gehen Sie wie folgt vor, um eine CEV zu erstellen:
1. Identifizieren Sie die Installationsdateien der Oracle-Datenbank, die Sie in Ihre CEV aufnehmen möchten.
1. Laden Sie die Installationsdateien herunter.
1. Erstellen Sie ein JSON-Manifest, das die Installationsdateien auflistet.
RDS Custom für Oracle bietet JSON-Manifestvorlagen mit unseren empfohlenen .zip-Dateien für jede unterstützte Oracle Database Version. Die folgende Vorlage ist beispielsweise für 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"
]
}
```
Jeder Vorlage ist eine Readme-Datei zugeordnet, die Anweisungen zum Herunterladen der Patches, URLs für die ZIP-Dateien und Dateiprüfsummen enthält. Sie können diese Vorlagen unverändert verwenden oder sie mit Ihren eigenen Patches ändern. Um die Vorlagen zu überprüfen, laden Sie [custom-oracle-manifest.zip](samples/custom-oracle-manifest.zip) auf Ihre lokale Festplatte herunter und öffnen Sie sie dann mit einer Dateiarchivierungsanwendung. Weitere Informationen finden Sie unter [Schritt 5: Vorbereiten des CEV-Manifests](#custom-cev.preparing.manifest).
## Schritt 2: Herunterladen Ihrer Datenbankinstallationsdateien und Patches von Oracle Software Delivery Cloud
Wenn Sie die Installationsdateien identifiziert haben, die Sie für Ihre CEV benötigen, laden Sie sie auf Ihr lokales System herunter. Die Installationsdateien und Patches der Oracle Database werden in der Oracle Software Delivery Cloud gehostet. Für jede CEV ist eine Basisversion, wie Oracle Database 19c oder Oracle Database 12c Release 2 (12.2), und eine optionale Liste mit Patches erforderlich.
**So laden Sie die Installationsdateien der Datenbank für Oracle Database herunter**
1. Wechseln Sie zu[https://edelivery.oracle.com/](https://edelivery.oracle.com/)und melden Sie sich an.
1. Geben Sie **Oracle Database Enterprise Edition** oder **Oracle Database Standard Edition 2** in das Suchfeld ein und wählen Sie **Suchen** aus.
1. Wählen Sie eine der folgenden Basisversionen aus:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/custom-cev.preparing.html)
1. Klicken Sie auf **Weiter**.
1. Deaktivieren Sie das Kontrollkästchen **Warteschlange herunterladen**.
1. Wählen Sie die Option aus, die Ihrer Basisversion entspricht:
+ **Oracle Database 19.3.0.0.0 – Long Term Release**.
+ **Oracle Database 18.0.0.0.0**
+ **Oracle Database 12.2.0.1.0**.
+ **Oracle Database 12.1.0.2.0**.
1. Klicken Sie auf**86-64 Linux**in**Plattform/Sprachen**aus.
1. Wählen Sie **Weiter** aus und unterzeichnen Sie dann die Oracle-Lizenzvereinbarung.
1. Wählen Sie die .zip-Datei aus, die Ihrer Datenbankversion entspricht:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/custom-cev.preparing.html)
1. Laden Sie Ihre gewünschten Oracle-Patches von `updates.oracle.com` oder `support.oracle.com` auf Ihr lokales System herunter. Sie finden die URLs für die Patches an den folgenden Orten:
+ Die Readme-Dateien sind in der .zip-Datei, die Sie in [Schritt 1 (optional): Herunterladen der Manifestvorlagen](#custom-cev.preparing.templates) heruntergeladen haben, enthalten.
+ Die Patches sind in jedem Versions-Update (RU) in den [Versionshinweisen für Amazon Relational Database Service (Amazon RDS) für Oracle](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes) aufgelistet.
## Schritt 3: Hochladen Ihrer Installationsdateien in Amazon S3
Hochladen Ihrer Oracle-Installations- und Patch-Dateien in Amazon S3 unter Verwendung der AWS CLI aus. Der S3-Bucket, der Ihre Installationsdateien enthält, muss sich in derselben AWS Region wie Ihr CEV befinden.
Für die Beispiele in diesem Abschnitt werden die folgenden Platzhalter verwendet:
+ `install-or-patch-file.zip`— Oracle-Installationsmediendatei Zum Beispiel ist p32126828\$1190000\$1Linux-x86-64.zip ein Patch.
+ `amzn-s3-demo-destination-bucket` – Ihr Amazon S3-Bucket, der für Ihre hochgeladenen Installationsdateien vorgesehen ist.
+ `123456789012/cev1` – Ein optionales Präfix in Ihrem Amazon-S3-Bucket.
+ `amzn-s3-demo-source-bucket` – Ein Amazon-S3-Bucket, in dem Sie Dateien optional inszenieren können.
**Topics**
+ [Schritt 3a: Stellen Sie sicher, dass sich Ihr S3-Bucket im richtigen befindet AWS-Region](#custom-cev.preparing.s3.verify-region)
+ [Schritt 3b: Sicherstellen, dass Ihre S3-Bucket-Richtlinie über die richtigen Berechtigungen verfügt](#custom-cev.preparing.s3.verify-policy)
+ [Schritt 3c: Hochladen Ihrer Dateien mit den Befehlen cp oder sync](#custom-cev.preparing.s3.upload)
+ [Schritt 3d: Auflisten der Dateien in Ihrem S3-Bucket](#custom-cev.preparing.s3.list)
### Schritt 3a: Stellen Sie sicher, dass sich Ihr S3-Bucket im richtigen befindet AWS-Region
Stellen Sie sicher, dass sich Ihr S3-Bucket in der AWS Region befindet, in der Sie den `create-custom-db-engine-version` Befehl ausführen möchten.
```
aws s3api get-bucket-location --bucket amzn-s3-demo-destination-bucket
```
### Schritt 3b: Sicherstellen, dass Ihre S3-Bucket-Richtlinie über die richtigen Berechtigungen verfügt
Sie können eine CEV ohne Vorgabe oder anhand einer Quell-CEV erstellen. Wenn Sie vorhaben, ein neues CEV aus dem Quellcode zu erstellen CEVs, stellen Sie sicher, dass Ihre S3-Bucket-Richtlinie über die richtigen Berechtigungen verfügt:
1. Identifizieren Sie den von RDS Custom reservierten S3-Bucket. Der Bucket-Name weist das Format `do-not-delete-rds-custom-account-region-string` auf. Der Bucket-Name kann beispielsweise `do-not-delete-rds-custom-123456789012-us-east-1-abc123EXAMPLE` lauten.
1. Stellen Sie sicher, dass die folgende Berechtigung an Ihre S3-Bucket-Richtlinie angehängt ist. Ersetzen Sie `do-not-delete-rds-custom-123456789012-us-east-1-abc123EXAMPLE` durch den Namen von Ihrem Bucket.
```
{
"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/*"
}, ...
```
### Schritt 3c: Hochladen Ihrer Dateien mit den Befehlen cp oder sync
Wählen Sie eine der folgenden Optionen:
+ Verwenden von`aws s3 cp`um eine einzelne ZIP-Datei hochzuladen.
Laden Sie jede ZIP-Installationsdatei separat hoch. Kombinieren Sie die ZIP-Dateien nicht in einer ZIP-Datei.
+ Verwenden von`aws s3 sync`um ein Verzeichnis hochzuladen.
**Example**
Im folgenden Beispiel wird `install-or-patch-file.zip` in den `123456789012/cev1`-Ordner im RDS Custom Amazon S3-Bucket hochgeladen. Führen Sie ein separates`aws s3`-Befehl für jeden .zip, den Sie hochladen möchten.
Für Linux, macOS oder Unix:
```
1. aws s3 cp install-or-patch-file.zip \
2. s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
Für Windows:
```
1. aws s3 cp install-or-patch-file.zip ^
2. s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
**Example**
Das folgende Beispiel lädt die Dateien in Ihrem lokalen *cev1* Ordner in den *123456789012/cev1* Ordner in Ihrem Amazon S3 S3-Bucket hoch.
Für Linux, macOS oder Unix:
```
aws s3 sync cev1 \
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
Für Windows:
```
aws s3 sync cev1 ^
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
**Example**
Im folgenden Beispiel werden alle Dateien in `amzn-s3-demo-source-bucket` zum **`123456789012/cev1`**-Ordner in Ihrem Amazon-S3-Bucket hochgeladen.
Für Linux, macOS oder Unix:
```
aws s3 sync s3://amzn-s3-demo-source-bucket/ \
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
Für Windows:
```
aws s3 sync s3://amzn-s3-demo-source-bucket/ ^
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
### Schritt 3d: Auflisten der Dateien in Ihrem S3-Bucket
Im folgenden Beispiel wird der Befehl `s3 ls` verwendet, um die Dateien in Ihrem Amazon-S3-Bucket in RDS Custom aufzulisten.
```
aws s3 ls \
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
## Schritt 4 (optional): Teilen Sie Ihre Installationsmedien in S3 AWS-Konten
Für die Zwecke dieses Abschnitts ist der Amazon S3-Bucket, der Ihre hochgeladenen Oracle-Installationsdateien enthält, Ihr *Medien-Bucket*. Ihre Organisation verwendet möglicherweise mehrere AWS-Konten in einem AWS-Region. Wenn ja, möchten Sie vielleicht einen verwenden, um Ihren Medien-Bucket AWS-Konto zu füllen, und einen anderen, AWS-Konto um ihn zu erstellen CEVs. Wenn Sie Ihren Medienbucket nicht teilen möchten, fahren Sie mit dem nächsten Abschnitt fort.
In dieser Abbildung wird von Folgendem ausgegangen:
+ Sie können auf das Konto zugreifen, mit dem Ihr Media-Bucket erstellt wurde, und auf ein anderes Konto, in dem Sie das Konto erstellen CEVs möchten.
+ Sie beabsichtigen, nur CEVs in einem Konto zu erstellen AWS-Region. Wenn Sie mehrere Regionen verwenden möchten, erstellen Sie in jeder Region einen Medien-Bucket.
+ Sie verwenden die CLI. Wenn Sie die Amazon S3-Konsole verwenden, passen Sie die folgenden Schritte an.
**So konfigurieren Sie Ihren Media-Bucket für die gemeinsame Nutzung zwischen AWS-Konten**
1. Melden Sie sich bei dem an AWS-Konto , der den S3-Bucket enthält, in den Sie Ihre Installationsmedien hochgeladen haben.
1. Beginnen Sie entweder mit einer leeren JSON-Richtlinienvorlage oder einer vorhandenen Richtlinie, die Sie anpassen können.
Mit dem folgenden Befehl wird eine vorhandene Richtlinie abgerufen und unter gespeichert. *my-policy.json* In diesem Beispiel wird der S3-Bucket benannt*amzn-s3-demo-bucket*, der Ihre Installationsdateien enthält.
```
aws s3api get-bucket-policy \
--bucket amzn-s3-demo-bucket \
--query Policy \
--output text > my-policy.json
```
1. Bearbeiten Sie die Media Bucket-Berechtigungen wie folgt:
+ Im `Resource`-Element Ihrer Vorlage geben Sie den S3-Bucket an, in den Sie Ihre Oracle Database-Installationsdateien hochgeladen haben.
+ Geben Sie im `Principal` Element all das an AWS-Konten , das Sie ARNs für die Erstellung verwenden möchten CEVs. Sie können den Stamm, einen Benutzer oder eine Rolle zur Zulassungsliste des S3-Buckets hinzufügen. Weitere Informationen finden Sie unter [IAM-IDs](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html) im *AWS Identity and Access Management -Benutzerhandbuch*.
------
#### [ 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. Fügen Sie die Richtlinie zu Ihrem Bucket hinzu.
Im folgenden Beispiel *amzn-s3-demo-bucket* ist dies der Name des S3-Buckets, der Ihre Installationsdateien enthält, sowie *my-policy.json* der Name Ihrer JSON-Datei.
```
aws s3api put-bucket-policy \
--bucket amzn-s3-demo-bucket \
--policy file://my-policy.json
```
1. Melden Sie sich bei einem an, AWS-Konto in dem Sie etwas erstellen möchten CEVs.
1. Stellen Sie sicher, dass dieses Konto auf den Media-Bucket in dem Konto zugreifen kann AWS-Konto , von dem es erstellt wurde.
```
aws s3 ls --query "Buckets[].Name"
```
Weitere Informationen finden Sie unter [aws s3 ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) in der *AWS CLI Befehlsreferenz*.
1. Erstellen Sie ein CEV, indem Sie die Schritte unter [Erstellen einer CEV](custom-cev.create.md) ausführen.
## Schritt 5: Vorbereiten des CEV-Manifests
Ein CEV-Manifest ist ein JSON-Dokument, das Folgendes enthält:
+ (Erforderlich) Die Liste der ZIP-Installationsdateien, die Sie auf Amazon S3 hochgeladen haben. RDS Custom wendet die Patches in der Reihenfolge an, in der sie im Manifest aufgelistet sind.
+ (Optional) Installationsparameter, die nicht standardmäßige Werte für die Oracle-Basis, das Oracle-Standardverzeichnis sowie die ID und den Namen des UNIX/Linux Benutzers und der Gruppe festlegen. Beachten Sie, dass Sie die Installationsparameter für eine bestehende CEV oder DB-Instance nicht ändern können. Sie können auch nicht von einer CEV auf eine andere CEV aktualisieren, wenn die Installationsparameter unterschiedliche Einstellungen haben.
Beispiele für CEV-Manifeste finden Sie in den JSON-Vorlagen, die Sie in [Schritt 1 (optional): Herunterladen der Manifestvorlagen](#custom-cev.preparing.templates) heruntergeladen haben. Sie können sich die Beispiele auch unter [CEV-Manifest-Beispiele](#custom-cev.preparing.manifest.examples) ansehen.
**Topics**
+ [JSON-Felder im CEV-Manifest](#custom-cev.preparing.manifest.fields)
+ [Erstellen des CEV-Manifests](#custom-cev.preparing.manifest.creating)
+ [CEV-Manifest-Beispiele](#custom-cev.preparing.manifest.examples)
### JSON-Felder im CEV-Manifest
Die folgende Tabelle beschreibt die JSON-Felder im Manifest.
| JSON-Feld | Description |
| --- | --- |
| `MediaImportTemplateVersion` | Version des CEV-Manifests. Das Datum muss im Format `YYYY-MM-DD` angegeben werden. |
| `databaseInstallationFileNames` | Liste der Installationsdateien für die Datenbank geordnet. |
| `opatchFileNames` | Geordnete Liste der OPatch Installationsprogramme, die für die Oracle-DB-Engine verwendet werden. Es ist nur ein Wert gültig. Werte für`opatchFileNames`muss mit beginnen`p6880880_`aus. |
| `psuRuPatchFileNames` | Die PSU- und RU-Patches für diese Datenbank. Wenn Sie `psuRuPatchFileNames` mit einschließen, ist `opatchFileNames` erforderlich. Werte für`opatchFileNames`muss mit beginnen`p6880880_`aus. |
| `OtherPatchFileNames` | Die Patches, die nicht in der Liste der PSU- und RU-Patches enthalten sind. RDS Custom wendet diese Patches an, nachdem die PSU- und RU-Patches angewendet wurden. Wenn Sie `OtherPatchFileNames` mit einschließen, ist `opatchFileNames` erforderlich. Werte für`opatchFileNames`muss mit beginnen`p6880880_`aus. |
| `installationParameters` | Nicht standardmäßige Einstellungen für die Oracle-Basis, das Oracle-Standardverzeichnis sowie die ID und den Namen des UNIX/Linux Benutzers und der Gruppe. Sie können die folgenden Parameter festlegen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/custom-cev.preparing.html) |
Jede Oracle Database-Version hat eine andere Liste unterstützter Installationsdateien. Achten Sie beim Erstellen Ihres CEV-Manifests darauf, nur Dateien anzugeben, die von RDS Custom für Oracle unterstützt werden. Andernfalls schlägt die CEV-Erstellung mit einem Fehler fehl. Alle Patches, die in den [Versionshinweisen für Amazon Relational Database Service (Amazon RDS) für Oracle](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes) aufgelistet sind, werden unterstützt.
### Erstellen des CEV-Manifests
**So erstellen Sie ein CEV-Manifest**
1. Listen Sie alle Installationsdateien auf, die Sie anwenden möchten, in der Reihenfolge, in der sie angewendet werden sollen.
1. Korrelieren Sie die Installationsdateien mit den unter [JSON-Felder im CEV-Manifest](#custom-cev.preparing.manifest.fields) beschriebenen JSON-Feldern.
1. Führen Sie eine der folgenden Aufgaben aus:
+ Erstellen Sie das CEV-Manifest als JSON-Textdatei.
+ Bearbeiten Sie die CEV-Manifestvorlage, wenn Sie die CEV in der Konsole erstellen. Weitere Informationen finden Sie unter [Erstellen einer CEV](custom-cev.create.md).
### CEV-Manifest-Beispiele
Die folgenden Beispiele zeigen CEV-Manifestdateien für verschiedene Oracle Database-Releases. Wenn Sie ein JSON-Feld in Ihr Manifest einschließen, stellen Sie sicher, dass es leer ist. So ist beispielsweise das folgende CEV-Manifest ungültig, da `otherPatchFileNames` leer ist.
```
{
"mediaImportTemplateVersion": "2020-08-14",
"databaseInstallationFileNames": [
"V982063-01.zip"
],
"opatchFileNames": [
"p6880880_190000_Linux-x86-64.zip"
],
"psuRuPatchFileNames": [
"p32126828_190000_Linux-x86-64.zip"
],
"otherPatchFileNames": [
]
}
```
**Topics**
+ [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 Beispiel für ein CEV-Manifests für Oracle Database 12c Release 1 (12.1)**
In dem folgenden Beispiel für das PSU vom Juli 2021 für Oracle Database 12c Release 1 (12.1) wendet RDS Custom die Patches in der angegebenen Reihenfolge an. Somit wendet RDS Custom p32768233, dann p32876425, dann p18759211 usw. an. In dem Beispiel werden neue Werte für den UNIX-Benutzer und die UNIX-Gruppe sowie für das Oracle-Standardverzeichnis und die Oracle-Basis festgelegt.
```
{
"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 Beispiel für ein CEV-Manifests für Oracle Database 12c Release 2 (12.2)**
Im folgenden Beispiel für das PSU vom Oktober 2021 für Oracle Database 12c Release 2 (12.2) wendet RDS Custom p33261817 an, dann p33192662, dann p29213893 und so weiter. In dem Beispiel werden neue Werte für den UNIX-Benutzer und die UNIX-Gruppe sowie für das Oracle-Standardverzeichnis und die Oracle-Basis festgelegt.
```
{
"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 Beispiel-CEV-Manifests für Oracle Database 18c**
Im folgenden Beispiel für das PSU vom Oktober 2021 für Oracle Database 18c wendet RDS Custom p32126855 an, dann p28730253, dann p27539475 und so weiter. In dem Beispiel werden neue Werte für den UNIX-Benutzer und die UNIX-Gruppe sowie für das Oracle-Standardverzeichnis und die Oracle-Basis festgelegt.
```
{
"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 Beispiel-CEV-Manifests für Oracle Database 19c**
Im folgenden Beispiel für Oracle Database 19c wendet RDS Custom p32126828, dann p29213893, dann p29782284 usw. an. In dem Beispiel werden neue Werte für den UNIX-Benutzer und die UNIX-Gruppe sowie für das Oracle-Standardverzeichnis und die Oracle-Basis festgelegt.
```
{
"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"
}
}
```
## Schritt 6 (optional): Validieren des CEV-Manifests
Stellen Sie optional sicher, dass das Manifest eine gültige JSON-Datei ist, indem Sie die`json.tool`Python-Skript. Wenn Sie beispielsweise in das Verzeichnis wechseln, das ein CEV-Manifest namens enthält`manifest.json`führen Sie den folgenden Befehl aus.
```
python -m json.tool < manifest.json
```
## Schritt 7: Hinzufügen der erforderlichen IAM-Berechtigungen
Stellen Sie sicher, dass der IAM-Prinzipal, der die CEV erstellt, über die erforderlichen Richtlinien verfügt, die unter [Schritt 5: Erteilen Sie Ihrem IAM-Benutzer oder Ihrer IAM-Rolle die erforderlichen Berechtigungen](custom-setup-orcl.md#custom-setup-orcl.iam-user) beschrieben sind.
# Erstellen einer CEV
Sie können einen neuen CEV mit der AWS-Managementkonsole oder der AWS CLI erstellen. Geben Sie entweder die Multi-Tenant- oder die Nicht-Multi-Tenant-Architektur an. Weitere Informationen finden Sie unter [Überlegungen zur Multi-Tenant-Architektur](custom-creating.md#custom-creating.overview).
In der Regel dauert das Erstellen einer CEV etwa zwei Stunden. Nachdem Sie die CEV erstellt haben, können Sie sie verwenden, um eine DB-Instance von RDS Custom zu erstellen oder zu aktualisieren. Weitere Informationen erhalten Sie unter [Erstellen einer RDS Custom für Oracle DB-Instance](custom-creating.md#custom-creating.create) und [Upgrade einer benutzerdefinierten RDS-für-Oracle-DB-Instance](custom-upgrading-modify.md).
**Anmerkung**
Wenn Ihre DB-Instance derzeit Oracle Linux 7.9 verwendet, erstellen Sie eine neue CEV, die das neueste AMI verwendet, das Oracle Linux 8 verwendet. Ändern Sie anschließend Ihre Instance so, dass sie die neue CEV verwendet.
Beachten Sie die folgenden Anforderungen und Einschränkungen für das Erstellen einer CEV:
+ Der Amazon-S3-Bucket mit Ihren Installationsdateien muss sich in derselben AWS-Region wie Ihre CEV befinden. Andernfalls schlägt die Erstellung fehl.
+ Der CEV-Name muss das Format haben`major-engine-version.customized_string`, wie in `19.cdb_cev1`.
+ Der CEV-Name muss zwischen 1 und 50 alphanumerische Zeichen, Unterstriche, Bindestriche oder Punkte enthalten.
+ Der CEV-Name darf keine aufeinanderfolgenden Punkte enthalten, wie in `19..cdb_cev1`.
## Konsole
**So erstellen Sie eine VPC**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon-RDS-Konsole unter [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Wählen Sie im Navigationsbereich und dann aus.**Benutzerdefinierte Engine-Versionen**aus.
Die**Benutzerdefinierte Engine-Versionen**Seite zeigt alle CEVs an, die derzeit existieren. Wenn Sie keine CEVs erstellt haben, ist die Seite leer.
1. Klicken Sie auf **Erstellen einer benutzerdefinierten Engine-Version**.
1. Gehen Sie unter **Engine-Optionen** wie folgt vor:
1. Wählen Sie in **Engine type** (Engine-Typ) **Oracle**.
1. Wählen Sie unter **Architektureinstellungen** optional die Option **Mehrmandantenarchitektur** aus, um eine mehrmandantenfähige Oracle-CEV zu erstellen, die die Engine `custom-oracle-ee-cdb` oder `custom-oracle-se2-cdb` verwendet. Sie können eine CDB von RDS Custom für Oracle nur mit einer mehrmandantenfähigen CEV erstellen. Wenn Sie diese Option nicht auswählen, ist Ihre CEV eine Nicht-CDB, die die Engine `custom-oracle-ee` oder `custom-oracle-se2` verwendet.
**Anmerkung**
Die Architektur, die Sie auswählen, ist ein dauerhaftes Merkmal Ihrer CEV. Sie können Ihre CEV später nicht ändern, um eine andere Architektur zu verwenden.
1. Wählen Sie eine der folgenden Optionen:
+ **Neue CEV erstellen** – Erstellen Sie eine CEV von Grund auf neu. In diesem Fall müssen Sie ein JSON-Manifest angeben, das die Datenbank-Binärdateien angibt.
+ **CEV aus Quelle erstellen** – Wählen Sie unter **Geben Sie die CEV an, die Sie kopieren möchten** eine vorhandene CEV aus, die als Quell-CEV verwendet werden soll. In diesem Fall können Sie ein neues Amazon Machine Image (AMI), jedoch keine anderen Datenbank-Binärdateien angeben.
1. Wählen Sie unter **Engine-Version** die Engine-Hauptversion aus.
1. Führen Sie unter **Versionsdetails** die folgenden Schritte aus:
1. Geben Sie einen gültigen Namen im Feld **Benutzerdefinierter Engine-Versionsname** ein. So könnten Sie beispielsweise **19.cdb\$1cev1** eingeben.
1. (Optional) Geben Sie eine Beschreibung für Ihre CEV ein.
1. Gehen Sie unter **Installationsmedien** wie folgt vor:
1. (Optional) Lassen Sie das Feld **AMI-ID** leer, um das neueste vom Service bereitgestellte AMI zu verwenden, oder geben Sie ein AMI ein, das Sie zuvor zum Erstellen einer CEV verwendet haben. Verwenden Sie eine der folgenden Methoden, um gültige AMI-IDs abzurufen:
+ Wählen Sie in der Konsole im linken Navigationsbereich **Benutzerdefinierten Engine-Versionen** und anschließend den Namen einer CEV aus. Die von der CEV verwendete AMI-ID wird auf der Registerkarte **Konfiguration** angezeigt.
+ Verwenden Sie in der AWS CLI den Befehl `describe-db-engine-versions`. Suchen Sie in der Ausgabe nach `ImageID`.
1. Für**S3-Speicherort von Manifestdateien**Geben Sie den Speicherort des Amazon S3-Buckets ein, den Sie in angegeben haben[Schritt 3: Hochladen Ihrer Installationsdateien in Amazon S3](custom-cev.preparing.md#custom-cev.preparing.s3)aus. Geben Sie z. B. ei **s3://my-custom-installation-files/123456789012/cev1/**.
**Anmerkung**
Die AWS-Region, in der Sie die CEV erstellen, muss sich in derselben Region wie der S3-Bucket befinden.
1. (Nur für „Neue CEV erstellen“) Geben Sie im Feld **CEV-Manifest** das JSON-Manifest ein, das Sie in [Erstellen des CEV-Manifests](custom-cev.preparing.md#custom-cev.preparing.manifest.creating) erstellt haben.
1. Wählen Sie im Abschnitt **KMS-Schlüssel** die Option **Geben Sie einen Schlüssel-ARN ein** aus, um die verfügbaren AWS KMS-Schlüssel aufzulisten. Wählen Sie dann Ihren KMS-Schlüssel aus der Liste aus.
Ein AWS KMS-Schlüssel ist für RDS Custom erforderlich. Weitere Informationen finden Sie unter [Schritt 1: Einen symmetrischen AWS KMS Verschlüsselungsschlüssel erstellen oder wiederverwenden](custom-setup-orcl.md#custom-setup-orcl.cmk).
1. (Optional) Wählen Sie **Neues Tag hinzufügen** aus, um ein Schlüssel-Wert-Paar für Ihre CEV zu erstellen.
1. Klicken Sie auf **Erstellen einer benutzerdefinierten Engine-Version**.
Wenn das JSON-Manifest ein ungültiges Format aufweist, wird in der Konsole **Fehler beim Validieren des CEV-Manifests** angezeigt. Beheben Sie die Probleme und versuchen Sie es erneut.
Die**Benutzerdefinierte Engine-Versionen**-Seite wird angezeigt. Ihre CEV wird mit dem Status angezeigt**Erstellen**aus. Die Erstellung einer CEV dauert ungefähr zwei Stunden.
## AWS CLI
So erstellen Sie eine CEV mithilfe derAWS CLIAusführen des s[erstellen-custom-db-Motorversion](https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html)befehl.
Die folgenden Optionen sind erforderlich:
+ `--engine` – Geben Sie den Engine-Typ an. Geben Sie für eine CDB entweder `custom-oracle-ee-cdb` oder `custom-oracle-se2-cdb` an. Geben Sie für eine Nicht-CDB entweder oder `custom-oracle-ee` an `custom-oracle-se2`. Sie können CDBs nur aus einer CEV erstellen, die mit `custom-oracle-ee-cdb` oder `custom-oracle-se2-cdb` erstellt wurde. Sie können Nicht-CDBs nur aus einer CEV erstellen, die mit `custom-oracle-ee` oder `custom-oracle-se2` erstellt wurde.
+ `--engine-version` – Geben Sie die Engine-Version an. Das Format lautet *Haupt-Engine-Version*.*angepasste\$1Zeichenfolge*. Der CEV-Name muss zwischen 1 und 50 alphanumerische Zeichen, Unterstriche, Bindestriche oder Punkte enthalten. Der CEV-Name darf keine aufeinanderfolgenden Punkte enthalten, wie in `19..cdb_cev1`.
+ `--kms-key-id` – Geben Sie einen AWS KMS key an.
+ `--manifest` – Geben Sie entweder `manifest_json_string` oder `--manifest file:file_name` an. Zeilenumbruchzeichen sind in `manifest_json_string` nicht zulässig. Stellen Sie sicher, dass doppelte Anführungszeichen („) im JSON-Code maskiert werden, indem Sie ihnen einen umgekehrten Schrägstrich (\$1) voranstellen.
Das folgende Beispiel zeigt das `manifest_json_string` für 19c von [Schritt 5: Vorbereiten des CEV-Manifests](custom-cev.preparing.md#custom-cev.preparing.manifest). Das Beispiel legt neue Werte für die Oracle-Basis, das Oracle-Standardverzeichnis sowie die ID und den Namen des UNIX/Linux-Benutzers und der Gruppe fest. Wenn Sie diese Zeichenfolge kopieren, entfernen Sie alle Zeilenumbruchzeichen, bevor Sie sie in den Befehl einfügen.
`"{\"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` – Geben Sie denselben Bucket-Namen an, den Sie in [Schritt 3: Hochladen Ihrer Installationsdateien in Amazon S3](custom-cev.preparing.md#custom-cev.preparing.s3) angegeben haben. Die AWS-Region, in der Sie `create-custom-db-engine-version` ausführen, muss mit der Region übereinstimmen, in der sich Ihr Amazon-S3-Bucket befindet.
Sie können auch die folgenden Optionen angeben:
+ `--description` – Geben Sie eine Beschreibung Ihrer CEV an.
+ `--database-installation-files-s3-prefix` – Geben Sie den Ordnernamen an, den Sie in [Schritt 3: Hochladen Ihrer Installationsdateien in Amazon S3](custom-cev.preparing.md#custom-cev.preparing.s3) angegeben haben.
+ `--image-id` – Geben Sie eine AMI-ID an, die wiederverwendet werden soll. Um gültige IDs zu finden, führen Sie den Befehl `describe-db-engine-versions` aus und suchen Sie dann in der Ausgabe nach`ImageID`. Standardmäßig verwendet RDS Custom für Oracle das neueste verfügbare AMI.
Im folgenden Beispiel wird eine mehrmandantenfähige Oracle-CEV mit dem Namen `19.cdb_cev1` erstellt. In dem Beispiel wird ein vorhandenes AMI wiederverwendet, anstatt das neueste verfügbare AMI zu nutzen. Stellen Sie sicher, dass der Name Ihres CEV mit der Versionsnummer der Haupt-Engine beginnt.
**Example**
Für Linux, macOS oder 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
```
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**
Rufen Sie Details zu Ihrem CEV ab, indem Sie die`describe-db-engine-versions`befehl.
```
1. aws rds describe-db-engine-versions \
2. --engine custom-oracle-se2-cdb \
3. --include-all
```
Die folgende beispielhafte Teilausgabe zeigt die Engine, die Parametergruppen, das Manifest und andere Informationen.
```
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. ...
```
## Fehler beim Erstellen einer CEV
Wenn der Vorgang zum Erstellen einer CEV fehlschlägt, gibt RDS Custom `RDS-EVENT-0198` mit der Nachricht `Creation failed for custom engine version major-engine-version.cev_name` aus und schließt Details zum Fehler mit ein. Zum Beispiel druckt das Ereignis fehlende Dateien.
Eine fehlgeschlagene CEV kann nicht modifiziert werden. Sie können es nur löschen und dann erneut versuchen, eine CEV zu erstellen, nachdem Sie die Ursachen des Fehlers behoben haben. Informationen zur Fehlerbehebung der Gründe für einen Fehler bei der CEV-Erstellung finden Sie unter [Fehlerbehebung bei der Erstellung von benutzerdefinierten Engine-Versionen für RDS Custom für Oracle](custom-troubleshooting.md#custom-troubleshooting.cev).
# Ändern des CEV-Status
Sie können eine CEV unter Verwendung derAWS-Managementkonsoleoder dasAWS CLIaus. Sie können die CEV-Beschreibung oder ihren Verfügbarkeitsstatus ändern. Ihre CEV hat einen der folgenden Statuswerte:
+ `available`— Sie können diesen CEV verwenden, um eine neue RDS Custom DB-Instance zu erstellen oder eine DB-Instance zu aktualisieren. Dies ist der Standardstatus für eine neu erstellte CEV.
+ `inactive`— Sie können mit diesem CEV keine RDS Custom Instance erstellen oder aktualisieren. Sie können einen DB-Snapshot nicht wiederherstellen, um eine neue RDS Custom DB-Instance mit diesem CEV zu erstellen.
Sie können den CEV von jedem unterstützten Status in einen anderen unterstützten Status ändern. Sie können den Status ändern, um die versehentliche Verwendung einer CEV zu verhindern oder eine nicht fortgesetzte CEV erneut für die Verwendung berechtigt zu machen. Beispielsweise können Sie den Status Ihrer CEV unter `available` zu `inactive` und von `inactive` zurück zu `available` aus.
## Konsole
**So ändern Sie eine CEV**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon-RDS-Konsole unter [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Wählen Sie im Navigationsbereich und dann aus. **Benutzerdefinierte Engine-Versionen**aus.
1. Wählen Sie eine CEV aus, deren Beschreibung oder Status Sie ändern möchten.
1. Wählen Sie für **Actions (Aktionen)** die Option **Modify (Ändern)** aus.
1. Nehmen Sie eine oder alle der folgenden Änderungen vor:
+ Für **Einstellungen für CEV-Status** wählen Sie einen neuen Verfügbarkeitsstatus aus.
+ Geben Sie auf der Seite **Update description (Beschreibung aktualisieren)** eine Beschreibung für die neue Version ein.
1. Klicken Sie auf **Ändern der CEV**.
Wenn der CEV verwendet wird, wird die Konsole **Sie können den CEV-Status nicht ändern** angezeigt. Beheben Sie die Probleme und versuchen Sie es erneut.
Die **Benutzerdefinierte Engine-Versionen**-Seite wird angezeigt.
## AWS CLI
Um ein CEV mit AWS CLI zu ändern, führen Sie den Befehl [modify-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-custom-db-engine-version.html) aus. Sie können CEVs zum Ändern finden, indem Sie die [describe-db-engine-Versionen](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html)befehl.
Die folgenden Optionen sind erforderlich:
+ `--engine engine-type`, wobei der *Engine-Typ* `custom-oracle-ee`, `custom-oracle-se2`, `custom-oracle-ee-cdb` oder `custom-oracle-se2-cdb` ist
+ `--engine-version cev`, wobei *`cev`* der Name der benutzerdefinierten Engine-Version ist, die Sie ändern möchten
+ `--status`` status`, wobei *`status`* ist der Verfügbarkeitsstatus, den Sie dem CEV zuweisen möchten
Im folgenden Beispiel wird ein CEV namens `19.my_cev1` von seinem aktuellen Status in `inactive` geändert.
**Example**
Für Linux, macOS oder Unix:
```
1. aws rds modify-custom-db-engine-version \
2. --engine custom-oracle-se2 \
3. --engine-version 19.my_cev1 \
4. --status inactive
```
Windows:
```
1. aws rds modify-custom-db-engine-version ^
2. --engine custom-oracle-se2 ^
3. --engine-version 19.my_cev1 ^
4. --status inactive
```
# Anzeigen von CEV-Details zu Amazon RDS Custom für Oracle
Sie können Details zu Ihrem CEV-Manifest und dem Befehl, mit dem Ihre CEV erstellt wurde, einsehen, indem Sie die AWS-Managementkonsole oder die AWS CLI verwenden.
## Konsole
**So zeigen Sie CEV-Details an**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon-RDS-Konsole unter [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Wählen Sie im Navigationsbereich und dann aus.**Benutzerdefinierte Engine-Versionen**aus.
Die**Benutzerdefinierte Engine-Versionen**Seite zeigt alle CEVs an, die derzeit existieren. Wenn Sie keine CEVs erstellt haben, ist die Seite leer.
1. Wählen Sie den Namen der CEV, die Sie anzeigen möchten.
1. Wählen Sie **Configuration** (Konfiguration) aus, um die in Ihrem Manifest angegebenen Installationsparameter anzuzeigen.
![\[Sehen Sie sich die Installationsparameter für eine CEV an.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/cev-configuration-tab.png)
1. Wählen Sie **Manifest** aus, um die in der Option `--manifest` des Befehls `create-custom-db-engine-version` angegebenen Installationsparameter anzuzeigen. Sie können diesen Text kopieren, Werte nach Bedarf ersetzen und sie in einem neuen Befehl verwenden.
![\[Sehen Sie sich den Befehl an, der zum Erstellen der CEV verwendet wurde.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/cev-manifest-tab.png)
## AWS CLI
Führen Sie den Befehl [describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html) aus, um Details zur CEV mit der AWS CLI anzuzeigen.
Die folgenden Optionen sind erforderlich:
+ `--engine engine-type`, wobei der *Engine-Typ* `custom-oracle-ee`, `custom-oracle-se2`, `custom-oracle-ee-cdb` oder `custom-oracle-se2-cdb` ist
+ `--engine-version major-engine-version.customized_string`
Im folgenden Beispiel wird eine Nicht-CDB-CEV erstellt, die die Enterprise Edition verwendet. Der CEV-Name `19.my_cev1` beginnt mit der Hauptversionsnummer der Engine, die erforderlich ist.
**Example**
Für Linux, macOS oder Unix:
```
1. aws rds describe-db-engine-versions \
2. --engine custom-oracle-ee \
3. --engine-version 19.my_cev1
```
Für Windows:
```
1. aws rds describe-db-engine-versions ^
2. --engine custom-oracle-ee ^
3. --engine-version 19.my_cev1
```
Die folgende beispielhafte Teilausgabe zeigt die Engine, die Parametergruppen, das Manifest und andere Informationen.
```
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. ]
```
# Löschen einer CEV
Sie können eine CEV mithilfe der AWS-Managementkonsole oder der AWS CLI löschen. Dies dauert in der Regel einige Minuten.
Um eine CEV zu löschen, kann sie von keinem der folgenden Optionen verwendet werden:
+ Stopp einer RDS-DB-Instance.
+ Ein Snapshot einer RDS Custom DB-Instance
+ Eine automatisierte Sicherung Ihrer RDS Custom DB-Instance
## Konsole
**So löschen Sie eine VPC**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon-RDS-Konsole unter [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Wählen Sie im Navigationsbereich und dann aus. **Benutzerdefinierte Engine-Versionen**aus.
1. Wählen Sie eine CEV aus, deren Beschreibung oder Status Sie löschen möchten.
1. Klicken Sie bei ** Actions** auf **Delete**.
Die Dialogbox **Löschen*cev\$1name*?** wird angezeigt.
1. Geben Sie **delete me** ein und klicken Sie auf **Delete (Löschen)**.
In der**Benutzerdefinierte Engine-Versionen**-Seite zeigt das Banner, dass Ihre CEV gelöscht wird.
## AWS CLI
So löschen Sie eine CEV mithilfe derAWS CLIAusführen des s[lösche-custom-db-Motorversion](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-custom-db-engine-version.html)befehl.
Die folgenden Optionen sind erforderlich:
+ `--engine engine-type`, wobei der *Engine-Typ* `custom-oracle-ee`, `custom-oracle-se2`, `custom-oracle-ee-cdb` oder `custom-oracle-se2-cdb` ist
+ `--engine-version cev`, wobei*cev*ist der Name der zu löschenden benutzerdefinierten Engine-Version
Im folgenden Beispiel wird ein Tresor namens `19.my_cev1` gelöscht.
**Example**
Für Linux, macOS oder Unix:
```
1. aws rds delete-custom-db-engine-version \
2. --engine custom-oracle-ee \
3. --engine-version 19.my_cev1
```
Windows:
```
1. aws rds delete-custom-db-engine-version ^
2. --engine custom-oracle-ee ^
3. --engine-version 19.my_cev1
```