Release Notes

Graphics Agent for macOS 25.03.0

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. 

Resolved Issues

Session can now be established to macOS agent when pcoip.allow_lossy_hid_reports is enabled

25.03.0
231343

The issue has been resolved.

Collaborator with H264 hardware decode enabled can now join the session when the session owner's client has hardware decode disabled

25.03.0
220225

The issue has been resolved.

Known Issues

Connection Fails when Broker Certificate Serial Number is 0

New
241199

If you are using Anyware Clients version 25.03, brokered connections will fail if the broker certificate includes serial number zero (0). 
Note: While certificates from GoDaddy have been identified to exhibit this issue, other certificate providers may also be affected. 

Workaround:

If you experience connectivity issues in brokered connections, downgrade the Anyware Client and Anyware Agent to version 24.10.

Active Directory password change is not supported on macOS agent

233873

When the Active Directory password has expired and prompted for a change at local login on a mac, the password change is not replicated to the Active Directory server.

Workaround:

Use other means to update the Active Directory password.

Clipboard and Remote Printing not available in first PCoIP session after a macOS agent reboot.

New
236081

Clipboard and Remote Printing functionality will be unavailable in very first PCoIP connection to a remote macOS agent after reboot (i.e. the PCoIP connection that logs the user in).

This issue affects macOS Sonoma and Sequoia.

Workaround:

Disconnect and then reconnect. Full Clipboard and Remote Printing functionality will be restored in subsequent PCoIP sessions.

Active Directory password change is not supported on macOS agent

 
233873

When the Active Directory password has expired and prompted for a change at local login on a mac, the password change is not replicated to the Active Directory server.

Workaround:

Use other means to update the Active Directory password.

Windows photo background can increase bandwidth usage

 
232870

When dragging a window over a complex photographic windows background this can interfere with efficient PCoIP encoding causing more bandwidth usage and delay than necessary.

Workaround:

Disable the windows background by setting it to a solid color like black. Follow the session planning guide OS optimization recommendations documented here: https://anyware.hp.com/web-help/pcoip/sessionplanningguide/2024.10/optimization/application-os-optimization/

Topology Changes Disconnect first PCoIP Session after a Sequoia macOS Agent Reboot

New
231646

Following the reboot of a Sequoia macOS agent, the first PCoIP connection disconnects if topology changes such as client window resizing or screen switching occur during session. 

This issue affects agents running on macOS Sequoia only.

Workaround:

Do one of the following to fix the issue: 

  • When connected to macOS Sequoia agents, do not resize the client window during the first session after agent reboot.
  • To start the client session in full screen mode, ensure that you disconnect the previous session (before agent reboot) in the full screen mode.
  • If you are disconnected due to topology changes, connect to the agent again.

Note that this issue is only observed in the first PCoIP session after a macOS Sequoia agent is rebooted. Topology functions normally in subsequent sessions.

macOS Agent attached displays will not be restored if a user logs out during a PCoIP session

New
226435

The Anyware macOS agent will disable any connected display when accessed remotely via PCoIP. This is a privacy feature. The displays are restored when the user disconnects their PCoIP session.

However, if the user logs out (via the Apple Menu option or other means) then the displays will not be restored correctly and will not be available until the macOS agent computer is rebooted.

Workaround:

Always disconnect the PCoIP session via the PCoIP Client menu option. If the remote agent is being shared by multiple users then it is better for users to reboot the remote computer via the Apple menu option when they have finished using the remote agent as this will disconnect their PCoIP session and ensure connected displays are restored.

Attempting to "install" macOS Anyware Agent from an image (e.g. time machine) may prevent the computer from booting

New
225896

macOS Anyware Agent must be installed from the install package (.pkg) directly onto the target computer. Attempting to install the macOS Anyware Agent on a new computer (where it has never been installed before) using a machine image from a different machine that contains the macOS Anyware Agent may result in the computer failing to boot.

Workaround:

