Creazione di un CEV

È possibile creare un CEV tramite Console di gestione AWS o 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 CEV, puoi usarla per creare o aggiornare un’istanza database RDS Custom. Per ulteriori informazioni, consultare Creazione di un'istanza database RDS Custom per Oracle e Aggiornamento di un'istanza database RDS Custom per Oracle.

Nota

Se la tua istanza database utilizza attualmente Oracle Linux 7.9, crea una nuova CEV che utilizzi l’AMI più recente, che usa Oracle Linux 8. Modifica quindi l’istanza in modo da utilizzare la nuova CEV.

Tieni presenti i requisiti e le limitazioni seguenti per la creazione di una CEV:

• Il bucket Amazon S3 che contiene i file di installazione deve trovarsi nella stessa Regione Regione AWS della CEV. In caso contrario, il processo di creazione non riesce.

• Il nome della CEV deve essere nel formato major-engine-version.customized_string, come in 19.cdb_cev1.

• Il nome della CEV deve contenere da 1 a 50 caratteri alfanumerici, caratteri di sottolineatura, trattini o punti.

• Il nome della CEV non può contenere punti consecutivi, come in 19..cdb_cev1.

Console

Per creare un CEV

1. Accedi alla Console di gestione AWS e apri la console Amazon RDS all'indirizzo https://console.aws.amazon.com/rds/.

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

3. Scegliere Creazione della versione del motore personalizzata.

4. In Opzioni motore, procedi nel modo seguente:

   1. Per Engine type (Tipo di motore), seleziona Oracle.

   2. In Impostazioni dell’architettura, scegli Architettura multi-tenant per creare una CEV multitenant Oracle, che utilizza il motore di database custom-oracle-ee-cdb o custom-oracle-se2-cdb. È possibile creare un RDS Custom per Oracle solo con una CEV multi-tenant. Se non si sceglie questa opzione, la CEV non è un CDB, che utilizza il motore custom-oracle-ee o 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.

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

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

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

      La Regione AWS in cui crei la versione del motore personalizzato 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.

7. Nella sezione Chiave KMS, seleziona Inserisci un ARN della chiave per elencare le chiavi AWS KMS disponibili. Selezionare quindi la propria chiave KMS dall'elenco.

   Per RDS Custom è necessaria la chiave AWS KMS. Per ulteriori informazioni, consulta Fase 1: creazione o riutilizzo di una chiave AWS KMS di crittografia simmetrica.

8. (Facoltativo) Scegli Aggiungi nuovo tag per creare una coppia chiave-valore per la tua CEV.

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

AWS CLI

Creazione di un CEV tramite AWS CLI, esegui il comando create-custom-db-engine-version.

Sono richieste le seguenti opzioni:

• --engine: specifica il tipo di motore. Per un CDB, specifica custom-oracle-ee-cdb o custom-oracle-se2-cdb. Per un non CDB, specifica custom-oracle-ee o custom-oracle-se2. È possibile creare CDB solo da una CEV creata con custom-oracle-ee-cdb o custom-oracle-se2-cdb. È possibile creare non CDB solo da una CEV creata con custom-oracle-ee o custom-oracle-se2.

• --engine-version: specifica la versione del motore. Il formato è major-engine-version.customized_string. Il nome della CEV deve contenere da 1 a 50 caratteri alfanumerici, caratteri di sottolineatura, trattini o punti. Il nome della CEV non può contenere punti consecutivi, come in 19..cdb_cev1.

• --kms-key-id: specifica una 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. La Regione AWS in cui esegui 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.

Per Linux, macOS o 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.