产品文档
Linux Virtual Delivery Agent 2103
Current Release 2402 LTSR 2311 2308 2305 2303 2301 2212 2210 2209 2207 2206 2204 2203 LTSR 1912 LTSR 7.15 LTSR
查看 PDF

轻松安装

June 21, 2022
投稿者: 
C C

从 Linux VDA 7.13 版起支持轻松安装。此功能通过自动安装必需的软件包并自定义配置文件来帮助您设置 Linux VDA 的运行环境。

使用轻松安装

要使用此功能，请执行以下操作：

  1. 准备配置信息和 Linux 计算机。
  2. 安装 Linux VDA 软件包。
    转至 Citrix Virtual Apps and Desktops 下载页面。展开相应版本的 Citrix Virtual Apps and Desktops，然后单击组件以下载与 Linux 发行版匹配的 Linux VDA 包。
  3. 设置运行时环境以完成 Linux VDA 安装。

步骤 1：准备配置信息和 Linux 计算机

收集轻松安装所需的以下配置信息：

  • 主机名 - 要安装 Linux VDA 的计算机的主机名
  • 域名服务器的 IP 地址
  • NTP 服务器的 IP 地址或字符串名称
  • 域名 - 域的 NetBIOS 名称
  • 领域名称 - Kerberos 领域名称
  • 活动域的 FQDN - 完全限定域名

重要：

  • 要安装 Linux VDA，请确认是否在 Linux 计算机上正确添加了存储库。
  • 要启动会话，请确认是否安装了 X Windows 系统和桌面环境。

注意事项

  • 默认情况下，工作组名称是域名。要在您的环境中自定义工作组，请执行以下操作：

    a. 在 Linux VDA 计算机上创建 tmp/ctxinstall.conf 文件。
    b. 将“wworkgroup=<your workgroup>”行添加到文件中并保存您所做的更改。

  • Centrify 不支持纯 IPv6 DNS 配置。/etc/resolv.conf 中至少需要有一个使用 IPv4 的 DNS 服务器，adclient 才能正确查找 AD 服务。

    日志：

     ADSITE   : Check that this machine's subnet is in a site known by AD   : Failed
          : This machine's subnet is not known by AD.
          : We guess you should be in the site Site1.
 <!--NeedCopy-->

    此问题是 Centrify 及其配置独有的。要解决此问题，请执行以下操作：

    a. 在域控制器上打开管理工具。
    b. 选择 Active Directory 站点和服务。
    c. 为子网添加正确的子网地址。

  • 要将 VDA 连接到特定 OU，请执行以下操作：

    1. 确保域控制器上存在特定的 OU。

      有关示例 OU，请参阅下面的屏幕截图。

      示例 OU 示意图

    2. 在 VDA 上创建 /tmp/ctxinstall.conf 文件。

    3. 将 ou=<your ou> 行添加到 /tmp/ctxinstall.conf 文件中。

      OU 值因 AD 方法的不同而异。请参见下表。

      操作系统 Winbind SSSD Centrify PBIS
      RHEL 8 ou=”OU=redhat,OU=Linux” ou=”OU=redhat,OU=Linux” ou=”XD.LOCAL/Linux/redhat” 不支持
      RHEL 7 ou=”Linux/redhat” ou=”Linux/redhat” ou=”XD.LOCAL/Linux/redhat” ou=”Linux/redhat”
      Ubuntu ou=”Linux/ubuntu” ou=”Linux/ubuntu” ou=”XD.LOCAL/Linux/ubuntu” ou=”Linux/ubuntu”
      SUSE 12.5 ou=”Linux/suse” ou=”Linux/suse” ou=”XD.LOCAL/Linux/suse” 不支持
      Debian ou=”Linux/debian” ou=”Linux/debian” ou=”XD.LOCAL/Linux/debian” ou=”Linux/debian”

  • 自 Linux VDA 7.16 起，轻松安装支持纯 IPv6。以下先决条件和限制适用：

    • 必须配置您的 Linux 存储库，以确保您的计算机可以通过纯 IPv6 网络下载所需软件包。
    • 在纯 IPv6 网络中不支持 Centrify。

    注意：

    如果您的网络是纯 IPv6，并且所有输入均采用恰当的 IPv6 格式，VDA 将通过 IPv6 向 Delivery Controller 注册。如果您的网络具有混合 IPv4 和 IPv6 配置，第一个 DNS IP 地址的类型将决定是使用 IPv4 还是使用 IPv6 来注册。

  • 如果选择 Centrify 作为加入域的方法，ctxinstall.sh 脚本需要 Centrify 软件包。ctxinstall.sh 获取 Centrify 软件包的方法有两种：

  • 如果选择 PBIS 作为加入域的方法，ctxinstall.sh 脚本需要 PBIS 软件包。ctxinstall.sh 获取 PBIS 软件包的方法有两种：

