Skip to main content

2026 年 11 月 18 日

使用 Easy Setup Tool 準備 Linux 機器

此頁面說明適用於 Linux 機器的 Easy Setup Tool (easyinstall_viewagent.sh)。此工具會執行所有安裝與系統組態,讓 Linux 機器可用於 Horizon 8 部署。

**附註:**RHEL 10.0 目前不支援 Easy Setup Tool。

Easy Setup Tool 概觀

Easy Setup Tool 是一個引導式安裝程式,可在 Linux 機器上執行以下作業。

  • 系統預先檢查

    驗證機器是否符合以下需求:

    如果機器無法符合特定需求,該工具將顯示通知。

  • 系統組態

    執行以下系統組態:

    • 設定 DNS。

    • 設定 NTP 和主機名稱設定,並將機器加入指定的 Active Directory 網域。

      **附註:**此版本的 Easy Setup Tool 僅執行系統安全服務精靈 (SSSD) 驗證方法來加入網域。

  • Horizon Agent 安裝

    在機器上執行下列作業:

    • 建置下列核心模組,以支援 Linux 桌面平台的特定功能:
      • V4L2Loopback 驅動程式,其支援即時影音 (RTAV)
      • 支援 USB 重新導向的 USB VHCI 驅動程式
    • 安裝 Horizon Agent 所需的必要代理程式相依性套件,如安裝 Horizon Agent 的 Linux 相依性套件中所列。
    • 依指定的安裝選項安裝 Linux 版 Horizon Agent。

**附註:**如需如何指定安裝參數 (例如 Active Directory 網域、代理程式安裝選項及安裝程式提示層級) 的相關資訊,請參閱〈Easy Setup Tool 的組態參數〉。

下載並執行 Easy Setup Tool

  1. 從 Omnissa Customer Connect 下載 Linux 版 Horizon Agent 安裝程式套件。

    導覽至目前 Horizon 8 版本的下載頁面,然後導覽至適用於 64 位元 Linux 的 Horizon 下載頁面。

    下載 Horizon Agent tarball 安裝程式,其檔案名稱的模式為 Omnissa-horizonagent-linux-x86_64-YYMM-y.y.y-xxxxxxx.tar.gz,其中 YYMM 為行銷版本號碼,y.y.y 為內部版本號碼,xxxxxxx 為組建編號。

  2. 解壓縮適用於您的 Linux 發行版的 tarball。以下命令中使用 agent-installer 作為安裝程式 tarball 的參照名稱。

    tar -xvzf *Omnissa-horizonagent-linux-x86\64-YYMM-y.y.y-xxxxxxx.tar.gz*
    
  3. 導覽至 tarball 資料夾,然後以 root 使用者身分執行 easyinstall.viewagent.sh 指令碼。為您想要包含的任何安裝選項,附加命令列參數。

    如需詳細資訊,請參閱下方的〈Easy Setup Tool 的命令列參數〉。

    請參考以下命令範例:

    #Run the Easy Setup Tool with default prompts and installation options
    ./easyinstall_viewagent.sh
    
    #Run the tool in silent mode with installation options specified in easyinstall.conf
    ./easyinstall_viewagent.sh -s -f ./easyinstall.conf
    
  4. 允許 Easy Setup Tool 無中斷地繼續執行,並視需要回應任何安裝程式提示。

  5. 安裝程序完成後,重新啟動 Linux 機器,使變更生效。

  6. 透過執行下列命令來確認 viewagent 服務是否已啟動。

    sudo service viewagent status
    

Easy Setup Tool 的命令列參數

下表說明命令列參數,這些參數可附加到 ./easyinstall_viewagent.sh 執行命令,以指定安裝選項和提示層級。

選項說明
-s,--silent 在無提示模式下 (會略過所有安裝程式提示),執行 Easy Setup Tool。 從 -f 參數指定的組態檔案中擷取所需的安裝選項。如需更多詳細資料,請參閱本主題中的〈Easy Setup Tool 的組態參數〉章節。 命令範例:

