Skip to content

Installing GPU Drivers on Linux machines

Before installing the PCoIP Agent, you need to 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 22.07 are shown below. Be sure to install the specified driver, and not the latest available version. Teradici qualifies 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, Teradici does not control these resources or their locations and it's possible that they could break.

Install libglvnd-opengl before proceeding

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

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 14.0 (510.47.03)+ 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 14.0 (510.47.03)+ 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 NVIDIA's recommended driver. 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 GRID 13.1 (470.82.01)+ 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 13.1 (470.82.01)+ 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 14.0 (510.47.03)+ Instructions shown below.

To install NVIDIA driver for all other instances, including non-cloud instances:

  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
    

    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.

Installing the PCoIP Agent

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