步骤 2：安装 Linux VDA 软件包

要为 Linux VDA 设置环境，请运行以下命令。

对于 RHEL 和 CentOS 发行版：

sudo yum  -y localinstall   <PATH>/<Linux VDA RPM>
<!--NeedCopy-->

对于 Ubuntu/Debian 发行版：

sudo dpkg -i <PATH>/<Linux VDA deb>
sudo apt-get install -f
<!--NeedCopy-->

注意：

要为 Debian 发行版安装必要的依赖项，请将 deb http://deb.debian.org/debian/ oldstable main 行添加到 /etc/apt/sources.list 文件。

对于 SUSE 发行版：

zypper -i install <PATH>/<Linux VDA RPM>
<!--NeedCopy-->

步骤 3：设置运行时环境以完成安装

注意：

在设置运行时环境之前，请确保已在操作系统中安装了 en_US.UTF-8 区域设置。如果该区域设置在您的操作系统中不可用，请运行 sudo locale-gen en_US.UTF-8 命令。对于 Debian，请通过取消批注 # en_US.UTF-8 UTF-8 行来编辑 /etc/locale.gen 文件，然后运行 sudo locale-gen 命令。

安装 Linux VDA 软件包后，使用 ctxinstall.sh 脚本来配置运行环境。可以在交互模式或无提示模式下运行该脚本。

注意：

下载 .NET Core Runtime（该运行时大小超过 27 MB）时，轻松安装可能看起来没有响应。有关下载进度，请查看 /var/log/ctxinstall.log。

交互模式：

要执行手动配置，请运行以下命令并在每个提示处键入相关参数。

sudo /opt/Citrix/VDA/sbin/ctxinstall.sh
<!--NeedCopy-->

无提示模式：

要在无提示模式下使用轻松安装，请先设置以下环境变量，然后再运行 ctxinstall.sh。

  • CTX_EASYINSTALL_HOSTNAME=host-name – 表示 Linux VDA 服务器的主机名。
  • CTX_EASYINSTALL_DNS=ip-address-of-dns – DNS 的 IP 地址。
  • CTX_EASYINSTALL_NTPS=address-of-ntps – NTP 服务器的 IP 地址或字符串名称。
  • CTX_EASYINSTALL_DOMAIN=domain-name – 域的 NetBIOS 名称
  • CTX_EASYINSTALL_REALM=realm-name – Kerberos 领域名称。
  • CTX_EASYINSTALL_FQDN=ad-fqdn-name
  • CTX_EASYINSTALL_ADINTEGRATIONWAY=winbind | sssd | centrify | pbis – 表示 Active Directory 集成方法。
  • CTX_EASYINSTALL_USERNAME=domain-user-name – 表示域用户的名称；用于加入域。
  • CTX_EASYINSTALL_PASSWORD=password – 指定域用户的密码；用于加入域。

