AWS dcv: DCV Linux prerequisites: OS support and install command updates
Summary
Restructures the Amazon DCV Linux prerequisite guide: updates supported OS tabs (adds Amazon Linux 2023, RHEL/CentOS/Rocky 8/9, SUSE Linux Enterprise 15, Ubuntu 22.04/24.04), replaces yum/apt commands with dnf/zypper equivalents, renames GDM3 to GDM, and reorganizes the Wayland-disable and glxinfo/XDummy sections.
Security assessment
The diff is purely documentation maintenance: OS version updates, package manager command changes (yum to dnf, apt, zypper), and section reorganization. The Wayland-disable instructions are a compatibility requirement for DCV, not a security control, and no vulnerability, CVE, or credential/authz guidance is introduced.
Evidence
+The default desktop environment for Amazon Linux 2023 is GNOME and the default desktop manager is GDM.
Diff
diff --git a/dcv/latest/adminguide/setting-up-installing-linux-prereq.md b/dcv/latest/adminguide/setting-up-installing-linux-prereq.md index b0a7e4807..fc9fe7dc5 100644 --- a//dcv/latest/adminguide/setting-up-installing-linux-prereq.md +++ b//dcv/latest/adminguide/setting-up-installing-linux-prereq.md @@ -7 +7 @@ -Install a desktop environment and desktop managerDisable the Wayland protocol (GDM3 only)Configure the X ServerInstall the glxinfo utilityVerify OpenGL software renderingInstall GPU drivers for graphics instancesInstall XDummy driver for non-GPU instances +Install a desktop environment and desktop managerDisable the Wayland protocol (GDM only)Configure the X ServerInstall the glxinfo utilityVerify OpenGL software renderingInstall GPU drivers for graphics instancesInstall XDummy driver for non-GPU instances @@ -19 +19 @@ This topic describes how to install the prerequisites required to use Amazon DCV - * Disable the Wayland protocol (GDM3 only) + * Disable the Wayland protocol (GDM only) @@ -42 +42 @@ The following tabbed content shows the steps for installing the default desktop -RHEL, CentOS, and Rocky Linux +Amazon Linux 2 @@ -45 +45 @@ RHEL, CentOS, and Rocky Linux -The default desktop environment for RHEL, CentOS , and Rocky Linux is Gnome3 and the default desktop manager is GDM. +The default desktop environment for Amazon Linux 2 is GNOME and the default desktop manager is GDM. @@ -47 +47 @@ The default desktop environment for RHEL, CentOS , and Rocky Linux is Gnome3 and -###### To install and configure the desktop environment and desktop manager on RHEL, CentOS, and Rocky Linux +###### To install and configure the desktop environment and desktop manager on Amazon Linux 2 @@ -51,3 +51 @@ The default desktop environment for RHEL, CentOS , and Rocky Linux is Gnome3 and - * RHEL and Rocky Linux - - $ sudo yum groupinstall 'Server with GUI' + $ sudo yum install gdm gnome-session gnome-classic-session gnome-session-xsession @@ -55 +53 @@ The default desktop environment for RHEL, CentOS , and Rocky Linux is Gnome3 and - * CentOS + $ sudo yum install xorg-x11-server-Xorg xorg-x11-fonts-Type1 xorg-x11-drivers @@ -57 +55 @@ The default desktop environment for RHEL, CentOS , and Rocky Linux is Gnome3 and - $ sudo yum groupinstall "GNOME Desktop" + $ sudo yum install gnome-terminal gnu-free-fonts-common gnu-free-mono-fonts gnu-free-sans-fonts gnu-free-serif-fonts @@ -70 +68 @@ The default desktop environment for RHEL, CentOS , and Rocky Linux is Gnome3 and -Amazon Linux 2 +Amazon Linux 2023 @@ -73 +71 @@ Amazon Linux 2 -The default desktop environment for Amazon Linux 2 is Gnome3 and the default desktop manager is GDM. +The default desktop environment for Amazon Linux 2023 is GNOME and the default desktop manager is GDM. @@ -75 +73 @@ The default desktop environment for Amazon Linux 2 is Gnome3 and the default des -###### To install and configure the desktop environment and desktop manager on Amazon Linux 2 +###### To install and configure the desktop environment and desktop manager on Amazon Linux 2023 @@ -79,5 +77 @@ The default desktop environment for Amazon Linux 2 is Gnome3 and the default des - $ sudo yum install gdm gnome-session gnome-classic-session gnome-session-xsession - - $ sudo yum install xorg-x11-server-Xorg xorg-x11-fonts-Type1 xorg-x11-drivers - - $ sudo yum install gnome-terminal gnu-free-fonts-common gnu-free-mono-fonts gnu-free-sans-fonts gnu-free-serif-fonts + $ sudo dnf group install "Desktop" @@ -87 +81 @@ The default desktop environment for Amazon Linux 2 is Gnome3 and the default des - $ sudo yum upgrade + $ sudo dnf upgrade @@ -96 +90 @@ The default desktop environment for Amazon Linux 2 is Gnome3 and the default des -Amazon Linux 2023 +RHEL, CentOS, and Rocky Linux 8/9 @@ -99 +93 @@ Amazon Linux 2023 -The default desktop environment for Amazon Linux 2023 is Gnome3 and the default desktop manager is GDM. +The default desktop environment for RHEL, CentOS, and Rocky Linux 8/9 is GNOME and the default desktop manager is GDM. @@ -101 +95 @@ The default desktop environment for Amazon Linux 2023 is Gnome3 and the default -###### To install and configure the desktop environment and desktop manager on Amazon Linux 2023 +###### To install and configure the desktop environment and desktop manager on RHEL, CentOS, and Rocky Linux @@ -105 +99 @@ The default desktop environment for Amazon Linux 2023 is Gnome3 and the default - $ sudo dnf groupinstall 'Desktop' + $ sudo dnf group install "Server with GUI" @@ -118 +112 @@ The default desktop environment for Amazon Linux 2023 is Gnome3 and the default -Ubuntu 20.x, 22.x, and 24.x +SUSE Linux Enterprise 15 @@ -121 +115 @@ Ubuntu 20.x, 22.x, and 24.x -For Ubuntu 20.x/22.x/24.x, the default desktop environment is Gnome3 and the default desktop manager is GDM3. Starting with Ubuntu 20.x, LightDM isn't supported anymore with Amazon DCV. +The default desktop environment for SUSE Linux Enterprise 15 is SLE Classic and the default desktop manager is GDM. @@ -123 +117 @@ For Ubuntu 20.x/22.x/24.x, the default desktop environment is Gnome3 and the def -###### To install and configure the desktop environment and desktop manager on Ubuntu 20.x/22.x/24.x +###### To install and configure the desktop environment and desktop manager on SUSE Linux Enterprise 15 @@ -127,13 +121 @@ For Ubuntu 20.x/22.x/24.x, the default desktop environment is Gnome3 and the def - $ sudo apt update - - $ sudo apt install ubuntu-desktop - -Install GDM3 - - $ sudo apt install gdm3 - - 2. Verify that GDM3 is set as the default desktop manager. - - $ cat /etc/X11/default-display-manager - -The output is as follows. + $ sudo zypper install -t pattern gnome_basic @@ -141 +123 @@ The output is as follows. - /usr/sbin/gdm3 + 2. Verify that GDM is set as the default desktop manager. @@ -143 +125 @@ The output is as follows. -If GDM3 isn't set as the default desktop manager, use the following command to set it as the default. + $ sudo update-alternatives --set default-displaymanager /usr/lib/X11/displaymanagers/gdm @@ -145 +127 @@ If GDM3 isn't set as the default desktop manager, use the following command to s - $ sudo dpkg-reconfigure gdm3 + $ sudo sed -i "s/DEFAULT_WM=\"\"/DEFAULT_WM=\"gnome\"/" /etc/sysconfig/windowmanager @@ -149 +131 @@ If GDM3 isn't set as the default desktop manager, use the following command to s - $ sudo apt upgrade + $ sudo zypper update @@ -177 +159 @@ Amazon DCV 2022.2 and newer are not affected by this issue. -SUSE Linux Enterprise 12.x +Ubuntu 22.04/24.04 @@ -180 +162 @@ SUSE Linux Enterprise 12.x -The default desktop environment for SUSE Linux Enterprise 12.x is SLE Classic and the default desktop manager is GDM. +The default desktop environment for Ubuntu 22.04/24.04 is GNOME and the default desktop manager is GDM. LightDM isn't supported with Amazon DCV. @@ -182 +164 @@ The default desktop environment for SUSE Linux Enterprise 12.x is SLE Classic an -###### To install and configure the desktop environment and desktop manager on SUSE Linux Enterprise 12.x +###### To install and configure the desktop environment and desktop manager on Ubuntu 22.04/24.04 @@ -186 +168,3 @@ The default desktop environment for SUSE Linux Enterprise 12.x is SLE Classic an - $ sudo zypper install -t pattern gnome-basic + $ sudo apt update + + $ sudo apt install ubuntu-desktop @@ -190 +174 @@ The default desktop environment for SUSE Linux Enterprise 12.x is SLE Classic an - $ sudo update-alternatives --set default-displaymanager /usr/lib/X11/displaymanagers/gdm + $ cat /etc/X11/default-display-manager @@ -192 +176,7 @@ The default desktop environment for SUSE Linux Enterprise 12.x is SLE Classic an - $ sudo sed -i "s/DEFAULT_WM=\"\"/DEFAULT_WM=\"gnome\"/" /etc/sysconfig/windowmanager +The output is as follows. + + /usr/sbin/gdm3 + +If GDM isn't set as the default desktop manager, use the following command to set it as the default. + + $ sudo dpkg-reconfigure gdm3 @@ -196 +186 @@ The default desktop environment for SUSE Linux Enterprise 12.x is SLE Classic an - $ sudo zypper update + $ sudo apt upgrade @@ -205 +195 @@ The default desktop environment for SUSE Linux Enterprise 12.x is SLE Classic an -SUSE Linux Enterprise 15.x +###### Note @@ -206,0 +197 @@ SUSE Linux Enterprise 15.x +When using a version of Amazon DCV older than 2022.2 with **Virtual Sessions** , you may run into [a known GDM issue](https://gitlab.gnome.org/GNOME/gdm/-/issues/650). To make virtual sessions work correctly, you can adopt one of the following solutions: @@ -208 +199 @@ SUSE Linux Enterprise 15.x -The default desktop environment for SUSE Linux Enterprise 15.x is SLE Classic and the default desktop manager is GDM3. + * **On servers that do not have a GPU** , you can disable the desktop manager because it's not required to run virtual sessions. Configure the system to run in multi-user mode by running the following command before creating virtual sessions: @@ -210 +201 @@ The default desktop environment for SUSE Linux Enterprise 15.x is SLE Classic an -###### To install and configure the desktop environment and desktop manager on SUSE Linux Enterprise 15.x + $ sudo systemctl isolate multi-user.target @@ -212 +203 @@ The default desktop environment for SUSE Linux Enterprise 15.x is SLE Classic an - 1. Install the desktop environment and the desktop manager packages. + * **On servers with a GPU** , in addition to disabling the desktop manager, you need to start an X server on the system before creating virtual sessions. To do this, run the following commands: @@ -214 +205 @@ The default desktop environment for SUSE Linux Enterprise 15.x is SLE Classic an - $ sudo zypper install -t pattern gnome_basic + $ sudo systemctl isolate multi-user.target @@ -216 +207 @@ The default desktop environment for SUSE Linux Enterprise 15.x is SLE Classic an - 2. Verify that GDM is set as the default desktop manager. + $ sudo dcvstartx & @@ -218 +208,0 @@ The default desktop environment for SUSE Linux Enterprise 15.x is SLE Classic an - $ sudo update-alternatives --set default-displaymanager /usr/lib/X11/displaymanagers/gdm @@ -220 +209,0 @@ The default desktop environment for SUSE Linux Enterprise 15.x is SLE Classic an - $ sudo sed -i "s/DEFAULT_WM=\"\"/DEFAULT_WM=\"gnome\"/" /etc/sysconfig/windowmanager @@ -222 +210,0 @@ The default desktop environment for SUSE Linux Enterprise 15.x is SLE Classic an - 3. Update the software packages to ensure that the Linux server is up to date. @@ -224 +212 @@ The default desktop environment for SUSE Linux Enterprise 15.x is SLE Classic an - $ sudo zypper update +Amazon DCV 2022.2 and newer are not affected by this issue. @@ -226 +214 @@ The default desktop environment for SUSE Linux Enterprise 15.x is SLE Classic an - 4. Reboot the Linux server. +## Disable the Wayland protocol (GDM only) @@ -228 +216 @@ The default desktop environment for SUSE Linux Enterprise 15.x is SLE Classic an - $ sudo reboot +Amazon DCV doesn't support the Wayland protocol. If you're using the GDM desktop manager, you must disable the Wayland protocol. If you aren't using GDM, skip this step. @@ -229,0 +218 @@ The default desktop environment for SUSE Linux Enterprise 15.x is SLE Classic an +Amazon Linux 2/2023 @@ -231,0 +221 @@ The default desktop environment for SUSE Linux Enterprise 15.x is SLE Classic an +###### To disable the Wayland protocol @@ -233 +223 @@ The default desktop environment for SUSE Linux Enterprise 15.x is SLE Classic an -###### Note + 1. Open the `/etc/gdm/custom.conf` file using your preferred text editor. @@ -235 +225 @@ The default desktop environment for SUSE Linux Enterprise 15.x is SLE Classic an -When using a version of Amazon DCV older than 2022.2 with **Virtual Sessions** , you may run into [a known GDM issue](https://gitlab.gnome.org/GNOME/gdm/-/issues/650). To make virtual sessions work correctly, you can adopt one of the following solutions: + 2. In the `[daemon]` section, set `WaylandEnable` to `false`. @@ -237 +227,2 @@ When using a version of Amazon DCV older than 2022.2 with **Virtual Sessions** , - * **On servers that do not have a GPU** , you can disable the desktop manager because it's not required to run virtual sessions. Configure the system to run in multi-user mode by running the following command before creating virtual sessions: + [daemon] + WaylandEnable=false @@ -239 +230 @@ When using a version of Amazon DCV older than 2022.2 with **Virtual Sessions** , - $ sudo systemctl isolate multi-user.target + 3. Restart the GDM service. @@ -241 +232 @@ When using a version of Amazon DCV older than 2022.2 with **Virtual Sessions** , - * **On servers with a GPU** , in addition to disabling the desktop manager, you need to start an X server on the system before creating virtual sessions. To do this, run the following commands: + $ sudo systemctl restart gdm @@ -243 +233,0 @@ When using a version of Amazon DCV older than 2022.2 with **Virtual Sessions** , - $ sudo systemctl isolate multi-user.target @@ -245 +234,0 @@ When using a version of Amazon DCV older than 2022.2 with **Virtual Sessions** , - $ sudo dcvstartx & @@ -247,0 +237 @@ When using a version of Amazon DCV older than 2022.2 with **Virtual Sessions** , +RHEL, CentOS, and Rocky Linux 8/9 @@ -250 +240 @@ When using a version of Amazon DCV older than 2022.2 with **Virtual Sessions** , -Amazon DCV 2022.2 and newer are not affected by this issue. +###### To disable the Wayland protocol @@ -252 +242 @@ Amazon DCV 2022.2 and newer are not affected by this issue. -## Disable the Wayland protocol (GDM3 only) + 1. Open the `/etc/gdm/custom.conf` file using your preferred text editor. @@ -254 +244 @@ Amazon DCV 2022.2 and newer are not affected by this issue. -Amazon DCV doesn't support the Wayland protocol. If you're using the GDM3 desktop manager, you must disable the Wayland protocol. If you aren't using GDM3, skip this step. + 2. In the `[daemon]` section, set `WaylandEnable` to `false`. @@ -256 +246,2 @@ Amazon DCV doesn't support the Wayland protocol. If you're using the GDM3 deskto -###### To disable the Wayland protocol + [daemon] + WaylandEnable=false