Skip to content

Installing the PCoIP Software Client for Linux

To install the PCoIP Software Client for Linux:

  1. Install the Software Client for Linux repository, using the script on our download site.

    teradici-repo Package

    If you do not install the teradici-repo package then you will not be able to successfully install the PCoIP Software Client. You may be experiencing this issue if you see an error message stating Unable to locate pcoip-client. Please ensure you download and install the repo.

  2. Install the PCoIP Software Client for Linux: ```$ sudo yum install pcoip-client

    3. Launch the _pcoip-client_ to create default configuration files and then quit the client.
    
    Refer to the reference section for additional information, such as [Disabling the Virtual Terminal Functionality](../reference/disabling_virtual_terminals.md) and configuring [Linux Keyboard Shortcuts](../reference/linux_keyboard_shortcuts.md).
    
    ## Kernel Network Configuration
    The <code>pcoip-configure-kernel-networking.sh</code> script is installed with the PCoIP Software Client for Linux. This script tunes the kernel networking configuration to facilitate the network performance required by the Client. You need to run this script after installing the PCoIP Software Client for Linux.
    
    Run the following command:
    
    ``` bash
    sudo pcoip-configure-kernel-networking --persistent
    
    The script contains the following parameters:

  3. rmem_max: A kernel parameter that controls the maximum size of receive buffers used by sockets.

  4. rmem_default: A kernel parameter that controls the default size of receive buffers used by sockets.
  5. ipv4.udp_mem: A kernel parameter that controls the maximum total buffer-space to allocate.
  6. netdev_max_backlog: A kernel parameter that controls the maximum size of the receive queue.

rmem_max size

This parameter must be at least as large as rmem_default/

The values of these parameters can be viewed on the command line when the script is run, as outlined in the example below:

# cat /etc/sysctl.d/01-pcoip-client.conf
net.core.rmem_max = 32000000
net.core.rmem_default = 32000000
net.ipv4.udp_mem = 1000000 2000000 4000000
net.core.netdev_max_backlog = 2000

Troubleshooting PCoIP Session Connection Issues

If you encounter issues with your PCoIP Session, please see the following KB article: https://help.teradici.com/s/article/1027. This article details some potential causes and fixes for common connection issues.

Installing the Software Client in Silent Mode

To install the Software Client for Linux in silent mode, use the following command:

sudo apt install -y <pcoip-client deb package>