

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

# Langkah 3: Siapkan agen Manajer Sesi Amazon DCV
<a name="agent"></a>

Agen harus diinstal pada semua host server Amazon DCV di armada. Agen dapat diinstal pada host Windows, Linux dan macOS. Untuk informasi selengkapnya tentang sistem operasi yang didukung, lihat[Persyaratan Manajer Sesi Amazon DCV](requirements.md).

**Prasyarat**  
Server Amazon DCV harus diinstal pada host sebelum menginstal agen.

------
#### [ Linux host ]

**catatan**  
[Agen Session Manager tersedia untuk distribusi dan arsitektur Linux yang tercantum dalam Persyaratan:](requirements.md)  
Instruksi berikut adalah untuk menginstal agen pada host 64-bit x86. Untuk menginstal agen pada host ARM 64-bit ganti {{x86\_64}} dengan`aarch64`. Untuk Ubuntu, ganti {{amd64}} dengan`arm64`.

**Untuk menginstal agen pada host Linux**

1. Paket-paket tersebut ditandatangani secara digital dengan tanda tangan GPG yang aman. Untuk mengizinkan pengelola paket memverifikasi tanda tangan paket, Anda harus mengimpor kunci Amazon DCV GPG. Jalankan perintah berikut untuk mengimpor kunci Amazon DCV GPG. 
   + Amazon Linux 2, RHEL, CentOS, dan SUSE Linux Enterprise

     ```
     $ sudo rpm --import https://d1uj6qtbmh3dt5.cloudfront.net/NICE-GPG-KEY
     ```
   + Ubuntu

     ```
     $ wget https://d1uj6qtbmh3dt5.cloudfront.net/NICE-GPG-KEY
     ```

     ```
     $ gpg --import NICE-GPG-KEY
     ```

1. Unduh paket instalasi.
   + Amazon Linux 2

     ```
     $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.801-1.el7.{{x86_64}}.rpm
     ```
   + Amazon Linux 2023

     ```
     $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.888-1.amzn2023.{{x86_64}}.rpm
     ```
   + RHEL 8.x dan Rocky Linux 8.x

     ```
     $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.888-1.el8.{{x86_64}}.rpm
     ```
   + CentOS 9.x, RHEL 9.x, dan Rocky Linux 9.x

     ```
     $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.888-1.el9.{{x86_64}}.rpm
     ```
   + Ubuntu 20.04

     ```
     $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent_2025.0.888-1_{{amd64}}.ubuntu2004.deb
     ```
   + Ubuntu 22.04

     ```
     $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent_2025.0.888-1_{{amd64}}.ubuntu2204.deb
     ```
   + Ubuntu 24.04

     ```
     $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent_2025.0.888-1_{{amd64}}.ubuntu2404.deb
     ```
   + SUSE Linux Perusahaan 12

     ```
     $ curl -O https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.888-1.sles12.x86_64.rpm
     ```
   + SUSE Linux Perusahaan 15

     ```
     $ curl -O https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.888-1.sles15.x86_64.rpm
     ```

1. Instal paket .
   + Amazon Linux 2

     ```
     $  sudo yum install -y ./nice-dcv-session-manager-agent-2025.0.888-1.el7.{{x86_64}}.rpm
     ```
   + Amazon Linux 2023

     ```
     $  sudo yum install -y ./nice-dcv-session-manager-agent-2025.0.888-1.amzn2023.{{x86_64}}.rpm
     ```
   + RHEL 8.x dan Rocky Linux 8.x

     ```
     $  sudo yum install -y ./nice-dcv-session-manager-agent-2025.0.888-1.el8.{{x86_64}}.rpm
     ```
   + CentOS 9.x, RHEL 9.x, dan Rocky Linux 9.x

     ```
     $  sudo yum install -y ./nice-dcv-session-manager-agent-2025.0.888-1.el9.{{x86_64}}.rpm
     ```
   + Ubuntu 20.04

     ```
     $  sudo apt install ./nice-dcv-session-manager-agent_2025.0.888-1_{{amd64}}.ubuntu2004.deb
     ```
   + Ubuntu 22.04

     ```
     $  sudo apt install ./nice-dcv-session-manager-agent_2025.0.888-1_{{amd64}}.ubuntu2204.deb
     ```
   + Ubuntu 24.04

     ```
     $  sudo apt install ./nice-dcv-session-manager-agent_2025.0.888-1_{{amd64}}.ubuntu2404.deb
     ```
   + SUSE Linux Perusahaan 12

     ```
     $ sudo zypper install ./nice-dcv-session-manager-agent-2025.0.888-1.sles12.x86_64.rpm
     ```
   + SUSE Linux Perusahaan 15

     ```
     $ sudo zypper install ./nice-dcv-session-manager-agent-2025.0.888-1.sles15.x86_64.rpm
     ```

1. Tempatkan salinan sertifikat yang ditandatangani sendiri broker (yang Anda salin pada langkah sebelumnya) di ` /etc/dcv-session-manager-agent/` direktori pada agen.

1. Buka `/etc/dcv-session-manager-agent/agent.conf` menggunakan editor teks pilihan Anda dan lakukan hal berikut.
   + Untuk`broker_host`, tentukan nama DNS host tempat broker diinstal.
