AWS dcv documentation change
Summary
Added detailed installation instructions for Amazon DCV server on Amazon Linux 2023 including package downloads, GPG key verification, and optional component installations
Security assessment
Added instructions for GPG key verification to validate package integrity, which is a security best practice. However, there's no mention of addressing a specific vulnerability or security incident.
Diff
diff --git a/dcv/latest/adminguide/setting-up-installing-linux-server.md b/dcv/latest/adminguide/setting-up-installing-linux-server.md index ffcb53d7f..1a7396a4b 100644 --- a/dcv/latest/adminguide/setting-up-installing-linux-server.md +++ b/dcv/latest/adminguide/setting-up-installing-linux-server.md @@ -138,0 +139,116 @@ After you installed DKMS, run the following command to install the DCV USB drive +Amazon Linux 2023 + + +The Amazon DCV server is available for Amazon Linux 2023 servers based on the 64-bit x86 and 64-bit ARM architectures. + +###### Important + +The `nice-dcv-gl` and `nice-dcv-gltest` packages aren't available for servers based on the 64-bit ARM architecture. + +###### To install the Amazon DCV server on Amazon Linux 2023 + + 1. Launch and connect to the server where you intend to install the Amazon DCV server. + + 2. The Amazon DCV server packages are digitally signed with a secure GPG signature. To allow the package manager to verify the package signature, you must import the Amazon DCV GPG key. To do so, open a terminal window and import the Amazon DCV GPG key. + + $ sudo rpm --import https://d1uj6qtbmh3dt5.cloudfront.net/NICE-GPG-KEY + + 3. Download the packages from the [Amazon DCV download website](http://download.amazondcv.com). The RPM and deb packages are packaged into a `.tgz` archive. Make sure that you download the correct archive for your operating system. + + * 64-bit x86 + + $ wget https://d1uj6qtbmh3dt5.cloudfront.net/2024.0/Servers/nice-dcv-2024.0-18131-amzn2023-x86_64.tgz + + * 64-bit ARM + + $ wget https://d1uj6qtbmh3dt5.cloudfront.net/2024.0/Servers/nice-dcv-2024.0-18131-amzn2023-aarch64.tgz + +###### Tip + +The [latest packages](http://download.amazondcv.com/latest.html) page of the download website contains links that always point to the newest available version. You can use these links to automatically retrieve the newest Amazon DCV packages. + + * 64-bit x86 + + $ wget https://d1uj6qtbmh3dt5.cloudfront.net/nice-dcv-amzn2023-x86_64.tgz + + * 64-bit ARM + + $ wget https://d1uj6qtbmh3dt5.cloudfront.net/nice-dcv-amzn2023-aarch64.tgz + + 4. Extract the contents of the `.tgz` archive and navigate into the extracted directory. + + * 64-bit x86 + + $ tar -xvzf nice-dcv-2024.0-18131-amzn2023-x86_64.tgz && cd nice-dcv-2024.0-18131-amzn2023-x86_64 + + * 64-bit ARM + + $ tar -xvzf nice-dcv-2024.0-18131-amzn2023-aarch64.tgz && cd nice-dcv-2024.0-18131-amzn2023-aarch64 + + 5. Install the Amazon DCV server. + + * 64-bit x86 + + $ sudo dnf install nice-dcv-server-2024.0.18131-1.amzn2023.x86_64.rpm + + * 64-bit ARM + + $ sudo dnf install nice-dcv-server-2024.0.18131-1.amzn2023.aarch64.rpm + + 6. (Optional) If you plan to use the web client with Amazon DCV version 2021.2 and later, install the `nice-dcv-web-viewer` package. + + * 64-bit x86 + + $ sudo dnf install nice-dcv-web-viewer-2024.0.18131-1.amzn2023.x86_64.rpm + + * 64-bit ARM + + $ sudo dnf install nice-dcv-web-server-2024.0.18131-1.amzn2023.aarch64.rpm + + 7. (Optional) To use virtual sessions, install the `nice-xdcv` package. + + * 64-bit x86 + + $ sudo dnf install nice-xdcv-2024.0.631-1.amzn2023.x86_64.rpm + + * 64-bit ARM + + $ sudo dnf install nice-xdcv-2024.0.631-1.amzn2023.aarch64.rpm + + 8. (Optional) If you plan to use GPU sharing, install the `nice-dcv-gl` package. + + * 64-bit x86 + + $ sudo dnf install nice-dcv-gl-2024.0.1078-1.amzn2023.x86_64.rpm + +###### Note + +You can optionally install the `nice-dcv-gltest` package. This package includes a simple OpenGL application that can be used to determine if your virtual sessions are properly configured to use hardware-based OpenGL. + + 9. (Optional) If you plan to use Amazon DCV [external authenticator](https://docs.aws.amazon.com/dcv/latest/adminguide/external-authentication.html), use the `nice-dcv-simple-external-authenticator` package. + + * 64-bit x86 + + $ sudo dnf install nice-dcv-simple-external-authenticator-2024.0.259-1.amzn2023.x86_64.rpm + + * 64-bit ARM + + $ sudo dnf install nice-dcv-simple-external-authenticator-2024.0.259-1.amzn2023.aarch64.rpm + + 10. (Optional) If you plan to support specialized USB devices using USB remotization, install the DCV USB drivers. + +To install the DCV USB drivers, you must have Dynamic Kernel Module Support (DKMS) installed on your server. Use the following commands to install DKMS. + + $ sudo dnf install dkms + +After you installed DKMS, run the following command to install the DCV USB drivers: + + $ sudo dcvusbdriverinstaller + + 11. (Optional) If you plan to support the microphone redirection, verify that the `pulseaudio-utils` package is installed on your system. Use the following command to install it. + + $ sudo dnf install pulseaudio-utils + + + +