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 仅执行系统安全服务守护进程 (System Security Services Daemon, SSSD) 身份验证方法来加入域。

  • Horizon Agent 安装

    在计算机上执行以下操作:

    • 构建以下内核模块以支持 Linux 桌面的某些功能:
      • V4L2Loopback 驱动程序,支持实时音频-视频 (Real-Time Audio-Video, RTAV)
      • 支持 USB 重定向的 USB VHCI 驱动程序
    • 安装安装 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 安装程序 tar,文件名采用 Omnissa-horizonagent-linux-x86_64-YYMM-y.y.y-xxxxxxx.tar.gz 模式,其中 YYMM 是营销版本号,y.y.y 是内部的版本号,xxxxxxx 是内部版本号。

  2. 解压缩适用于您所用 Linux 分发包的 tar。以下命令使用 agent-installer 指代安装程序 tar。

    tar -xvzf *Omnissa-horizonagent-linux-x86\64-YYMM-y.y.y-xxxxxxx.tar.gz*
    
  3. 导航到 tar 文件夹,然后以 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 脚本的同一 tar 文件夹中。

  • 将配置文件保存在同一 tar 文件夹中。

  • 将配置参数分成与三个安装程序提示级别相对应的集合: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指定要在配置过程中使用的代理服务器(可选)。
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指定是否安装单点登录支持 [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 密钥分发中心 (Key Distribution Center, 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…