Install Tehama Client on Mac
Latest available Tehama Client versions for Mac:
- Version 2.5.1 (Stable): Single install for Tehama Client + PCoIP Client.
- Version 3.1.0 (Beta): Dual install for Tehama Client and Session Client (HP Anyware Client).
Downloaded from: the Tehama Web UI, current release or beta version
Supported macOS versions: Minimum macOS version: Mojave
This guide contains instructions for installing the Tehama Client on your Mac device. Follow the instructions based on the version you're installing.
Table of Contents
- Before You Begin - Uninstall any old version
- Download and Install Tehama Client v2.5.1 (Stable)
- Download and Install Tehama Client v3.1.0 (Beta)
- Configure Permissions (for both versions)
- Postinstallation Issues/Enhancements
- Extended Number Pad Not Working
- Mac Control vs Command in Tehama Windows Desktop
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:
- Open your Applications folder.
- Locate any of the following applications:
- Tehama
- Tehama PCoIP Client
- HP Anyware Client
- Teradici PCoIP Client
- Drag each application to the Trash.
- Empty the Trash to permanently remove the applications.
- Remove any residual client applications from your device's Accessibility settings:
- Open System Preferences.
- Click on Security & Privacy.
- Go to the Privacy tab.
- Select Accessibility from the sidebar menu.
- Click the lock icon to make changes (you will need to provide authorization).
- Look for any of the following in the list:
- applet
- Tehama
- PCoIPClient
- HP Anyware Client
- If found, select them and click the Minus (-) button to remove them.
- Click the lock icon to prevent further changes.
- Restart your device.
Note: Failure to uninstall old clients may cause conflicts during installation.
Download and Install Tehama Client v2.5.1 (Stable)
Step 1: Download the Client
- Log in to the Tehama Web UI.
- Go to the DESKTOPS page.
- Click on the INSTALL CLIENT button in the top right of the page.
- Click on the download link next to the Apple symbol.
- Wait for the
tehama_pcoip_client.dmg
file to be downloaded to your Downloads folder.
Step 2: Install the Tehama Client v2.5.1
- Go to your Downloads folder.
- Double-click on
tehama_pcoip_client.dmg
. - Read through the SOFTWARE LICENSE AGREEMENT.
- Click on Agree to accept the agreement and proceed.
- A dialog appears instructing you to "Drag and drop both apps into Applications folder to install".
- Drag the Tehama.app icon into the Applications folder icon.
- Drag the PCoIPClient.app icon into the Applications folder icon.
- Dismiss the dialog.
Download and Install Tehama Client v3.1.0 (Beta)
Step 1: Download the Tehama Client
- Log in to the Tehama Web UI.
- Go to the DESKTOPS page.
- Click on the INSTALL CLIENT button in the top right of the page.
- Click on the download link next to the Apple symbol.
- Wait for the
tehama_pcoip_client.dmg
file to be downloaded to your Downloads folder.
Step 2: Install the Tehama Client
- Go to your Downloads folder.
- Double-click on
tehama_pcoip_client.dmg
. - Read through the SOFTWARE LICENSE AGREEMENT.
- Click on Agree to accept the agreement and proceed.
- Drag the Tehama.app icon into the Applications folder icon.
- Dismiss the dialog.
Step 3: Install the Session Client
After installing the Tehama Client, on your first attempt to connect to a Tehama Desktop, you will be prompted to install the Session Client (HP Anyware Client).
- If you choose Yes, the Session Client installation will start. Follow the instructions to complete the installation.
- If you choose No, you will not be able to connect to a desktop until the Session Client is installed. You can either:
- Retry the connection and choose Yes when prompted again.
- Install the Session Client manually from the Help menu by selecting Install Session Client.
Note: If you do not have administrative rights, a system administrator will need to install both the Tehama Client and the Session Client for you.
Configure Permissions (for both versions)
This step configures the Client permissions needed to ensure that peripherals, like your keyboard and mouse, function properly with your Tehama Desktop.
If you intend to use an extended keyboard with your Tehama Desktop, you may also need to configure additional Client permissions by following the instructions in the section "Extended Number Pad Not Working" after you have finished this step.
- Open your browser, if it is not already open.
- Log in to the Tehama Web UI, if you are not already logged in.
- Navigate to the DESKTOPS page.
- Locate your Tehama Desktop in the list of desktops.
- Click on the CONNECT button to connect to your desktop.
- After your desktop has finished preparing, a message will appear asking if you want to "Open Tehama.app?".
- Click on Open Tehama.app.
- You should see a prompt stating that "'applet' would like to control this computer using accessibility features".
- Click on Open System Preferences.
- The Security & Privacy window will open to the Accessibility section.
- Ensure that applet is listed and that the checkbox next to it is selected. If not, select the checkbox.
- Click the lock icon to prevent further changes.
- Restart your Tehama Desktop session (close and reconnect).
Note: This configuration only takes effect the next time you connect to your Tehama Desktop.
Postinstallation Issues/Enhancements
After you have installed the Tehama Client, you should be able to launch and use your Tehama Desktop.
This section describes how to solve issues some users may experience with the Tehama Client on Mac.
This section also contains Tehama Client configuration enhancements, like how to remap the behavior of Command+C/V to be the same in your Mac device and on your Tehama Windows Desktop.
Extended Number Pad Not Working
The Tehama Client allows you to use your peripheral devices with it, so you can get the most out of your Tehama Desktop.
An important peripheral device is an extended keyboard, a keyboard with a number pad. A small number of Tehama Desktop users may need to run through the following instructions to configure additional Client permissions in order to use this peripheral with the Client on their Mac devices.
It is assumed that you have already installed the Client, following the instructions in the Installation Workflow.
- Add PCoIPClient into your Accessibility list, and ensure everything is checked:
- Open System Preferences.
- Click on Security & Privacy.
- Go to the Privacy tab.
- Select Accessibility from the sidebar menu.
- Click the lock icon to make changes (you will need to provide authorization).
- Click on the Plus (+) button to add a new application.
- Navigate to your Applications folder.
- Select the PCoIPClient application.
- Click Open. The PCoIPClient application will now be in the Accessibility list.
- Ensure that the checkbox next to PCoIPClient is selected.
- Click the lock icon to prevent further changes.
- Connect to your Tehama Desktop to try it out. (If you have an open Desktop session, close it and reconnect.)
- Try pressing the Clear key once when you are inside a Tehama Windows Desktop, to verify that you can now use the extended keyboard.
Mac Control vs Command in Tehama Windows Desktop
By default, the keyboard is mapped to align with the operating system you are using. For example, if you use Tehama Windows Desktops from a MacBook, due to the difference between Windows and macOS on their control/command keys, your experience will be as follows:
- When you are inside the Tehama Windows Desktop, Control+C/V is used for copy/paste.
- When you are on your local MacBook, Command+C/V is used for copy/paste.
If you would like to remap this experience to use Command+C/V for both macOS and Tehama Windows Desktop, please do the following:
- Open Terminal on macOS.
- Run the following command lines one by one in Terminal:
defaults write "com.teradici.Teradici PCoIP Client" mac_capture_all_keys 0
defaults write "com.teradici.Teradici PCoIP Client" mac_system_shortcut_capture 0
defaults write "com.teradici.Teradici PCoIP Client" remap_cmd_to_ctrl 1
- The last line ensures the 'Command' key maps to the 'Ctrl' key on your Tehama Windows Desktop.
- Connect to your Tehama Desktop to try it out. (If you have an open Desktop session, close it and reconnect.)
Now, you should be able to use Command+C/V for copy/paste operations both on your Mac and inside the Tehama Windows Desktop.