Graphics Agent for Linux Administrators' Guide

Installing GPU Drivers on Linux machines

Before installing the Anyware Agent, install the correct driver for your configured GPUs. SSH into your machine and then proceed with the installation instructions below.

The correct driver versions for release 24.10 are shown below. Be sure to install the specified driver, and not the latest available version. We qualify Graphics Agent support against the driver versions listed here.

Documentation for download and installation of these drivers is provided by their manufacturers. As a convenience, we've provided the current locations of relevant third-party documentation here. While we do our best to keep these links up to date, we do not control these resources or their locations and it's possible that they could break.

RHEL/Rocky Linux Only: Install `libglvnd-opengl` before proceeding

When using RHEL OR Rocky Linux, install the libglvnd-opengl package before installing the GPU drivers:

sudo yum install libglvnd-opengl

Install NVIDIA GRID Drivers on AWS Instances

Instance Type Supported GPUs Supported NVIDIA GRID driver version Installation instructions
EC2 G4dn NVIDIA T4 GRID 17.2 Download the driver from Amazon using the AWS CLI or SDKs, as documented by Amazon.
G4 instances must also include NVIDIA licensing, as documented by NVIDIA.
EC2 G5 NVIDIA A10G GRID 17.2 Download the driver from Amazon using the AWS CLI or SDKs, as documented by Amazon.
G5 instances must also include NVIDIA licensing, as documented by NVIDIA.

Install NVIDIA Drivers on Physical PCs

Instance Type Supported GPUs Supported NVIDIA driver version Installation instructions
Physical PC
  • Tesla (any)
  • Quadro (k2000+)
 Use the latest 552.55+ driver for your supported GPU Download the driver directly from NVIDIA and follow their instructions to install. You may only have access to this driver if you have purchased a corresponding card.

Install NVIDIA GRID Drivers on Azure NV-series Instances

Instance Type Supported GPUs Supported NVIDIA GRID driver version Installation instructions
Azure NV-series NVIDIA M60, T4 GRID 16.5 Microsoft Azure download

Install NVIDIA GRID Drivers on Google Cloud Instances

Instance Type Supported GPUs Supported NVIDIA GRID driver version Installation instructions
Google Cloud instances NVIDIA P4, P100, T4 GRID 17.x Google Cloud Documentation

Install NVIDIA GRID Drivers on Other Instance Types

Instance Type Supported GPUs Supported NVIDIA GRID driver version Installation instructions
All other instance types GPUs as listed in NVIDIA's GRID release notes. GRID 17.1 Instructions shown below.

Installing NVIDIA Drivers on All Other Instances

For all other instance types, including non-cloud instances, use the following procedures:

Install NVIDIA Drivers on RHEL or Rocky Linux

Install `libglvnd-opengl` before proceeding

Before installing the NVIDIA drivers, install the libglvnd-opengl package:

sudo yum install libglvnd-opengl

  1. Install tools required to install the NVIDIA drivers:

    sudo yum install kernel-devel

  2. Disable the Nouveau video driver (two commands):

    echo 'blacklist nouveau' | sudo tee -a /etc/modprobe.d/blacklist.conf

  3. As a super user (sudo), edit the file /etc/default/grub. Append the following to the GRUB_CMDLINE_LINUX entry:

    rd.driver.blacklist=nouveau nouveau.modeset=0

    For example:

    GRUB_CMDLINE_LINUX="crashkernel=auto console=ttyS0,38400n8 rd.driver.blacklist=nouveau nouveau.modeset=0"

    Generate a new grub configuration to include the above changes, then reboot:

    sudo grub2-mkconfig -o /boot/grub2/grub.cfg 
sudo reboot

  4. Install the NVIDIA driver:

    sudo ./NVIDIA-Linux-x86_64-xxx.xx-grid.run --dkms

    Where xxx.xx is the NVIDIA driver version shown in Linux System Requirements.

    Important: Azure installations require Hyper-V daemon installation

    If you are running on an Azure instance, you also need to install the Azure Hyper-V daemon:

    sudo yum install hyperv-daemons

  5. Respond to the installer prompts as follows:

    • Accept the EULA
    • Say yes to installing 32-bit binaries
    • Say no to modifying the x.org file

  6. Update initramfs using dracut:

    dracut -fv

  7. Verify the NVIDIA installation:

    nvidia-smi

    If the installation was successful, you will see your video card in the response.

Install NVIDIA Drivers on Ubuntu

  1. Install tools required to install the NVIDIA drivers:

    sudo apt install build-essential

  2. Disable the Nouveau video driver (two commands):

    echo 'blacklist nouveau' | sudo tee -a /etc/modprobe.d/blacklist.conf

  3. As a super user (sudo), edit the file /etc/default/grub. Append the following to the GRUB_CMDLINE_LINUX entry:

    rd.driver.blacklist=nouveau nouveau.modeset=0

    For example:

    GRUB_CMDLINE_LINUX="crashkernel=auto console=ttyS0,38400n8 rd.driver.blacklist=nouveau nouveau.modeset=0"

    Generate a new grub configuration to include the above changes, then reboot:

    sudo grub2-mkconfig -o /boot/grub2/grub.cfg 
sudo reboot

  4. Install the NVIDIA driver:

    sudo ./NVIDIA-Linux-x86_64-xxx.xx-grid.run --dkms

    Where xxx.xx is the NVIDIA driver version shown in Linux System Requirements.

  5. Respond to the installer prompts as follows:

    • Accept the EULA
    • Say yes to installing 32-bit binaries
    • Say no to modifying the x.org file

  6. Verify the NVIDIA installation:

    nvidia-smi

    If the installation was successful, you will see your video card in the response.

Installing the Anyware Agent

Once the NVIDIA drivers are present, you can install the Graphics Agent for Linux.

Last updated: Wednesday, November 20, 2024