Software Client for macOS Administrators' Guide

This section describes how to install and uninstall the Anyware Software Client for macOS.

Before You Begin

Before installing a Anyware Software Client:

  • You must be logged in as an administrator to the client machine.
  • Close any existing Anyware Software Client applications.

Installing the Anyware Software Client

  1. Download the PCoIPClient.dmg disk image file on the Mac machine.

  2. Double-click the file to mount the volume.

  3. Accept the license agreement by clicking Agree.

  4. In the PCoIPClient volume window, drag the PCoIPClient icon into the Applications folder icon to install the program.

  5. To optionally create an alias on the desktop or the dock:

    • Double-click the Applications folder icon to open the folder.
    • Drag the client application to the desktop or dock.
  6. During installation, when prompted, grant the required permissions. A prompt will appear requiring you to grant Screen Recording permission to Anyware Client. The Accessibility prompt appears after you action the Screen Recording prompt.

    1. On the Screen Recording prompt that appears, click Open System Settings.

    2. Go to Privacy & Security, and turn on Screen Recording for Anyware Client.

    3. On the Accessibility prompt that appears, click Open System Settings.

    4. Go to Privacy & Security, and turn on Accessibility for Anyware Client.

  7. Confirm that Anyware Client has been granted the required permissions:

    1. Go to System Settings > Privacy & Security > Screen Recording.
    2. Ensure that screen recording is enabled for Anyware Client.
    3. Go to System Settings > Privacy & Security > Accessibility.
    4. Ensure that accessibility is enabled for Anyware Client.
  8. To eject the volume when you are finished, drag it to the trash.

  9. Restart the machine.

Installing the Software Client in Silent Mode

The following section outlines how to install the Anyware Software Client in silent mode. Note that you must authorize the application to run in silent mode.

Note: Permissions Require GUI

In order to grant Screen Recording and Accessibility permissions, the macOS client machine must display a graphical user interface. During installation, you must launch Anyware Client.app to grant user permissions.

  1. Attach the .dmg file:

    yes | hdiutil attach <pcoip client installer>.dmg 
    
  2. Delete the current Anyware Client:

    rm -R '/Applications/PCoIPClient.app'
    
  3. Install the new Anyware Client:

    cp -R '/Volumes/<pcoip client installer>/PCoIPClient.app' /Applications
    
  4. During installation, when prompted, grant the required permissions. A prompt will appear requiring you to grant Screen Recording permission to Anyware Client. The Accessibility prompt appears after you action the Screen Recording prompt.

    1. On the Screen Recording prompt that appears, click Open System Settings.

    2. Go to Privacy & Security, and turn on Screen Recording for Anyware Client.

    3. On the Accessibility prompt that appears, click Open System Settings.

    4. Go to Privacy & Security, and turn on Accessibility for Anyware Client.

  5. Confirm that Anyware Client has been granted the required permissions:

    1. Go to System Preferences > Security & Privacy > Screen Recording.
    2. Ensure that screen recording is enabled for Anyware Client.
    3. Go to System Preferences > Security & Privacy > Accessibility.
    4. Ensure that accessibility is enabled for Anyware Client.
  6. Unmount the drive afterwards:

    yes | hdiutil unmount <pcoip client installer>
    
  7. Restart the machine.

Uninstalling the Anyware Software Client

  • Navigate to the Applications folder and drag the PCoIPClient program to the trash. -OR- Right-click the application and select Move to Trash.

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.


Last updated: Thursday, July 18, 2024