Installing the Graphics Agent for macOS¶

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

Installing Using the Installation Package¶

1. Download the installer to the machine you'll be using as the Anyware host.
2. Run the installer pkg.
3. Click through the installer steps and accept the End User License Agreement. The installation begins.
4. If prompted, allow incoming network connections. This will ensure that Anyware Agent.app, pcoip-agent, and pcoip-server are allowed through the firewall.

5. 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.

6. When prompted, grant the required permissions. A prompt will appear requiring you to grant Screen Recording permission to Anyware Agent Helper. 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 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.

   5. Confirm that Anyware Agent Helper has been granted the required permissions:
   6. Go to System Preferences > Security & Privacy > Screen Recording.
   7. Ensure that screen recording is enabled for Anyware Agent Helper.
   8. Go to System Preferences > Security & Privacy > Accessibility.
   9. Ensure that accessibility is enabled for Anyware Agent Helper.

7. Restart the machine.

Installing Using the Terminal¶

1. Download the installer to the machine you'll be using as the Anyware host.
2. Open a terminal window.

3. 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. 1. Open the Anyware Agent application (Anyware Agent.app), found in /System/Volumes/Data/Applications. 1. 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.

4. Launch Anyware Agent.app to grant the required permissions. A prompt will appear requiring you to grant screen recording permission to Anyware Agent Helper. 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 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.

      

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

   1. Go to System Preferences > Security & Privacy > Screen Recording.
   2. Ensure that screen recording is enabled for Anyware Agent Helper.
   3. Go to System Preferences > Security & Privacy > Accessibility.
   4. Ensure that accessibility is enabled for Anyware Agent Helper.
6. Restart the machine.

Uninstalling the Graphics Agent for macOS¶

1. 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;
   

   1. Uninstall the Graphics Agent by running the following command:

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