Erstellen einer CEV - Amazon Relational Database Service
Fehler beim Erstellen einer CEV

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

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.

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 und Upgrade einer benutzerdefinierten RDS-für-Oracle-DB-Instance.

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 habenmajor-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.

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/.

  2. Wählen Sie im Navigationsbereich und dann aus.Benutzerdefinierte Engine-Versionenaus.

    DieBenutzerdefinierte Engine-VersionenSeite zeigt alle CEVs an, die derzeit existieren. Wenn Sie keine CEVs erstellt haben, ist die Seite leer.

  3. Klicken Sie auf Erstellen einer benutzerdefinierten Engine-Version.

  4. Gehen Sie unter Engine-Optionen wie folgt vor:

    1. Wählen Sie in Engine type (Engine-Typ) Oracle.

    2. 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.

    3. 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.

    4. Wählen Sie unter Engine-Version die Engine-Hauptversion aus.

  5. 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.

  6. 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.

    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

      Die AWS-Region, in der Sie die CEV erstellen, muss sich in derselben Region wie der S3-Bucket befinden.

    3. (Nur für „Neue CEV erstellen“) Geben Sie im Feld CEV-Manifest das JSON-Manifest ein, das Sie in Erstellen des CEV-Manifests erstellt haben.

  7. 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: Erstellen oder Wiederverwenden eines symmetrischen AWS KMS -Verschlüsselungsschlüssels.

  8. (Optional) Wählen Sie Neues Tag hinzufügen aus, um ein Schlüssel-Wert-Paar für Ihre CEV zu erstellen.

  9. 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.

DieBenutzerdefinierte Engine-Versionen-Seite wird angezeigt. Ihre CEV wird mit dem Status angezeigtErstellenaus. Die Erstellung einer CEV dauert ungefähr zwei Stunden.

So erstellen Sie eine CEV mithilfe derAWS CLIAusführen des serstellen-custom-db-Motorversionbefehl.

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_Zeichenfolge. 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 (\) voranstellen.

    Das folgende Beispiel zeigt das manifest_json_string für 19c von Schritt 5: Vorbereiten des CEV-Manifests. 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 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 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 nachImageID. 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.

Für 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

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 CEV ab, indem Sie diedescribe-db-engine-versionsbefehl.

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 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.