**penting**  
Jika broker berjalan pada EC2 instans Amazon, untuk `broker_host` Anda harus menentukan alamat Ipv4 pribadi instans.
   + (Opsional) Untuk`broker_port`, tentukan port untuk berkomunikasi dengan broker. Secara default agen dan broker berkomunikasi melalui port`8445`. Hanya ubah ini jika Anda perlu menggunakan port yang berbeda. Jika Anda mengubahnya, pastikan broker dikonfigurasi untuk menggunakan port yang sama.
   + Untuk`ca_file`, tentukan jalur lengkap file sertifikat yang Anda salin di langkah sebelumnya. Contoh: 

     ```
     ca_file = '/etc/dcv-session-manager-agent/{{broker_cert}}.pem'
     ```

     Atau, jika Anda ingin menonaktifkan verifikasi TLS, atur `tls_strict` ke`false`.

1. Simpan dan tutup file .

1. Jalankan perintah berikut untuk memulai agen.

   ```
   $ sudo systemctl start dcv-session-manager-agent
   ```

------
#### [ Windows host ]

**Untuk menginstal agen pada host Windows**

1. Unduh [penginstal agen](https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-x64-Release-2025.0-888.msi).

1. Jalankan pemasang. Pada layar Selamat Datang, pilih **Berikutnya**.

1. Pada layar EULA, baca perjanjian lisensi dengan cermat, dan jika Anda setuju, pilih **Saya menerima persyaratan** dan pilih **Berikutnya**.

1. Untuk memulai instalasi, pilih **Instal**.

1. Tempatkan salinan sertifikat yang ditandatangani sendiri broker (yang Anda salin pada langkah sebelumnya) di `C:\Program Files\NICE\DCVSessionManagerAgent\conf\` folder pada agen.

1. Buka `C:\Program Files\NICE\DCVSessionManagerAgent\conf\agent.conf` menggunakan editor teks pilihan Anda, lalu lakukan hal berikut:
   + Untuk`broker_host`, tentukan nama DNS host tempat broker diinstal.
**penting**  
Jika broker berjalan pada EC2 instans Amazon, untuk `broker_host` Anda harus menentukan IPv4 alamat pribadi instans.
   + (Opsional) Untuk`broker_port`, tentukan port untuk berkomunikasi dengan broker. Secara default agen dan broker berkomunikasi melalui port`8445`. Hanya ubah ini jika Anda perlu menggunakan port yang berbeda. Jika Anda mengubahnya, pastikan broker dikonfigurasi untuk menggunakan port yang sama.
   + Untuk`ca_file`, tentukan jalur lengkap file sertifikat yang Anda salin di langkah sebelumnya. Contoh: 

     ```
     ca_file = 'C:\Program Files\NICE\DCVSessionManagerAgent\conf\{{broker_cert}}.pem'
     ```

     Atau, jika Anda ingin menonaktifkan verifikasi TLS, atur `tls_strict` ke`false`.

1. Simpan dan tutup file .

1. Hentikan dan mulai ulang layanan agen agar perubahan diterapkan. Jalankan perintah berikut di command prompt.

   ```
   C:\> sc stop DcvSessionManagerAgentService
   ```

   ```
   C:\> sc start DcvSessionManagerAgentService
   ```

------
#### [ macOS host ]

**Untuk menginstal agen pada host macOS**

1. Unduh [penginstal agen](https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.888-macos-arm64.pkg) atau gunakan baris perintah:

   ```
   $ curl -O https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.888-macos-arm64.pkg
   ```

1. Instal paket . Anda dapat menggunakan baris perintah atau melalui penginstal agen:
   + Baris perintah:

     ```
     $ sudo installer -pkg ./nice-dcv-session-manager-agent-2025.0.888-macos-arm64.pkg -target /
     ```
   + Installer agen: Klik dua kali `.pkg` file dan ikuti panduan instalasi.

1. Tempatkan salinan sertifikat yang ditandatangani sendiri broker (yang Anda salin pada langkah sebelumnya) di `/etc/dcv-session-manager-agent/` direktori pada agen.

1. Buka `/etc/dcv-session-manager-agent/agent.conf` menggunakan editor teks pilihan Anda dan lakukan hal berikut.
   + Untuk`broker_host`, tentukan nama DNS host tempat broker diinstal.
**penting**  
Jika broker berjalan pada EC2 instans Amazon, untuk `broker_host` Anda harus menentukan IPv4 alamat pribadi instans.
   + (Opsional) Untuk`broker_port`, tentukan port untuk berkomunikasi dengan broker. Secara default agen dan broker berkomunikasi melalui port`8445`. Hanya ubah ini jika Anda perlu menggunakan port yang berbeda. Jika Anda mengubahnya, pastikan broker dikonfigurasi untuk menggunakan port yang sama.
   + Untuk`ca_file`, tentukan jalur lengkap file sertifikat yang Anda salin di langkah sebelumnya. Contoh: 

     ```
     ca_file = '/usr/local/etc/dcv-session-manager-agent/{{broker_cert}}.pem'
     ```

     Atau, jika Anda ingin menonaktifkan verifikasi TLS, atur `tls_strict` ke`false`.

1. Simpan dan tutup file .

1. Mulai layanan agen.

   ```
   $ sudo launchctl load /Library/LaunchDaemons/com.amazon.dcv.session-manager.agent.plist
   ```

------