Installing the Graphics Agent for macOS¶

This topic contains instructions for intalling the Graphics Agent for macOS. Before you proceed, ensure that you performed the necessary prerequisite tasks.

Note: If Prompts Do Not Appear

If you are not prompted for permissions during installation, AFTER the installation completes, launch Anyware Agent.app to prompt for privacy permissions. Anyware Agent.app is available at: /System/Volumes/Data/Applications. For instructions on granting permissions, see Troubleshooting Connection Issues.

Installing Using the Installation Package¶

Download the installer to the machine you'll be using as the Anyware host.
Run the installer pkg.
Click through the installer steps and accept the End User License Agreement. The installation begins.
when prompted, allow incoming network connections. This will ensure that Anyware Agent.app, pcoip-agent, and pcoip-server are allowed through the firewall.
Next, provide the license registration code you received from HP.

Important: This step does not apply for License Server users

If you are using a local License Server, do not follow this step; refer to Licensing the Graphics Agent for macOS.

If you are using Anyware Cloud Licensing, open a terminal window and type one of the following commands, depending on whether your host machine is behind a proxy server:
- If you use a proxy server to access the internet, provide this command (replace <XXXXXX@YYY-YYYY-YYY>, <PROXY_SERVER_ADDRESS>, and <PROXY_PORT_NUMBER> with your own values):
```
sudo pcoip-register-host --registration-code=<XXXXXX@YYY-YYYY-YYY> --proxy-server=<PROXY_SERVER_ADDRESS> --proxy-port=<PROXY_PORT_NUMBER>
```
- If your system does not use a proxy server, provide this command (replace {REGISTRATION_CODE} with your own value):
```
sudo pcoip-register-host --registration-code=<XXXXXX@YYY-YYYY-YYY>
```
If you are using a License Server, refer to Licensing the Graphics Agent for macOS for licensing instructions.
When prompted, allow incoming network connections:
1. On the Screen Recording prompt that appears, click Open System Settings.
2. Go to Privacy & Security, and turn on Screen Recording for Anyware Agent Helper.
3. On the Accessibility prompt that appears, click Open System Settings.
4. Go to Privacy & Security, and turn on Accessibility for Anyware Agent Helper.
Restart the machine.

Installing Using the Terminal¶

Important: Permissions Require GUI

In order to grant Screen Recording and Accessibility permissions, the macOS agent machine must display a graphical user interface.

Download the installer to the machine you'll be using as the Anyware host.
Open a terminal window.
Run the installer using the following command. Replace {PACKAGE_NAME} with the name of the .pkg file you downloaded:
```
sudo installer -pkg {PACKAGE_NAME}.pkg -target /
```
The installer will return a 0 if successful. A return value of anything other than 0 indicates a failure.
Next, provide the license registration code you received from HP Anyware.

Important: This step does not apply for License Server users

If you are using a local License Server, do not follow this step; refer to Licensing the Graphics Agent for macOS.

If you are using Cloud Licensing, type one of the following commands, depending on whether your host machine is behind a proxy server:
- If you use a proxy server to access the internet, provide this command (replace <XXXXXX@YYY-YYYY-YYY>, <PROXY_SERVER_ADDRESS>, and <PROXY_PORT_NUMBER> with your own values):
```
sudo pcoip-register-host --registration-code=<XXXXXX@YYY-YYYY-YYY> --proxy-server=<PROXY_SERVER_ADDRESS> --proxy-port=<PROXY_PORT_NUMBER>
```
- If your system does not use a proxy server, provide this command (replace <XXXXXX@YYY-YYYY-YYY> with your own registration code value):
```
sudo pcoip-register-host --registration-code={REGISTRATION_CODE}
```
If you are using a License Server, refer to Licensing the Graphics Agent for macOS for licensing instructions.
When prompted, allow incoming network connections:
1. On the Screen Recording prompt that appears, click Open System Settings.
2. Go to Privacy & Security, and turn on Screen Recording for Anyware Agent Helper.
3. On the Accessibility prompt that appears, click Open System Settings.
4. Go to Privacy & Security, and turn on Accessibility for Anyware Agent Helper.
Restart the machine.

Note: If Prompts Do Not Appear

If you are not prompted for permissions during installation, launch Anyware Agent.app to prompt for privacy permissions to Anyware Agent Helper. Anyware Agent.app is found at the following location: /System/Volumes/Data/Applications. For instructions, see Screen Recording and Accessibility permissions.

Note: More about Anyware Agent.app

Anyware Agent.app is only used to prompt for privacy permissions to Anyware Agent Helper. You do not need to launch Anyware Agent.app again once permissions have been granted.

Uninstalling the Graphics Agent for macOS¶

Note: Deleting User Granted Permissions

User granted permissions are not be deleted by the uninstaller. You must delete these permissions BEFORE uninstalling the macOS agent.

Run the following commands to delete the user granted permissions:

sudo tccutil reset ScreenCapture com.teradici.pcoip-user-agent;

sudo tccutil reset Accessibility com.teradici.pcoip-user-agent;

Uninstall the Graphics Agent by running the following command:

sudo /Library/Application\ Support/Teradici/pcoip/uninstaller