Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Membuat CEV
**catatan**
Pemberitahuan akhir dukungan: Pada 31 Maret 2027, AWS akan mengakhiri dukungan untuk Amazon RDS Custom for Oracle. Setelah 31 Maret 2027, Anda tidak akan lagi dapat mengakses RDS Custom for Oracle console atau RDS Custom for Oracle resources. Untuk informasi selengkapnya, lihat [RDS Kustom untuk akhir dukungan Oracle](RDS-Custom-for-Oracle-end-of-support.md).
Anda dapat membuat CEV menggunakan Konsol Manajemen AWS atau. AWS CLI Tentukan arsitektur multi-penghuni atau nonmulti-penghuni. Untuk informasi selengkapnya, lihat [Pertimbangan arsitektur multi-penghuni](custom-creating.md#custom-creating.overview).
Biasanya, membuat CEV membutuhkan waktu sekitar dua jam. Setelah Anda membuat CEV, Anda dapat menggunakannya untuk membuat atau meningkatkan instans RDS Custom DB. Untuk informasi selengkapnya, lihat [Membuat instans DB RDS Custom for Oracle](custom-creating.md#custom-creating.create) dan [Memutakhirkan instans basis data RDS Custom for Oracle](custom-upgrading-modify.md).
**catatan**
Jika instans DB Anda saat ini menggunakan Oracle Linux 7.9, buat CEV baru yang menggunakan AMI terbaru, yang menggunakan Oracle Linux 8. Kemudian ubah instance Anda untuk menggunakan CEV baru.
Perhatikan persyaratan dan batasan berikut untuk membuat CEV:
+ Bucket Amazon S3 yang berisi file instalasi Anda harus Wilayah AWS sama dengan CEV Anda. Jika tidak, proses pembuatan gagal.
+ Nama CEV harus dalam format`{{major-engine-version}}.{{customized_string}}`, seperti dalam`19.cdb_cev1`.
+ Nama CEV harus berisi 1-50 karakter alfanumerik, garis bawah, tanda hubung, atau titik.
+ Nama CEV tidak dapat berisi periode berturut-turut, seperti pada. `19..cdb_cev1`
## Konsol
**Cara membuat CEV**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon RDS di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Di panel navigasi, pilih **Versi mesin kustom**.
Halaman **Versi mesin kustom** menampilkan semua CEV yang saat ini ada. Jika Anda belum membuat CEV, halaman tersebut kosong.
1. Pilih **Buat versi mesin kustom**.
1. Di bagian **Jenis mesin**, lakukan hal berikut:
1. Untuk **Jenis mesin**, pilih **Oracle**.
1. Untuk **pengaturan Arsitektur**, opsional memilih arsitektur **Multitenant untuk membuat CEV** multitenant Oracle, yang menggunakan mesin DB atau. `custom-oracle-ee-cdb` `custom-oracle-se2-cdb` Anda dapat membuat CDB RDS Custom for Oracle hanya dengan CEV Multi-penghuni. Jika Anda tidak memilih opsi ini, CEV Anda adalah non-CDB, yang menggunakan mesin atau. `custom-oracle-ee` `custom-oracle-se2`
**catatan**
Arsitektur yang Anda pilih adalah karakteristik permanen CEV Anda. Anda tidak dapat memodifikasi CEV Anda untuk menggunakan arsitektur yang berbeda nanti.
1. Pilih salah satu opsi berikut:
+ **Buat CEV baru** – Buat CEV dari awal. Dalam hal ini, Anda harus menentukan manifes JSON yang menentukan biner basis data.
+ **Buat CEV dari sumber** – Dalam **Tentukan CEV yang ingin Anda salin**, pilih CEV yang ada untuk digunakan sebagai sumber CEV. Dalam hal ini, Anda dapat menentukan Amazon Machine Image (AMI) baru, tetapi tidak dapat menentukan biner basis data yang berbeda.
1. Untuk **Versi mesin**, pilih versi mesin utama.
1. Dalam **Detail versi**, lakukan hal berikut:
1. Masukkan nama yang valid dalam **Nama versi mesin kustom**. Misalnya, Anda dapat memasukkan nama **19.cdb\_cev1**.
1. (Opsional) Masukkan deskripsi untuk CEV Anda.
1. Di **Media instalasi**, lakukan hal berikut:
1. (Opsional) Untuk **ID AMI**, biarkan bidang kosong untuk menggunakan AMI terbaru yang disediakan layanan, atau masukkan AMI yang sebelumnya Anda gunakan untuk membuat CEV. Untuk mendapatkan ID AMI yang valid, gunakan salah satu teknik berikut:
+ Di konsol, pilih **Versi mesin kustom** di panel navigasi kiri, dan pilih nama CEV. ID AMI yang digunakan oleh CEV muncul di tab **Konfigurasi**.
+ Di AWS CLI, gunakan `describe-db-engine-versions` perintah. Cari output untuk `ImageID`.
1. Untuk **Lokasi file manifes S3**, masukkan lokasi bucket Amazon S3 yang Anda tentukan di [Langkah 3: Unggah file instalasi Anda ke Amazon S3](custom-cev.preparing.md#custom-cev.preparing.s3). Misalnya, masukkan **s3://my-custom-installation-files/123456789012/cev1/**.
**catatan**
Tempat Wilayah AWS Anda membuat CEV harus berada di Wilayah yang sama dengan bucket S3.
1. (Khusus buat CEV baru) Untuk **manifes CEV**, masukkan manifes JSON yang Anda buat di [Membuat manifes CEV](custom-cev.preparing.md#custom-cev.preparing.manifest.creating).
1. Di bagian **tombol KMS**, pilih **Masukkan kunci ARN untuk membuat** daftar kunci yang AWS KMS tersedia. Lalu pilih kunci KMS Anda dari daftar.
AWS KMS Kunci diperlukan untuk RDS Custom. Untuk informasi selengkapnya, lihat [Langkah 1: Buat atau gunakan kembali kunci enkripsi simetris AWS KMS](custom-setup-orcl.md#custom-setup-orcl.cmk).
1. (Opsional) Pilih **Tambahkan tag baru** guna membuat pasangan nilai kunci untuk CEV Anda.
1. Pilih **Buat versi mesin kustom**.
Jika format manifes JSON tidak valid, konsol akan menampilkan **Terjadi kesalahan saat memvalidasi manifes CEV**. Perbaiki masalah dan coba lagi.
Halaman **Versi mesin kustom** muncul. CEV Anda ditampilkan dengan status **Membuat**. Proses untuk membuat CEV membutuhkan waktu sekitar dua jam.
## AWS CLI
Untuk membuat CEV dengan menggunakan, jalankan perintah AWS CLI[create-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html).
Opsi berikut diperlukan:
+ `--engine`— Tentukan jenis mesin. Untuk CDB, tentukan salah satu `custom-oracle-ee-cdb` atau`custom-oracle-se2-cdb`. Untuk non-CDB, tentukan salah satu atau`custom-oracle-ee`. `custom-oracle-se2` Anda dapat membuat CDB hanya dari CEV yang dibuat dengan `custom-oracle-ee-cdb` atau. `custom-oracle-se2-cdb` Anda dapat membuat non-CDB hanya dari CEV yang dibuat dengan atau. `custom-oracle-ee` `custom-oracle-se2`
+ `--engine-version` – Tentukan versi mesin. Formatnya adalah{{major-engine-version}}. {{customized\_string}}. Nama CEV harus berisi 1-50 karakter alfanumerik, garis bawah, tanda hubung, atau titik. Nama CEV tidak dapat berisi periode berturut-turut, seperti pada. `19..cdb_cev1`
+ `--kms-key-id`— Tentukan sebuah AWS KMS key.
+ `--manifest` – Tentukan `{{manifest_json_string}}` atau `--manifest file:{{file_name}}`. Karakter baris baru tidak diizinkan di `{{manifest_json_string}}`. Pastikan tidak ada kutipan ganda (") dalam kode JSON dengan memberikan awalan garis miring terbalik (\\).
Contoh berikut menunjukkan `{{manifest_json_string}}` untuk 19c dari [Langkah 5: Siapkan manifes CEV](custom-cev.preparing.md#custom-cev.preparing.manifest). Contoh menetapkan nilai baru untuk basis Oracle, rumah Oracle, dan ID dan nama UNIX/Linux pengguna dan grup. Jika Anda menyalin string ini, hapus semua karakter baris baru sebelum Anda menempelkannya ke perintah Anda.
`"{\"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` – Tentukan nama bucket yang sama dengan yang Anda tentukan di [Langkah 3: Unggah file instalasi Anda ke Amazon S3](custom-cev.preparing.md#custom-cev.preparing.s3). Tempat Wilayah AWS Anda menjalankan `create-custom-db-engine-version` harus Wilayah yang sama dengan bucket Amazon S3 Anda.
Anda juga dapat menentukan parameter berikut:
+ `--description` – Tentukan deskripsi CEV Anda.
+ `--database-installation-files-s3-prefix` – Tentukan nama folder yang Anda tentukan di [Langkah 3: Unggah file instalasi Anda ke Amazon S3](custom-cev.preparing.md#custom-cev.preparing.s3).
+ `--image-id` – Tentukan ID AMI yang ingin digunakan kembali. Untuk menemukan ID yang valid, jalankan perintah `describe-db-engine-versions`, lalu cari output untuk `ImageID`. Secara default, RDS Custom for Oracle menggunakan AMI terbaru yang tersedia.
Contoh berikut membuat CEV multi-penghuni Oracle bernama `19.cdb_cev1`. Contoh menggunakan kembali AMI yang ada, bukan menggunakan AMI terbaru yang tersedia. Pastikan bahwa nama CEV Anda dimulai dengan nomor versi mesin utama.
**Example**
Untuk Linux, macOS, atau 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}}
```
Untuk 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**
Dapatkan detail tentang CEV Anda dengan menggunakan perintah `describe-db-engine-versions`.
```
1. aws rds describe-db-engine-versions \
2. --engine custom-oracle-se2-cdb \
3. --include-all
```
Output contoh parsial berikut menunjukkan mesin, grup parameter, manifes, dan informasi lainnya.
```
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. ...
```
## Kegagalan dalam membuat CEV
Jika proses untuk membuat CEV gagal, RDS Custom mengeluarkan `RDS-EVENT-0198` dengan pesan `Creation failed for custom engine version {{major-engine-version.cev_name}}` yang menyertakan detail tentang kegagalan. Misalnya, peristiwa mencetak file yang tidak ada.
Anda tidak dapat memodifikasi CEV yang gagal. Anda hanya dapat menghapusnya, lalu mencoba membuat CEV lagi setelah memperbaiki penyebab kegagalan. Untuk informasi tentang pemecahan masalah alasan kegagalan pembuatan CEV, lihat [Memecahkan masalah pembuatan versi mesin kustom untuk RDS Custom for Oracle](custom-troubleshooting.md#custom-troubleshooting.cev).