ctxsetup.sh 脚本使用以下变量：

  • CTX_XDL_SUPPORT_DDC_AS_CNAME = Y | N – Linux VDA 支持使用 DNS CNAME 记录指定 Delivery Controller 名称。
  • CTX_XDL_DDC_LIST=‘list-ddc-fqdns’ – Linux VDA 要求提供由空格分隔的 Delivery Controller 完全限定域名 (FQDN) 列表以用于向 Delivery Controller 注册。必须至少指定一个 FQDN 或 CNAME。
  • CTX_XDL_VDA_PORT=port-number – Linux VDA 将通过 TCP/IP 端口与 Delivery Controller 通信。
  • CTX_XDL_REGISTER_SERVICE=Y | N - 在启动计算机后启动 Linux VDA 服务。
  • CTX_XDL_ADD_FIREWALL_RULES=Y | N – Linux VDA 服务要求允许传入网络连接通过系统防火墙。您可以在系统防火墙中自动为 Linux Virtual Desktop 打开所需端口（默认端口 80 和 1494）。
  • CTX_XDL_HDX_3D_PRO=Y | N – Linux VDA 支持 HDX 3D Pro，这是一组 GPU 加速技术，旨在优化富图形应用程序的虚拟化水平。如果选择了 HDX 3D Pro，则要为 VDI 桌面（单会话）模式配置 VDA -（即 CTX_XDL_VDI_MODE=Y）。
  • CTX_XDL_VDI_MODE=Y | N – 将计算机配置为专用桌面交付模型 (VDI) 还是托管共享桌面交付模型。对于 HDX 3D Pro 环境，将该值设置为 Y。
  • CTX_XDL_SITE_NAME=dns-name – Linux VDA 通过 DNS 发现 LDAP 服务器。要将 DNS 搜索结果限制为本地站点，应指定 DNS 站点名称。如果不需要，可以将其设置为 <none>。
  • CTX_XDL_LDAP_LIST=‘list-ldap-servers’ – Linux VDA 查询 DNS 来发现 LDAP 服务器。如果 DNS 无法提供 LDAP 服务记录，您可以提供以空格分隔的 LDAP FQDN（带有 LDAP 端口）列表。例如 ad1.mycompany.com:389。如果不需要，可以将其设置为 <none>。
  • CTX_XDL_SEARCH_BASE=search-base-set – Linux VDA 通过设置为 Active Directory 域根的搜索库来查询 LDAP（例如，DC=mycompany,DC=com）。为提高搜索性能，可以指定搜索基础（例如 OU=VDI,DC=mycompany,DC=com）。如果不需要，可以将其设置为 <none>。
  • CTX_XDL_FAS_LIST=‘list-fas-servers’ – 联合身份验证服务 (FAS) 服务器是通过 AD 组策略配置的。Linux VDA 不支持 AD 组策略，但您可以改为提供以分号分隔的 FAS 服务器的列表。顺序必须与在 AD 组策略中配置的顺序相同。如果删除了任何服务器地址，请使用 <none> 文本字符串填充其空白，并且不要修改服务器地址的顺序。
  • CTX_XDL_DOTNET_RUNTIME_PATH=path-to-install-dotnet-runtime - 安装 .NET Core Runtime 3.1 以支持新的 Broker 代理服务 (ctxvda) 的路径。默认路径为 /usr/bin。
  • CTX_XDL_START_SERVICE=Y | N – 在完成配置后，是否启动 Linux VDA 服务。
  • CTX_XDL_TELEMETRY_SOCKET_PORT - 用于侦听 Citrix Scout 的套接字端口。默认端口为 7503。
  • CTX_XDL_TELEMETRY_PORT - 用于与 Citrix Scout 通信的端口。默认端口为 7502。

如果未设置任何参数，安装将回滚到交互模式，提示用户输入。通过环境变量设置了所有参数时，ctxinstall.sh 脚本仍会提示用户输入安装 .NET Core Runtime 3.1 的路径。

在无提示模式下，必须运行以下命令以设置环境变量，然后运行 ctxinstall.sh 脚本。

export CTX_EASYINSTALL_HOSTNAME=host-name

export CTX_EASYINSTALL_DNS=ip-address-of-dns

export CTX_EASYINSTALL_NTPS=address-of-ntps

export CTX_EASYINSTALL_DOMAIN=domain-name

export CTX_EASYINSTALL_REALM=realm-name

export CTX_EASYINSTALL_FQDN=ad-fqdn-name

export CTX_EASYINSTALL_ADINTEGRATIONWAY=winbind | sssd | centrify | pbis

export CTX_EASYINSTALL_USERNAME=domain-user-name

