疑難排解部署錯誤

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

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

請確認 PowerShell 指令碼是您要執行的指令碼，然後從 PowerShell 主控台執行以下命令：

unblock-file .\uagdeploy.ps1

找不到 ovftool 命令

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

內容 netmask1 中的網路無效

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

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

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

請忽略這則警告訊息。它會自動與支援的作業系統對應。

定位器無法參考物件錯誤

這則錯誤通知您 vSphere OVF Tool 使用的 target= 值不是 vCenter Server 環境所需的正確值。請使用 https://communities.vmware.com/docs/DOC-30835 列示的表格，以取得用來參考 vCenter 主機或叢集之目標格式的範例。最上層物件的指定方式如下：

target=vi://[email protected]:[email protected]/

物件現可列出要在下一層使用的可能名稱。

target=vi://[email protected]:[email protected]/Datacenter1/
target=vi://[email protected]:[email protected]/Datacenter1/host
target=vi://[email protected]:[email protected]/Datacenter1/host/Cluster1/
or
target=vi://[email protected]:[email protected]/Datacenter1/host/esxhost1

在目標中使用的資料夾名稱、主機名稱及叢集名稱有區分大小寫。

錯誤訊息：無法從工作階段擷取用戶端憑證：sessionId

• 檢查是否已在瀏覽器中正確安裝使用者憑證。
• 檢查是否已在瀏覽器和 Unified Access Gateway 上啟用預設 TLS 通訊協定 1.2 版。

無法使用在 Chrome 瀏覽器上啟動的 VMware vSphere Web Client 部署 Unified Access Gateway ova

您必須在 vSphere Web Client 上用來部署 ova 檔案的瀏覽器上安裝用戶端整合外掛程式。在 Chrome 瀏覽器上安裝外掛程式後，系統會顯示一則錯誤訊息，指出瀏覽器並未安裝，且將不允許您在來源位置中輸入 ova 檔案 URL。這是 Chrome 瀏覽器方面的問題，與 Unified Access Gateway ova 無關。建議您使用不同的瀏覽器來部署 Unified Access Gateway ova。

無法使用 VMware vSphere HTML4/5 Web Client 部署 Unified Access Gateway ova

您可能會遇到錯誤，例如為內容指定的值無效。此問題與 Unified Access Gateway ova 無關。建議您改用 vSphere FLEX 用戶端來部署 ova。

無法使用 VMware vSphere 6.7 HTML5 Web Client 部署 Unified Access Gateway ova

您可能會在 VMware vSphere 6.7 HTML5 Web Client 的部署內容頁面上發現遺漏的欄位。此問題與 Unified Access Gateway ova 無關。建議您改用 vSphere FLEX 用戶端來部署 ova。

無法從 Workspace ONE Access 透過 Chrome 啟動 XenApp

部署 Unified Access Gateway 作為來自 Workspace ONE Access 的 Web 反向 Proxy 之後，您可能無法從 Chrome 瀏覽器啟動 XenApp。

請遵循下列步驟來解決此問題。

1. 若要從 Workspace ONE Access 服務停用功能旗標 orgUseNonNPAPIForCitrixLaunch，請使用下列 REST API。

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

2. 等待 24 小時使變更生效，或重新啟動 Workspace ONE Access 服務。
   • 若要在 Linux 上重新啟動服務，請登入虛擬應用裝置並執行下列命令：service horizon-workspace restart。
   • 若要在 Windows 上重新啟動服務，請執行下列指令碼：install_dir\usr\local\horizon\scripts\horizonService.bat restart 。