Network and Connectivity
Goal: Maintain a stable, low-latency connection to your remote Mac.- Use a wired Ethernet connection whenever possible. Wi-Fi interference often causes pixelation or dropped sessions.
- Avoid hotel, guest, or captive Wi-Fi networks that may throttle UDP traffic.
- Confirm that your network allows TCP 4172 and UDP 4172, which HP Anyware uses for the PCoIP protocol.
- If you are on a corporate network, ask your IT team to whitelist these ports or exclude them from VPN tunnels.
- Disable VPNs, packet-inspection firewalls, or content-filtering software during testing if frequent disconnects occur.
- Restart your modem or router if you notice high latency or inconsistent throughput.
Display and Performance
Goal: Preserve image clarity and minimize lag while using macOS remotely.- Start with your local display set to 1080p or lower; 4K or Retina scaling requires greater bandwidth.
- When troubleshooting, connect with a single monitor. Multiple displays increase GPU and network load.
- In the HP Anyware Client preferences, select H.264 for best overall compatibility with macOS hosts.
- Close background apps that use bandwidth such as streaming, video calls, or large downloads.
- If you encounter a black or frozen screen, end the session, wait 30 seconds, then reconnect. If the issue continues, MacStadium Support can verify the host’s virtual display configuration.
Session Stability and Timeouts
Goal: Avoid unplanned session interruptions or idle timeouts.- To end your session, close the HP Anyware client window. Do not use the macOS Log Out option from within the session. Logging out of macOS breaks the remote display state and prevents future PCoIP connections until the host is rebooted.
- Stay active within your session; extended inactivity may trigger an automatic disconnect.
- If disconnected unexpectedly, reconnect within one to two minutes; your macOS session usually remains active.
- If the HP Anyware Client re-prompts for credentials after a disconnect, note the message and contact Support.
- Keep the Client window open if stepping away briefly. Frequent reconnects in short intervals can create session conflicts.
Client Software and Updates
Goal: Maintain compatibility between the HP Anyware Client and the macOS agent.- Download the latest Client for your platform at https://www.hpanyware.com/downloads.
- Avoid beta or outdated versions; macOS agents are maintained on current release tracks.
- Restart your local computer periodically to clear cached network sessions.
- If switching between Wi-Fi and Ethernet, reconnect the Client to re-establish the PCoIP session.
- Include your Client version and OS type (for example, Windows 11 v24.06 Client or macOS 14.5 Client) in any Support request.
Common Symptoms and Recommended Actions
| Symptom | Likely Cause | Recommended Action |
|---|---|---|
| Screen remains black or frozen | macOS host display adapter not initialized | End session and reconnect; if persistent, MacStadium Support can refresh the host display service |
| Image quality drops or becomes blocky | Network congestion or limited bandwidth | Run a speed test at https://www.speedtest.net; share results with Support |
| Repeated disconnects | VPN or firewall interference | Try wired Ethernet or temporarily disable VPN |
| Session ends after idle time | Broker timeout policy | Reconnect and report if the timeout seems unusually short |
| ”Unable to connect to agent” | macOS host agent service offline | Contact Support with the timestamp and error text |
| Error 6405 | PCoIP agent failed to launch remote session | Reboot the host; if the error followed a macOS logout within the session, a reboot is required to restore access. See Cloud Access Troubleshooting |