export CTX_EASYINSTALL_PASSWORD=password

export CTX_XDL_SUPPORT_DDC_AS_CNAME=Y | N

export CTX_XDL_DDC_LIST=‘list-ddc-fqdns’

export CTX_XDL_VDA_PORT=port-number

export CTX_XDL_REGISTER_SERVICE=Y | N

export CTX_XDL_ADD_FIREWALL_RULES=Y | N

export CTX_XDL_HDX_3D_PRO=Y | N

export CTX_XDL_VDI_MODE=Y | N

export CTX_XDL_SITE_NAME=dns-site-name | '<none>'

export CTX_XDL_LDAP_LIST=‘list-ldap-servers’ | '<none>'

export CTX_XDL_SEARCH_BASE=search-base-set | '<none>'

export CTX_XDL_FAS_LIST=‘list-fas-servers’ | '<none>'

export CTX_XDL_DOTNET_RUNTIME_PATH=path-to-install-dotnet-runtime

export CTX_XDL_TELEMETRY_SOCKET_PORT=port-number

export CTX_XDL_TELEMETRY_PORT=port-number

export CTX_XDL_START_SERVICE=Y | N

sudo -E /opt/Citrix/VDA/sbin/ctxinstall.sh
<!--NeedCopy-->

运行 sudo 命令时，键入 -E 选项以将现有环境变量传递给它创建的新 shell。我们建议您使用前面的命令并加上 #!/bin/bash 作为第一行来创建 shell 脚本文件。

或者，您可以使用单个命令指定所有参数：

sudo CTX_XDL_SUPPORT_DDC_AS_CNAME=Y|N \

CTX_XDL_DDC_LIST=‘list-ddc-fqdns’ \

CTX_XDL_VDA_PORT=port-number \

CTX_XDL_REGISTER_SERVICE=Y|N \

CTX_XDL_ADD_FIREWALL_RULES=Y|N \

CTX_XDL_AD_INTEGRATION=1|2|3|4 \

CTX_XDL_HDX_3D_PRO=Y|N \

CTX_XDL_VDI_MODE=Y|N \

CTX_XDL_SITE_NAME=dns-name \

CTX_XDL_LDAP_LIST=‘list-ldap-servers’ \

CTX_XDL_SEARCH_BASE=search-base-set \

CTX_XDL_FAS_LIST=‘list-fas-servers’ \

CTX_XDL_DOTNET_RUNTIME_PATH=path-to-install-dotnet-runtime \

CTX_XDL_TELEMETRY_SOCKET_PORT=port-number \

CTX_XDL_TELEMETRY_PORT=port-number \

CTX_XDL_START_SERVICE=Y|N \

/opt/Citrix/VDA/sbin/ctxsetup.sh
<!--NeedCopy-->

故障排除

请使用此部分中的信息对可能因使用此功能而引发的问题进行故障排除。

使用 SSSD 加入域失败

尝试加入域时可能会出现错误，输出类似如下（要进行屏幕打印，请验证日志）：

Step 6: join Domain!Enter ctxadmin's password:Failed to join domain: failed to lookup DC info for domain 'CITRIXLAB.LOCAL' over rpc: The network name cannot be found

/var/log/xdl/vda.log：

