Graphics Agent for macOS Administrators' Guide

Establishing a Connection from a PCoIP Client

Once you've installed and configured your Graphics Agent for macOS, you're ready to accept incoming connections from remote Anyware Clients. PCoIP clients are remote endpoint devices available in as software or firmware and make secure PCoIP connections to the remote desktop through the installed Graphics Agent for macOS.

Managing Client Connections

In most cases, Anyware clients connect to Anyware agents through a connection broker. The broker is responsible for matching users to their available desktops, and then establishing the PCoIP session with their selected resource.

Anyware agents do not need to be configured to use these brokering services. All relevant configuration is done at the broker, which then communicates with the agent.

Brokering Options

There are several ways you can manage client connections to remote desktops

Direct Connections

In direct connection scenarios—where a broker is not involved—the Anyware agent acts as its own broker. In these cases, a client user will provide the IP address or FQDN of the agent machine to their client, and the connection is made securely with no intermediate step.

Anyware Manager

Anyware Manager is a service, available as a cloud-based service or as an installable instance, that centrally manages PCoIP deployments. It enables highly scalable and cost-effective HP Anyware deployments by managing cloud compute costs and brokering PCoIP connections to remote Windows or Linux workstations.

Connection Manager

The Connection Manager is provided in a bundle with the Security Gateway, and allows self-managed brokering services. For information about the Connection Manager, including installation and configuration instructions, see the Connection Manager and Security Gateway documentation.

Third-party Connection Brokers

Anyware agents also support third-party connection brokers. For a current list of brokering partners, see Technology Partners on the website.

Anyware Agent Deployment and Client Connectivity Requirements

Anyware clients can connect to your desktops hosted in proof-of-concept, cloud, or datacenter deployments. Requirements and network security levels will vary depending on your deployment type. See Supported Anyware Architectures for each deployment's components and requirements.

Note: Access to Clipboard Data

If clipboard redirection is enabled, Anyware agents have access to clipboard data. We recommend that you disable clipboard redirection if you are handling sensitive data.

Additional Information

Information about Anyware client connectivity requirements and usage instructions, is available in the following documentation:

Connection troubleshooting

If you encounter issues while connecting, see the Troubleshooting Connection Issues for fixes to common issues.

Note Note:

Sometimes, if a user disconnects from a PCoIP session during the login process, the macOS agent becomes unresponsive. In this scenario, the macOS agent will reboot the remote machine. To prevent data loss, this reboot behaviour will not occur if users are already logged in. This reboot behaviour is enabled by default. You can disable it by setting the pcoip.enable_restart_if_unconnectable parameter to 0. To see how to configure parameters, see Configuring the macOS Agent.


Last updated: Thursday, July 18, 2024