Erstellen einer CEV

Sie können eine CEV mit dem AWS Management Console oder dem 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 die CEV erstellt wurde, können Sie sie verwenden, um eine DB-Instance von RDS Custom zu erstellen. Weitere Informationen finden Sie unter Erstellen einer RDS Custom für Oracle DB-Instance.

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

Der Amazon S3 S3-Bucket, der Ihre Installationsdateien enthält, muss sich in demselben Ordner AWS-Region wie Ihr CEV befinden. 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 VPC

Melden Sie sich bei der Amazon RDS-Konsole an AWS Management Console und öffnen Sie sie unter https://console.aws.amazon.com/rds/.
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.
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, um ein Oracle Multitenant CEV zu erstellen, das die DB-Engine oder verwendet. custom-oracle-ee-cdb custom-oracle-se2-cdb Sie können eine CDB von RDS Custom für Oracle nur mit einer mehrmandantenfähigen CEV erstellen. Wenn Sie diese Option nicht wählen, handelt es sich bei Ihrem CEV um eine Nicht-CDB, die die Engine oder verwendet. custom-oracle-ee custom-oracle-se2
  
  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, 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
  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: Erstellen oder Wiederverwenden eines symmetrischen AWS KMS -Verschlüsselungsschlüssels.
(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 Motortyp 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 an. custom-oracle-ee 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 oder erstellt wurde. custom-oracle-ee custom-oracle-se2
--engine-version – Geben Sie die Engine-Version an. Das Format ist. major-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. 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 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 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 LinuxmacOS, oderUnix:


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

Vorbereiten der Erstellung einer CEV

Ändern des CEV-Status

Erstellen einer CEV

So erstellen Sie eine VPC

Anmerkung

Anmerkung

Fehler beim Erstellen einer CEV