2016-11-04 02:11:52.317 [INFO ] - The Citrix Desktop Service successfully obtained the following list of 1 delivery controller(s) with which to register: 'CTXDDC.citrixlab.local (10.158.139.214)'.
2016-11-04 02:11:52.362 [ERROR] - RegistrationManager.AttemptRegistrationWithSingleDdc: Failed to register with http://CTXDDC.citrixlab.local:80/Citrix/CdsController/IRegistrar. Error: General security error (An error occurred in trying to obtain a TGT: Client not found in Kerberos database (6))
2016-11-04 02:11:52.362 [ERROR] - The Citrix Desktop Service cannot connect to the delivery controller 'http://CTXDDC.citrixlab.local:80/Citrix/CdsController/IRegistrar' (IP Address '10.158.139.214')
Check the following:- The system clock is in sync between this machine and the delivery controller.
-  The Active Directory provider (e.g. winbind daemon) service is running and correctly configured.
-  Kerberos is correctly configured on this machine.
If the problem persists, please refer to Citrix Knowledge Base article CTX117248 for further information.
Error Details:
Exception 'General security error (An error occurred in trying to obtain a TGT: Client not found in Kerberos database (6))' of type 'class javax.xml.ws.soap.SOAPFaultException'.
2016-11-04 02:11:52.362 [INFO ] - RegistrationManager.AttemptRegistrationWithSingleDdc: The current time for this VDA is Fri Nov 04 02:11:52 EDT 2016.
Ensure that the system clock is in sync between this machine and the delivery controller.
Verify the NTP daemon is running on this machine and is correctly configured.
2016-11-04 02:11:52.364 [ERROR] - Could not register with any controllers. Waiting to try again in 120000 ms. Multi-forest - false
2016-11-04 02:11:52.365 [INFO ] - The Citrix Desktop Service failed to register with any controllers in the last 470 minutes.
<!--NeedCopy-->

/var/log/messages：

Nov 4 02:15:27 RH-WS-68 [sssd[ldap_child[14867]]]: Failed to initialize credentials using keytab [MEMORY:/etc/krb5.keytab]: Client 'RH-WS-68$@CITRIXLAB.LOCAL' not found in Kerberos database. Unable to create GSSAPI-encrypted LDAP connection.Nov 4 02:15:27 RH-WS-68 [sssd[ldap_child[14867]]]: Client 'RH-WS-68$@CITRIXLAB.LOCAL' not found in Kerberos database

要解决此问题，请执行以下操作：

  1. 运行 rm -f /etc/krb5.keytab 命令。
  2. 运行 net ads leave $REALM -U $domain-administrator 命令。
  3. 在 Delivery Controller 上删除计算机目录和交付组。
  4. 运行 /opt/Citrix/VDA/sbin/ctxinstall.sh。
  5. 在 Delivery Controller 上创建计算机目录和交付组。

Ubuntu 桌面会话显示灰屏

启动会话时会出现此问题，随后将在空桌面中阻止启动会话功能。此外，使用本地用户帐户登录时，计算机的控制台也显示灰屏。

要解决此问题，请执行以下操作：

  1. 运行 sudo apt-get update 命令。
  2. 运行 sudo apt-get install unity lightdm 命令。
  3. 向 /etc/lightdm/lightdm.conf 中添加以下行：
    greeter-show-manual-login=true

由于缺少主目录，尝试启动 Ubuntu 桌面会话失败

/var/log/xdl/hdx.log：

2016-11-02 13:21:19.015 <P22492:S1> citrix-ctxlogin: StartUserSession: failed to change to directory(/home/CITRIXLAB/ctxadmin) errno(2)

2016-11-02 13:21:19.017 <P22227> citrix-ctxhdx: logSessionEvent: Session started for user ctxadmin.

2016-11-02 13:21:19.023 <P22492:S1> citrix-ctxlogin: ChildPipeCallback: Login Process died: normal.

2016-11-02 13:21:59.217 <P22449:S1> citrix-ctxgfx: main: Exiting normally.
<!--NeedCopy-->

提示：

此问题的根本原因是没有为域管理员创建主目录。

要解决此问题，请执行以下操作：

  1. 在命令行中，键入 pam-auth-update。

  2. 在生成的对话框中，确认是否已选中 Create home directory login （创建主目录登录信息）。

    Ubuntu 无法启动会话的示意图

会话不启动，也不快速结束并显示 dbus 错误

/var/log/messages（适用于 RHEL 或 CentOS）：

Oct 27 04:17:16 CentOS7 citrix-ctxhdx[8978]: Session started for user CITRIXLAB\ctxadmin.

Oct 27 04:17:18 CentOS7 kernel: traps: gnome-session[19146] trap int3 ip:7f89b3bde8d3 sp:7fff8c3409d0 error:0

Oct 27 04:17:18 CentOS7 gnome-session[19146]: ERROR: Failed to connect to system bus: Exhausted all available authentication mechanisms (tried: EXTERNAL, DBUS_COOKIE_SHA1, ANONYMOUS) (available: EXTERNAL, DBUS_COOKIE_SHA1, ANONYMOUS)#012aborting...

