Erstellen einer CEV

Sie können eine CEV mit dem AWS Management Console 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.

In der Regel CEV dauert das Erstellen von etwa zwei Stunden. Nachdem Sie die erstellt habenCEV, können Sie sie verwenden, um eine RDS benutzerdefinierte DB-Instance zu erstellen oder zu aktualisieren. Weitere Informationen erhalten Sie unter Erstellen einer RDS Custom für Oracle DB-Instance und Eine RDS benutzerdefinierte für Oracle DB-Instance aktualisieren.

Anmerkung

Wenn Ihre DB-Instance derzeit Oracle Linux 7.9 verwendet, erstellen Sie eine neueCEV, die die neueste Version verwendetAMI, die Oracle Linux 8 verwendet. Ändern Sie dann Ihre Instance so, dass sie die neue Version verwendetCEV.

Beachten Sie die folgenden Anforderungen und Einschränkungen für die Erstellung einerCEV:

Der Amazon S3 S3-Bucket, der Ihre Installationsdateien enthält, muss sich in demselben Ordner AWS-Region befinden wie IhrCEV. Andernfalls schlägt der Erstellungsprozess fehl.
Der CEV Name muss das Format habenmajor-engine-version.customized_string, wie in19.cdb_cev1.
Der CEV Name muss 1—50 alphanumerische Zeichen, Unterstriche, Bindestriche oder Punkte enthalten.
Der CEV Name darf keine aufeinanderfolgenden Punkte enthalten, wie in. 19..cdb_cev1

So erstellen Sie eine CEV

Melden Sie sich bei der an AWS Management Console und öffnen Sie die RDS Amazon-Konsole unter https://console.aws.amazon.com/rds/.
Wählen Sie im Navigationsbereich und dann aus.Benutzerdefinierte Engine-Versionenaus.

Auf der Seite Benutzerdefinierte Engine-Versionen werden alle derzeit CEVs vorhandenen Engine-Versionen angezeigt. Wenn Sie keine erstellt habenCEVs, ist die Seite leer.
Klicken Sie auf Erstellen einer benutzerdefinierten Engine-Version.
Gehen Sie unter Engine-Optionen wie folgt vor:
1. Wählen Sie in Engine type (Engine-Typ) Oracle.
2. Wählen Sie für Architektureinstellungen optional Multitenant Architecture aus, um einen Oracle Multitenant zu erstellenCEV, der die DB-Engine custom-oracle-ee-cdb oder verwendet. custom-oracle-se2-cdb Sie können eine RDS benutzerdefinierte Lösung für Oracle nur CDB mit einem CEV Multitenant erstellen. Wenn Sie diese Option nicht wählen, CEV handelt es sich bei Ihrer nicht um eine OptionCDB, die die Engine custom-oracle-ee oder custom-oracle-se2 verwendet.
  
  Anmerkung
  Die Architektur, für die Sie sich entscheiden, ist ein bleibendes Merkmal IhrerCEV. Sie können Ihre Architektur nicht ändernCEV, um später eine andere zu verwenden.
3. Wählen Sie eine der folgenden Optionen:
  - Neu erstellen CEV — Erstellen Sie eine CEV von Grund auf neu. In diesem Fall müssen Sie ein JSON Manifest angeben, das die Datenbank-Binärdateien angibt.
  - CEVAus Quelle erstellen — Wählen Sie unter Geben Sie anCEV, dass Sie kopieren möchten, eine vorhandene Datei aus, die als Quelle CEV verwendet werden CEV soll. In diesem Fall können Sie ein neues Amazon Machine Image (AMI) angeben, aber Sie können keine anderen Datenbank-Binärdateien angeben.
4. Wählen Sie unter Engine-Version die Engine-Hauptversion aus.
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_cev1 eingeben.
2. (Optional) Geben Sie eine Beschreibung für Ihre CEV ein.
Gehen Sie unter Installationsmedien wie folgt vor:
1. (Optional) Lassen Sie für AMIID entweder das Feld leer, um den neuesten Service zu verwendenAMI, oder geben Sie eine einAMI, mit der Sie zuvor eine CEV erstellt haben. Verwenden Sie eine der folgenden Methoden AMIIDs, um eine gültige Version zu erhalten:
  - Wählen Sie in der Konsole im linken Navigationsbereich die Option Benutzerdefinierte Engine-Versionen und wählen Sie den Namen einesCEV. Die von der verwendete AMI ID CEV 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.
