Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# 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](custom-creating.md#custom-creating.overview).
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](custom-creating.md#custom-creating.create) e [Aggiornamento di un'istanza database RDS Custom per Oracle](custom-upgrading-modify.md).
**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/](https://console.aws.amazon.com/rds/).
1. 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.
1. Scegliere **Creazione della versione del motore personalizzata**.
1. In **Opzioni motore**, procedi nel modo seguente:
1. Per **Engine type** (Tipo di motore), seleziona **Oracle**.
1. 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.
1. 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.
1. In **Versione principale**, scegli la versione principale del motore.
1. 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\$1cev1**.
1. (Facoltativo) Inserisci una descrizione per la CEV.
1. 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`.
1. 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](custom-cev.preparing.md#custom-cev.preparing.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.
1. (Solo Crea un nuovo CEV) In **Manifest CEV** inserisci il manifesto JSON creato in [Creazione del manifest CEV](custom-cev.preparing.md#custom-cev.preparing.manifest.creating).
1. 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: Creare o riutilizzare una chiave di crittografia simmetrica AWS KMS](custom-setup-orcl.md#custom-setup-orcl.cmk).
1. (Facoltativo) Scegli **Aggiungi nuovo tag** per creare una coppia chiave-valore per la tua CEV.
1. 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](https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html).
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\$1string*. 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 (\$1).
L'esempio seguente mostra il `manifest_json_string` per 19c da [Fase 5: preparazione del manifesto CEV](custom-cev.preparing.md#custom-cev.preparing.manifest). 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](custom-cev.preparing.md#custom-cev.preparing.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](custom-cev.preparing.md#custom-cev.preparing.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.
**Example**
Per Linux, macOS o Unix:
```
1. aws rds create-custom-db-engine-version \
2. --engine custom-oracle-se2-cdb \
3. --engine-version 19.cdb_cev1 \
4. --database-installation-files-s3-bucket-name us-east-1-123456789012-custom-installation-files \
5. --database-installation-files-s3-prefix 123456789012/cev1 \
6. --kms-key-id my-kms-key \
7. --description "test cev" \
8. --manifest manifest_string \
9. --image-id ami-012a345678901bcde
```
Per Windows:
```
1. aws rds create-custom-db-engine-version ^
2. --engine custom-oracle-se2-cdb ^
3. --engine-version 19.cdb_cev1 ^
4. --database-installation-files-s3-bucket-name us-east-1-123456789012-custom-installation-files ^
5. --database-installation-files-s3-prefix 123456789012/cev1 ^
6. --kms-key-id my-kms-key ^
7. --description "test cev" ^
8. --manifest manifest_string ^
9. --image-id ami-012a345678901bcde
```
**Example**
Ottenere informazioni sul CEV tramite il comando `describe-db-engine-versions`.
```
1. aws rds describe-db-engine-versions \
2. --engine custom-oracle-se2-cdb \
3. --include-all
```
Il seguente output parziale mostra il motore, i gruppi di parametri, il manifesto e altre informazioni.
```
1. {
2. "DBEngineVersions": [
3. {
4. "Engine": "custom-oracle-se2-cdb",
5. "EngineVersion": "19.cdb_cev1",
6. "DBParameterGroupFamily": "custom-oracle-se2-cdb-19",
7. "DBEngineDescription": "Containerized Database for Oracle Custom SE2",
8. "DBEngineVersionDescription": "test cev",
9. "Image": {
10. "ImageId": "ami-012a345678901bcde",
11. "Status": "active"
12. },
13. "ValidUpgradeTarget": [],
14. "SupportsLogExportsToCloudwatchLogs": false,
15. "SupportsReadReplica": true,
16. "SupportedFeatureNames": [],
17. "Status": "available",
18. "SupportsParallelQuery": false,
19. "SupportsGlobalDatabases": false,
20. "MajorEngineVersion": "19",
21. "DatabaseInstallationFilesS3BucketName": "us-east-1-123456789012-custom-installation-files",
22. "DatabaseInstallationFilesS3Prefix": "123456789012/cev1",
23. "DBEngineVersionArn": "arn:aws:rds:us-east-1:123456789012:cev:custom-oracle-se2-cdb/19.cdb_cev1/abcd12e3-4f5g-67h8-i9j0-k1234l56m789",
24. "KMSKeyId": "arn:aws:kms:us-east-1:732027699161:key/1ab2345c-6d78-9ef0-1gh2-3456i7j89k01",
25. "CreateTime": "2023-03-07T19:47:58.131000+00:00",
26. "TagList": [],
27. "SupportsBabelfish": false,
28. ...
```
## 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](custom-troubleshooting.md#custom-troubleshooting.cev).