./easyinstall_viewagent.sh -s -f ./easyinstall.conf
-l,--prompt-level 根據安裝程式提示的層級,來指定使用者互動層級。 這些設定用來從 -f 參數指定的組態檔案中,擷取每個提示層級。如需更多詳細資料,請參閱〈Easy Setup Tool 的組態參數〉。 允許的值:
  • default - 僅顯示基本安裝選項的提示。如果沒有包含或者未設定 -l 參數,則會使用此 default 提示層級。
  • advanced - 除了 default 提示外,也會顯示進階安裝選項的提示,例如是否安裝遠端體驗功能。
  • expert - 除了 default 和 advanced 提示外,也會顯示專家安裝選項的提示,例如是否安裝 FIPS 支援。
命令範例:

./easyinstall_viewagent.sh -l advanced -f ./easyinstall.conf
-f,--config-file 從指定的組態檔案中讀取組態。如需詳細資訊,請參閱 Easy Setup Tool 的組態參數。 命令範例:

./easyinstall_viewagent.sh -s -f ./easyinstall.conf
-p,--pre-check-only 僅執行概觀中所述的預先檢查作業。不會執行系統組態或安裝 Horizon Agent。 命令範例:

./easyinstall_viewagent.sh -p
-c,--configure-only 僅執行概觀中所述的系統組態。不會執行預先檢查作業或安裝 Horizon Agent。 命令範例:

./easyinstall_viewagent.sh -c
-i,--install-agent-only 僅安裝 Horizon Agent,如概觀中所述。不會執行預先檢查作業或系統組態。 命令範例:

./easyinstall_viewagent.sh -i
-h,--help 顯示 Easy Setup Tool 的説明資訊,然後結束該工具。 命令範例:

./easyinstall_viewagent.sh -h

Easy Setup Tool 的組態參數

您可以將參數寫入至組態檔案,然後使用 -f 命令列參數擷取該檔案,以指定 Easy Setup Tool 的組態參數。

例如,下列命令會依據 easyinstall.conf 組態檔中指定的 advanced 安裝程式提示來執行該工具。


./easyinstall_viewagent.sh -l advanced -f ./easyinstall.conf

撰寫組態檔時,請遵循以下規則和慣例:

  • 請參閱組態範本 easyinstall.conf.template,此範本位於與 easyinstall_viewagent.sh 指令碼相同的 tarball 資料夾中。

  • 將組態檔儲存在相同 tarball 資料夾中。

  • 將組態參數分成三組,各與三個安裝程式提示層級相對應:default、advanced 和 expert。

  • 若要略過提示,請在組態檔中註解排除該提示的組態參數。

  • 在下表中,標有「選用」的項目對應至接受選用輸入的提示。使用者可略過選用提示,而不輸入任何內容。

  • 對於接受「y」或「n」輸入的提示,大寫設定代表預設設定。

    例如,EASYINSTALL_AGENT_MANAGED 參數的預設設定為「Y」,表示 Horizon Agent 依預設會以受管理模式安裝。在略過提示或在無提示模式下執行 Easy Setup Tool 時,預設設定將生效。

預設提示層級的參數

組態參數說明
EASYINSTALL_HOSTNAME指定主機的主機名稱 (選用)。
EASYINSTALL_DNS_LIST指定主機的 DNS (選用)。
EASYINSTALL_DOMAIN_FQDN指定要加入之 Active Directory 網域的 FQDN。
EASYINSTALL_DOMAIN_JOIN_USER指定要用於網域加入的使用者帳戶。
EASYINSTALL_DOMAIN_JOIN_PASSWORD指定要用於網域加入的密碼。
EASYINSTALL_PROXY指定要在組態程序中使用的 Proxy 伺服器 (選用)。
EASYINSTALL_AGENT_ACCEPT_GENERAL_TERMS 指定是否接受通用條款合約 [Y/n]。 您必須接受通用條款,才能繼續使用 Easy Setup Tool。

進階提示層級的參數

