Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengelola sesi Amazon DCV
Setelah server Amazon DCV disiapkan dan semua aplikasi Anda diinstal, klien Anda mengaksesnya melalui sesi aman. Mengelola sesi ini untuk klien Anda memberi mereka akses dan menetapkan parameter untuk setiap sesi.
Sebelum klien Anda dapat terhubung ke satu, Anda harus membuat sesi Amazon DCV di server Amazon DCV Anda. Klien hanya dapat terhubung ke server Amazon DCV jika ada sesi aktif.
Setiap sesi Amazon DCV memiliki atribut berikut:
+ **ID sesi** - Digunakan untuk mengidentifikasi sesi tertentu di server Amazon DCV.
+ **Pemilik** — Pengguna Amazon DCV yang membuat sesi. Secara default, hanya pemilik yang dapat terhubung ke sesi.
Klien Amazon DCV memerlukan informasi ini untuk terhubung ke sesi.
**Topics**
+ [Memahami sesi Amazon DCV](managing-sessions-intro.md)
+ [Menggunakan Alat Baris Perintah untuk Mengelola Sesi](managing-sessions-cli.md)
+ [Memulai sesi Amazon DCV](managing-sessions-start.md)
+ [Menghentikan sesi Amazon DCV](managing-sessions-lifecycle-stop.md)
+ [Melihat sesi Amazon DCV](managing-sessions-lifecycle-view.md)
+ [Mengelola sesi Amazon DCV aktif](managing-running-session.md)
+ [Mengatur zona waktu sesi](managing-session-time-zone.md)
+ [Mengelola pengosongan layar di Linux](managing-screen-blanking.md)
+ [Mengambil tangkapan layar di Sesi DCV Amazon](managing-sessions-lifecycle-screenshot.md)
# Memahami sesi Amazon DCV
Amazon DCV menawarkan dua jenis sesi — sesi konsol dan sesi virtual. Tabel berikut merangkum perbedaan antara dua jenis sesi.
| Jenis sesi | Support | Beberapa sesi | Izin yang diperlukan | Tangkapan layar langsung | Dukungan OpenGL yang dipercepat GPU |
| --- | --- | --- | --- | --- | --- |
| Konsol | Server Linux, macOS, dan Windows Amazon DCV | Tidak, hanya satu sesi konsol yang diizinkan di setiap server | Hanya pengguna admin yang dapat memulai dan menutup sesi | Ya | Ya, tanpa perangkat lunak tambahan |
| Virtual | Hanya server DCV Amazon Linux | Ya, beberapa sesi virtual diperbolehkan di satu server | Setiap pengguna dapat memulai dan menutup sesi | Tidak, server X khusus (Xdcv), berjalan untuk setiap sesi virtual. Layar diambil dari server X. | Ya, tetapi membutuhkan paket DCV-GL |
**catatan**
Anda tidak dapat menjalankan konsol dan sesi virtual di server Amazon DCV yang sama secara bersamaan.
## Sesi konsol
Sesi konsol didukung di server Windows, Linux, dan macOS Amazon DCV. Jika Anda menggunakan server Windows atau macOS Amazon DCV, Anda hanya dapat menggunakan sesi konsol.
Hanya satu sesi konsol yang dapat di-host di server Amazon DCV sekaligus. Sesi konsol dibuat dan dikelola oleh Administrator di server Windows Amazon DCV dan pengguna root di server Linux dan macOS Amazon DCV.
Dengan sesi konsol, Amazon DCV langsung menangkap konten layar desktop. Jika server dikonfigurasi dengan GPU, sesi konsol Amazon DCV memiliki akses langsung ke GPU.
## Sesi Virtual
Sesi virtual hanya didukung di server Linux Amazon DCV.
Anda dapat meng-host beberapa sesi virtual di server Amazon DCV yang sama secara bersamaan. Sesi virtual dibuat dan dikelola oleh pengguna Amazon DCV. Pengguna Amazon DCV hanya dapat mengelola sesi yang telah mereka buat. Pengguna root dapat mengelola semua sesi virtual yang saat ini berjalan di server Amazon DCV.
Dengan sesi virtual, Amazon DCV memulai instance server X`Xdcv`, dan menjalankan lingkungan desktop di dalam server X. Amazon DCV memulai instance server X khusus baru untuk setiap sesi virtual. Setiap sesi virtual menggunakan tampilan yang disediakan oleh instance server X-nya.
**catatan**
Sementara Amazon DCV memastikan bahwa setiap sesi virtual memiliki `Xdcv` tampilan independen, banyak sumber daya sistem lainnya, termasuk file di folder rumah pengguna, layanan D-Bus, dan perangkat, adalah per pengguna dan dengan demikian akan dibagikan dan diakses di beberapa sesi virtual untuk pengguna yang sama.
Anda tidak boleh menjalankan beberapa sesi virtual di server Amazon DCV yang sama untuk pengguna yang sama pada saat yang sama, kecuali jika Anda telah menyiapkan Sistem Operasi untuk mengurangi kemungkinan kekhawatiran tentang sumber daya bersama.
Jika `dcv-gl` paket diinstal dan dilisensikan, sesi virtual Amazon DCV berbagi akses ke server. GPUs Untuk berbagi OpenGL berbasis perangkat keras di beberapa sesi virtual, Anda harus menghubungkan instance server X virtual ke GPU dengan mengonfigurasi file. `dcv-gl.conf`
# Menggunakan Alat Baris Perintah untuk Mengelola Sesi
Server Amazon DCV menyertakan alat baris perintah yang dapat digunakan untuk memulai, menghentikan, dan melihat sesi Amazon DCV.
## Menggunakan alat baris perintah pada Windows Amazon DCV Server
Untuk menggunakan alat baris perintah pada server Windows Amazon DCV, jalankan perintah dari direktori instalasi Amazon DCV atau tambahkan direktori Amazon DCV ke variabel lingkungan PATH. Jika Anda menambahkan direktori Amazon DCV ke variabel lingkungan PATH, Anda dapat menggunakan perintah dari direktori apa pun.
**Untuk menggunakan alat baris perintah dari direktori instalasi Amazon DCV**
Arahkan ke folder tempat `dcv.exe` file berada, secara `C:\Program Files\NICE\DCV\Server\bin\` default, dan buka jendela prompt perintah.
Atau Anda dapat menentukan jalur lengkap saat menjalankan perintah dari direktori yang berbeda.
```
"C:\> Program Files\NICE\DCV\Server\bin\dcv.exe" list-sessions
```
**Untuk menambahkan direktori Amazon DCV ke variabel lingkungan PATH**
1. Di File Explorer, klik kanan **PC ini** dan pilih **Properties**.
1. Pilih **Pengaturan sistem lanjutan**.
1. Pada tab **Advanced**, pilih **Variabel Lingkungan**.
1. Di bagian **Variabel sistem**, pilih variabel **Path** dan pilih **Edit**.
1. Pilih **Baru** dan tentukan jalur lengkap ke `bin` folder di direktori instalasi Amazon DCV (misalnya,`C:\Program Files\NICE\DCV\Server\bin\`).
1. Pilih **OK** dan tutup jendela Variabel Lingkungan.
## Menggunakan baris perintah pada Linux Amazon DCV Server
Di server Linux Amazon DCV, alat baris perintah secara otomatis dikonfigurasi dalam variabel `$PATH` lingkungan. Anda dapat menggunakan alat ini dari folder mana pun. Buka jendela terminal dan masukkan perintah untuk menjalankan.
## Menggunakan baris perintah pada macOS Amazon DCV Server
Pada server macOS Amazon DCV, alat baris perintah secara otomatis dikonfigurasi dalam variabel lingkungan. `$PATH` Anda dapat menggunakan alat ini dari folder mana pun. Buka jendela terminal dan masukkan perintah untuk menjalankan.
## Penggunaan alat baris perintah
Tabel berikut mencakup opsi alat baris perintah yang tersedia. Daftar ini dapat diambil dengan menggunakan `--help` saat menelepon`dcv`. Untuk informasi lebih lanjut tentang cara menggunakan setiap perintah, teruskan `--help` setelah perintah yang Anda inginkan untuk informasi penggunaan. Sebagai contoh: `dcv create-session --help`.
| Perintah | Deskripsi |
| --- | --- |
| `create-session` | Buat sesi DCV baru |
| `close-session` | Menutup sesi DCV yang aktif |
| `describe-session` | Jelaskan sesi DCV |
| `list-sessions` | Buat daftar sesi DCV aktif |
| `list-connections` | Buat daftar koneksi klien untuk sesi DCV |
| `close-connection` | Menutup koneksi klien yang aktif |
| `get-screenshot` | Dapatkan tangkapan layar konsol DCV |
| `set-display-layout` | Mengatur tata letak tampilan sesi DCV aktif |
| `set-name` | Tetapkan nama untuk sesi DCV |
| `set-permissions` | Mengatur izin sesi DCV aktif |
| `set-storage-root` | Mengatur root penyimpanan sesi DCV aktif |
| `reload-licenses` | Memuat ulang lisensi secara paksa untuk semua sesi yang sedang berjalan |
| `get-config` | Dapatkan konfigurasi server |
| `list-endpoints` | Buat daftar titik akhir DCV |
| `set-config` | Tetapkan konfigurasi server |
| `version` | Tampilkan versi DCV |
| `help` | Tampilkan bantuan |
# Memulai sesi Amazon DCV
Bila Anda menggunakan default untuk menginstal [Windows Amazon DCV server](setting-up-installing-wininstall.md), [sesi konsol](managing-sessions-intro.md#managing-sessions-intro-console) secara otomatis dibuat dan aktif setelah server diinstal. Sesi konsol default dimiliki oleh `Administrator` dan memiliki ID sesi default`console`. Anda dapat menggunakan sesi ini atau Anda dapat [menutupnya](managing-sessions-lifecycle-stop.md) dan membuat sesi baru.
Jika Anda memilih untuk keluar dari pembuatan sesi konsol otomatis saat menginstal server Amazon DCV, Anda harus membuatnya secara manual. Setelah Anda menginstal server Amazon DCV, Anda dapat mengaktifkan atau menonaktifkan [pembuatan sesi konsol otomatis](#managing-sessions-start-auto) kapan saja.
**catatan**
Server Linux dan macOS Amazon DCV tidak mendapatkan sesi konsol default setelah instalasi.
Misalnya Anda menggunakan lisensi mengambang di server berbasis Internet lokal atau alternatif dan melebihi jumlah maksimum sesi bersamaan yang didukung oleh lisensi Anda. Anda mungkin mendapatkan `no licenses` kesalahan. Jika Anda mendapatkan kesalahan ini, hentikan sesi yang tidak digunakan untuk melepaskan lisensi dan coba lagi.
Server Amazon DCV harus berjalan untuk memulai sesi. Untuk informasi selengkapnya, lihat [Memulai Server DCV Amazon](manage-start.md).
**Topics**
+ [Memulai sesi konsol dan virtual secara manual](#managing-sessions-start-manual)
+ [Mengaktifkan Sesi Konsol Otomatis](#managing-sessions-start-auto)
## Memulai sesi konsol dan virtual secara manual
Anda dapat memulai sesi Amazon DCV kapan saja. Anda hanya dapat menjalankan satu sesi konsol pada satu waktu. Jika Anda menggunakan server DCV Amazon Linux, Anda dapat menjalankan beberapa sesi virtual secara bersamaan.
Ini adalah praktik yang baik untuk dijalankan `dcv list-sessions` sebelum membuat sesi, terutama jika Anda menggunakan server Windows Amazon DCV.
Untuk membuat konsol atau sesi virtual di server Windows, Linux, atau macOS Amazon DCV, gunakan perintah. `dcv create-session`
**Topics**
+ [Sintaksis](#managing-sessions-start-manual-syntax)
+ [Opsi](#managing-sessions-start-manual-options)
+ [Contoh](#managing-sessions-start-manual-examples)
### Sintaksis
Sintaks minimal perintah untuk memulai sesi adalah:
```
dcv create-session session_ID
```
Sintaks lengkap dengan semua opsi adalah:
```
dcv create-session \
--type console|virtual \
--name session_name \
--user username \
--owner owner_name \
--permissions-file /path_to/permissions_file \
--storage-root /path_to/storage_directory \
--gl on|off \
--max-concurrent-clients number_of_clients \
--init /path_to/init_script \
session_ID
```
**catatan**
`\`Simbol mewakili sintaks untuk membagi perintah dalam beberapa baris.
Anda juga dapat menggunakan `dcv create-session --help` untuk menampilkan referensi cepat ke sintaks.
### Opsi
Opsi berikut dapat digunakan dengan `dcv create-session` perintah:
**`--type`**
Opsi ini hanya didukung di server Linux Amazon DCV. Ini menentukan jenis sesi yang akan dibuat dan dapat berupa `console` atau`virtual`.
Tipe: String
Nilai yang diizinkan: `console` \$1 `virtual`
Wajib: Tidak
**`--name`**
Menentukan nama untuk sesi. Nama sesi dapat berupa string hingga 256 karakter. Jika string melebihi 256 karakter, perintah gagal. Nama sesi tidak harus unik di seluruh sesi yang sedang berjalan.
Anda dapat mengubah nama sesi kapan saja menggunakan `dcv set-name` perintah. Untuk informasi selengkapnya, lihat [Mengelola nama sesi](managing-session-name.md).
Tipe: String
Diperlukan: Ya
**`--user`**
Opsi ini didukung dengan sesi virtual pada sesi DCV Amazon Linux saja. Nilai ini adalah pengguna yang akan digunakan untuk membuat sesi. Hanya pengguna root yang dapat meniru pengguna lain.
Tipe: String
Wajib: Tidak
**`--owner`**
Menentukan pemilik sesi. Default untuk pengguna yang saat ini masuk jika dihilangkan.
Tipe: String
Wajib: Tidak
**`--permissions-file`**
Menentukan path ke file izin kustom. Default ke server default jika dihilangkan.
Tipe: String
Wajib: Tidak
**`--storage-root`**
Menentukan path ke folder yang digunakan untuk penyimpanan sesi.
Anda dapat menggunakan `%home%` untuk menentukan direktori home pengguna yang saat ini masuk. Misalnya, berikut ini menetapkan direktori untuk penyimpanan sesi seperti `c:\Users\username\storage\` untuk server Windows atau `$HOME/storage/` untuk server Linux.
```
--storage-root %home%/storage/
```
Jika subdirektori tertentu tidak ada, penyimpanan sesi dinonaktifkan.
Tipe: String
Wajib: Tidak
**`--gl`**
Opsi ini didukung dengan sesi virtual pada sesi DCV Amazon Linux saja. Ini mengesampingkan `dcv-gl` status default dan dapat berupa atau`on`. `off`
Tipe: String
Nilai yang diizinkan: `on` \$1 `off`
Wajib: Tidak
**`--max-concurrent-clients`**
Menentukan jumlah maksimum klien Amazon DCV yang diizinkan untuk terhubung ke sesi. Default ke koneksi tak terbatas jika dihilangkan.
Tipe: Integer
Wajib: Tidak
**`--init`**
Opsi ini didukung dengan sesi virtual di server Linux Amazon DCV saja. Ini menentukan jalan ke `init` skrip kustom. Script dapat digunakan untuk memulai lingkungan desktop tertentu dan meluncurkan aplikasi tertentu secara otomatis ketika sesi dimulai. Skrip harus dapat dieksekusi. Default ke skrip yang memulai lingkungan desktop default jika dihilangkan.
Tipe: String
Wajib: Tidak
**`session ID`**
Memberikan ID untuk sesi Anda di akhir perintah.
Tipe: String
Diperlukan: Ya
### Contoh
**Contoh 1 - Sesi konsol**
Perintah berikut membuat sesi konsol yang dimiliki oleh `dcv-user` dengan ID sesi unik dari`my-session`, dan nama sesi`my graphics session`. Ini juga menentukan file izin bernama. `perm-file.txt`
+ Server DCV Amazon Windows
```
C:\> dcv create-session^
--owner dcv-user^
--name "my graphics session"^
--permissions-file perm-file.txt^
my-session
```
+ Server DCV Amazon Linux
```
$ sudo dcv create-session \
--type=console \
--owner dcv-user \
--name "my graphics session" \
--permissions-file perm-file.txt \
my-session
```
**Contoh 2 - Sesi Virtual (hanya server Linux Amazon DCV)**
Perintah berikut membuat sesi virtual menggunakan pengguna root untuk meniru pemilik sesi yang dimaksud,. `dcv-user` Sesi ini dimiliki oleh `dcv-user` meskipun dibuat oleh pengguna root
```
$ sudo dcv create-session \
--owner dcv-user \
--user dcv-user \
my-session
```
**Contoh 3 - Sesi Virtual (hanya server Linux Amazon DCV)**
Perintah berikut membuat sesi virtual yang dimiliki oleh pengguna yang membuatnya:
```
$ dcv create-session my-session
```
## Mengaktifkan Sesi Konsol Otomatis
Mengaktifkan sesi konsol otomatis memastikan bahwa sesi konsol dibuat secara otomatis setiap kali server Amazon DCV dimulai. Sesi konsol otomatis dimiliki oleh pengguna Amazon DCV yang ditentukan oleh parameter `owner` konfigurasi. ID sesinya selalu`console`.
Parameter lain yang mempengaruhi sesi konsol otomatis adalah`max-concurrent-clients`,`permissions-file`, dan`storage-root`. Untuk informasi selengkapnya tentang parameter ini, lihat [`session-management/automatic-console-session`Parameter](config-param-ref.md#session_management_automatic_console_session).
**catatan**
Amazon DCV tidak mendukung sesi virtual otomatis.
------
#### [ Windows Amazon DCV server ]
**Untuk mengaktifkan sesi konsol otomatis di server Windows Amazon DCV**
1. Buka Windows Registry Editor.
1. Arahkan ke **HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftware\$1 GSettings dcv\$1 session-management** key.
1. Buat `create-session` parameter:
1. Di panel navigasi, buka menu konteks (klik kanan) untuk kunci **manajemen sesi** dan pilih Nilai **Baru**, **DWORD** (32-bit).
1. Untuk **Nama**, masukkan `create-session` dan tekan **Enter**.
1. Buka parameter **create-session**. Untuk **data Nilai**, masukkan`1`, dan pilih **OK**.
1. Arahkan ke **tombol HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftware\$1 dcvGSettings\$1 session-management/**. automatic-console-session
1. Buat `owner` parameter:
1. Di panel navigasi, buka menu konteks (klik kanan) untuk **automatic-console-session**kunci dan pilih **Baru**, Nilai **String**.
1. Untuk **Nama**, masukkan `owner` dan tekan **Enter**.
1. Buka parameter **pemilik**. Untuk **data Nilai**, masukkan nama pemilik sesi dan pilih **OK**.
1. Pilih **OK** dan tutup Windows Registry Editor.
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
------
#### [ Linux Amazon DCV server ]
**Untuk mengaktifkan sesi konsol otomatis di server DCV Amazon Linux**
1. Arahkan ke `/etc/dcv/` dan buka `dcv.conf` dengan editor teks pilihan Anda.
1. Tambahkan `owner` parameter `create-session` dan ke `[session-management/automatic-console-session]` bagian menggunakan format berikut:
```
[session-management]
create-session = true
[session-management/automatic-console-session]
owner="session-owner"
```
1. Simpan dan tutup file .
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
------
#### [ macOS Amazon DCV server ]
**Untuk mengaktifkan sesi konsol otomatis di server DCV macOS Amazon**
1. Arahkan ke `/etc/dcv/` dan buka `dcv.conf` dengan editor teks pilihan Anda.
1. Tambahkan `owner` parameter `create-session` dan ke `[session-management/automatic-console-session]` bagian menggunakan format berikut:
```
[session-management]
create-session = true
[session-management/automatic-console-session]
owner="session-owner"
```
1. Simpan dan tutup file .
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
------
# Menghentikan sesi Amazon DCV
Sesi konsol hanya dapat dihentikan oleh administrator di server Windows Amazon DCV, dan pengguna root di server Linux dan macOS Amazon DCV. Sesi virtual di server DCV Amazon Linux hanya dapat dihentikan oleh pengguna root atau pengguna Amazon DCV yang membuatnya.
**catatan**
Menghentikan sesi menutup semua aplikasi yang berjalan dalam sesi.
Untuk menghentikan konsol atau sesi virtual di server Windows, Linux, atau macOS Amazon DCV, gunakan `dcv close-session` perintah dan tentukan ID sesi unik.
**Topics**
+ [Sintaksis](#managing-sessions-lifecycle-stop-syntax)
+ [Contoh](#example)
## Sintaksis
```
dcv close-session session-id
```
## Contoh
Misalnya, perintah berikut menghentikan sesi dengan ID unik dari`my-session`.
```
dcv close-session my-session
```
# Melihat sesi Amazon DCV
Administrator pada server Windows Amazon DCV atau pengguna root pada server Linux Amazon DCV dapat melihat semua sesi aktif yang berjalan di server. Pengguna Amazon DCV hanya dapat melihat sesi yang telah mereka buat.
**Topics**
+ [Melihat semua sesi aktif](#list-all)
+ [Melihat sesi aktif tertentu](#view-specific)
## Melihat semua sesi aktif
Untuk membuat daftar konsol aktif atau sesi virtual di server DCV Amazon Windows atau Linux, gunakan `dcv list-sessions` perintah.
**Topics**
+ [Sintaksis](#list-all-syntax)
+ [Output](#output)
### Sintaksis
```
dcv list-sessions
```
### Output
Perintah mengembalikan daftar sesi aktif dalam format berikut.
```
Session: session-id (owner:session-owner type:virtual|console name:'my session')
```
## Melihat sesi aktif tertentu
Untuk melihat informasi tentang sesi, gunakan `dcv describe-session` perintah dan tentukan ID sesi unik.
**Topics**
+ [Sintaksis](#view-specific-syntax)
+ [Output](#output)
### Sintaksis
```
$ dcv describe-session session_id
```
### Output
Dalam contoh output berikut, `display-layout` elemen menunjukkan bahwa tata letak tampilan sesi diatur untuk menggunakan dua layar 800x600. Dari jumlah tersebut, layar kedua diimbangi ke x = 800 (ke kanan) dari layar pertama.
```
Session: test
owner: session-id
name: session-name
x display: :1
x authority: /run/user/1009/dcv/test.xauth
display layout: 800x600+0+0,800x600+800+0
```
Anda juga dapat menyertakan opsi `--json` (atau`-j`) untuk memaksa perintah mengembalikan output dalam format JSON. Output JSON memberikan rincian tambahan tentang sesi.
```
$ dcv describe-session session-id --json
```
Berikut ini adalah contoh output JSON.
```
{
"id" : "session-id",
"owner" : "dcvuser",
"name" : "session-name",
"num-of-connections" : 0,
"creation-time" : "2020-03-02T16:08:50Z",
"last-disconnection-time" : "",
"licenses" : [
{
"product" : "dcv",
"status" : "licensed",
"check-timestamp" : "2020-03-02T16:08:50Z",
"expiration-date" : "2020-03-29T00:00:00Z"
},
{
"product" : "dcv-gl",
"status" : "licensed",
"check-timestamp" : "2020-03-02T16:08:50Z",
"expiration-date" : "2020-03-29T00:00:00Z"
}
],
"storage-root" : "",
"type" : "virtual",
"x11-display" : ":2",
"x11-authority" : "/run/user/1009/dcv/vsession.xauth",
"display-layout" : [
{
"width" : 800,
"height" : 600,
"x" : 0,
"y" : 0
},
{
"width" : 800,
"height" : 600,
"x" : 800,
"y" : 0
}
]
}
```
# Mengelola sesi Amazon DCV aktif
Setelah klien masuk dan mulai menggunakan sesi DCV, sesi dianggap aktif. Saat sesi aktif, Anda masih dapat melakukan tugas manajemen tertentu. Bagian ini memberikan informasi yang Anda butuhkan tentang mengelola parameter sesi ini saat masih digunakan oleh klien.
**Topics**
+ [Mengelola penyimpanan sesi](managing-session-storage.md)
+ [Mengelola otorisasi sesi](managing-session-perms.md)
+ [Mengelola tata letak tampilan sesi](managing-session-display.md)
+ [Mengelola nama sesi](managing-session-name.md)
+ [Menemukan dan menghentikan sesi idle](stop-idle-sessions.md)
# Mengelola penyimpanan Sesi Amazon DCV
Penyimpanan sesi adalah direktori di server Amazon DCV yang dapat diakses klien ketika mereka terhubung ke sesi Amazon DCV.
Jika penyimpanan sesi diaktifkan di server Amazon DCV, Anda dapat menggunakan `dcv set-storage-root` perintah untuk menentukan direktori di server yang akan digunakan untuk penyimpanan sesi. Untuk informasi selengkapnya tentang mengaktifkan penyimpanan sesi di server Amazon DCV, lihat. [Mengaktifkan penyimpanan sesi](manage-storage.md)
Untuk mengatur jalur penyimpanan sesi, gunakan `dcv set-storage-root` perintah dan tentukan ID sesi dan jalur ke direktori yang akan digunakan.
**Topics**
+ [Sintaksis](#managing-session-storage-syntax)
+ [Opsi](#managing-session-storage-options)
+ [Contoh](#session-storage-example)
## Sintaksis
```
dcv set-storage-root --session session_id /path_to/directory
```
Untuk jalur direktori, Anda dapat menggunakan `%home%` untuk menentukan direktori home pengguna yang saat ini masuk. Misalnya, `%home%/storage/` jalur diselesaikan ke `c:\Users\username\storage\` pada server Windows. Ini menyelesaikan ke server `$HOME/storage/` Linux.
**catatan**
`storage-root`Nilai harus berupa jalur absolut di macOS.
## Opsi
Opsi berikut dapat digunakan dengan `dcv set-storage-root` perintah
**`--session`**
ID sesi untuk menentukan direktori penyimpanan.
Tipe: String
Diperlukan: Ya
## Contoh
**Contoh server Windows Amazon DCV**
Contoh berikut disetel ke jalur penyimpanan `c:\session-storage` untuk sesi dengan ID sesi dari`my-session`.
```
C:\> dcv set-storage-root --session my-session c:\session-storage
```
**Contoh server DCV Amazon Linux**
Contoh berikut disetel ke jalur penyimpanan ke direktori bernama `session-storage` di direktori home pengguna saat ini, untuk sesi dengan ID sesi`my-session`.
```
$ dcv set-storage-root --session my-session %home%/session-storage/
```
# Mengelola otorisasi Sesi Amazon DCV
Otorisasi digunakan untuk memberikan atau menolak izin klien Amazon DCV ke fitur Amazon DCV tertentu. Biasanya, otorisasi dikonfigurasi saat sesi Amazon DCV dimulai. Namun, dimungkinkan untuk mengedit izin untuk sesi yang sedang berjalan. Untuk informasi selengkapnya tentang otorisasi Amazon DCV, lihat. [Mengkonfigurasi otorisasi Amazon DCV](security-authorization.md)
Untuk memodifikasi izin untuk sesi berjalan, gunakan `dcv set-permissions` perintah.
**Topics**
+ [Sintaksis](#managing-session-perms-syntax)
+ [Opsi](#managing-session-perms-options)
+ [Contoh](#session-perms-example)
## Sintaksis
```
dcv set-permissions --session session-id --none | --reset-builtin | --file /path_to/permissions_file
```
Anda harus menentukan`--none`,`--reset-builtin`, atau`--file`.
## Opsi
Opsi berikut dapat digunakan dengan `dcv set-permissions` perintah.
**--sesi**
Menentukan ID sesi untuk mengatur izin untuk.
**--reset-builtin**
Menyetel ulang izin sesi ke izin sesi default. Izin default hanya memberi pemilik sesi akses penuh ke semua fitur.
**--tidak ada**
Mencabut semua izin untuk sesi tersebut.
**--berkas-berkas**
Menentukan path ke file izin kustom. Jika file yang ditentukan kosong, semua izin dicabut. Untuk informasi selengkapnya tentang membuat file izin khusus, lihat[Memahami file izin](security-authorization-file-create.md).
## Contoh
**Contoh 1—Mencabut semua izin**
Contoh berikut mencabut semua izin klien untuk sesi dengan ID dari. `my-session`
```
C:\> dcv set-permissions --session my-session --none
```
**Contoh 2 — Menentukan izin kustom**
Contoh berikut menentukan file izin kustom yang dinamai `perm-file.txt` untuk sesi dengan ID dari. `my-session` File ini terletak di `c:\dcv\` direktori.
```
C:\> dcv set-permissions --session my-session --file c:\dcv\perm-file.txt
```
**Contoh 3—Menyetel ulang izin**
Contoh berikut me-reset izin ke default untuk sesi dengan ID dari. `my-session`
```
C:\> dcv set-permissions --session my-session --reset-builtin
```
# Mengelola tata letak tampilan Amazon DCV Session
Anda dapat mengatur tata letak tampilan untuk sesi Amazon DCV yang sedang berjalan. Tata letak tampilan menentukan konfigurasi default yang digunakan saat klien terhubung ke sesi. Namun, klien dapat mengganti tata letak secara manual menggunakan pengaturan klien Amazon DCV atau pengaturan tampilan sistem operasi asli.
Jika konfigurasi perangkat keras dan perangkat lunak server host tidak mendukung resolusi yang ditentukan atau jumlah layar, server Amazon DCV tidak menerapkan tata letak tampilan yang ditentukan.
Amazon DCV dapat mengonfigurasi resolusi sesuai dengan pengaturan dan konfigurasi sistem server.
+ Resolusi klien web dibatasi secara default ke 1920x1080 (dari pengaturan web-client-max-head server resolusi).
+ Klien asli dibatasi secara default ke 4096x2160 (dari). max-head-resolution
Perhatikan bahwa resolusi dan jumlah monitor yang tersedia bergantung pada konfigurasi server, pastikan untuk mengikuti [panduan prasyarat](https://docs.aws.amazon.com/dcv/latest/adminguide/setting-up-installing.html) untuk mengatur lingkungan sistem dan driver dengan benar untuk kinerja terbaik.
**catatan**
Untuk klien asli, hingga maksimal empat monitor dapat digunakan.
Untuk klien web, maksimal dua monitor dapat digunakan.
Resolusi yang lebih tinggi atau lebih dari jumlah maksimum monitor tidak didukung dalam konfigurasi apa pun.
**Topics**
+ [Mengakses tata letak tampilan](#display-restrict)
+ [Mengatur tata letak tampilan](#dislay-set)
+ [Melihat tata letak tampilan](#dislay-view)
## Mengakses tata letak tampilan
Anda dapat mengonfigurasi server Amazon DCV untuk mencegah klien meminta tata letak tampilan yang berada di luar rentang yang ditentukan. Untuk membatasi perubahan tata letak tampilan, konfigurasikan parameter server Amazon DCV berikut.
+ [`enable-client-resize`](config-param-ref.md#paramref.display.enable-client-resize)—Untuk mencegah klien mengubah tata letak tampilan, atur parameter ini ke`false`.
+ [`min-head-resolution`](config-param-ref.md#paramref.display.min-head-resolution)dan [`max-head-resolution`](config-param-ref.md#paramref.display.max-head-resolution)—Menentukan resolusi minimum dan maksimum yang diizinkan masing-masing.
+ [`web-client-max-head-resolution`](config-param-ref.md#paramref.display.web-client-max-head-resolution)—Menentukan resolusi maksimum yang diizinkan untuk klien browser web. `max-head-resolution`Batasan diterapkan di atas `web-client-max-head-resolution` batasan. Secara default, resolusi maksimum untuk klien browser web adalah 1920x1080. Menentukan resolusi yang lebih tinggi dapat menyebabkan masalah kinerja, tergantung pada browser web dan spesifikasi komputer klien.
+ [`max-num-heads`](config-param-ref.md#paramref.display.max-num-heads)—Menentukan jumlah maksimum tampilan.
+ `max-layout-area`- Menentukan jumlah maksimum piksel yang diizinkan untuk area layar. Permintaan dengan total area layar (dinyatakan dalam piksel) melebihi nilai yang ditentukan diabaikan.
Untuk informasi selengkapnya tentang parameter ini, lihat [`display`Parameter](config-param-ref.md#display) di Referensi Parameter.
## Mengatur tata letak tampilan
**Untuk mengonfigurasi tata letak tampilan untuk sesi Amazon DCV yang sedang berjalan**
Gunakan `dcv set-display-layout` perintah dan tentukan sesi untuk mengatur tata letak tampilan dan deskriptor tata letak tampilan untuk.
```
dcv set-display-layout --session session-id display-layout-descriptor
```
Deskriptor tata letak tampilan menentukan jumlah tampilan dan resolusi dan posisi offset untuk setiap tampilan. Deskripsi harus ditentukan dalam format berikut:
```
widthxheight+|-x-position-offset+|-y-position-offset
```
Jika Anda menentukan lebih dari satu layar, pisahkan deskriptor layar dengan koma. Offset posisi layar menentukan posisi sudut kiri atas layar relatif terhadap layar 1. Jika Anda tidak menentukan offset posisi untuk layar, defaultnya adalah x=0 dan y=0.
**penting**
Jika Anda menentukan lebih dari satu layar, pastikan Anda mengatur offset posisi dengan benar untuk setiap layar untuk menghindari tumpang tindih layar.
Misalnya, deskriptor tata letak tampilan berikut menentukan dua layar:
+ Layar 1: Resolusi 1920x1080 diimbangi ke x = 0, y = 0
+ Layar 2: Resolusi 800x600 diimbangi ke x = 1920, y = 0 sehingga muncul di sebelah kanan layar 1.
![\[Tata letak layar dengan dua layar.\]](http://docs.aws.amazon.com/id_id/dcv/latest/adminguide/images/eg2.png)
```
1920x1080+0+0,800x600+1920+0
```
Deskriptor tata letak tampilan berikut menentukan tiga layar.
+ Layar 1: Resolusi 1920x1080 diimbangi ke x = 0, y = 0
+ Layar 2: Resolusi 1920x1080 diimbangi ke x = 1920, y = 0 sehingga muncul di sebelah kanan layar 1.
+ Layar 3: Resolusi 1024x768 diimbangi ke x = -1024, y = 0 sehingga muncul di sebelah kiri layar 1.
![\[Tata letak layar dengan tiga layar.\]](http://docs.aws.amazon.com/id_id/dcv/latest/adminguide/images/eg1.png)
```
1920x1080+0+0,1920x1080+1920+0,1024x768-1024+0
```
## Melihat tata letak tampilan
**Untuk melihat tata letak tampilan untuk sesi**
Gunakan `dcv describe-session` perintah dan tinjau `display layout` elemen dalam output. Untuk informasi selengkapnya, lihat [Melihat sesi Amazon DCV](managing-sessions-lifecycle-view.md).
# Mengelola nama sesi
Anda dapat mengubah nama sesi berjalan kapan saja. Anda dapat menggunakan nama sesi tertentu untuk mengidentifikasi sesi dengan cepat berdasarkan namanya. Nama sesi tidak harus unik di seluruh sesi yang sedang berjalan.
Untuk mengubah nama sesi yang sedang berjalan, gunakan `dcv set-name` perintah.
**Topics**
+ [Sintaksis](#managing-session-name-syntax)
+ [Opsi](#managing-session-name-options)
+ [Contoh](#example)
## Sintaksis
```
$ dcv set-name --session session_id --none |--name "session-name"
```
Anda harus menentukan `--name` atau `--none`.
## Opsi
Opsi berikut dapat digunakan dengan `dset-name` perintah.
**`--session`**
ID sesi untuk mengatur nama untuk.
Tipe: String
Diperlukan: Ya
**`--name`**
Nama untuk menetapkan sesi. Hanya tentukan opsi ini jika Anda ingin menetapkan nama ke sesi. Jika Anda ingin menghapus nama, hilangkan paramater ini. Nama sesi dapat mencapai 256 karakter. Ini dapat terdiri dari huruf, angka, dan karakter khusus. Jika string yang ditentukan melebihi 256 karakter, perintah gagal.
Tipe: String
Wajib: Tidak
**`--none`**
Tentukan parameter ini untuk menghapus nama yang ada dari sesi. Jika Anda tidak ingin menghapus nama sesi, hilangkan opsi ini.
Wajib: Tidak
## Contoh
**Contoh 1—Mengubah nama sesi**
Contoh berikut menetapkan nama sesi dengan ID dari `my-session` to`my graphics session`.
```
$ dcv set-name --session my-session --name "my graphics sessions"
```
**Contoh 2 — Menghapus nama sesi**
Contoh berikut menghapus nama sesi dengan ID dari`my-session`.
```
$ dcv set-name --session my-session --none
```
# Menemukan dan menghentikan sesi idle
Anda dapat mengidentifikasi sesi DCV Amazon yang menganggur menggunakan perintah `dcv describe-sessions` CLI dengan opsi perintah. `-j` Menentukan `-j` opsi mengkonfigurasi perintah untuk mengembalikan output dalam format JSON, yang memberikan rincian tambahan tentang sesi.
Misalnya, perintah berikut mengembalikan informasi tentang sesi bernama`my-session`.
```
$ dcv describe-session my-session -j
```
Output:
```
{
"id" : "my-session",
"owner" : "dcvuser",
"x11-display" : ":1",
"x11-authority" : "/run/user/1009/dcv/test3.xauth",
"num-of-connections" : 1,
"creation-time" : "2019-05-13T13:21:19.262883Z",
"last-disconnection-time" : "2019-05-14T12:32:14.357567Z",
"licensing-mode" : "DEMO",
"licenses" : [
{
"product" : "dcv",
"status" : "LICENSED",
"check-timestamp" : "2019-05-14T12:35:40Z",
"expiration-date" : "2019-05-29T00:00:00Z"
},
{
"product" : "dcv-gl",
"status" : "LICENSED",
"check-timestamp" : "2019-05-14T12:35:40Z",
"expiration-date" : "2019-05-29T00:00:00Z"
}
]
}
```
Dalam output perintah, `num-of-connections` parameter menunjukkan jumlah koneksi klien aktif. Nilai `0` menunjukkan bahwa tidak ada koneksi klien aktif, dan sesi saat ini idle. Anda juga dapat menggunakan `last-disconnection-time` parameter untuk menentukan kapan sesi terakhir memiliki koneksi klien aktif.
Anda dapat membuat skrip atau cron job yang menggunakan informasi ini untuk mengidentifikasi sesi idle. Kemudian Anda dapat berhenti menggunakannya dengan menggunakan [`dcv close-session`](managing-sessions-lifecycle-stop.md)perintah.
**catatan**
Menghentikan sesi menutup semua aplikasi yang berjalan dalam sesi.
# Mengatur zona waktu sesi
DCV memungkinkan pemilik sesi dan pengguna untuk mengatur zona waktu sesi mereka untuk mencerminkan lokasi Server DCV atau lokasi mereka saat ini.
Jika hanya pengguna individu dalam satu sesi yang diharuskan memiliki fitur ini, Anda perlu mengatur parameter terpusat untuk semua pengguna terlebih dahulu dan kemudian menyesuaikan izin individu secara terpisah dengan membuat file izin khusus di. [Menambahkan izin](security-authorization-file-create-permission.md)
**catatan**
Fitur ini tidak tersedia pada sesi virtual Linux.
**catatan**
Di macOS, pengalihan zona waktu diterapkan setelah login.
**Mengaktifkan pengalihan zona waktu**
Anda dapat mengaktifkan dan menonaktifkan fitur ini untuk semua pengguna pada sesi tertentu.
1. Ubah [`enable-timezone-redirection`](config-param-ref.md#paramref.redirection.enable-timezone-redirection)parameter ke salah satu nilai berikut:
+ `always-on`: Pengalihan Zona Waktu selalu diaktifkan.
Fitur akan dihidupkan dan sesi menampilkan informasi zona waktu klien. Pengguna tidak akan dapat mematikan fitur tersebut.
+ `always-off`: Pengalihan Zona Waktu selalu dinonaktifkan.
Fitur ini akan dimatikan dan sesi menampilkan informasi zona waktunya sendiri. Pengguna tidak akan dapat mengaktifkan fitur tersebut.
+ `client-decides`: Pengalihan Zona Waktu diaktifkan secara default.
Sesi akan mengaktifkan fitur, menampilkan zona waktu klien, dan pengguna akan memiliki opsi untuk menonaktifkannya yang memungkinkan zona waktu server ditampilkan.
**catatan**
Pengaturan ini adalah pengaturan default standar.
1. Mulai ulang sesi yang terpengaruh agar perubahan Anda muncul.
# Mengelola pengosongan layar di Linux
Untuk sesi Konsol di server Linux, DCV mengosongkan layar lokal secara default ketika setidaknya satu pengguna jarak jauh terhubung ke server, dan mengembalikan output (juga mengunci layar) setelah pemutusan pengguna jarak jauh terakhir.
Ini mencegah pengguna dalam kedekatan fisik server untuk melihat layar dan berinteraksi dengan sesi jarak jauh menggunakan perangkat input yang terhubung ke host. Ini mungkin tidak diinginkan karena alasan privasi atau kepatuhan hukum setempat saat mengerjakan sesi konsol dari jarak jauh. Input lokal dicegah dengan menonaktifkan perangkat yang terhubung secara fisik seperti keyboard dan mouse. Perangkat input dinonaktifkan segera setelah dicolokkan atau ketika ditemukan diaktifkan. Secara analog, perangkat input diaktifkan kembali ketika tidak ada pengguna jarak jauh yang terhubung, sehingga memungkinkan login dan interaksi lokal.
**Menonaktifkan pengosongan layar dan pemblokiran input**
Pengosongan layar dapat dinonaktifkan menggunakan prosedur berikut:
1. Arahkan ke `/etc/dcv/` dan buka `dcv.conf` file dengan editor teks pilihan Anda.
1. Temukan `disable-local-console parameter` di `[display/linux]` bagian. Untuk mengizinkan tampilan yang terhubung secara lokal agar tetap aktif dan menampilkan sesi jarak jauh yang sedang berlangsung, dan mengizinkan interaksi melalui perangkat yang terhubung secara lokal. `disable-local-console=false` Nilai defaultnya adalah `true` (yaitu: pengosongan layar dan pemblokiran input aktif). Jika tidak ada `disable-local-console` parameter di `[display/linux]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[display/linux]
disable-local-console=false|true
```
1. Simpan dan tutup file .
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
**Mencegah perangkat input yang dipilih agar tidak dinonaktifkan**
Perangkat tertentu dapat diatur agar tetap diaktifkan.
Perangkat input yang namanya dimulai dengan `DCV ` (harap perhatikan ruang setelah nama) tidak akan pernah dinonaktifkan terlepas dari nilai `display-local-console` pengaturan. Untuk mengganti nama perangkat input, lihat panduan ini: [Aktifkan Stylus](enable-stylus.md).
# Mengambil tangkapan layar di Sesi DCV Amazon
Anda dapat menggunakan `dcv get-screenshot` perintah untuk mengambil tangkapan layar desktop untuk sesi yang sedang berjalan.
## Sintaksis
```
dcv get-screenshot --max-width pixels --max-height pixels --format JPEG|PNG --primary --json --output /path_to/destination session_name
```
## Opsi
**`--max-width`**
Menentukan lebar maksimum, dalam piksel, tangkapan layar. Jika Anda tidak menentukan lebar atau tinggi, tangkapan layar menggunakan resolusi tampilan sesi. Jika Anda menentukan tinggi saja, lebar secara otomatis diskalakan untuk mempertahankan rasio aspek.
Tipe: Integer
Wajib: Tidak
**`--max-height`**
Menentukan tinggi maksimum, dalam piksel, dari tangkapan layar. Jika Anda tidak menentukan lebar atau tinggi, tangkapan layar menggunakan resolusi tampilan sesi. Jika Anda menentukan lebar saja, tinggi secara otomatis diskalakan untuk mempertahankan rasio aspek.
Tipe: Integer
Wajib: Tidak
**`--format`**
Format file tangkapan layar. Saat ini, hanya `PNG` format `JPEG` dan yang didukung. Jika Anda menentukan jenis file yang bertentangan untuk `--output` opsi `--format` dan, nilai yang ditentukan untuk `--format` diprioritaskan. Misalnya, jika Anda menentukan `--format JPEG` dan`--output myfile.png`, Amazon DCV membuat file gambar JPEG.
Tipe: String
Nilai yang diizinkan: `JPEG` \$1 `PNG`
Wajib: Tidak
**`--primary`**
Menunjukkan apakah akan mendapatkan tangkapan layar dari tampilan utama saja. Untuk mendapatkan tangkapan layar dari tampilan utama saja, tentukan`--primary`. Untuk mendapatkan tangkapan layar dari semua tampilan, hilangkan opsi ini. Jika Anda memilih untuk mendapatkan tangkapan layar dari semua tampilan, semua tampilan digabungkan menjadi satu tangkapan layar.
Wajib: Tidak
**`--json`, `-j`**
Menunjukkan apakah akan mengirimkan output dalam format JSON yang dikodekan dalam base64. Untuk mendapatkan output JSON, tentukan`--json`. Kalau tidak, hilangkan itu.
Wajib: Tidak
**`--output`, `-o`**
Menentukan jalur tujuan, nama file, dan jenis file untuk tangkapan layar. Misalnya, untuk Windows, tentukan`c:\directory\filename.format`, dan untuk Linux, tentukan`/directory/filename.format`. Formatnya harus `.png` atau`.jpeg`. Jika Anda menentukan jenis file yang bertentangan untuk `--output` opsi `--format` dan, nilai yang ditentukan untuk `--format` diprioritaskan. Misalnya, jika Anda menentukan `--format JPEG` dan`--output myfile.png`, Amazon DCV membuat file gambar JPEG.
Tipe: String
Diperlukan: tidak
## Contoh
**Contoh 1**
Contoh perintah berikut mendapatkan screenshot dari sesi yang diberi nama`my-session`. Tangkapan layar menggunakan resolusi server.
```
dcv get-screenshot --output myscreenshot.png my-session
```
**Contoh 2**
Perintah contoh berikut mengambil tangkapan layar dengan lebar `200` piksel dengan tinggi `100` piksel. Dibutuhkan dari sesi yang diberi nama`my-session`. Ini menyimpan tangkapan layar di direktori saat ini dengan nama file`myscreenshot.png`.
```
dcv get-screenshot --max-width 200 --max-height 100 --output myscreenshot.png my-session
```
**Contoh 3**
Contoh perintah berikut mengambil screenshot dari sesi yang diberi nama`my-session`. Tangkapan layar hanya dari tampilan utama. Ini menyimpan file di direktori saat ini dan memberi nama tangkapan layar`myscreenshot.png`.
```
dcv get-screenshot --primary --output myscreenshot.jpeg my-session
```
**Contoh 4**
Contoh perintah berikut mendapatkan screenshot dari sesi yang diberi nama`my-session`. Perintah mengeluarkan file yang dikodekan dalam base64 dan dalam format JSON.
```
dcv get-screenshot --json --format png my-session
```