Skip to content

MacOS Installation Prerequisites

This topic describes the tasks that you must perform before installing the macOS Agent.

Enable firewall settings

The macOS machine that will act as the PCoIP host must allow PCoIP traffic through its firewall. Firewall settings should be either:

  • The firewall is off, or

  • The firewall is on, and:

    • Automatically allow downloaded signed software to receive incoming connections is checked to allow Anyware Agent Helper access to Mac resources, or

      Automatically allow Incoming Connections

    • Automatically allow downloaded signed software to receive incoming connections is not checked, and the following executables are allowed through the firewall to allow Anyware Agent Helper access to Mac resources:

      • /Applications/PCoIP Agent.app

      • /Applications/PCoIP Agent.app/Contents/MacOS/pcoip-agent

      • /Applications/PCoIP Agent.app/Contents/Resources/pcoip-server.bundle/Contents/MacOS/pcoip-server

      Note: Allowing the Executables Through the Firewall

      If Automatically allow downloaded signed software to receive incoming connections is NOT enabled, you can do EITHER OF THE FOLLOWING:

      .

Allow the executables before installation

  1. Go to System Preferences > Network > Firewall.

  2. Ensure that the firewall is on.

  3. Click Firewall Options.

  4. Click the Automatically allow downloaded signed software to receive incoming connections check box.

  5. Allow incoming connections from Anyware Agent executables:

    a. Click the “+” button and then choose Anyware Agent.app, pcoip-agent, and pcoip-server.

    b. Make sure that the dropdown list value next to them is set to Allow incoming connections.

    Allow Incoming Connections

Energy Saver settings

Energy Saver features can cause the remote system to go to sleep or become unresponsive. To prevent this, open System Preferences > Energy Saver, and configure the settings as follows:

Energy saver settings

Setting Value
Turn off display after set slider to Never
Prevent computer from sleeping automatically when the display is off checked
Put hard disks to sleep when possible unchecked
Wake for network access checked
Start up automatically after power failure checked
Enable Power Nap checked

Create a user account for PCoIP Connections

The user name cannot contain spaces, and cannot be the root user account (the root user is an administrative account with elevated permissions, and is disabled by default in macOS).

Disable FileVault

If the FileVault setting is enabled on the PCoIP host Mac, files on the hard drive are encrypted and subsequently, unauthorized access is prevented. The hard drive remains locked every time the PCoIP host Mac is restarted. Until the hard drive is unlocked, client machines cannot establish PCoIP connections with the PCoIP host.

Therefore, to ensure that the FileVault setting does not prevent PCoIP connection, do one of the following:

  • Unlock the hard drive by providing the user password and then allowing the PCoIP host to boot.
  • Disable FileVault from System Preferences > Privacy & Security on the PCoIP host Mac.

Disabling the FileVault setting