組態名稱說明
EASYINSTALL_NTP輸入 NTP 伺服器的 IP 位址 (選用)。
EASYINSTALL_DOMAIN_JOIN指定是否加入 Active Directory 網域 [Y/n]。
EASYINSTALL_AGENT_MANAGED指定是否以受管理模式安裝 Horizon Agent [Y/n]。
EASYINSTALL_AGENT_MULTIPLE_SESSION指定是否安裝多重工作階段支援 [Y/n]。
EASYINSTALL_AGENT_WEBCAM指定是否安裝網路攝影機重新導向功能 [y/N]。
EASYINSTALL_AGENT_AUDIO_IN指定是否安裝音訊輸入重新導向支援 [y/N]。
EASYINSTALL_AGENT_USB_REDIRECTION指定是否安裝 USB 重新導向功能 [y/N]。
EASYINSTALL_AGENT_CLIENT_DRIVE_REDIRECTION指定是否安裝用戶端磁碟機重新導向功能 [Y/n]。
EASYINSTALL_AGENT_CLIPBOARD_REDIRECTION指定是否安裝剪貼簿重新導向功能 [Y/n]。
EASYINSTALL_AGENT_PRINTER_REDIRECTION指定是否安裝印表機重新導向功能 [Y/n]。
EASYINSTALL_AGENT_SKIP_BUILD_MODULES指定是否略過建置所需的模組 [y/N]。
EASYINSTALL_AGENT_SINGLE_SIGN_ON指定是否安裝 Single Sign-On 支援 [Y/n]。
EASYINSTALL_AGENT_RESTART_AFTER_INSTALLATION指定是否在安裝後自動重新啟動機器 [y/N]。
EASYINSTALL_HORIZON_CONNECTION_SERVER_ADDRESS輸入連線伺服器的 FQDN 或 IP 位址 (僅適用於非受管理模式)。
EASYINSTALL_HORIZON_ADMIN_DOMAIN輸入連線伺服器的管理員網域名稱 (僅適用於非受管理模式)。
EASYINSTALL_HORIZON_ADMIN_USER輸入連線伺服器的管理員名稱 (僅適用於非受管理模式)。
EASYINSTALL_HORIZON_ADMIN_PASSWORD輸入連線伺服器的管理員密碼 (僅適用於非受管理模式)。

專家提示層級參數

組態名稱說明
EASYINSTALL_AGENT_FIPS指定是否安裝 FIPS 模式支援 [y/N]。
EASYINSTALL_AGENT_IPV6指定是否安裝 IPv6 網路支援 [y/N]。
EASYINSTALL_AGENT_NO_HOSTED_APP指定是否停用單一工作階段應用程式集區 [y/N]。
EASYINSTALL_AGENT_DISABLE_HZNGREETER指定是否停用支援 True SSO 和智慧卡 SSO 功能的 Horizon Greeter [y/N]。
EASYINSTALL_AGENT_SMARTCARD_REDIRECTION指定是否安裝智慧卡重新導向功能 [y/N]。
EASYINSTALL_AGENT_TRUE_SSO指定是否安裝 True SSO 功能 [y/N]。
EASYINSTALL_AGENT_SELF_SIGNED_CERT_SUBJECT_DN輸入偏好的自我簽署憑證的主體 DN (選用)。
EASYINSTALL_AGENT_JMS_SSL_KEYSTORE_PASSWORD輸入偏好的 JMS SSL 金鑰儲存區密碼 (選用)。
EASYINSTALL_AGENT_VHCI_SOURCE_DOWNLOAD_PATH指定 VHCI 來源套件的檔案路徑 (選用)。
EASYINSTALL_AGENT_V4L2LOOPBACK_SOURCE_DOWNLOAD_PATH指定 V4L2Loopback 來源套件的檔案路徑 (選用)。
EASYINSTALL_HORIZON_ADMIN_KDC指定 Horizon 8 管理員網域的 Kerberos 金鑰發佈中心 (KDC) (選用,僅適用於非受管理模式)。
EASYINSTALL_HORIZON_CONNECTION_SERVER_KDC為連線伺服器域指定 KDC (選用,僅適用於非受管理模式)。
EASYINSTALL_HORIZON_CONNECTION_SERVER_DOMAIN輸入連線伺服器的網域名稱 (選用,僅適用於非受管理模式)。

Easy Setup Tool 的功能考量事項

以下考量事項和限制適用於 Easy Setup Tool。

Was this page helpful?

Provide feedback for this topic

Was this topic helpful?

Please do not include any personal or confidential information.

Generating link…