

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

# Membuat dan mengelola versi mesin BYOM untuk RDS untuk SQL Server
<a name="sqlserver-byom-creating-cev"></a>

Membuat versi mesin BYOM memerlukan pengaturan satu kali (verifikasi Mobilitas Lisensi, mendapatkan media RTM, dan mengunggahnya ke S3). Setelah penyiapan, Anda dapat membuat versi mesin menggunakan konsol Amazon RDS atau AWS CLI.

## Sebelum Anda mulai
<a name="sqlserver-byom-creating-cev.before-you-begin"></a>

### Langkah 1: Selesaikan verifikasi Mobilitas Lisensi Microsoft
<a name="sqlserver-byom-creating-cev.step1"></a>

Lisensi Mobilitas melalui Jaminan Perangkat Lunak diperlukan untuk BYOM. Anda harus memiliki cakupan Jaminan Perangkat Lunak aktif pada lisensi SQL Server Anda sebelum menerapkannya. AWS

Untuk menyelesaikan proses verifikasi:

1. **Tinjau kelayakan** Kunjungi [halaman Mobilitas AWS Lisensi](https://aws.amazon.com/windows/resources/licensemobility/) untuk meninjau persyaratan dan kriteria kelayakan.

1. **Kirim formulir verifikasi** Unduh dan lengkapi [formulir verifikasi Microsoft License Mobility](https://www.microsoft.com/en-us/licensing/licensing-programs/software-assurance-license-mobility.aspx). Kirimkan formulir ke Microsoft melalui mitra lisensi Anda atau secara langsung.

1. **Tunggu persetujuan** Microsoft mengirimi Anda email konfirmasi saat verifikasi Anda disetujui.

Anda harus mengirimkan formulir ke Microsoft secara langsung atau melalui pengecer Microsoft Anda dalam waktu 10 hari sejak produk dibawa AWS.

**penting**  
AWS tidak memvalidasi atau menegakkan kepatuhan lisensi Microsoft. Anda bertanggung jawab untuk menjaga kepatuhan terhadap perjanjian lisensi Microsoft Anda.

### Langkah 2: Dapatkan media instalasi SQL Server
<a name="sqlserver-byom-creating-cev.step2"></a>

Unduh file Release to Manufacturing (RTM) untuk versi utama SQL Server yang ingin Anda gunakan. File RTM adalah media instalasi dasar untuk versi dan edisi utama SQL Server (misalnya, SQL Server 2019 Enterprise Edition).

Anda dapat memperoleh file RTM dari salah satu sumber Microsoft berikut:
+ **Langganan Visual Studio** Jika Anda memiliki langganan Visual Studio aktif, unduh file RTM dari halaman [unduhan pelanggan](https://visualstudio.microsoft.com/subscriptions/).
+ **Pusat admin Microsoft 365** Jika Anda membeli produk melalui lisensi volume, unduh file RTM dari halaman [Unduhan pusat admin Microsoft 365](https://admin.microsoft.com).

**penting**  
Unduh hanya file Core-based ISO bahasa Inggris. Jangan gunakan file CAL-based Server\+ISO.

### Langkah 3: Unggah media instalasi ke Amazon S3
<a name="sqlserver-byom-creating-cev.step3"></a>

Unggah file SQL Server RTM ke bucket Amazon S3 di Wilayah dan akun yang AWS sama tempat Anda berencana membuat versi mesin BYOM. Untuk mengunggah file RTM menggunakan AWS CLI:

```
aws s3 cp SQLServer2022-x64-ENU-Enterprise.iso s3://my-sqlserver-media/ISOs/
```

**catatan**  
Jika Anda tidak menyediakan file Pembaruan Kumulatif (CU) selama pembuatan mesin BYOM, Amazon RDS secara otomatis mengunduh CU yang diperlukan dari Microsoft saat Anda membuat versi mesin.

## Membuat versi mesin BYOM
<a name="sqlserver-byom-creating-cev.creating"></a>

Gunakan `describe-db-engine-versions` untuk memverifikasi versi mesin mana yang memenuhi syarat untuk membuat versi mesin BYOM. Untuk versi yang didukung, tinjau[Bawa Media Anda Sendiri (BYOM) untuk RDS untuk SQL Server](sqlserver-byom.md).

### Konsol
<a name="sqlserver-byom-creating-cev.console"></a>

1. Masuk ke [Konsol AWS Manajemen dan buka konsol](https://console.aws.amazon.com/rds/) Amazon RDS.

1. Di panel navigasi, pilih **Versi mesin kustom**.

1. Dari dropdown, pilih **RDS untuk** SQL Server.

1. Pilih **Buat versi mesin kustom**.

1. Untuk **tipe Engine**, pilih **SQL Server**.

1. Untuk **Jenis manajemen basis data**, pilih **Amazon RDS.**

1. Untuk **Edisi**, pilih salah satu dari berikut ini: 
   + SQL Server Enterprise Edition
   + SQL Server Standard Edition

1. Untuk **versi Engine**, pilih versi SQL Server yang cocok dengan file instalasi Anda (misalnya, SQL Server 2022`16.00.4175.1.v1`).

1. Untuk **media Instalasi**, masukkan URI S3 yang berisi media SQL Server RTM Anda, atau pilih **Browse S3** untuk mencari dan memilih file.

1. Pilih **Buat versi mesin kustom**.

Konsol menampilkan versi mesin BYOM baru dengan status awal validasi **Tertunda**. Status berlangsung secara otomatis. Untuk informasi selengkapnya, lihat [Status siklus hidup versi mesin BYOM](#sqlserver-byom-creating-cev.lifecycle).

### CLI
<a name="sqlserver-byom-creating-cev.cli"></a>

Gunakan `create-custom-db-engine-version` perintah untuk membuat versi mesin BYOM dari media instalasi Anda. Amazon RDS secara otomatis mengunduh pembaruan kumulatif yang diperlukan dari Microsoft.

```
aws rds create-custom-db-engine-version \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1 \
    --database-installation-files-s3-bucket-name my-sqlserver-media \
    --database-installation-files-s3-prefix "ISOs/" \
    --database-installation-files "SQLServer2022-x64-ENU-Enterprise.iso"
```

**Respons**

```
{
    "Engine": "sqlserver-ee",
    "MajorEngineVersion": "16.00",
    "EngineVersion": "16.00.4175.1.v1",
    "DatabaseInstallationFiles": [
        "SQLServer2022-x64-ENU-Enterprise.iso"
    ],
    "DBEngineDescription": "Microsoft SQL Server Enterprise Edition",
    "DBEngineVersionArn": "arn:aws:rds:us-east-1:123456789012:cev:sqlserver-ee/16.00.4175.1.v1/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    ....
    "Status": "pending-validation",
    .....
}
```

**Parameter CLI**


| Parameter | Diperlukan | Deskripsi | 
| --- | --- | --- | 
| --engine | Ya | Jenis mesin database:sqlserver-ee,sqlserver-se. | 
| --engine-version | Ya | Versi mesin target (misalnya,16.00.4175.1.v1). | 
| --database-installation-files-s3-bucket-name | Ya | Nama bucket S3 yang berisi media instalasi Anda. Bucket harus berada di AWS Wilayah yang sama dengan versi mesin BYOM. | 
| --database-installation-files-s3-prefix | Tidak | S3 key prefix (folder path) tempat file media instalasi disimpan. | 
| --database-installation-files | Ya | Nama file dari media instalasi. | 

**catatan**  
Saat menggunakan AWS CLI, `--database-installation-files-s3-bucket-name``--database-installation-files-s3-prefix`, dan `--database-installation-files` parameter hanya diperlukan untuk versi mesin BYOM pertama yang Anda buat untuk versi dan edisi utama. Untuk versi minor berikutnya dalam versi utama yang sama, hanya `--engine` dan `--engine-version` diperlukan.

## Menjelaskan versi mesin BYOM
<a name="sqlserver-byom-creating-cev.describing"></a>

Setelah Anda membuat versi mesin BYOM, gunakan `describe-db-engine-versions` untuk memeriksa status dan detailnya. Output mengembalikan dua catatan untuk versi mesin yang sama: satu untuk Lisensi Termasuk (`DBEngineMediaType: None`) dan satu untuk BYOM (`DBEngineMediaType: Customer Provided`).

**Contoh:**

```
aws rds describe-db-engine-versions \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1 \
    --include-all \
    --output table \
    --query "DBEngineVersions[].{Engine: Engine, Version: EngineVersion, Status: Status, MediaType: DBEngineMediaType}"
```

**Tanggapan:**

```
-----------------------------------------------------------------------
|                      DescribeDBEngineVersions                       |
+--------------+---------------------+------------+-------------------+
|    Engine    |      MediaType      |  Status    |      Version      |
+--------------+---------------------+------------+-------------------+
|  sqlserver-ee|  None               |  available |  16.00.4175.1.v1  |
|  sqlserver-ee|  Customer Provided  |  available |  16.00.4175.1.v1  |
+--------------+---------------------+------------+-------------------+
```

## Status siklus hidup versi mesin BYOM
<a name="sqlserver-byom-creating-cev.lifecycle"></a>


| Status | Deskripsi | 
| --- | --- | 
| pending-validation | RDS menerima permintaan dan mengantri untuk diproses. | 
| validating | RDS memvalidasi file media RTM. | 
| creating | RDS menginstal SQL Server dari file media RTM. | 
| available | Versi mesin BYOM siap untuk pembuatan misalnya. | 
| incompatible\_installation\_media | File instalasi tidak valid atau rusak. Ini adalah status terakhir. Hapus versi mesin BYOM dan coba lagi dengan file yang benar. | 

## Memodifikasi versi mesin BYOM
<a name="sqlserver-byom-creating-cev.modifying"></a>

Anda dapat memodifikasi versi mesin BYOM menggunakan Konsol AWS Manajemen atau CLI AWS . Anda dapat memodifikasi deskripsi versi mesin BYOM atau status ketersediaannya. Versi mesin BYOM Anda memiliki salah satu nilai status berikut:
+ **tersedia** - Anda dapat menggunakan versi mesin BYOM ini untuk membuat instans DB baru atau meningkatkan instans DB. Ini adalah status default untuk versi mesin BYOM yang baru dibuat.
+ **tidak aktif** - Anda tidak dapat membuat atau memutakhirkan instans DB dengan versi mesin BYOM ini. Anda tidak dapat memulihkan snapshot DB untuk membuat instans DB baru dengan versi mesin BYOM ini.

Anda dapat mengubah status versi mesin BYOM dari `available` ke `inactive` atau dari `inactive` ke. `available` Anda dapat mengubah status `inactive` untuk mencegah penggunaan versi mesin BYOM yang tidak disengaja atau membuat versi mesin BYOM yang dihentikan memenuhi syarat untuk digunakan lagi.

```
aws rds modify-custom-db-engine-version \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1 \
    --status inactive
```

**Respons**

```
{
    "Engine": "sqlserver-ee",
    "MajorEngineVersion": "16.00",
    "EngineVersion": "16.00.4175.1.v1",
    ....
    "Status": "inactive",
    ....
}
```

**catatan**  
Instans yang ada yang berjalan pada versi mesin BYOM yang Anda atur ke tidak aktif terus beroperasi secara normal. Hanya operasi pembuatan dan pemulihan instance baru yang terpengaruh.

## Menghapus versi mesin BYOM
<a name="sqlserver-byom-creating-cev.deleting"></a>

Gunakan `delete-custom-db-engine-version` untuk menghapus versi mesin BYOM secara permanen. Setelah dihapus, versi mesin kembali ke satu LI-only entri.

**Prasyarat untuk penghapusan**

Sebelum Anda dapat menghapus versi mesin BYOM, pastikan yang berikut:
+ Tidak ada instans DB yang menggunakan versi BYOM.
+ Tidak ada snapshot DB yang mereferensikan versi BYOM.

Jika salah satu sumber daya RDS ada, API gagal permintaan penghapusan.

**Menghapus versi mesin BYOM (CLI)**

```
aws rds delete-custom-db-engine-version \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1
```

**Respons**

```
{
    "Engine": "sqlserver-ee",
    "MajorEngineVersion": "16.00",
    "EngineVersion": "16.00.4175.1.v1",
    .....
    "Status": "deleting",
    ....
}
```

## Pertimbangan-pertimbangan
<a name="sqlserver-byom-creating-cev.considerations"></a>
+ Anda menyediakan file ISO RTM sekali per versi dan edisi utama. Semua versi minor dalam versi dan edisi utama yang sama akan menggunakan kembali media instalasi yang sama.
+ Saat menyediakan SQL Server RTM Anda untuk Bring Your Own Media, Anda hanya harus menggunakan Core-based RTM ISO dan bukan file RTM ISO berbasis Server \+ CAL.

## Langkah selanjutnya
<a name="sqlserver-byom-creating-cev.next-steps"></a>

Setelah versi mesin BYOM Anda mencapai `available` status, Anda dapat meluncurkan instance RDS untuk SQL Server menggunakannya. Lihat [Membuat instance BYOM DB untuk RDS untuk SQL Server](sqlserver-byom-creating-instance.md).