Release Notes
Graphics Agent for macOS 23.04.1
Note: 23.04.1 is the first 23.04.x release of the Graphics Agent for Linux. There was no 23.04.0 release.
Release 23.04 of the Graphics Agent for macOS includes:
Multiple Collaborator Support
This release introduces support for multiple collaborators in a single collaboration session. Up to 5 collaborators can now join a single PCoIP session using the same invitation. For more information, see Multiple Collaborators.
Introduces Support for macOS 13 (Ventura)
This release introduces support for macOS 13 (Ventura), and removes support for macOS 11 (Big Sur).
Display topology issues on macOS x86 with fitHeadless4K HDMI corrected with Ventura 13.2 OS Update
PCoIP Agents for macOS with a fitHeadless4K HDMI plug attached should no longer exhibit topology issues as long as the macOS version on the agent machine is Ventura 13.2 or greater.
Display topology issues on macOS Agent fixed with Ventura 13.2 update
For the best possible PCoIP macOS agent topology experience upgrade the agent workstation to macOS Ventura 13.2.
Agent no longer crashes when collaborator supplies a long string for the name
Agent no longer crashes when a collaborator supplies a long string in the Name field from the client. However, the connection approval dialog may not be shown by the Collaboration Manager due to the long name.
Collaboration Manager Warning if PCoIP Ultra mode is not enabled
PCoIP Ultra Collaboration only functions if PCoIP Ultra (CPU Offload, GPU Offload or Auto Offload) are enabled on the PCoIP Agent. If a user attempts to start a collaboration session on an Agent without PCoIP Ultra enabled, they will see a warning message and not be able to start the collaboration session.
macOS agent does not support rotated displays
The remote macOS agent will disconnect if a rotated display is requested in full screen one monitor or full screen all monitor modes.
Do not rotate displays on your client machine.
Slow topology configuration with irregular sized client displays in full screen all monitors mode
If the client machine has a display with an irregular sized (specifically that the resolution height or width of the display are not exactly divisible by 4) then very slow topology changes may occur. The change can be in excess of 15-20 seconds.
This will only happen in full screen all monitors mode when the client has more than one local display attached.
If possible, scale the irregular sized display to a resolution that is divisible by 4 in both dimensions.
Resizing collaboration session window causes crash
Re-sizing the PCoIP Client window while participating in a PCoIP Ultra Collaboration session may cause the PCoIP client to crash.
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
When the collaborator client window is resized, cursor artifacts may be seen on the collaborator client momentarily.
Once the resizing settles, the artifacts will disappear.
Wacom tablets can span unusable local displays from an Apple Silicon macOS agent
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.
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
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.
Mouse input can be restored by disconnecting the PCoIP session and reconnecting.
Collaborator may not see the remote cursor when first connected
When a guest collaborator connects to the host's session, the host's cursor may not be visible to the guest until it moves.
The host collaborator should move their cursor. This will update its position and cause the cursor to appear in the guest collaborator's client.
Poor user experience with Apple Silicon and Big Sur
There are a number of limitations when remotely connecting to an Apple Silicon machine running Big Sur, including mouse input problems that prevent interaction with operating system.
Upgrade to Monterey on the Apple Silicon macOS system.
Users must enter their password twice
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.
Unlock the desktop by entering the correct password.
Multi-channel audio deteriorates after switching from wired to wireless network
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.
Disconnect the session and reconnect after switching to a wireless network.
Timezone not automatically updated when connecting to a macOS system
The remote macOS system does not automatically update its time zone to match the client's location.
Manually set the timezone on the remote macOS system.
Horizontal scroll is not supported
Using a horizontal scroll wheel on a mouse or a horizontal gesture on a trackpad has no effect.
Left-click on a scroll bar to drag the viewport to the desired location.
Interrupted sessions do not automatically reconnect
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.
Disconnect the PCoIP session, and start a new connection.
Some multiple-key combinations are not sent to the remote system
Certain key combination, such as ctrl+arrow, are not sent correctly to the remote system.
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
Occasionally, a user may not be able to connect to a remote macOS agent.
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 login dialogs can prevent PCoIP sessions
Login prompts on the remote system will prevent a PCoIP session from starting.
Make sure you have logged in to the remote computer using the user account that will host PCoIP sessions, and dismissed all prompts. # On the remote machine, log in to the user account that will host PCoIP sessions with either VNC or Screen Sharing. # From this connection, dismiss any login dialogs that are presented. # Log out from this user account. # Attempt the PCoIP connection again, using the PCoIP Client.
macOS firewall settings can prevent PCoIP connections
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.
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-serverThe 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
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.
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
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.
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
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
Use the UI application controls to interact with media applications on a remote system.
Connection failure on macOS agents with more than one NIC
If the macOS agent machine's pcoip.connectionaddress_ value is set to the wrong IP address, PCoIP clients will not be able to connect.
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
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.
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
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.
Update desired mouse settings on the client computer.
Copy and paste of complex objects may not work
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.
Copy and paste the image and the text in separate actions, instead of together.
Usernames cannot contain spaces
If your remote username contains spaces, the PCoIP agent will not be able to connect to it.
Change the username to eliminate the spaces, or create a new space-free account to use for PCoIP connections.