Security Guide

PCoIP requires a certificate to establish a session. The Graphics Agent for macOS generates a self-signed certificate that secures the PCoIP session. Each component in the Anyware system can generate these self-signed certificates, which will automatically work together without requiring any configuration.

The Graphics Agent for macOS does not support creating custom certificates.

Overview

About the Graphics Agent for macOS

This guide is intended for administrators who are deploying the Graphics Agent for macOS as part of HP Anyware. It assumes thorough knowledge of macOS conventions and general networking concepts, including firewall configuration.

The Graphics Agent for macOS is part of HP Anyware. It enables users to deliver GPU-powered physical workstations to end users via remote clients.

Finding your Agent Version Number

Finding the Graphics Agent for macOS Version Number

To find the installed version number of the Graphics Agent for macOS, open a Terminal window and run the following command:

sudo grep "Software Build ID" /var/log/pcoip-agent/agent.log

The command output will contain your installed version.

Creating a Support File

Creating a Technical Support File

We may request a support file from your system in order to troubleshoot and diagnose issues. The support file is an archive containing Anyware Graphics Agent for macOS logs and other diagnostic data that can help support diagnose your problem.

What's New in This Release

The 25.03 release of the Graphics Agent for macOS fixes known issues, bugs and stability enhancements for a better user experience and seamless support. In addition, it includes the following feature:

Changes to macOS Support

macOS 15 Sequoia is currently in tech preview for Anyware Graphics Agent. Consult the release notes for known issues while running Anyware Agent on macOS 15.

Updating the Agent

Updating the macOS Graphics Agent

To update the Graphics Agent for macOS to a new version, obtain the new installer and run it in place to replace the older version. Your configuration settings will be preserved.

Note: About Permissions

Prerequisites for Installation

Prerequisites for Installation

Before you begin, make sure that you perform the following tasks.

Configure Energy Settings

Energy Saver features in Sequoia can cause the remote system to go to sleep or become unresponsive.

To prevent this, do the following:

Licensing the Agent

Licensing The Agent

The Graphics Agent for macOS must be assigned a valid PCoIP session license before it will work. Until you've registered it, you can't connect to the desktop using a Anyware client.

You receive a registration code when you purchase a pool of licenses from HP. Each registration code can be used multiple times; each use consumes one license in its pool.