Installing the PCoIP Software Client for Linux¶
To install the PCoIP Software Client for Linux:
-
Install the Software Client for Linux repository. A shell script to install this is here.
Teradici Distribution Platform
Teradici's distribution platform has recently changed. The new system requires access to the dl.teradici.com subdomain. The old system, which used downloads.teradici.com, is deprecated and will be decommissioned in the future.
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.
-
Install the PCoIP Software Client for Linux:
sudo apt update sudo apt install pcoip-client
- Launch the pcoip-client to create default configuration files and then quit the client.
The reference section also has information on Disabling the Virtual Terminal Functionality and configuring Linux Keyboard Shortcuts.
To install the PCoIP Software Client for CentOS (Technical Preview)
Support for CentOS is currently in Technical Preview.
The following command installs the PCoIP Software Client for CentOS:
sudo yum install pcoip-client
Kernel Network Configuration¶
The pcoip-configure-kernel-networking.sh
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:
sudo pcoip-configure-kernel-networking --persistent
rmem_max
: A kernel parameter that controls the maximum size of receive buffers used by sockets.rmem_default
: A kernel parameter that controls the default size of receive buffers used by sockets.ipv4.udp_mem
: A kernel parameter that controls the maximum total buffer-space to allocate.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¶
The following section outlines how to install the PCoIP Software Client in silent mode. Please note that you must authorize the application to run in silent mode. The following commands outline how to install the PCoIP Software Client on Ubuntu in silent mode:
- Ubuntu Client:
sudo apt install -y <pcoip-client deb package>