2. FürS3-Speicherort von ManifestdateienGeben Sie den Speicherort des Amazon S3-Buckets ein, den Sie in angegeben habenSchritt 3: Hochladen Ihrer Installationsdateien in Amazon S3aus. Geben Sie z. B. ei s3://my-custom-installation-files/123456789012/cev1/.
  
  Anmerkung
  Der, AWS-Region in dem Sie den erstellen, CEV muss sich in derselben Region wie der S3-Bucket befinden.
3. (CEVNur neu erstellen) Geben Sie für CEVManifest das JSON Manifest ein, in dem Sie es erstellt habenDas Manifest erstellen CEV.
Wählen Sie im KMSSchlüsselbereich die Option Schlüssel eingeben aus, ARN um die verfügbaren AWS KMS Schlüssel aufzulisten. Wählen Sie dann Ihren KMS Schlüssel aus der Liste aus.

Für RDS Benutzerdefiniert ist ein AWS KMS Schlüssel erforderlich. Weitere Informationen finden Sie unter Schritt 1: Erstellen oder Wiederverwenden eines symmetrischen AWS KMS -Verschlüsselungsschlüssels.
(Optional) Wählen Sie Neues Tag hinzufügen, um ein Schlüssel-Wert-Paar für Ihr zu erstellen. CEV
Klicken Sie auf Erstellen einer benutzerdefinierten Engine-Version.

Wenn das JSON Manifest ein ungültiges Format hat, zeigt die Konsole Fehler bei der Überprüfung des Manifests an. CEV Beheben Sie die Probleme und versuchen Sie es erneut.

DieBenutzerdefinierte Engine-Versionen-Seite wird angezeigt. Ihr CEV wird mit dem Status Wird erstellt angezeigt. Der Vorgang zum Erstellen einer CEV dauert ungefähr zwei Stunden.

Um eine mit CEV dem zu erstellen AWS CLI, führen Sie den Befehl create-custom-db-engine-version aus.

Die folgenden Optionen sind erforderlich:

--engine— Geben Sie den Motortyp an. Geben Sie für a CDB entweder custom-oracle-ee-cdb oder ancustom-oracle-se2-cdb. Geben Sie für einen WertCDB, der nicht- ist, entweder custom-oracle-ee oder ancustom-oracle-se2. Sie können CDBs nur aus einer Datei erstellen, die mit custom-oracle-ee-cdb oder CEV erstellt wurdecustom-oracle-se2-cdb. Sie können nicht CDBs nur aus einer Datei erstellen, die mit custom-oracle-ee oder CEV erstellt wurdecustom-oracle-se2.
--engine-version – Geben Sie die Engine-Version an. Das Format istmajor-engine-version. customized_string. Der CEV Name muss 1—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. Achten Sie darauf, doppelte Anführungszeichen („) im JSON Code zu umgehen, indem Sie ihnen einen umgekehrten Schrägstrich (\) voranstellen.

Das folgende Beispiel zeigt das manifest_json_string für 19c von Schritt 5: Bereiten Sie das CEV Manifest vor. 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 Ihren 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 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 Ihres anCEV.
--database-installation-files-s3-prefix – Geben Sie den Ordnernamen an, den Sie in Schritt 3: Hochladen Ihrer Installationsdateien in Amazon S3 angegeben haben.
--image-id— Geben Sie eine AMI ID an, die Sie wiederverwenden möchten. Um eine gültige Version zu findenIDs, führen Sie den describe-db-engine-versions Befehl aus und suchen Sie dann in der Ausgabe nachImageID. Standardmäßig verwendet RDS Custom for Oracle die neueste verfügbare VersionAMI.

