Disabling Wayland and GPU Rendering for SanerNow Remote Access on Linux

Overview:
SanerNow Remote Access does not currently support the Wayland Display Server, which replaces the X Window System (X11). Many newer Linux distributions use Wayland by default.

Operating System:
Linux

Applicable Platform:

• On-Cloud Deployment

• On-Premises Deployment

Disabling Wayland on Linux

To ensure compatibility with SanerNow Remote Access, follow these steps to disable Wayland:

Step 1: Open the Wayland Configuration File

Use one of the following commands to open your distribution’s Wayland configuration file:

sudo nano /etc/gdm3/custom.conf

or

sudo nano /etc/gdm/custom.conf

Step 2: Edit the Configuration File

1. Modify the file with sudo/root privileges using your preferred text editor.

2. Locate the following line:

   #WaylandEnable=false

3. Remove the # symbol to uncomment the line, changing it to:

   WaylandEnable=false

4. Save the file and exit the editor.

Step 3: Reboot the System

For the changes to take effect, reboot your system:

sudo reboot

Note:

• Setting WaylandEnable=false forces your system to use X11 instead of Wayland.

• To enable the Wayland Display Server again, change WaylandEnable=false back to WaylandEnable=true.

Disabling GPU Rendering and Acceleration

If needed, you can disable GPU rendering and acceleration when launching Remote Assist.

Launch Remote Assist with GPU Disabled

Use one of the following command-line flags:

/opt/jc_user_ro/jumpcloud-remote-assist/jumpcloud-remote-assist --no-sandbox

OR

/opt/jc_user_ro/jumpcloud-remote-assist/jumpcloud-remote-assist --disable-gpu --disable-software-rasterizer

Launch Remote Assist from TTY Console

1. Switch to the TTY console.

2. Navigate to the Remote Assist directory:

   cd /opt/jc_user_ro/jumpcloud-remote-assist

3. Run the launcher script:

   ./jc-raa-launcher.sh

Following these steps ensures that SanerNow Remote Access runs optimally on your Linux system without conflicts from Wayland or GPU acceleration.