Install the macOS agent directly onto the target system rather than including in a system backup or cloned image.

First Connection After Reboot Might Fail When Login Animation is Enabled on macOS Sonoma 14.5

 
222370

Sometimes, the first connection attempt after rebooting the macOS agent on macOS Sonoma version 14.5 might fail. This is due to a problem with the Anyware login animation that is displayed briefly when the macOS agent logs the user in.

Workaround:

Disable login animation by setting pcoip.enableloginanimation to 0. Consult the Graphics Agent for macOS Administrators' Guide for more information.

Internal Users Cannot Generate Collaboration Invitation URLs for External Users

 
206912

Internal users connected to PCoIP sessions using internal addresses cannot generate collaboration invitation URLs that external users can access, as the URLs contain internal addresses.

Workaround:

Use a FQDN that can be accessible by both the internal and external users. The FQDN can map to an internal address for internal users, and external address for external users.

Switch User Is Not Supported on macOS Agents

 
196137

Graphics Agent for macOS only supports a single logged in user. The ability to switch between multiple logged in users is not supported.

Workaround:
  • Wait until the first user logs out before having another user log in.
  • Ask the first user to click "switch user". This will cause their PCoIP session to disconnect. The second user can then attempt to connect via PCoIP. This will fail on the first connection attempt but then can succeed on the second attempt.

Cannot Install or Upgrade macOS Agent when Users are Logged On

 
193967

macOS Graphics Agent cannot be installed or upgraded when one or more users are logged on to the host machine. An attempt at installation or upgrade fails and an error message is displayed.

Workaround:

Do the following:

  1. Verify that users are not logged on to the macOS host machine.
  2. Install or upgrade the macOS Graphics Agent.

Mobile Account Creation Dialog Disappears from Remote Session

 
193570

While conducting first-time login on a MacOS Host that requires the "Mobile Account Creation" dialog, that dialog may disappear from the remote screen and become visible on a locally attached monitor if left without interaction for several seconds.

Workaround:

To get the "Mobile Account Creation" dialog window to re-appear on the remote screen, change the display settings by switching from windowed to full screen, or vise-versa, which should re-acquire the dialog window.

Switch User Accounts When Collaboration is Enabled Does Not Work

 
190476

When Collaboration is enabled on a macOS Graphics Agent, attempting to log in using a different user account results in the the PCoIP session getting disconnected.

Workaround:

Reboot macOS Graphics Agent host before attempting to switch user accounts when Collaboration enabled.  Failing to do so will result in all users being unable to login remotely until the host is rebooted.

PCoIP Ultra GPU Offload on macOS Graphics Agents has Low Framerate Performance

 
186963

When PCoIP Ultra GPU Offload __ is enabled on macOS Graphics Agents, low framerate performance is observed.

Workaround:

Do either of the following:

  • Enable PCoIP Ultra CPU Offload.
  • OR -
  • Disable PCoIP Ultra.

