Linux Virtual Delivery Agent

使用简易安装进行快速安装（推荐）

April 17, 2026

投稿者:

C C

重要提示：

对于全新安装，建议您参考本文进行快速安装。本文详细介绍了如何使用简易安装来安装和配置 Linux VDA。简易安装可节省时间和精力，并且比手动安装更不容易出错。它通过自动安装必要的软件包和自定义配置文件来帮助您设置 Linux VDA 的运行环境。

支持的发行版

	Winbind	SSSD	Centrify	PBIS
RHEL 7.7	是	是	是	是
RHEL 6.10	是	是	是	否
CentOS 7.7	是	是	是	是
CentOS 6.10	是	是	是	否
Ubuntu 18.04	是	是	是	是
Ubuntu 16.04	是	是	是	是
SUSE 12.3	是	否	是	否

使用简易安装

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

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

收集简易安装所需的以下配置信息：

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

重要提示：

要安装 Linux VDA，请验证存储库是否已正确添加到 Linux 计算机上。

要启动会话，请验证是否已安装 X Window 系统和桌面环境。

注意事项

工作组名称默认为域名。要在您的环境中自定义工作组，请执行以下操作：
- a. 在 Linux VDA 计算机上创建 /tmp/ctxinstall.conf 文件。
- b. 将 workgroup=\<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.
 
