部署错误

在您的环境中部署 Unified Access Gateway 时，您可能会遇到一些困难。您可以使用不同的过程诊断和修复部署问题。

运行从 Internet 下载的脚本时的安全警告

确认 PowerShell 脚本是您要运行的脚本，然后从 PowerShell 控制台运行以下命令：

unblock-file .\uagdeploy.ps1

ovftool command not found

确认您的 Windows 计算机上已安装 OVF Tool 软件，以及该软件安装在脚本所预期的位置。

netmask1 属性中的网络无效

该消息可能指示 netmask0、netmask1 或 netmask2。检查是否在 INI 文件中为以下三个网络分别设置了一个值：netInternet、netManagementNetwork 和 netBackendNetwork。

显示有关不支持操作系统标识符的警告消息

显示警告消息，指示选定主机不支持指定的操作系统标识符 SUSE Linux Enterprise Server 12.0 64 位 (id:85)。它将映射到以下操作系统标识符：其他 Linux（64 位）。

请忽略此警告消息。它将自动映射到受支持的操作系统。

Locator does not refer to an object error

该错误通知 vSphere OVF Tool 使用的 target= value 不适用于您的 vCenter Server 环境。顶级对象指定如下：

target=vi://administrator@vsphere.local:PASSWORD@192.168.0.21/

该对象现在列出了下一个层级所使用的可能名称。

target=vi://administrator@vsphere.local:PASSWORD@192.168.0.21/Datacenter1/
target=vi://administrator@vsphere.local:PASSWORD@192.168.0.21/Datacenter1/host
target=vi://administrator@vsphere.local:PASSWORD@192.168.0.21/Datacenter1/host/Cluster1/
or
target=vi://administrator@vsphere.local:PASSWORD@192.168.0.21/Datacenter1/host/esxhost1

目标中使用的文件夹名称、主机名和集群名称区分大小写。

Error message: Unable to retrieve client certificate from session: sessionId

• 检查是否在浏览器中正确安装了用户证书。
• 检查是否在浏览器和 Unified Access Gateway 中启用了默认 TLS 协议版本 1.2。

无法在 Omnissa Access 上从 Chrome 中启动 XenApp

从 Omnissa Access 中将 Unified Access Gateway 部署为 Web 反向代理后，您可能无法从 Chrome 浏览器中启动 XenApp。

请按照以下步骤解决该问题。

1. 使用以下 REST API 从 Omnissa Access 服务禁用 orgUseNonNPAPIForCitrixLaunch 功能标记。

   PUT https://fqdn/SAAS/jersey/manager/api/tenants/settings?tenantId=tenantname
   { "items":[ {"name":"orgUseNonNPAPIForCitrixLaunch","value": "false"} ] }
   with the following two headers:
   Content-Type application/json
   Authorization HZN value_of_HZN_cookie_for_admin_user
   

2. 等待 24 小时以使更改生效，或重新启动 Omnissa Access 服务。

   • 要在 Linux 上重新启动该服务，请登录到虚拟设备并运行以下命令：service horizon-workspace restart。
   • 要在 Windows 上重新启动该服务，请运行以下脚本：install_dir\usr\local\horizon\scripts\horizonService.bat restart。