Creazione di un CEV

È possibile creare un CEV utilizzando AWS Management Console o il AWS CLI. Specifica l'architettura multilocazione o non multilocazione. Per ulteriori informazioni, consulta Considerazioni sull'architettura multilocazione.

In genere, la creazione di un CEV richiede circa due ore. Dopo aver creato la versione del motore personalizzato (CEV), puoi usare la CEV per creare un'istanza database RDS Custom. Per ulteriori informazioni, consulta Creazione di un'istanza database RDS Custom per Oracle.

Tieni presente i seguenti requisiti e limitazioni per la creazione di un CEV:

Il bucket Amazon S3 contenente i file di installazione deve trovarsi nello stesso Regione AWS file del tuo CEV. In caso contrario, il processo di creazione fallisce.
Il nome CEV deve essere nel formato seguentemajor-engine-version.customized_string. 19.cdb_cev1
Il nome CEV deve contenere da 1 a 50 caratteri alfanumerici, trattini bassi o punti.
Il nome CEV non può contenere punti consecutivi, come in. 19..cdb_cev1

Per creare un CEV

Accedi AWS Management Console e apri la console Amazon RDS all'indirizzo https://console.aws.amazon.com/rds/.
Nel pannello di navigazione, scegliere Versioni motore personalizzate.

La pagina Versioni motore personalizzate mostra tutti i CEV attualmente esistenti. Se non è stato creato alcun CEV, la pagina è vuota.
Scegliere Creazione della versione del motore personalizzata.
In Opzioni motore, procedi nel modo seguente:
1. Per Engine type (Tipo di motore), seleziona Oracle.
2. Per le impostazioni dell'architettura, scegli facoltativamente Architettura multitenant per creare un CEV multitenant Oracle, che utilizza il motore DB o. custom-oracle-ee-cdb custom-oracle-se2-cdb È possibile creare un RDS Custom per Oracle solo con una CEV multi-tenant. Se non scegli questa opzione, il tuo CEV non è un CDB, che utilizza il motore o. custom-oracle-ee custom-oracle-se2
  
  Nota
  L'architettura selezionata è una caratteristica permanente della CEV. Non puoi modificare la CEV in modo che utilizzi un'architettura diversa in un secondo momento.
3. Seleziona una delle seguenti opzioni:
  - Crea un nuovo CEV: crea una nuova versione del motore personalizzato da zero. In questo caso, è necessario specificare un manifesto JSON che definisca i file binari del database.
  - Crea un CEV dall'origine: in Specifica il CEV da copiare scegli una versione del motore personalizzato esistente da utilizzare come CEV di origine. In questo caso, puoi specificare una nuova Amazon Machine Image (AMI), ma non puoi definire file binari del database diversi.
4. In Versione principale, scegli la versione principale del motore.
In Dettagli versione, procedi come segue:
1. Inserisci un nome valido in Nome della versione del motore personalizzato. Ad esempio, è possibile inserire il nome 19.cdb_cev1.
2. (Facoltativo) Inserisci una descrizione per la CEV.
In Media di installazione, esegui le operazioni indicate di seguito:
1. (Facoltativo) Lascia il campo ID AMI vuoto per utilizzare l'AMI più recente fornita dal servizio oppure specifica l'AMI che hai usato in precedenza per creare una versione del motore personalizzato. Per ottenere ID AMI validi, usa una delle seguenti tecniche:
  - Nella console, scegli Versioni del motore personalizzato nel riquadro di navigazione a sinistra e scegli il nome di una CEV. L'ID AMI utilizzato dalla CEV viene visualizzato nella scheda Configurazione.
  - Nel AWS CLI, usa il comando. describe-db-engine-versions Cerca nell'output per ImageID.
2. Per la posizione S3 dei file manifest, inserisci la posizione del bucket Amazon S3 specificata in Fase 3: caricamento dei file di installazione in Amazon S3. Ad esempio, specifica s3://my-custom-installation-files/123456789012/cev1/.
  
  Nota
  Il Regione AWS file in cui crei il CEV deve trovarsi nella stessa regione del bucket S3.
3. (Solo Crea un nuovo CEV) In Manifest CEV inserisci il manifesto JSON creato in Creazione del manifest CEV.
Nella sezione chiave KMS, seleziona Inserisci una chiave ARN per elencare le chiavi disponibili. AWS KMS Selezionare quindi la propria chiave KMS dall'elenco.

