部署錯誤

您在部署 Unified Access Gateway 至環境中時，可能會遇到困難。您可以使用多種程序來診斷及修正部署時發生的問題。

執行從網際網路下載的指令碼時出現安全警告

請確認 PowerShell 指令碼為您預期要執行的指令碼，然後在 PowerShell 主控台中執行下列命令：

unblock-file .\uagdeploy.ps1

ovftool command not found

請確認您已在 Windows 機器上安裝 OVF Tool 軟體，並且該軟體安裝在指令碼預期的位置。

內容 netmask1 中的網路無效

這則訊息可能會指出 netmask0、netmask1 或 netmask2。請確認已在 netInternet、netManagementNetwork 及 netBackendNetwork 這三個網路各自的 INI 檔案中設定值。

關於作業系統識別碼不受支援的警告訊息

警告訊息顯示指定的作業系統識別碼 SUSE Linux Enterprise Server 12.0 64-bit (id:85) 在選定主機上不受支援。它對應至以下作業系統識別碼：Other Linux (64-bit)。

請忽略此警告訊息。系統會自動對應至受支援的作業系統。

Locator does not refer to an object error

此錯誤指出，vSphere OVF Tool 使用的 target= 值與您的 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。

無法透過 Chrome 從 Omnissa Access 啟動 XenApp

將 Unified Access Gateway 部署為 Omnissa Access 的 Web 反向 Proxy 後，您可能無法透過 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。