For more information, see the [masOS Graphics Agent Administrators' Guide](PCoIP Graphics Agent for macOS (teradici.com))

macOS Graphics Agent does not support rotated displays

 
178290

If a rotated display is requested in Full Screen One Monitor or Full Screen All Monitors mode, the macOS Graphics Agent disconnects.

Workaround:
  • To fix this issue, do not rotate displays on the client machine.

Slow Topology Configuration for Irregularly sized Client Displays

 
177363

If the client machine is operating in the Full Screen All Monitors mode with multiple local monitors, such that one of the monitors has an irregularly sized display, then topology changes might occur slowly.

Workaround:
  • Scale the irregular sized display to a resolution that is divisible by 4 in both the dimensions.

Issues with Local Display of the MacBook Pro on Session Termination

 
170956

When a PCoIP session between a macOS Graphics Agent and a MacBook Pro is terminated by logging off, the local display on the MacBook Pro might not get enabled.

Workaround:

Connect to the MacBook Pro with an Anyware Client. 

# DO NOT log off from the session. Instead, disconnect from the PCoIP session by using the Disconnect option from the client menu.

If this does not work, reboot the MacBook Pro.

Resizing collaboration session window causes crash

 
165911

Re-sizing the PCoIP Client window while participating in a PCoIP Ultra Collaboration session may cause the PCoIP client to crash.

Workaround:

Avoid re-sizing client window size while participating in a PCoIP Ultra Collaboration session.

If this occurs, re-start the collaboration session by sending a new invitation to the Guest Collaborator.

Cursor artifacts may appear if collaborator client window is resized

 
165332

When the collaborator client window is resized, cursor artifacts may be seen on the collaborator client momentarily.

Workaround:

Once the resizing settles, the artifacts will disappear.

Wacom tablets can span unusable local displays from an Apple Silicon macOS agent

 
161561

When connecting a Wacom tablet to a remote Apple silicon-based Mac, and when the host machine has a physical display that is not disabled, a mismatch can occur in the mapping of the locally rendered cursor to the remote cursor. This can cause the Wacom tablet to span all displays, including unusable local displays.

Workaround:

On the remote machine, open up System Preferences and navigate to the Wacom Tablet page. Under the Mapping settings for the pen tool, change the Screen Area option from Full to the desired local screen. Note that the displays attached to the remote will be arranged below and to the right of local displays. !Screen Shot 2022-07-19 at 1.17.02 PM.png|thumbnail!

Upgrading Graphics Agent for macOS remotely can lose mouse input

 
156881

When upgrading PCoIP Graphics Agent for macOS through a remote PCoIP session, input from the user's mouse can be interrupted making it difficult to click the close button on the installer or restart the macOS machine.

Workaround:

Mouse input can be restored by disconnecting the PCoIP session and reconnecting.

Collaborator may not see the remote cursor when first connected

 
154011

When a guest collaborator connects to the host's session, the host's cursor may not be visible to the guest until it moves.

Workaround:

The host collaborator should move their cursor. This will update its position and cause the cursor to appear in the guest collaborator's client.

Users must enter their password twice

 
147850

When establishing a PCoIP connection to a macOS agent, the user provides their username and password in the PCoIP client. Once connected, the user is shown the macOS lock screen, which requires them to provide their password a second time.

Workaround:

Unlock the desktop by entering the correct password.

Multi-channel audio deteriorates after switching from wired to wireless network

 
145191

When a session started with a wired connection is switched to a wireless network, the multi-channel audio quality deteriorates. The audio quality does not improve after switching back from the wireless network to a wired connection.

Workaround:

Disconnect the session and reconnect after switching to a wireless network.

Timezone not automatically updated when connecting to a macOS system

 
140017

The remote macOS system does not automatically update its time zone to match the client's location.

Workaround:

Manually set the timezone on the remote macOS system.

macOS clear key not supported

 
138619

The macOS clear key cannot be sent to PCoIP agent

Workaround:

Use other keys or mouse input to clear text field input

macOS Modifier Keys Might Stick on macOS Graphics Agents

 
134413

Sometimes, the Command, Control, or the Option key might stick on macOS Graphics agents, leading to incorrect keystrokes or mouse events.

Workaround:
  • To fix this issue, press and then release the Command, Control, and Option keys sequentially.

Horizontal scroll is not supported

 
134364

Using a horizontal scroll wheel on a mouse or a horizontal gesture on a trackpad has no effect.

Workaround:

Left-click on a scroll bar to drag the viewport to the desired location.

Interrupted sessions do not automatically reconnect

 
134341

If a network interruption of greater than 60 seconds occurs during a PCoIP session to the PCoIP Graphics Agent for macOS, a dialog will appear indicating the session is reconnecting, but the connection is never restored.

Workaround:

Disconnect the PCoIP session, and start a new connection.

Some multiple-key combinations are not sent to the remote system

 
134327

Certain key combination, such as ctrl+arrow, are not sent correctly to the remote system.

Workaround:

Use the mouse and menus for operations where keyboard shortcuts do not work. Please report keyboard shortcut problems by opening a ticket at help.teradici.com!

Connection failures

 
134318

Occasionally, a user may not be able to connect to a remote macOS agent.

Workaround:

Review the Troubleshooting Connection Issues section in the admin guide.

 

Additionally, rebooting the remote macOS system may resolve connection issues.

If rebooting does not restore remote connectivity then re-install the PCoIP Agent and re-confirm all required settings.

macOS firewall settings can prevent PCoIP connections

 
134315

The remote and client machines must be able to reach one another. If the firewall blocks network messages then a connection will not be established.

Workaround:

The remote and client machines must be able to reach one another. For both machines, the firewall must either be off, or, if the firewall is on, the following conditions must be set:

  • Automatically allow downloaded signed software to receive incoming connections* is checked, or
  • On the remote machine, Automatically allow downloaded signed software to receive incoming connections is not checked, and the following executables are allowed through the firewall:
  • /Applications/PCoIP Agent.app
  • /Applications/PCoIP Agent.app/Contents/MacOS/pcoip-agent
  • /Applications/PCoIP Agent.app/Contents/MacOS/pcoip-server   The Automatically allow downloaded signed software to receive incoming connections setting is in System Preferences > Security & Privacy, under the Firewall tab. Click Firewall Options to reveal it. The Firewall Options button is only visible if the firewall is on.

Only one user can be logged in at a time

 
134307

PCoIP connections will be denied if another user is already logged into the remote machine (for example, via the remote machine's user interface). This is true whether the logged-in user is using PCoIP or not.

Workaround:

In order to ensure a remote user can log in, make sure all other users are logged out.

Cannot type into local client spotlight search

 
133955

In a PCoIP session using a PCoIP Client for macOS and a PCoIP Agent for macOS, and while the client is in focus, all keystrokes are sent to the remote system. Since Spotlight does not take focus when invoked, it will not receive keystrokes while the PCoIP client is in use.

Workaround:

Switch focus to the client computer by either switching applications, or by minimizing the PCoIP client.

Multi-media keys don't function on remote applications

 
132908

Multi-media keys apply to the local client machine, and are not sent to the remote. This includes keys such as:

F7 - RWND/Previous  F8 - Play/Pause F9 - FFWD/Next song F10 - Mute F11 - Volume Down F12 - Volume Up

Workaround:

Use the UI application controls to interact with media applications on a remote system.

Connection failure on macOS agents with more than one NIC

 
132633

If the macOS agent machine's pcoip.connectionaddress_ value is set to the wrong IP address, PCoIP clients will not be able to connect.

Workaround:

set the pcoip.connection_address to the IP address that can be reached from the PCoIP client.

Locally connected displays may not restore after PCoIP disconnect

 
132606

Displays connected to the remote macOS machine are disabled during remote PCoIP sessions. In some cases, they may not be restored correctly after the PCoIP session is disconnected.

Workaround:

Connect to the machine again with a PCoIP Client, and disconnect the session through the PCoIP Client disconnect menu option. If this does not restore the display then reboot the remote machine.

Mouse preference changes on the remote machine have no effect

 
132588

Changing mouse preferences (such as size) on the remote macOS agent machine has no effect. This happens because mouse settings are controlled by the client computer, not the remote host.

Workaround:

Update desired mouse settings on the client computer.

Copy and paste of complex objects may not work

 
132183

Copying images and text in a single action between the local and remote machines may not work as expected. This occurs in either direction, from the PCoIP client to the PCoIP agent or the reverse.

Workaround:

Copy and paste the image and the text in separate actions, instead of together.

Usernames cannot contain spaces

 
120485

If your remote username contains spaces, the PCoIP agent will not be able to connect to it.

Workaround:

Change the username to eliminate the spaces, or create a new space-free account to use for PCoIP connections.