È richiesta una AWS KMS chiave per RDS Custom. Per ulteriori informazioni, consulta Fase 1: creazione o riutilizzo di una chiave AWS KMS di crittografia simmetrica.
(Facoltativo) Scegli Aggiungi nuovo tag per creare una coppia chiave-valore per la tua CEV.
Scegliere Creazione della versione del motore personalizzata.

Se il formato del manifesto JSON non è valido, la console visualizza Error validating the CEV manifest. Risolvi i problemi e riprova.

La pagina Versioni motore personalizzate viene visualizzata. Il tuo CEV viene mostrato con lo stato Creating (Creazione). Il processo di creazione della versione del motore personalizzato richiede circa due ore.

Per creare un CEV utilizzando AWS CLI, esegui il comando create-custom-db-engine-version.

Sono richieste le seguenti opzioni:

--engine— Specificare il tipo di motore. Per un CDB, specificare custom-oracle-ee-cdb ocustom-oracle-se2-cdb. Per un non-CDB, specifica o. custom-oracle-ee custom-oracle-se2 È possibile creare CDB solo da un CEV creato con o. custom-oracle-ee-cdb custom-oracle-se2-cdb È possibile creare documenti non CDB solo da un CEV creato con o. custom-oracle-ee custom-oracle-se2
--engine-version: specifica la versione del motore. Il formato è. major-engine-version stringa_personalizzata. Il nome CEV deve contenere da 1 a 50 caratteri alfanumerici, trattini bassi o punti. Il nome CEV non può contenere punti consecutivi, come in. 19..cdb_cev1
--kms-key-id— Specificare un AWS KMS key.
--manifest: specifica manifest_json_string o --manifest file:file_name. I caratteri di nuova riga non sono consentiti in manifest_json_string. Assicurati di evitare le doppie virgolette (") nel codice JSON precedendole con il backslash (\).

L'esempio seguente mostra il manifest_json_string per 19c da Fase 5: preparazione del manifesto CEV. L'esempio imposta nuovi valori per la base Oracle, la home Oracle e l'ID e il nome dell'utente e del gruppo UNIX/Linux. Se copi questa stringa, rimuovi tutti i caratteri di nuova riga prima di incollarla nel comando.

"{\"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: specifica lo stesso nome del bucket specificato in Fase 3: caricamento dei file di installazione in Amazon S3. Il Regione AWS bucket in cui viene eseguito create-custom-db-engine-version deve trovarsi nella stessa regione del bucket Amazon S3.

È anche possibile specificare le seguenti opzioni:

--description: specifica una descrizione della CEV.
--database-installation-files-s3-prefix: specifica il nome della cartella specificato in Fase 3: caricamento dei file di installazione in Amazon S3.
--image-id: specifica un ID AMI che si desidera riutilizzare. Per trovare ID validi, esegui il comando describe-db-engine-versions, quindi cerca l'output per ImageID. Per impostazione predefinita, RDS Custom per Oracle utilizza l'AMI disponibile più recente.

L'esempio seguente crea una CEV multitenant Oracle denominata 19.cdb_cev1. L'esempio riutilizza un'AMI esistente anziché utilizzare l'ultima AMI disponibile. Assicurati che il nome del tuo CEV inizi con il numero di versione principale del motore.

PerLinux, omacOS: 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

Per 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

Ottenere informazioni sul CEV tramite il comando describe-db-engine-versions.


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

Il seguente output parziale mostra il motore, i gruppi di parametri, il manifesto e altre informazioni.


{
    "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,
...

Impossibile creare un CEV

Se il processo di creazione di un CEV non riesce, RDS Custom emette RDS-EVENT-0198 con il messaggio Creation failed for custom engine version major-engine-version.cev_name e include i dettagli sull'errore. Ad esempio, l'evento stampa i file mancanti.

Non è possibile modificare un CEV fallito. È possibile solamente eliminarlo, quindi riprovare a creare un CEV dopo aver risolto le cause dell'errore. Per informazioni sulla risoluzione dei problemi relativi all'errore di creazione del CEV, consulta Risoluzione dei problemi relativi alla creazione di versioni personalizzate del motore per RDS Custom per Oracle.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Preparazione alla creazione di un CEV

Modifica dello stato del CEV

Creazione di un CEV

Per creare un CEV

Nota

Nota

Impossibile creare un CEV