Im folgenden Beispiel wird ein Oracle-Multitenant CEV mit dem Namen 19.cdb_cev1 erstellt. Im Beispiel wird ein vorhandenes wiederverwendet, AMI anstatt das neueste verfügbare zu verwenden. AMI Stellen Sie sicher, dass Ihr Name mit der Versionsnummer der Haupt-Engine CEV beginnt.

Wählen Sie in der &Snowconsole; Ihren Auftrag aus der Tabelle. Linux, macOS, oder Unix:


aws rds create-custom-db-engine-version \
    --engine custom-oracle-se2-cdb \
    --engine-version 19.cdb_cev1 \
    --database-installation-files-s3-bucket-name us-east-1-123456789012-custom-installation-files \
    --database-installation-files-s3-prefix 123456789012/cev1 \
    --kms-key-id my-kms-key \
    --description "test cev" \
    --manifest manifest_string \
    --image-id ami-012a345678901bcde

Wählen Sie in der &Snowconsole; Ihren Auftrag aus der Tabelle. Windows:


aws rds create-custom-db-engine-version ^
    --engine custom-oracle-se2-cdb ^
    --engine-version 19.cdb_cev1 ^
    --database-installation-files-s3-bucket-name us-east-1-123456789012-custom-installation-files ^
    --database-installation-files-s3-prefix 123456789012/cev1 ^
    --kms-key-id my-kms-key ^
    --description "test cev" ^
    --manifest manifest_string ^
    --image-id ami-012a345678901bcde

Rufen Sie Details zu Ihrem ab, CEV indem Sie den describe-db-engine-versions Befehl verwenden.


aws rds describe-db-engine-versions \
    --engine custom-oracle-se2-cdb \
    --include-all

Die folgende beispielhafte Teilausgabe zeigt die Engine, die Parametergruppen, das Manifest und andere Informationen.


{
    "DBEngineVersions": [
        {
            "Engine": "custom-oracle-se2-cdb",
            "EngineVersion": "19.cdb_cev1",
            "DBParameterGroupFamily": "custom-oracle-se2-cdb-19",
            "DBEngineDescription": "Containerized Database for Oracle Custom SE2",
            "DBEngineVersionDescription": "test cev",
            "Image": {
                "ImageId": "ami-012a345678901bcde",
                "Status": "active"
            },
            "ValidUpgradeTarget": [],
            "SupportsLogExportsToCloudwatchLogs": false,
            "SupportsReadReplica": true,
            "SupportedFeatureNames": [],
            "Status": "available",
            "SupportsParallelQuery": false,
            "SupportsGlobalDatabases": false,
            "MajorEngineVersion": "19",
            "DatabaseInstallationFilesS3BucketName": "us-east-1-123456789012-custom-installation-files",
            "DatabaseInstallationFilesS3Prefix": "123456789012/cev1",
            "DBEngineVersionArn": "arn:aws:rds:us-east-1:123456789012:cev:custom-oracle-se2-cdb/19.cdb_cev1/abcd12e3-4f5g-67h8-i9j0-k1234l56m789",
            "KMSKeyId": "arn:aws:kms:us-east-1:732027699161:key/1ab2345c-6d78-9ef0-1gh2-3456i7j89k01",
            "CreateTime": "2023-03-07T19:47:58.131000+00:00",
            "TagList": [],
            "SupportsBabelfish": false,
...

Fehler beim Erstellen eines CEV

Wenn der Vorgang zum Erstellen einer CEV fehlschlägt, gibt RDS Custom einen Fehler RDS-EVENT-0198 mit der Nachricht Creation failed for custom engine version major-engine-version.cev_name aus und enthält Informationen zu dem Fehler. Zum Beispiel druckt das Ereignis fehlende Dateien.

Sie können eine fehlgeschlagene Datei nicht ändernCEV. Sie können es nur löschen und dann erneut versuchen, eine zu erstellen, CEV nachdem Sie die Ursachen des Fehlers behoben haben. Informationen zur Behebung der Gründe für das Fehlschlagen bei der CEV Erstellung finden Sie unterProblembehandlung bei der Erstellung einer benutzerdefinierten Engine-Version für RDS Custom for Oracle.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Vorbereitung der Erstellung eines CEV

Ändern des CEV-Status