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.
# Erstellen einer CEV
**Anmerkung**
Hinweis zum Ende des Supports: Am 31. März 2027 AWS wird der Support für Amazon RDS Custom for Oracle eingestellt. Nach dem 31. März 2027 können Sie nicht mehr auf die Ressourcen von RDS Custom for Oracle oder RDS Custom for Oracle zugreifen. Weitere Informationen finden Sie unter [Ende des Supports für RDS Custom für Oracle](RDS-Custom-for-Oracle-end-of-support.md).
Sie können ein CEV mit dem AWS-Managementkonsole oder dem erstellen. AWS CLI 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 an AWS-Managementkonsole 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.
Auf der Seite **Benutzerdefinierte Engine-Versionen** werden alle derzeit CEVs vorhandenen Engine-Versionen angezeigt. Wenn Sie keine erstellt haben CEVs, 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 IDs, um ein gültiges AMI zu erhalten:
+ 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 `describe-db-engine-versions` Befehl. 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**
Das, AWS-Region in dem Sie das 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 **Schlüssel-ARN eingeben** aus, um die verfügbaren AWS KMS Schlüssel aufzulisten. Wählen Sie dann Ihren KMS-Schlüssel aus der Liste aus.
Für RDS Custom ist ein AWS KMS Schlüssel erforderlich. Weitere Informationen finden Sie unter [Schritt 1: Einen symmetrischen Verschlüsselungsschlüssel erstellen oder wiederverwenden AWS KMS](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
Um ein CEV mit dem zu erstellen AWS CLI, führen Sie den Befehl [create-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html) aus.
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 oder erstellt wurde. `custom-oracle-ee-cdb` `custom-oracle-se2-cdb` Sie können nicht CDBs nur aus einer CEV erstellen, die mit `custom-oracle-ee` oder erstellt wurde. `custom-oracle-se2`
+ `--engine-version` – Geben Sie die Engine-Version an. Das Format ist*major-engine-version*. *customized\$1string*. 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 eine an AWS KMS key.
+ `--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 Region, AWS-Region in der Sie ausführen, `create-custom-db-engine-version` muss dieselbe Region wie Ihr Amazon S3 S3-Bucket sein.
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 einen gültigen Wert zu finden IDs, führen Sie den `describe-db-engine-versions` Befehl 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
```
Für 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).