Membuat CEV - Layanan Basis Data Relasional Amazon
Kegagalan dalam membuat CEV

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Membuat CEV

Anda dapat membuat CEV menggunakan AWS Management Console atau. AWS CLI Tentukan arsitektur multi-penghuni atau nonmulti-penghuni. Untuk informasi selengkapnya, lihat Pertimbangan arsitektur multi-penghuni.

Biasanya, membuat CEV membutuhkan waktu sekitar dua jam. Setelah CEV dibuat, Anda dapat menggunakannya untuk membuat instans DB RDS Custom. Untuk informasi selengkapnya, lihat Membuat instans DB RDS Custom for Oracle.

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 formatmajor-engine-version.customized_string, seperti dalam19.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

Cara membuat CEV

  1. Masuk ke AWS Management Console dan buka konsol Amazon RDS di https://console.aws.amazon.com/rds/.

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

  3. Pilih Buat versi mesin kustom.

  4. Di bagian Jenis mesin, lakukan hal berikut:

    1. Untuk Jenis mesin, pilih Oracle.

    2. Untuk pengaturan Arsitektur, secara 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.

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

    4. Untuk Versi mesin, pilih versi mesin utama.

  5. Dalam Detail versi, lakukan hal berikut:

    1. Masukkan nama yang valid dalam Nama versi mesin kustom. Misalnya, Anda dapat memasukkan nama 19.cdb_cev1.

    2. (Opsional) Masukkan deskripsi untuk CEV Anda.

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

    2. Untuk Lokasi file manifes S3, masukkan lokasi bucket Amazon S3 yang Anda tentukan di Langkah 3: Unggah file instalasi Anda ke Amazon 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.

    3. (Khusus buat CEV baru) Untuk manifes CEV, masukkan manifes JSON yang Anda buat di Membuat manifes CEV.

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

  8. (Opsional) Pilih Tambahkan tag baru guna membuat pasangan nilai kunci untuk CEV Anda.

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

Untuk membuat CEV dengan menggunakan AWS CLI, jalankan perintah create-custom-db-engine-version.

Opsi berikut diperlukan:

  • --engine— Tentukan jenis mesin. Untuk CDB, tentukan salah satu custom-oracle-ee-cdb ataucustom-oracle-se2-cdb. Untuk non-CDB, tentukan salah satu ataucustom-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. Contoh tersebut menetapkan nilai baru untuk basis Oracle, beranda Oracle, serta ID dan nama pengguna dan grup UNIX/Linux. 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. 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.

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

Untuk Linux, macOS, atau 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

Untuk 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

Dapatkan detail tentang CEV Anda dengan menggunakan perintah describe-db-engine-versions.

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

Output contoh parsial berikut menunjukkan mesin, grup parameter, manifes, dan informasi lainnya.

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

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.