```
此问题是 Centrify 及其配置所特有的。要解决此问题，请执行以下操作：

a. 在域控制器上打开管理工具。 b. 选择Active Directory 站点和服务。 c. 为子网添加适当的子网地址。
- 从 Linux VDA 7.16 开始，简易安装支持纯 IPv6。适用以下前提条件和限制：
- 必须配置您的 Linux 存储库，以确保您的计算机可以通过纯 IPv6 网络下载所需的软件包。
- Centrify 不支持纯 IPv6 网络。
注意：

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

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

简易安装可帮助自动从 Internet 下载 Centrify 软件包。以下是每个发行版的 URL：

RHEL: wget http://edge.centrify.com/products/centrify-suite/2016-update-1/installers/centrify-suite-2016.1-rhel4-x86_64.tgz?_ga=1.178323680.558673738.1478847956

CentOS: wget http://edge.centrify.com/products/centrify-suite/2016-update-1/installers/centrify-suite-2016.1-rhel4-x86_64.tgz?_ga=1.186648044.558673738.1478847956
SUSE: wget http://edge.centrify.com/products/centrify-suite/2016-update-1/installers/centrify-suite-2016.1-suse10-x86_64.tgz?_ga=1.10831088.558673738.1478847956

Ubuntu: wget http://edge.centrify.com/products/centrify-suite/2016-update-1/installers/centrify-suite-2016.1-deb7-x86_64.tgz?_ga=1.178323680.558673738.1478847956

从本地目录中获取 Centrify 软件包。要指定 Centrify 软件包的目录，请执行以下操作：

a. 如果 Linux VDA 服务器上不存在 /tmp/ctxinstall.conf 文件，请创建该文件。 b. 将 centrifypkgpath=\<path name\> 行添加到文件中。

例如：

 cat /tmp/ctxinstall.conf
 set "centrifypkgpath=/home/mydir"
 ls  -ls  /home/mydir
     9548 -r-xr-xr-x. 1 root root  9776688 May 13  2016 adcheck-rhel4-x86_64
 4140 -r--r--r--. 1 root root 4236714 Apr 21 2016 centrifyda-3.3.1-rhel4-x86_64.rpm
   33492 -r--r--r--. 1 root root 34292673 May 13  2016 centrifydc-5.3.1-rhel4-x86_64.rpm
     4 -rw-rw-r--. 1 root root     1168 Dec  1  2015 centrifydc-install.cfg
     756 -r--r--r--. 1 root root   770991 May 13  2016 centrifydc-ldapproxy-5.3.1-rhel4-x86_64.rpm
     268 -r--r--r--. 1 root root   271296 May 13  2016 centrifydc-nis-5.3.1-rhel4-x86_64.rpm
     1888 -r--r--r--. 1 root root  1930084 Apr 12  2016 centrifydc-openssh-7.2p2-5.3.1-rhel4-x86_64.rpm
     124 -rw-rw-r--. 1 root root   124543 Apr 19  2016 centrify-suite.cfg
     0 lrwxrwxrwx. 1 root root       10 Jul  9  2012 install-express.sh -> install.sh
     332 -r-xr-xr--. 1 root root   338292 Apr 10  2016 install.sh
     12 -r--r--r--. 1 root root    11166 Apr  9  2015 release-notes-agent-rhel4-x86_64.txt
     4 -r--r--r--. 1 root root     3732 Aug 24  2015 release-notes-da-rhel4-x86_64.txt
     4 -r--r--r--. 1 root root     2749 Apr  7  2015 release-notes-nis-rhel4-x86_64.txt
     12 -r--r--r--. 1 root root     9133 Mar 21  2016 release-notes-openssh-rhel4-x86_64.txt
 <!--NeedCopy-->

如果您选择 PBIS 作为加入域的方法，则 ctxinstall.sh 脚本需要 PBIS 软件包。ctxinstall.sh 获取 PBIS 软件包有两种方式：
- 简易安装可帮助自动从 Internet 下载 PBIS 软件包。以下是每个发行版的 URL：
  
  RHEL 7 / CentOS 7: wget https://github.com/BeyondTrust/pbis-open/releases/download/8.8.0/pbis-open-8.8.0.506.linux.x86_64.rpm.sh
  
  Ubuntu: wget https://github.com/BeyondTrust/pbis-open/releases/download/8.8.0/pbis-open-8.8.0.506.linux.x86_64.deb.sh
- 从 Internet 获取特定版本的 PBIS 软件包。为此，请更改 /opt/Citrix/VDA/sbin/ctxinstall.sh 文件中的 pbisDownloadPath 行以指定 PBIS 软件包的 URL。
  
  有关示例，请参阅以下屏幕截图：

步骤 2：准备管理程序

在受支持的管理程序上将 Linux VDA 作为虚拟机运行时，需要进行一些更改。请根据所使用的管理程序平台进行以下更改。如果您在裸机硬件上运行 Linux 计算机，则无需进行任何更改。

修复 Citrix Hypervisor™ 上的时间同步

启用 Citrix Hypervisor 时间同步功能后，在每个半虚拟化 Linux VM 中，NTP 和 Citrix Hypervisor 都会尝试管理系统时钟，这会导致问题。为避免时钟与其他服务器不同步，请确保每个 Linux 访客中的系统时钟与 NTP 同步。在这种情况下，需要禁用主机时间同步。HVM 模式下无需进行任何更改。

在某些 Linux 发行版上，如果您正在运行安装了 Citrix VM Tools 的半虚拟化 Linux 内核，则可以从 Linux VM 中检查 Citrix Hypervisor 时间同步功能是否存在并已启用：

su -

cat /proc/sys/xen/independent_wallclock
<!--NeedCopy-->

此命令返回 0 或 1：

0 - 时间同步功能已启用，必须禁用。
1 - 时间同步功能已禁用，无需进一步操作。

如果 /proc/sys/xen/independent_wallclock 文件不存在，则无需执行以下步骤。

如果已启用，请通过向文件写入 1 来禁用时间同步功能：

sudo echo 1 > /proc/sys/xen/independent_wallclock
<!--NeedCopy-->

要使此更改在重新启动后永久保留，请编辑 /etc/sysctl.conf 文件并添加以下行：

xen.independent_wallclock = 1

要验证这些更改，请重新启动系统：

su -

cat /proc/sys/xen/independent_wallclock
<!--NeedCopy-->

此命令返回值为 1。

修复 Microsoft Hyper-V 上的时间同步

安装了 Hyper-V Linux Integration Services 的 Linux VM 可以应用 Hyper-V 时间同步功能来使用主机操作系统的时钟。为确保系统时钟保持准确，您必须在 NTP 服务的同时启用此功能。

从管理操作系统：

打开 Hyper-V 管理器控制台。

1. 对于 Linux VM 的设置，选择 Integration Services。
1. 确保选中了 Time synchronization。
注意：
此方法与 VMware 和 Citrix Hypervisor 不同，在 VMware 和 Citrix Hypervisor 中，主机时间同步被禁用以避免与 NTP 冲突。Hyper-V 时间同步可以与 NTP 时间同步共存并对其进行补充。
修复 ESX 和 ESXi 上的时间同步

启用 VMware 时间同步功能后，在每个半虚拟化 Linux VM 中，NTP 和管理程序都会尝试同步系统时钟，这会导致问题。为避免时钟与其他服务器不同步，请确保每个 Linux 访客中的系统时钟与 NTP 同步。在这种情况下，需要禁用主机时间同步。

如果您正在运行安装了 VMware Tools 的半虚拟化 Linux 内核：
1. 打开 vSphere Client。
1. 编辑 Linux VM 的设置。
1. 在 Virtual Machine Properties（虚拟机属性）对话框中，打开 Options（选项）选项卡。
1. 选择 VMware Tools。
1. 在 Advanced（高级）框中，清除 Synchronize guest time with host（将访客时间与主机同步）。
步骤 3：安装 .NET Core Runtime 作为必备条件
在安装 Linux VDA 之前，请按照 https://docs.microsoft.com/en-us/dotnet/core/install/linux-package-managers 上的说明安装 .NET Core Runtime。
对于 1912 LTSR 初始版本、CU1 和 CU2，请安装 .NET Core Runtime 2.1。
- 对于 CU3 及更高版本，请安装 .NET Core Runtime 3.1。

安装 .NET Core Runtime 后，运行 which dotnet 命令以查找运行时路径。

根据命令输出，设置 .NET Core 运行时二进制路径。例如，如果命令输出为 /aa/bb/dotnet，则使用 /aa/bb 作为 .NET 二进制路径。

步骤 4：下载 Linux VDA 软件包

转到 Citrix Virtual Apps and Desktops 下载页面。展开相应版本的 Citrix Virtual Apps and Desktops，然后单击 Components（组件）以下载与您的 Linux 发行版匹配的 Linux VDA 软件包。

步骤 5：安装 Linux VDA 软件包

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

对于 RHEL 和 CentOS 发行版：

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

对于 Ubuntu 发行版：

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

对于 SUSE 发行版：

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

步骤 6：安装 NVIDIA GRID 驱动程序

启用 HDX™ 3D Pro 需要在您的管理程序和 VDA 计算机上安装 NVIDIA GRID 驱动程序。

要在特定的管理程序上安装和配置 NVIDIA GRID Virtual GPU Manager（主机驱动程序），请参阅以下指南：

-  [Citrix Hypervisor](/zh-cn/citrix-hypervisor/graphics/vm-graphics-config.html#install-the-nvidia-drivers)

VMware ESX

要安装和配置 NVIDIA GRID 访客 VM 驱动程序，请执行以下常规步骤：

确保客户机 VM 已关闭。
在管理程序控制面板中，为 VM 分配 GPU。
启动 VM。
在 VM 上安装客户机 VM 驱动程序。

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

注意：

在设置运行时环境之前，请确保您的操作系统中已安装 en_US.UTF-8 区域设置。如果您的操作系统中没有该区域设置，请运行 sudo locale-gen en_US.UTF-8 命令。

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

注意：

轻松安装在下载大小超过 27 MB 的 .NET Core Runtime 时，可能看起来没有响应。检查 /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 VDA 所需的端口（默认端口 80 和 1494）。
CTX_XDL_HDX_3D_PRO=Y | N – Linux VDA 支持 HDX 3D Pro，这是一组 GPU 加速技术，旨在优化富图形应用程序的虚拟化。如果选择 HDX 3D Pro，VDA 将配置为 VDI 桌面（单会话）模式 - （即 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 的路径，用于支持新的代理代理服务 (ctxvda)。默认路径为 /usr/bin。
CTX_XDL_START_SERVICE=Y | N – 配置完成后是否启动 Linux VDA 服务。

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

在静默模式下，您必须运行以下命令来设置环境变量，然后运行 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_START_SERVICE=Y | N

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

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

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

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_START_SERVICE=Y|N \

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

步骤 8：运行 XDPing

我们提供了一个命令行实用程序，即 Linux XDPing 工具，用于检查 Linux VDA 环境中的常见配置问题。您可以在运行受支持的 Linux 发行版的任何计算机上安装 XDPing 软件包。XDPing 不需要将 Linux VDA 软件包安装在计算机上。有关该工具的更多信息，请参阅知识中心文章 CTX202015。

步骤 9：运行 Linux VDA

启动 Linux VDA：

要启动 Linux VDA 服务：

sudo /sbin/service ctxhdx start

sudo /sbin/service ctxvda start
<!--NeedCopy-->

停止 Linux VDA：

要停止 Linux VDA 服务：

sudo /sbin/service ctxvda stop

sudo /sbin/service ctxhdx stop
<!--NeedCopy-->

注意：

在停止 ctxvda 和 ctxhdx 服务之前，请运行 service ctxmonitorservice stop 命令以停止监视器服务守护程序。否则，监视器服务守护程序会重新启动您停止的服务。

重新启动 Linux VDA：

要重新启动 Linux VDA 服务：

sudo /sbin/service ctxvda stop

sudo /sbin/service ctxhdx restart

sudo /sbin/service ctxvda start
<!--NeedCopy-->

检查 Linux VDA 的状态：

要检查 Linux VDA 服务的运行状态：

sudo /sbin/service ctxvda status

sudo /sbin/service ctxhdx status
<!--NeedCopy-->

步骤 10：在 Citrix Virtual Apps 或 Citrix Virtual Desktops™ 中创建计算机目录

创建计算机目录和添加 Linux VDA 计算机的过程与传统的 Windows VDA 方法类似。有关如何完成这些任务的更详细说明，请参阅创建计算机目录和管理计算机目录。

对于包含 Linux VDA 计算机的计算机目录，存在一些限制，使该过程与为 Windows VDA 计算机创建计算机目录不同：

对于操作系统，请选择：
- 对于托管共享桌面交付模型，选择 Multi-session OS 选项。
- 对于 VDI 专用桌面交付模型，选择 Single-session OS 选项。
请勿在同一计算机目录中混合使用 Linux 和 Windows VDA 计算机。

注意：

Citrix Studio 的早期版本不支持“Linux OS”的概念。但是，选择 Windows Server OS 或 Server OS 选项意味着等效的托管共享桌面交付模型。选择 Windows Desktop OS 或 Desktop OS 选项意味着每台计算机单个用户交付模型。

提示：

如果您将计算机从 Active Directory 域中移除并重新加入，则必须再次将该计算机从计算机目录中移除并重新添加。

步骤 11：在 Citrix Virtual Apps™ 或 Citrix Virtual Desktops 中创建交付组

创建交付组以及添加包含 Linux VDA 计算机的计算机目录的过程与 Windows VDA 计算机几乎相同。有关如何完成这些任务的更详细说明，请参阅创建交付组。

对于创建包含 Linux VDA 计算机目录的交付组，适用以下限制：

确保您选择的 AD 用户和组已正确配置为可登录 Linux VDA 计算机。
不允许未经身份验证（匿名）的用户登录。
请勿将交付组与包含 Windows 计算机的计算机目录混合使用。

重要提示：

发布应用程序受 Linux VDA 1.4 版及更高版本支持。但是，Linux VDA 不支持将桌面和应用程序交付到同一台计算机。

有关如何创建计算机目录和交付组的信息，请参阅 Citrix Virtual Apps and Desktops 7 1912 LTSR。

故障排除

使用本节中的信息来排查使用此功能时可能出现的问题。

使用 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

要解决此问题：

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

Ubuntu 桌面会话显示灰屏

当您启动会话后会话被阻止在空白桌面上时，会出现此问题。此外，当您使用本地用户帐户登录时，计算机控制台也会显示灰屏。

要解决此问题：

运行 sudo apt-get update 命令。
运行 sudo apt-get install unity lightdm 命令。
将以下行添加到 /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-->

提示：

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

要解决此问题：

在命令行中，键入 pam-auth-update。
在出现的对话框中，验证是否已选择 Create home directory login。

会话未启动或因 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-->

要解决此问题：

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

SELINUX=disabled
重新启动 VDA。

本内容的正式版本为英文版。部分 Cloud Software Group 文档内容采用了机器翻译，仅供您参考。Cloud Software Group 无法控制机器翻译的内容，这些内容可能包含错误、不准确或不合适的语言。对于从英文原文翻译成任何其他语言的内容的准确性、可靠性、适用性或正确性，或者您的 Cloud Software Group 产品或服务沿用了任何机器翻译的内容，我们均不作任何明示或暗示的保证，并且适用的最终用户许可协议或服务条款或者与 Cloud Software Group 签订的任何其他协议（产品或服务与已进行机器翻译的任何文档保持一致）下的任何保证均不适用。对于因使用机器翻译的内容而引起的任何损害或问题，Cloud Software Group 不承担任何责任。

这是否有帮助？

使用简易安装进行快速安装（推荐）

April 17, 2026

投稿者:

C C

April 17, 2026

投稿者:

C C

在本文中

支持的发行版
使用简易安装
步骤 2：准备管理程序
步骤 3：安装 .NET Core Runtime 作为必备条件
步骤 4：下载 Linux VDA 软件包
步骤 5：安装 Linux VDA 软件包
步骤 6：安装 NVIDIA GRID 驱动程序
步骤 7：设置运行时环境以完成安装
步骤 8：运行 XDPing
步骤 9：运行 Linux VDA
步骤 10：在 Citrix Virtual Apps 或 Citrix Virtual Desktops™ 中创建计算机目录
步骤 11：在 Citrix Virtual Apps™ 或 Citrix Virtual Desktops 中创建交付组
故障排除

这是否有帮助？

使用简易安装进行快速安装（推荐）

支持的发行版

使用简易安装

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

注意事项

步骤 2：准备管理程序

修复 Citrix Hypervisor™ 上的时间同步

修复 Microsoft Hyper-V 上的时间同步

修复 ESX 和 ESXi 上的时间同步

步骤 3：安装 .NET Core Runtime 作为必备条件

步骤 4：下载 Linux VDA 软件包

步骤 5：安装 Linux VDA 软件包

步骤 6：安装 NVIDIA GRID 驱动程序

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

步骤 8：运行 XDPing

步骤 9：运行 Linux VDA

步骤 10：在 Citrix Virtual Apps 或 Citrix Virtual Desktops™ 中创建计算机目录

步骤 11：在 Citrix Virtual Apps™ 或 Citrix Virtual Desktops 中创建交付组

故障排除

使用 SSSD 加入域失败

Ubuntu 桌面会话显示灰屏

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

会话未启动或因 dbus 错误而快速结束

SELinux 阻止 SSHD 访问主目录

在本文中