

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

# Kelola paket komponen VSS untuk snapshot EBS berbasis Windows VSS
<a name="application-consistent-snapshots-getting-started"></a>

Sebelum Anda membuat snapshot EBS berbasis VSS, pastikan Anda memiliki versi terbaru dari paket komponen VSS yang diinstal pada instance Windows Anda. Ada beberapa cara Anda dapat menginstal `AwsVssComponents` paket ke instance yang ada, sebagai berikut:
+ (Direkomendasikan) [Jalankan dokumen VssInstallAndSnapshot perintah AWSEC2 - (disarankan)](create-vss-snapshots-ssm.md#create-with-AWSEC2-VssInstallAndSnapshot). Operasi ini secara otomatis menginstal atau memperbarui jika diperlukan setiap kali dijalankan.
+ [Instal komponen VSS secara manual pada instance EC2 Windows](#install-vss-comps).
+ [Perbarui paket komponen VSS pada instans Windows EC2 Anda](#update-vss-comps).

Anda juga dapat membuat AMI dengan EC2 Image Builder yang menggunakan komponen terkelola `aws-vss-components-windows` guna menginstal paket `AwsVssComponents` untuk gambar. Komponen yang dikelola menggunakan AWS Systems Manager Distributor untuk menginstal paket. Setelah Image Builder membuat gambar, setiap instans yang Anda luncurkan dari AMI terkait akan menginstal paket VSS di dalamnya. Untuk informasi selengkapnya tentang cara membuat AMI dengan paket VSS yang diinstal, lihat [Komponen terkelola paket distributor untuk Windows](https://docs.aws.amazon.com/imagebuilder/latest/userguide/mgdcomponent-distributor-win.html) di *Panduan Pengguna EC2 Image Builder*.

**Topics**
+ [Instalasi manual](#install-vss-comps)
+ [Perbarui komponen](#update-vss-comps)

## Instal komponen VSS secara manual pada instance EC2 Windows
<a name="install-vss-comps"></a>

Instans EC2 Windows Anda harus memiliki komponen VSS yang diinstal sebelum Anda dapat membuat snapshot yang bersifat konsisten aplikasi dengan Systems Manager. Jika Anda tidak menjalankan dokumen perintah `AWSEC2-VssInstallAndSnapshot` untuk menginstal atau memperbarui paket secara otomatis setiap kali Anda membuat snapshot yang bersifat konsisten aplikasi, Anda harus menginstal paket secara manual.

Anda juga harus menginstal secara manual jika Anda berencana untuk menggunakan salah satu metode berikut guna membuat snapshot yang bersifat konsisten aplikasi dari instans EC2.
+ Buat snapshot VSS menggunakan AWS Backup
+ Membuat snapshot VSS menggunakan Amazon Data Lifecycle Manager

Jika Anda perlu melakukan instalasi manual, kami sarankan Anda menggunakan paket komponen AWS VSS terbaru untuk meningkatkan keandalan dan kinerja snapshot yang konsisten aplikasi pada instans Windows EC2 Anda.

**catatan**  
Untuk menginstal atau memperbarui paket `AwsVssComponents` secara otomatis setiap kali Anda membuat snapshot yang konsisten dengan aplikasi, sebaiknya gunakan Systems Manager untuk menjalankan dokumen `AWSEC2-VssInstallAndSnapshot`. Untuk informasi selengkapnya, lihat [Jalankan dokumen VssInstallAndSnapshot perintah AWSEC2 - (disarankan)](create-vss-snapshots-ssm.md#create-with-AWSEC2-VssInstallAndSnapshot).

Untuk menginstal komponen VSS pada instans Windows Amazon EC2, ikuti langkah-langkah untuk lingkungan pilihan Anda.

------
#### [ Console ]

**Untuk memasang komponen VSS menggunakan Distributor SSM**

1. Buka AWS Systems Manager konsol di [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Di panel navigasi, pilih **Jalankan Perintah**.

1. Pilih **Jalankan perintah**.

1. Untuk **dokumen Command**, pilih tombol di sebelah **AWS-configure AWSPackage**.

1. Untuk **Parameter perintah**, lakukan hal berikut:

   1. Verifikasi bahwa **Tindakan** diatur menjadi **Pasang**.

   1. Untuk **Nama**, masukkan `AwsVssComponents`.

   1. Untuk **Versi**, masukkan versi atau kosongkan kolom sehingga System Manager menginstal versi terbaru.

1. Untuk **Target**, identifikasi instans di mana Anda ingin menjalankan operasi ini dengan menentukan tanda atau memilih instans secara manual.
**catatan**  
Jika Anda memilih instans secara manual, dan instans yang ingin Anda lihat tidak disertakan dalam daftar, lihat [Di Mana Instans Saya?](https://docs.aws.amazon.com/systems-manager/latest/userguide/troubleshooting-remote-commands.html#where-are-instances) dalam *Panduan Pengguna AWS Systems Manager * untuk kiat pemecahan masalah.

1. Untuk **Parameter lainnya**:
   + (Opsional) Untuk **Komentar**, ketik informasi tentang perintah ini.
   + Untuk **Waktu habis (detik)**, tentukan jumlah detik untuk menunggu sistem sebelum gagal menjalankan perintah keseluruhan. 

1. (Opsional) Untuk **Kontrol laju**:
   + Untuk **Konkurensi**, tentukan jumlah atau persentase instans untuk menjalankan perintah pada saat yang sama.
**catatan**  
Jika Anda memilih target dengan memilih tanda Amazon EC2 dan Anda tidak yakin berapa banyak instans menggunakan tanda yang dipilih, batasi jumlah instans yang dapat menjalankan dokumen pada waktu yang sama dengan menentukan persentase.
   + Untuk **Ambang kesalahan**, tetapkan kapan harus berhenti menjalankan perintah pada instans lain setelah gagal pada jumlah atau persentase instans. Misalnya, jika Anda menentukan tiga kesalahan, Systems Manager berhenti mengirim perintah ketika kesalahan keempat diterima. Instans yang masih memproses perintah juga dapat mengirim kesalahan.

1. (Opsional) Untuk bagian **Opsi output**, jika Anda ingin menyimpan output perintah ke file, pilih kotak di samping **Aktifkan penulisan ke bucket S3**. Tentukan nama bucket dan nama prefiks (folder) (opsional).
**catatan**  
Izin S3 yang memberikan kemampuan untuk menulis data ke bucket S3 berasal dari profil instans yang ditetapkan ke instans, bukan data pengguna yang melaksanakan tugas ini. Untuk informasi selengkapnya, lihat [Mengonfigurasi izin instans EC2](https://docs.aws.amazon.com/systems-manager/latest/userguide/setup-instance-permissions.html#instance-profile-add-permissions) di *AWS Systems Manager Panduan Pengguna*. 

1. (Opsional) Tentukan opsi untuk **Notifikasi SNS**.

   Untuk informasi tentang konfigurasi notifikasi Amazon SNS untuk Run Command, lihat [Mengonfigurasi Notifikasi Amazon SNS untuk AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/monitoring-sns-notifications.html).

1. Pilih **Jalankan**.

------
#### [ AWS CLI ]

Gunakan prosedur berikut untuk mengunduh dan menginstal paket `AwsVssComponents` pada instans Anda dengan menggunakan Run Command dari AWS CLI. Paket menginstal dua komponen: pemohon VSS dan penyedia VSS. Sistem menyalin komponen ini ke direktori pada instans, lalu mendaftarkan penyedia DLL sebagai penyedia VSS.

**Untuk menginstal paket VSS**  
Jalankan perintah berikut untuk mengunduh dan menginstal komponen VSS yang diperlukan untuk System Manager.

```
aws ssm send-command \
    --document-name "AWS-ConfigureAWSPackage" \
    --instance-ids "i-1234567890abcdef0" \
    --parameters '{"action":["Install"],"name":["AwsVssComponents"]}'
```

------
#### [ PowerShell ]

Gunakan prosedur berikut untuk mengunduh dan menginstal `AwsVssComponents` paket pada instance Anda dengan menggunakan Run Command dari Tools for Windows PowerShell. Paket menginstal dua komponen: pemohon VSS dan penyedia VSS. Sistem menyalin komponen ini ke direktori pada instans, lalu mendaftarkan penyedia DLL sebagai penyedia VSS.

**Untuk menginstal paket VSS**  
Jalankan perintah berikut untuk mengunduh dan menginstal komponen VSS yang diperlukan untuk System Manager.

```
Send-SSMCommand `
    -DocumentName "AWS-ConfigureAWSPackage" `
    -InstanceId "i-1234567890abcdef0" `
    -Parameter @{'action'='Install';'name'='AwsVssComponents'}
```

------

### Verifikasi tanda tangan pada AWS komponen VSS
<a name="verify-ssm-comps"></a>

Gunakan prosedur berikut untuk memverifikasi tanda tangan pada paket `AwsVssComponents`.

1. Hubungkan ke instans Windows Anda. Untuk informasi selengkapnya, lihat [Hubungkan ke instans Windows Anda menggunakan RDP](connecting_to_windows_instance.md).

1. Arahkan ke C:\$1Program Files\$1 Amazon\$1AwsVssComponents.

1. Buka menu konteks (klik kanan) untuk `ec2-vss-agent.exe`, lalu pilih **Properti**.

1. Arahkan ke tab **Tanda Tangan Digital** dan verifikasi bahwa nama penandatangan adalah Amazon Web Services Inc.

1. Gunakan langkah-langkah sebelumnya untuk memverifikasi tanda tangan pada `Ec2VssInstaller` dan `Ec2VssProvider.dll`.

## Perbarui paket komponen VSS pada instans Windows EC2 Anda
<a name="update-vss-comps"></a>

Kami merekomendasikan Anda untuk terus meningkatkan komponen VSS dengan versi terbaru yang direkomendasikan. Ada beberapa cara berbeda untuk memperbarui komponen saat versi baru paket `AwsVssComponents` dirilis.

**Metode pembaruan**
+ Anda dapat mengulangi langkah-langkah yang dijelaskan [Instal komponen VSS secara manual pada instance EC2 Windows](#install-vss-comps) saat versi baru komponen AWS VSS dirilis.
+ Anda dapat mengonfigurasi kaitan Systems Manager State Manager untuk secara otomatis mengunduh dan menginstal komponen VSS baru atau yang diperbarui saat paket `AwsVssComponents` tersedia.
+ Anda dapat menginstal atau memperbarui paket `AwsVssComponents` secara otomatis setiap kali Anda membuat snapshot yang konsisten dengan aplikasi, sebaiknya gunakan Systems Manager untuk menjalankan dokumen `AWSEC2-VssInstallAndSnapshot`.

**catatan**  
Kami sarankan Anda menggunakan Systems Manager untuk menjalankan dokumen perintah `AWSEC2-VssInstallAndSnapshot`, yang secara otomatis menginstal atau memperbarui paket `AwsVssComponents` sebelum membuat snapshot yang konsisten dengan aplikasi. Untuk informasi selengkapnya, lihat [Jalankan dokumen VssInstallAndSnapshot perintah AWSEC2 - (disarankan)](create-vss-snapshots-ssm.md#create-with-AWSEC2-VssInstallAndSnapshot).

Untuk membuat kaitan Systems Manager State Manager, ikuti langkah-langkah untuk lingkungan pilihan Anda.

------
#### [ Console ]

Saat Anda membuat asosiasi Manajer Negara Systems Manager, ada dua opsi untuk memperbarui `AwsVssComponents` paket, sebagai berikut:

**Copot pemasangan dan instal ulang**  
Metode ini mengunduh dan menginstal paket tanpa prasyarat tambahan.

**Pembaruan di tempat**  
Ini melakukan pembaruan di tempat untuk paket, dan memiliki prasyarat berikut:  
+ Versi Agen SSM yang diinstal pada instance harus versi `3.3.808.0` atau yang lebih baru. Untuk informasi selengkapnya, lihat [Bekerja dengan SSM Agent di instans EC2 untuk Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-agent-windows.html) di *Panduan Pengguna AWS Systems Manager *.
+ Jika ditentukan, versi `AwsVssComponents` paket harus versi `2.5.0` atau yang lebih baru. Versi sebelumnya tidak mendukung pembaruan di tempat.
jika instans Anda tidak memenuhi prasyarat ini, pembaruan di tempat akan gagal. Gunakan opsi **Uninstall dan instal ulang** sebagai gantinya.

**Untuk membuat asosiasi State Manager**

1. Buka AWS Systems Manager konsol di [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Di panel navigasi, pilih **State Manager**.

   Atau, jika beranda Systems Manager terbuka terlebih dahulu, buka panel navigasi lalu pilih **State Manager**.

1. Pilih **Buat asosiasi**.

1. Di bidang **Nama**, masukkan nama deskriptif.

1. Dalam daftar **Dokumen**, pilih **AWS-configure AWSPackage**.

1. Di bagian **Parameter**, pilih **Instal** dari daftar **Tindakan**.

1. Untuk **jenis Instalasi**, pilih **Uninstall dan instal ulang** atau **In-place** update.

1. Di bidang **Nama**, masukkan `AwsVssComponents`. Anda dapat membuat bidang **Versi** dan **Argumen Tambahan** tetap kosong.

1. Di bagian **Target**, pilih opsi.
**catatan**  
Jika Anda memilih untuk menargetkan instans dengan menggunakan tanda, dan Anda menentukan tanda yang memetakan ke instans Linux, kaitan berhasil pada instans Windows tetapi gagal pada instans Linux. Status keseluruhan asosiasi menunjukkan **Gagal**.

1. Di bagian **Tentukan jadwal**, pilih opsi. 

1. Di bagian **Opsi lanjutan**, untuk **Keparahan kepatuhan**, pilih tingkat keparahan untuk kaitan. Untuk informasi selengkapnya, lihat [Pelajari tentang kepatuhan asosiasi](https://docs.aws.amazon.com/systems-manager/latest/userguide/compliance-about.html). Untuk **Ubah Kalender**, pilih kalender dengan perubahan yang telah dikonfigurasi sebelumnya. Untuk informasi selengkapnya, lihat tentang [Kalender Perubahan AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar.html).

1. Untuk **kontrol Tarif**, lakukan hal berikut:
   + Untuk **Konkurensi**, tentukan jumlah atau persentase dari simpul terkelola untuk menjalankan perintah pada saat yang sama.
   + Untuk **Ambang kesalahan**, tentukan kapan harus berhenti menjalankan perintah pada simpul terkelola lain setelah gagal pada jumlah atau persentase simpul.

1. (Opsional) Untuk **Opsi output**, untuk menyimpan output perintah ke file, pilih **Aktifkan output penulisan ke S3**. Masukkan nama bucket dan prefiks (folder) di dalam kotak.

1. Pilih **Buat asosiasi**, lalu pilih **Tutup**. Sistem ini mencoba untuk membuat asosiasi pada instans dan segera menerapkan status.
**catatan**  
Jika instans EC2 untuk Windows Server menunjukkan status **Gagal**, verifikasi bahwa Agen SSM berjalan pada instance, dan verifikasi bahwa instance dikonfigurasi dengan peran AWS Identity and Access Management (IAM) untuk Systems Manager. Untuk informasi selengkapnya, lihat [Menyiapkan AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-ec2.html).

------
#### [ AWS CLI ]

Gunakan perintah [create-association](https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html) untuk memperbarui paket Distributor sesuai jadwal tanpa membuat aplikasi terkait offline. Hanya file baru atau yang diperbarui dalam paket yang diganti.

**Untuk membuat asosiasi State Manager**  
Jalankan perintah berikut untuk membuat asosiasi. Nilai `--name`, nama dokumen, selalu `AWS-ConfigureAWSPackage`. Perintah berikut menggunakan kunci `InstanceIds` untuk menentukan instans target.

```
aws ssm create-association \
    --name "AWS-ConfigureAWSPackage" \
    --parameters action=Install,installationType="Uninstall and reinstall",name=AwsVssComponents \
    --targets Key=InstanceIds,Values=i-1234567890abcdef0,i-000011112222abcde
```

------
#### [ PowerShell ]

**Untuk membuat asosiasi State Manager**  
Gunakan [New- SSMAssociation](https://docs.aws.amazon.com/powershell/latest/reference/items/New-SSMAssociation.html) cmdlet.

```
New-SSMAssociation `
    -Name "AWS-ConfigureAWSPackage" `
    -Parameter  @{
        "action" = "Install"
        "installationType" = "Uninstall and reinstall"
        "name" = "AwsVssComponents"
    } `
    -Target @{
        "Key" = "InstanceIds" 
        "Values" = @("i-1234567890abcdef0", "i-000011112222abcde")
    }
```

------