Skip to main content

2026 年 4 月 14 日

使用 Easy Setup Tool 准备 Linux 计算机

此页面介绍了适用于 Linux 计算机的 Easy Setup Tool (easyinstall_viewagent.sh)。此工具可执行使 Linux 计算机可用于 Horizon 8 部署而必需完成的所有安装和系统配置。

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 依赖项包中列出的必需代理依赖项。
    • 使用指定的安装选项安装 Horizon Agent for Linux。

**注意:**有关如何指定安装参数(如 Active Directory 域、代理安装选项和安装程序提示级别)的信息,请参阅“Easy Setup Tool 的配置参数”。

下载并运行 Easy Setup Tool

  1. Omnissa Customer Connect 下载 Horizon Agent for Linux 安装程序软件包。

    导航到当前 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 - 除了 defaultadvanced 提示外,还显示专家安装选项的提示,例如是否安装 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 文件夹中。

  • 将配置参数分成与三个安装程序提示级别相对应的集合:defaultadvancedexpert

  • 要绕过提示,请在配置文件中注释掉该提示的配置参数。

  • 在以下各表中,标有“可选”的条目对应于接受可选输入的提示。用户可以跳过可选提示,而无需输入任何内容。

  • 对于接受“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。

此页面对您有帮助吗?

对本主题提供反馈

本主题对您有帮助吗?

请勿填写任何个人信息或机密信息。

正在生成链接…