Skip to main content

Reference articleInstall Tehama Client on Linux

  • Updated

Install Tehama Client on Linux (Ubuntu)

Latest available Tehama Client versions for Linux:

  • Ubuntu 18.04: Stable client available (v2.5.1)
  • Ubuntu 20.04: Stable and Beta clients available (v2.5.1 and v3.1.0 Beta)
  • Ubuntu 22.04: Beta client available (v3.1.0 Beta)

Downloaded from: the Tehama Web UI, current release or beta version

Supported Linux versions: Ubuntu 18.04, 20.04, and 22.04

This guide contains instructions for installing the Tehama Client on Ubuntu devices. Follow the instructions based on the version you're installing.

Table of Contents

Before You Begin - Uninstall any old version

Before installing the Tehama Client, it is strongly recommended that you uninstall any previously installed versions, including:

  • Tehama Client
  • Tehama PCoIP Client
  • HP Anyware Client
  • Teradici PCoIP Client

To uninstall any of these, use the following steps:

Client Version 2 or earlier

    1. Open a terminal.
    2. In the terminal, remove the Client with the following command (use a wildcard to target any version):
sudo apt remove tehama_pcoip_client_ubuntu*

Client Version 3 or higher

    1. Open a terminal.
    2. Create and run a script to fully remove the Client:
      1. Navigate to your home directory, type: cd ~
      2. Create the script, type: sudo vi remove-tehama.sh
      3. In insert mode, paste the script below, then write/quit:

#!/bin/bash

# Check if the script is run as root
if [[ $EUID -ne 0 ]]; then
  echo "This script must be run as root"
  exit 1
fi

sudo apt -y remove tehama-pcoip-client
sudo apt -y remove pcoip-client
sudo apt -y autoremove

cd ~

sudo rm -rf TehamaLogs

cd .config
sudo rm -rf tehama
sudo rm -rf TehamaPCoIPClient
sudo rm -rf Teradici
    1. Make the script executable, type: sudo chmod +x remove-tehama.sh
    2. Run the script, type: sudo ./remove-tehama.sh

Download and Install Tehama Client v2.5.1 (Stable)

Step 1: Download the Client

  1. Log in to the Tehama Web UI.
  2. Go to the DESKTOPS page.
  3. Click on the INSTALL CLIENT button in the top right of the page.
  4. Click on the download link next to the Linux symbol for Ubuntu 18.04 or 20.04:
    • For Ubuntu 18.04: tehama_pcoip_client_ubuntu18.deb
    • For Ubuntu 20.04: tehama_pcoip_client_ubuntu20.deb
  5. Wait for the .deb file to be downloaded to your Downloads folder.

Step 2: Install the Tehama Client v2.5.1

    1. Open a terminal.
    2. Go to your Downloads folder with the following command:
cd ~/Downloads
    1. Install the Client with the following command:
sudo apt install ./tehama_pcoip_client_ubuntu20.deb

Note: If a process has dpkg locked, the .deb file will not install. Ensure all system updates are complete and dpkg is not running.

  1. Wait for the Software License Agreement and accept it by entering Y.
  2. When the installation is complete, you will see a success message.

Download and Install Tehama Client v3.1.0 (Beta)

Step 1: Download the Client

  1. Log in to the Tehama Web UI.
  2. Go to the DESKTOPS page.
  3. Click on the INSTALL CLIENT button in the top right of the page.
  4. Click on the download link next to the Linux symbol for Ubuntu 20.04 or 22.04:
    • For Ubuntu 20.04: tehama_pcoip_client_ubuntu20.deb
    • For Ubuntu 22.04: tehama_pcoip_client_ubuntu22.deb
  5. Wait for the .deb file to be downloaded to your Downloads folder.

Step 2: Install the Tehama Client v3.1.0 Beta

    1. Open a terminal.
    2. Go to your Downloads folder with the following command:
cd ~/Downloads
    1. Install the Client with the following command:
sudo apt install ./tehama_pcoip_client_ubuntu20.deb

Note: If a process has dpkg locked, the .deb file will not install. Ensure all system updates are complete and dpkg is not running.

  1. Wait for the Software License Agreement and accept it by entering Y.
  2. When the installation is complete, you will see a success message.

Step 3: Install the Session Client

After the Tehama Client is installed, you can install the Session Client (HP Anyware Client) in one of two ways:

  1. When you first attempt to connect to a desktop, you will be prompted to install the Session Client.
  2. Alternatively, you can manually install the Session Client at any time by navigating to the Help menu in the Tehama Client and selecting Install Session Client.

Note: If you decline to install the Session Client during a connection attempt, you will need to install it before you can connect to a desktop.

Note for non-admin users: Users without admin rights will need a system administrator to install both the Tehama Client and the Session Client.

Related articles