Oct 27 04:17:18 CentOS7 gnome-session: gnome-session[19146]: ERROR: Failed to connect to system bus: Exhausted all available authentication mechanisms (tried: EXTERNAL, DBUS_COOKIE_SHA1, ANONYMOUS) (available: EXTERNAL, DBUS_COOKIE_SHA1, ANONYMOUS)

Oct 27 04:17:18 CentOS7 gnome-session: aborting...

Oct 27 04:17:18 CentOS7 citrix-ctxgfx[18981]: Exiting normally.

Oct 27 04:17:18 CentOS7 citrix-ctxhdx[8978]: Session stopped for user CITRIXLAB\ctxadmin.
<!--NeedCopy-->

或者，对于 Ubuntu 发行版，请使用日志 /var/log/syslog：

Nov  3 11:03:52 user01-HVM-domU pulseaudio[25326]: [pulseaudio] pid.c: Stale PID file, overwriting.

Nov  3 11:03:52 user01-HVM-domU pulseaudio[25326]: [pulseaudio] bluez5-util.c: Failed to get D-Bus connection: Did not receive a reply. Possible causes include: the remote application did not send a reply, the message bus security policy blocked the reply, the reply timeout expired, or the network connection was broken.

Nov  3 11:03:52 user01-HVM-domU pulseaudio[25326]: [pulseaudio] hashmap.c: Assertion 'h' failed at pulsecore/hashmap.c:116, function pa_hashmap_free(). Aborting.

Nov  3 11:03:52 user01-HVM-domU pulseaudio[25352]: [pulseaudio] core-util.c: Failed to connect to system bus: Did not receive a reply. Possible causes include: the remote application did not send a reply, the message bus security policy blocked the reply, the reply timeout expired, or the network connection was broken.

Nov  3 11:03:52 user01-HVM-domU pulseaudio[25352]: message repeated 10 times: [ [pulseaudio] core-util.c: Failed to connect to system bus: Did not receive a reply. Possible causes include: the remote application did not send a reply, the message bus security policy blocked the reply, the reply timeout expired, or the network connection was broken.]

Nov  3 11:03:52 user01-HVM-domU pulseaudio[25352]: [pulseaudio] pid.c: Daemon already running.Nov  3 11:03:58 user01-HVM-domU citrix-ctxgfx[24693]: Exiting normally
<!--NeedCopy-->

某些组或模块在重新启动后才会生效。如果日志中出现 dbus 错误消息，我们建议您重新启动系统并重试。

SELinux 可以防止 SSHD 访问主目录

用户可以启动会话，但不能登录。

/var/log/ctxinstall.log：

Jan 25 23:30:31 yz-rhel72-1 setroubleshoot[3945]: SELinux is preventing /usr/sbin/sshd from setattr access on the directory /root. For complete SELinux messages. run sealert -l 32f52c1f-8ff9-4566-a698-963a79f16b81

Jan 25 23:30:31 yz-rhel72-1 python[3945]: SELinux is preventing /usr/sbin/sshd from setattr access on the directory /root.

*****  Plugin catchall_boolean (89.3 confidence) suggests   ******************

If you want to allow polyinstantiation to enabled

   Then you must tell SELinux about this by enabling the 'polyinstantiation_enabled' boolean.

You can read 'None' man page for more details.

    Do

       setsebool -P polyinstantiation_enabled 1

*****  Plugin catchall (11.6 confidence) suggests   **************************

If you believe that sshd should be allowed setattr access on the root directory by default.

Then you should report this as a bug.

You can generate a local policy module to allow this access.

      Do

       allow this access for now by executing:

       # grep sshd /var/log/audit/audit.log | audit2allow -M mypol

# semodule -i mypol.pp
<!--NeedCopy-->

要解决此问题，请执行以下操作：

  1. 通过对 /etc/selinux/config 进行以下更改来禁用 SELinux。

    SELINUX=disabled

  2. 重新启动 VDA。

轻松安装
June 21, 2022
投稿者: 
C C
June 21, 2022
投稿者: 
C C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.