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.

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.

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

Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon RDS-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 haben CEVs, 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 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.
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 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.
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
  Das, AWS-Region in dem Sie das 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.
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.
(Optional) Wählen Sie Neues Tag hinzufügen aus, um ein Schlüssel-Wert-Paar für Ihre CEV zu erstellen.
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.

Um ein CEV mit 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 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 istmajor-engine-version. customized_string. 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 (\) 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 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 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 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.

Beispiel

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

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

Beispiel

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.

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

Vorbereiten der Erstellung einer CEV

Ändern des CEV-Status