有限可用性：对适用于 macOS 的 Horizon Agent 进行故障排除

Horizon Agent 日志文件

适用于 macOS 的 Horizon Agent 会将日志文件写入以下位置：

• /var/log/omnissa/*.log
• /Users/<username>/Library/Logs/Omnissa/*.log
• /var/root/Library/Logs/Omnissa/*.log

在对连接问题、会话失败或权限问题进行故障排除时，请收集这些日志。要流式传输最新的日志条目，请运行以下命令：

tail -f /var/log/omnissa/viewagent-debug.log

验证 Horizon Agent 服务

要确认 Horizon Agent 服务正在运行，请运行以下命令：

sudo launchctl list | grep omnissa

所有 Horizon Agent 守护进程条目都应显示在输出中，且退出代码为零。非零退出代码表示服务出现故障。

验证连接服务器连接

要验证 macOS 计算机是否可以访问 Horizon Connection Server，请运行以下命令：

nc -zv <connection-server-fqdn> 443

成功连接表示 TCP 端口 443 可以访问。Blast 会话需要打开其他端口。请确认 macOS 计算机与连接服务器之间已打开所需的 Horizon 端口。

常见问题和解决方案

会话连接后显示黑屏

**原因：**Horizon Agent 没有“屏幕录制”权限。

解决方案：在系统设置 > 隐私与安全性 > 屏幕录制中手动授予“屏幕录制”权限，或部署 PPPC MDM 配置文件。

键盘和鼠标输入不起作用

**原因：**Horizon Agent 没有“辅助功能”或“输入监控”权限。

解决方案：在系统设置 > 隐私与安全性中查看并手动授予以下权限：

或者，部署 PPPC MDM 配置文件以自动授予这些权限。

Horizon Agent 未向连接服务器注册

请检查以下各项：

• 确认 macOS 计算机主机名能够通过 DNS 正确解析。
• 确认在 macOS 计算机和 Horizon Connection Server 之间已打开 TCP 端口 443。
• 查看位于 /var/log/omnissa/viewagent-debug.log 的 Horizon Agent 日志文件，以获取具体的错误消息。

Blast 连接失败

**原因：**macOS 防火墙或网络防火墙阻止所需的 Blast 端口。

**解决方案：**将这些防火墙配置为允许所需的 Horizon Blast 端口。有关所需的端口列表，请参阅《Horizon 8 网络端口》文档。

尽管已部署 MDM 配置文件，但仍显示权限提示

• 输入监控及屏幕和系统音频录制权限提示是预期行为。无论 PPPC 配置文件配置如何，Apple 都不允许 MDM 以无提示方式授予这些权限。
• 辅助功能权限可以按无提示方式授予。如果显示“辅助功能”提示，则表明 PPPC 配置文件配置有误。

如果“辅助功能”提示持续出现，或者如果“输入监控”或“屏幕录制”提示根本没有出现（表示配置文件未能注册允许标准用户设置系统服务设置），请验证以下各项。

1. 确认 PPPC 配置文件在 UEM Console 中的设备上显示为已安装，而不仅仅是已分配。导航到设备 > [设备] > 配置文件，并确认安装状态为已安装。确认设备在分配配置文件后已通过 UEM 签入。

2. 确认 PPPC 配置文件包含三个具有正确包标识符的单独应用程序条目：

   • com.omnissa.horizon.blastworker（“辅助功能”和“输入监控”）
   • com.omnissa.horizon.agent（“屏幕和系统音频录制”）
   • com.omnissa.horizon.jre（“输入监控”）

   要验证参考机上的每个二进制文件，请运行以下命令。

   codesign --display -r - /path/to/BlastWorker
   codesign --display -r - /path/to/CaptureAgent
   codesign --display -r - /path/to/HorizonJRE
   

   **注意：**不要针对顶层的 /Applications/Omnissa\ Horizon\ Agent.app 运行此命令。每个子二进制文件的代码要求各不相同。

3. 确认每项服务的访问级别均已正确设置：

   • 辅助功能 → Allow
   • 屏幕捕获 → Allow Standard User to Set System Service
   • 侦听事件 → Allow Standard User to Set System Service

   注意：将屏幕捕获或侦听事件设置为 Allow 并不会以无提示方式授予该权限。对于这两项服务，Apple 会忽略此设置。正确的值为 Allow Standard User to Set System Service，这可确保用户在首次启动 VDI 时会收到批准提示。

4. 如果上述所有设置都正确无误，但用户仍未收到提示，请从 UEM Console 强制执行设备签入。

   • 在 UEM Console 中，导航到设备 > [设备] > 更多操作 > 查询 > 设备配置文件。
   • 让用户注销并重新登录以触发全新会话。

收集诊断信息

要收集完整的诊断包以供 Omnissa 技术支持团队使用，请运行 Horizon Agent 诊断收集工具：

sudo /Library/Omnissa/horizonagent/support/dct-debug.sh

诊断包将保存到 /tmp/。请在联系 Omnissa 技术支持团队时提供此包。

已知限制

以下限制适用于 2606 有限可用性版本中的适用于 macOS 的 Horizon Agent。

• 仅限物理机：不支持虚拟机部署。
• 仅限 Apple 芯片：不支持基于 Intel 的 Mac 硬件。
• 仅限单会话：每台 macOS 计算机支持一个并发 Horizon 会话。不支持多会话模式 (RDSH)。
• 不支持即时克隆：无法进行基于自动克隆的桌面置备。
• 无已发布的应用程序：仅支持完整桌面会话；无法进行单个应用程序发布。
• 无 USB 重定向：连接到客户端的 USB 设备无法重定向到 macOS 桌面。
• 无智能卡重定向：不支持通过重定向设备进行智能卡身份验证。
• 仅限手动桌面池：不支持自动和浮动分配池。
• 未受管设备需要用户同意：如果计算机未在 MDM 解决方案中注册，则用户必须手动批准 macOS 隐私权限。
• 不支持屏幕录制：不支持屏幕录制。
• 无硬件加速编码：不支持硬件加速视频编码。