Linux Virtual Delivery Agent

查看 PDF

关于如何在 SUSE 系统上进行 Linux VDA 的手动安装

August 3, 2026

投稿者:

C C

重要提示：

对于全新安装，我们建议您使用轻松安装进行快速安装。轻松安装可节省时间和精力，并且比本文中详述的手动安装更不容易出错。

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

步骤 1a：启动 YaST 工具

SUSE Linux Enterprise YaST 工具是一款功能强大的工具，它被设计用于配置操作系统的所有方面。

要启动基于文本的 YaST 工具：

su -

yast
<!--NeedCopy-->

要启动基于 UI 的 YaST 工具：

su -

yast2 &
<!--NeedCopy-->

步骤 1b：配置网络

以下各节提供了有关配置 Linux VDA 所使用的各种网络设置和服务的信息。网络配置通过 YaST 工具进行，而不是通过 Network Manager 等其他方法进行。这些说明基于使用基于 UI 的 YaST 工具。可以使用基于文本的 YaST 工具，但其导航方法不同，此处未作说明。

配置主机名和域名系统 (DNS)

启动基于 UI 的 YaST 工具。
选择系统，然后选择 网络设置。
打开 主机名/DNS 选项卡。
为“通过 DHCP 设置主机名”选择“否”选项。
选择修改 DNS 配置的使用自定义策略选项。
编辑以下内容以反映您的网络设置：
- 静态主机名 – 添加计算机的 DNS 主机名。
- 名称服务器 – 添加 DNS 服务器的 IP 地址。它通常是 AD 域控制器的 IP 地址。
- 域搜索列表 – 添加 DNS 域名。
更改 /etc/hosts 文件中的以下行，以将 FQDN 和主机名作为前两个条目：

127.0.0.1 <FQDN of the VDA> <hostname of the VDA> localhost

注意：

Linux VDA 目前不支持 NetBIOS 名称截断。因此，主机名不得超过 15 个字符。 提示：

仅使用 a–z、A–Z、0–9 和连字符 (-) 字符。避免使用下划线 (_)、空格和其他符号。主机名不能以数字开头，也不能以连字符结尾。此规则也适用于 Delivery Controller 主机名。

检查主机名

验证主机名是否设置正确：

hostname
<!--NeedCopy-->

此命令仅返回计算机的主机名，而不返回其完全限定域名 (FQDN)。

验证 FQDN 是否设置正确：

hostname -f
<!--NeedCopy-->

此命令返回计算机的 FQDN。

检查名称解析和服务可达性

验证您是否能够解析 FQDN，并与域控制器和 Delivery Controller™ 进行 ping 通测试：

nslookup domain-controller-fqdn

ping domain-controller-fqdn

nslookup delivery-controller-fqdn

ping delivery-controller-fqdn
<!--NeedCopy-->

如果您无法解析 FQDN 或 ping 这些计算机中的任何一台，请在继续之前查看这些步骤。

步骤 1c：配置 NTP 服务

保持 VDA、Delivery Controller 和域控制器之间准确的时钟同步至关重要。将 Linux VDA 作为虚拟机 (VM) 托管可能会导致时钟偏差问题。因此，首选使用远程 NTP 服务来维护时间。可能需要对默认 NTP 设置进行一些更改。

适用于 SUSE 15.5：

启动基于 UI 的 YaST 工具。
选择网络服务，然后选择NTP 配置。
在启动 NTP 守护程序部分中，选择立即和启动时。
为配置源选择动态。
根据需要添加 NTP 服务器。NTP 服务通常托管在 Active Directory 域控制器上。
如果存在，请删除或注释掉 /etc/chrony.conf 中的以下行。

include /etc/chrony.d/*.conf

编辑 chrony.conf 后，重新启动 chronyd 服务。
```
sudo systemctl restart chronyd.service

```

步骤 1d：安装 Linux VDA 依赖包

适用于 SUSE Linux Enterprise 操作系统的 Linux VDA 软件依赖于以下软件包：

Open Motif 运行时环境 2.3.1 或更高版本
Cups 1.6.0 或更高版本
ImageMagick 图像处理软件 6.8 或更高版本

添加存储库

除了 ImageMagick 之外，您可以通过官方存储库获取大多数所需的软件包。要获取 ImageMagick 软件包，请使用 YaST 或以下命令启用 sle-module-desktop-applications 存储库：

SUSEConnect -p sle-module-desktop-applications/<version number>/x86_64

安装科尔贝罗斯客户端

安装科尔贝罗斯客户端，用于 Linux VDA 和交付控制器之间的相互身份验证：

sudo zypper install krb5-client
<!--NeedCopy-->

Kerberos 客户端配置取决于所使用的 Active Directory 集成方法。请参阅以下说明。

安装并指定要使用的数据库

注意：

我们建议您仅在 VDI 模式下使用 SQLite，并在托管共享桌面交付模型中使用 PostgreSQL。

为了便于安装和 MCS，您可以指定使用 SQLite 或 PostgreSQL，而无需手动安装它们。除非通过 /etc/xdl/db.conf 另行指定，否则 Linux VDA 默认使用 PostgreSQL。

对于手动安装，您必须手动安装 SQLite、PostgreSQL 或两者。如果您同时安装了 SQLite 和 PostgreSQL，则可以在安装 Linux VDA 软件包后通过编辑 /etc/xdl/db.conf 来指定使用其中一个。

本节介绍如何安装 PostgreSQL 和 SQLite 以及如何指定使用其中一个。

安装 PostgreSQL 数据库服务器

要安装 Postgresql，请运行以下命令：

sudo zypper install postgresql-server

sudo zypper install postgresql-jdbc
<!--NeedCopy-->

运行以下命令以在计算机启动时或立即启动 PostgreSQL：

sudo systemctl enable postgresql

sudo systemctl restart postgresql
<!--NeedCopy-->

安装 SQLite 数据库

对于 SUSE，请运行以下命令安装 SQLite：

sudo zypper install sqlite3
<!--NeedCopy-->

指定要使用的数据库

如果您同时安装了 SQLite 和 PostgreSQL，则可以在安装 Linux VDA 软件包后通过编辑 /etc/xdl/db.conf 来指定要使用的其中一个。

Run /opt/Citrix/VDA/sbin/ctxcleanup.sh. Omit this step if it is a fresh installation.

编辑 /etc/xdl/db.conf 以指定要使用的数据库。以下是 db.conf 文件的示例：

# database configuration file for Linux VDA

## database choice
# possible choices are:
#     SQLite
#     PostgreSQL
# default choice is PostgreSQL
DbType="PostgreSQL"


## database port
# specify database port for the database.
# if not specified, default port will be used:
# SQLite: N/A
# PostgreSQL: 5432
DbPort=5432


## PostgreSQL customized
# only the following value means true, otherwise false:
#     true
#     yes
#     y
#     YES
#     Y
# default is false
DbCustomizePostgreSQL=false

## PostgreSQL service name
# specify the service name of PostgreSQL for Linux VDA
# default is "postgresql"
DbPostgreSQLServiceName="postgresql"
<!--NeedCopy-->

To use a custom version of PostgreSQL, set DbCustomizePostgreSQL to true.

Run ctxsetup.sh.

注意：

You can also use /etc/xdl/db.conf to configure the port number for PostgreSQL.

步骤 2：准备虚拟机管理程序

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

Fix time synchronization on XenServer (formerly Citrix Hypervisor™)

如果启用了 XenServer® 时间同步功能，在每个半虚拟化 Linux VM 中，您会遇到 NTP 和 XenServer 的问题。两者都尝试管理系统时钟。为避免时钟与其他服务器不同步，请使用 NTP 同步每个 Linux 访客中的系统时钟。此情况需要禁用主机时间同步。在 HVM 模式下无需进行任何更改。

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

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

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

reboot
<!--NeedCopy-->

重新启动后，验证设置是否正确：

su -

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

此命令返回值为 1。

修复微软 Hyper-V 上的时间同步

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

从管理操作系统执行以下操作：

打开 Hyper-V 管理器控制台。
对于 Linux VM 的设置，选择 集成服务。
确保已选择 时间同步。

注意：

此方法与 VMware 和 XenServer（以前称为 Citrix Hypervisor）不同，在 VMware 和 XenServer 中，主机时间同步被禁用以避免与 NTP 冲突。Hyper-V 时间同步可以与 NTP 时间同步共存并对其进行补充。

修复 ESX 和 ESXi 上的时间同步

如果启用了 VMware 时间同步功能，则在每个半虚拟化 Linux VM 中，您都会遇到 NTP 和管理程序的问题。两者都尝试同步系统时钟。为避免时钟与其他服务器不同步，请使用 NTP 同步每个 Linux 访客中的系统时钟。此情况需要禁用主机时间同步。

如果您正在运行安装了 VMware Tools 的半虚拟化 Linux 内核：

打开 vSphere 客户端。
编辑 Linux VM 的设置。
在 虚拟机属性 对话框中，打开选项选项卡。
Select VMware Tools.
在高级框中，清除 将访客时间与主机同步。

步骤 3: 将 Linux 虚拟机添加到 Windows 域

以下方法可用于将 Linux 计算机添加到 Active Directory (AD) 域：

请根据您选择的方法按照说明操作。

注意：

当 Linux VDA 中的本地帐户和 AD 中的帐户使用相同的用户名时，会话启动可能会失败。

桑巴视窗绑定

加入视窗域

您的域控制器必须可访问，并且您必须拥有一个具有将计算机添加到域的权限的 Active Directory 用户帐户：

启动 YaST，选择“网络服务”，然后选择“Windows 域成员身份”。
进行以下更改：
- 将“域或工作组”设置为您的 Active Directory 域的名称或域控制器的 IP 地址。确保域名为大写。
- 勾选 使用 SMB 信息进行 Linux 身份验证。
  - 勾选 登录时创建主目录。
  - 勾选 SSH 单点登录。
  - 确保未勾选 脱机身份验证。此选项与 Linux VDA 不兼容。
单击确定。如果系统提示您安装某些软件包，请单击安装。
如果找到域控制器，它会询问您是否要加入域。单击是。
出现提示时，键入有权将计算机添加到域的域用户的凭据，然后单击确定。
手动重新启动服务或重新启动计算机。建议您重新启动计算机：
```
su -
reboot

```

验证域成员身份

交付控制器要求所有虚拟投递代理计算机（Windows 虚拟投递代理和 Linux 虚拟投递代理）在 Active Directory 中具有计算机对象。

运行 Samba 的 net ads 命令以验证计算机是否已加入域：

sudo net ads testjoin
<!--NeedCopy-->

运行以下命令以验证额外的域和计算机对象信息：

sudo net ads info
<!--NeedCopy-->

验证克贝罗斯配置

确保已创建系统 keytab 文件并包含有效密钥：

sudo klist –ke
<!--NeedCopy-->

此命令显示主体名称和密码套件的各种组合可用的密钥列表。运行 Kerberos kinit 命令以使用这些密钥通过域控制器对计算机进行身份验证：

sudo kinit -k MACHINE\$@REALM
<!--NeedCopy-->

机器和领域名称必须以大写形式指定。必须使用反斜杠 (\) 对美元符号 ($) 进行转义，以防止 shell 替换。在某些环境中，DNS 域名与 Kerberos 领域名称不同。确保使用领域名称。如果此命令成功，则不会显示任何输出。

使用以下命令验证计算机帐户的 TGT 票证是否已缓存：

sudo klist
<!--NeedCopy-->

使用以下命令检查计算机帐户详细信息：

sudo net ads status
<!--NeedCopy-->

验证用户身份验证

使用 wbinfo 工具验证域用户是否可以向域进行身份验证：

wbinfo --krb5auth=domain\\username%password
<!--NeedCopy-->

此处指定的域是 AD 域名，而不是 Kerberos 领域名称。对于 bash shell，反斜杠 (\) 字符必须用另一个反斜杠进行转义。此命令返回指示成功或失败的消息。

验证 Winbind PAM 模块是否已正确配置。为此，请使用以前未使用的域用户帐户登录到 Linux VDA。

ssh localhost -l domain\\username
id -u
<!--NeedCopy-->

验证是否为 id -u 命令返回的 uid 创建了相应的 Kerberos 凭据缓存文件：

ls /tmp/krb5cc_uid
<!--NeedCopy-->

验证用户 Kerberos 凭据缓存中的票证是否有效且未过期：

klist
<!--NeedCopy-->

退出会话。

exit
<!--NeedCopy-->

可以通过直接登录到 Gnome 或 KDE 控制台来执行类似的测试。完成域加入验证后，请继续执行 (/zh-cn/linux-virtual-delivery-agent/2402-ltsr/installation-overview/manual-installation-overview/suse.html#step-6-install-the-linux-vda)。

Quest 身份验证服务

在域控制器上配置 Quest

假设您已在域控制器上安装并配置了 Quest 软件，并且已获得在 Active Directory 中创建计算机对象的管理权限。

启用域用户登录到 Linux VDA 计算机

为了使域用户能够在 Linux VDA 计算机上建立 HDX™ 会话：

在“Active Directory 用户和计算机”管理控制台中，打开该用户帐户的 Active Directory 用户属性。
选择“Unix 帐户”选项卡。
选中“启用 Unix”。
将“主 GID 号”设置为实际域用户组的组 ID。

注意：

这些说明等同于设置域用户以使用控制台、RDP、SSH 或任何其他远程处理协议进行登录。

在 Linux VDA 上配置奎斯特

配置 VAS 守护程序

必须启用 Kerberos 票证的自动续订并断开连接。必须禁用身份验证（脱机登录）：

sudo /opt/quest/bin/vastool configure vas vasd auto-ticket-renew-interval 32400

sudo /opt/quest/bin/vastool configure vas vas_auth allow-disconnected-auth false
<!--NeedCopy-->

此命令将续订间隔设置为九小时（32,400 秒），比默认的 10 小时票证有效期少一小时。在票证有效期较短的系统上，将此参数设置为较低的值。

Configure PAM and NSS

要通过 HDX 和其他服务（例如 su、ssh 和 RDP）启用域用户登录，请手动配置 PAM 和 NSS：

sudo /opt/quest/bin/vastool configure pam

sudo /opt/quest/bin/vastool configure nss
<!--NeedCopy-->

Join Windows domain

Join the Linux machine to the Active Directory domain using the Quest vastool command:

sudo /opt/quest/bin/vastool -u user join domain-name
<!--NeedCopy-->

此处的 user 是指有权将计算机加入 Active Directory 域的任何域用户。domain-name 是指域的 DNS 名称，例如 example.com。

加入域后，重新启动 Linux 计算机。

验证域成员身份

Delivery Controller 要求所有 VDA 计算机（Windows VDA 和 Linux VDA）在 Active Directory 中具有计算机对象。要验证已加入 Quest 的 Linux 计算机是否在域中，请执行以下操作：

sudo /opt/quest/bin/vastool info domain
<!--NeedCopy-->

如果计算机已加入域，此命令将返回域名。如果计算机未加入任何域，则会出现以下错误：

ERROR: No domain could be found. ERROR: VAS_ERR_CONFIG: at ctx.c:414 in _ctx_init_default_realm default_realm not configured in vas.conf. Computer may not be joined to domain

验证用户身份验证

验证 Quest 是否可以通过 PAM 验证域用户。为此，请使用以前未使用的域用户帐户登录到 Linux VDA。

ssh localhost -l domain\\username
id -u
<!--NeedCopy-->

验证是否为 id -u 命令返回的 uid 创建了相应的 Kerberos 凭据缓存文件：

ls /tmp/krb5cc_uid
<!--NeedCopy-->

验证 Kerberos 凭据缓存中的票证是否有效且未过期：

/opt/quest/bin/vastool klist
<!--NeedCopy-->

退出会话。

exit
<!--NeedCopy-->

可以通过直接登录 Gnome 或 KDE 控制台来执行类似的测试。完成域加入验证后，继续执行步骤 6：安装 Linux VDA。

赛孚耐直接控制

加入到 Windows 域中

安装赛孚耐直接控制代理后，使用赛孚耐 adjoin 命令将 Linux 计算机加入 Active Directory 域：

sudo adjoin -w -V -u user domain-name
<!--NeedCopy-->

用户是任何有权将计算机加入 Active Directory 域的 Active Directory 域用户。域名称是要将 Linux 计算机加入的域的名称。

验证域成员身份

交付控制器要求所有 VDA 计算机（Windows 和 Linux VDA）在活动目录中具有计算机对象。要验证已加入 Centrify 的 Linux 计算机是否在域中：

sudo adinfo
<!--NeedCopy-->

验证 Joined to domain 值是否有效，以及 CentrifyDC 模式是否返回 connected。如果模式停留在启动状态，则 Centrify 客户端遇到服务器连接或身份验证问题。

可以使用以下命令获取更全面的系统和诊断信息：

adinfo --sysinfo all

adinfo –diag
<!--NeedCopy-->

测试与各种活动目录和 Kerberos 服务的连接。

adinfo --test
<!--NeedCopy-->

在域加入验证后，继续执行步骤 6：安装 Linux VDA。

SSSD

如果您在 SUSE 上使用 SSSD，请按照本节中的说明进行操作。本节包含将 Linux VDA 计算机加入 Windows 域的说明，并提供了配置 Kerberos 身份验证的指导。

要在 SUSE 上设置 SSSD，请完成以下步骤：

加入域并创建主机密钥表
对 SSSD 进行 PAM 配置
对 SSSD 进行设置
Enable SSSD
验证域成员身份
Verify the Kerberos configuration
验证用户身份验证

加入域并创建主机密钥表

SSSD 不提供用于加入域和管理系统密钥表文件的 Active Directory 客户端功能。您可以改用 Samba 方法。在配置 SSSD 之前，请完成以下步骤。

停止并禁用名称服务缓存守护程序 (NSCD) 守护程序。

sudo systemctl stop nscd
sudo systemctl disable nscd
<!--NeedCopy-->

检查主机名和 Chrony 时间同步。

hostname
hostname -f
chronyc traking
<!--NeedCopy-->

安装或更新所需的软件包：

sudo zypper install samba-client sssd-ad
<!--NeedCopy-->

以 root 用户身份编辑 /etc/krb5.conf 文件，以允许 kinit 实用程序与目标域通信。在 [libdefaults]、[realms] 和 [domain_realm] 部分下添加以下条目：

注意：

根据您的 AD 基础结构配置 Kerberos。以下设置适用于单域、单林模型。
```
[libdefaults]

    dns_canonicalize_hostname = false

    rdns = false

    default_realm = REALM

    forwardable = true

[realms]

    REALM = {

        kdc = fqdn-of-domain-controller

        default_domain = realm

        admin_server = fqdn-of-domain-controller
    }
[domain_realm]

    .realm = REALM

```
领域是科尔贝罗斯领域名称，例如 example.com。大写领域 是大写的科尔贝罗斯领域名称，例如 EXAMPLE.COM。
以 root 用户身份编辑 /etc/samba/smb.conf，以允许 net 实用程序与目标域通信。在 [global] 部分下添加以下条目：
```
[global]
    workgroup = domain

    client signing = yes

    client use spnego = yes

    kerberos method = secrets and keytab

    realm = REALM

    security = ADS

```
域是活动目录域的短 NetBIOS 名称，例如 EXAMPLE。
修改 /etc/nsswitch.conf 文件中的 passwd 和 group 条目，以便在解析用户和组时引用 SSSD。
```
passwd: compat sss

group: compat sss

```
使用配置的 Kerberos 客户端以管理员身份向目标域进行身份验证。
```
kinit administrator

```

使用 net 实用程序将系统加入域并生成系统密钥表文件。

net ads join osname="SUSE Linux Enterprise Server" osVersion=15 -U administrator
<!--NeedCopy-->

配置 PAM 以用于 SSSD

在为 SSSD 配置 PAM 之前，请安装或更新所需的软件包：

sudo zypper install sssd sssd-ad
<!--NeedCopy-->

配置 PAM 模块以通过 SSSD 进行用户身份验证，并为用户登录创建主目录。

sudo pam-config --add  --sss
sudo pam-config --add --mkhomedir
<!--NeedCopy-->

设置 SSSD 服务

以 root 用户身份编辑 /etc/sssd/sssd.conf，以允许 SSSD 守护程序与目标域通信。一个示例 sssd.conf 配置（可根据需要添加额外选项）：

[sssd]
    config_file_version = 2
    services = nss,pam
    domains = domain-dns-name

[domain/domain-dns-name]
    id_provider = ad
    auth_provider = ad
    access_provider = ad
    ad_domain = domain-dns-name
    ad_server = fqdn-of-domain-controller
    ldap_id_mapping = true
    ldap_schema = ad

# Kerberos settings
    krb5_ccachedir = /tmp
    krb5_ccname_template = FILE:%d/krb5cc_%U

# Comment out if the users have the shell and home dir set on the AD side

    fallback_homedir = /home/%d/%u
    default_shell = /bin/bash

# Uncomment and adjust if the default principal SHORTNAME$@REALM is not available

# ldap_sasl_authid = host/client.ad.example.com@AD.EXAMPLE.COM

    ad_gpo_access_control = permissive

<!--NeedCopy-->

domain-dns-name is the DNS domain name, such as example.com.

注意：

ldap_id_mapping is set to true so that SSSD itself takes care of mapping Windows SIDs to Unix UIDs. Otherwise, the Active Directory must be able to provide POSIX extensions. ad_gpo_access_control is set to permissive to prevent an invalid logon error for Linux sessions. See the man pages for sssd.conf and sssd-ad.

设置 sssd.conf 上的文件所有权和权限：

sudo chmod 0600 /etc/sssd/sssd.conf
<!--NeedCopy-->

Enable SSSD

运行以下命令以在系统启动时启用并启动 SSSD 守护程序：

sudo systemctl enable sssd
sudo systemctl start sssd
<!--NeedCopy-->

验证域成员身份

运行 Samba 的 net ads 命令以验证计算机是否已加入域：
```
sudo net ads testjoin

```
运行以下命令以验证额外的域和计算机对象信息：
```
sudo net ads info

```

Verify Kerberos configuration

确保已创建系统 keytab 文件并包含有效密钥：

sudo klist -ke
<!--NeedCopy-->

此命令显示了可用于主体名称和密码套件的各种组合的密钥列表。

运行 Kerberos kinit 命令，使用这些密钥向域控制器验证计算机：

sudo kinit –k MACHINE\$@REALM
<!--NeedCopy-->

计算机和领域名称必须以大写形式指定。美元符号 ($) 必须用反斜杠 (\) 转义，以防止 shell 替换。在某些环境中，DNS 域名与 Kerberos 领域名称不同。请确保使用领域名称。如果此命令成功，则不显示任何输出。

使用以下命令验证计算机帐户的 TGT 票证是否已缓存：

sudo klist
<!--NeedCopy-->

验证用户身份验证

SSSD 不提供用于直接通过守护程序测试身份验证的命令行工具，只能通过 PAM 完成。

要验证 SSSD PAM 模块是否配置正确，请使用以前未使用的域用户帐户登录 Linux VDA。

ssh localhost -l domain\\username

id -u

klist

exit
<!--NeedCopy-->

验证 klist 命令返回的 Kerberos 票证对该用户是否正确且未过期。

作为 root 用户，验证是否为上一个 id -u 命令返回的 uid 创建了相应的票证缓存文件：

ls /tmp/krb5cc_uid
<!--NeedCopy-->

可以通过直接登录 Gnome 或 KDE 控制台来执行类似的测试。完成域加入验证后，继续执行步骤 6：安装 Linux VDA。

派比斯

下载所需的 PBIS 软件包

例如：

wget https://github.com/BeyondTrust/pbis-open/releases/download/9.1.0/pbis-open-9.1.0.551.linux.x86_64.rpm.sh
<!--NeedCopy-->

使 PBIS 安装脚本可执行

例如：

chmod +x pbis-open-9.1.0.551.linux.x86_64.rpm.sh
<!--NeedCopy-->

运行 PBIS 安装脚本

例如：

sh pbis-open-9.1.0.551.linux.x86_64.rpm.sh
<!--NeedCopy-->

将计算机加入 Windows 域

您的域控制器必须可访问，并且您必须拥有一个具有将计算机添加到域的权限的 Active Directory 用户帐户：

/opt/pbis/bin/domainjoin-cli join domain-name user
<!--NeedCopy-->

用户是一个域用户，拥有将计算机添加到 Active Directory 域的权限。域名称 是域的 DNS 名称，例如 example.com。

Note: To set Bash as the default shell, run the /opt/pbis/bin/config LoginShellTemplate/bin/bash command.

验证域成员身份

交付控制器要求所有 VDA 计算机（Windows VDA 和 Linux VDA）在 Active Directory 中具有计算机对象。要验证已加入 PBIS 的 Linux 计算机是否在域中：

/opt/pbis/bin/domainjoin-cli query
<!--NeedCopy-->

如果计算机已加入域，此命令将返回有关当前加入的 AD 域和 OU 的信息。否则，仅显示主机名。

验证用户身份验证

验证 PBIS 是否可以通过 PAM 验证域用户。为此，请使用以前未使用的域用户帐户登录到 Linux VDA。

ssh localhost -l domain\\user

id -u
<!--NeedCopy-->

验证是否为 id -u 命令返回的 UID 创建了相应的 Kerberos 凭据缓存文件：

ls /tmp/krb5cc_uid
<!--NeedCopy-->

退出会话。

exit
<!--NeedCopy-->

在域加入验证之后，继续执行步骤 6：安装 Linux VDA。

步骤 4：安装 .NET

在安装 Linux VDA 之前，请按照系统要求安装 .NET。

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

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

步骤 5：下载 Linux VDA 软件包

转到 Citrix 虚拟应用和桌面下载页面。
展开相应版本的 Citrix 虚拟应用和桌面。
展开组件以查找 Linux VDA。例如：
单击 Linux 虚拟投递代理链接以访问 Linux 虚拟投递代理下载。
下载与您的 Linux 发行版匹配的 Linux VDA 软件包。
下载可用于验证 Linux VDA 软件包完整性的 GPG 公钥。例如：

要使用公钥验证 Linux VDA 软件包的完整性，请运行以下命令将公钥导入 RPM 数据库并检查软件包完整性：
```
rpmkeys --import <path to the public key>
rpm --checksig --verbose <path to the Linux VDA package>

```

步骤 6：安装 Linux 虚拟桌面代理

步骤 6a：卸载旧版本

如果您安装了除前两个版本和 LTSR 版本之外的早期版本，请在安装新版本之前将其卸载。

停止 Linux 虚拟桌面代理服务：
```
sudo systemctl stop ctxvda

sudo systemctl stop ctxhdx

```
注意：

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

卸载软件包：

sudo rpm -e XenDesktopVDA
<!--NeedCopy-->

重要提示：

支持从最近的两个版本进行升级。

注意：

您可以在 /opt/Citrix/VDA/ 下找到已安装的组件。

要运行命令，需要完整的路径；或者，您可以将 /opt/Citrix/VDA/sbin 和 /opt/Citrix/VDA/bin 添加到系统路径中。

步骤 6b: 安装 Linux 虚拟投递代理

使用 Zypper 安装 Linux 虚拟投递代理软件：

sudo zypper install XenDesktopVDA-<version>.sle15_x.x86_64.rpm
<!--NeedCopy-->

使用 RPM 包管理器安装 Linux VDA 软件：

sudo rpm -i XenDesktopVDA-<version>.sle15_x.x86_64.rpm
<!--NeedCopy-->

步骤 6c：升级 Linux VDA（可选）

Linux VDA 支持从最新版本进行升级。例如，您可以将 Linux VDA 从 2308 升级到 2311，以及从 1912 LTSR 升级到 2203 LTSR。

注意：

升级现有安装会覆盖 /etc/xdl 下的配置文件。在执行升级之前，请务必备份这些文件。

sudo rpm -U XenDesktopVDA-<version>.sle15_x.x86_64.rpm
<!--NeedCopy-->

SUSE 15 的 RPM 依赖项列表：

java-17-openjdk >= 17

ImageMagick >= 7.0

dbus-1 >= 1.12.2

dbus-1-x11 >= 1.12.2

xorg-x11 >= 7.6_1

libXpm4 >= 3.5.12

libXrandr2 >= 1.5.1

libXtst6 >= 1.2.3

pam >= 1.3.0

bash >= 4.4

findutils >= 4.6

gawk >= 4.2

sed >= 4.4

cups >= 2.2

cups-filters >= 1.25

libxml2-2 >= 2.9

libmspack0 >= 0.6

ibus >= 1.5

libtcmalloc4 >= 2.5

libcap-progs >= 2.26

mozilla-nss-tools >= 3.53.1

libpython3_6m1_0 >= 3.6~

libQt5Widgets5 >= 5.12

libqrencode4 >= 4.0.0

libImlib2-1 >= 1.4.10
<!--NeedCopy-->

重要：

升级后重新启动 Linux VDA 计算机。

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

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

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

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

确保客户机虚拟机已关闭。
在管理程序控制面板中，为虚拟机分配一个 GPU。
启动虚拟机。
在虚拟机上安装客户机虚拟机驱动程序（来自您的云供应商或 NVIDIA）。

步骤 8: 配置 Linux 虚拟投递代理

注意：

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

安装软件包后，您必须通过运行 ctxsetup.sh 脚本来配置 Linux VDA。在脚本进行任何更改之前，它会验证环境并确保所有依赖项都已安装。如有必要，您可以随时重新运行该脚本以更改设置。

您可以手动运行脚本并进行提示，也可以使用预配置的响应自动运行脚本。在继续之前，请查看有关该脚本的帮助：

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

提示引导式配置

运行带有提示问题的手动配置：

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

自动化的配置

对于自动化安装，请使用环境变量提供安装脚本所需的选项。如果所有必需的变量都存在，脚本将不会提示任何信息。

支持的环境变量包括：

CTX_XDL_NON_DOMAIN_JOINED=’y|n’ – 是否将计算机加入域。默认值为“n”。对于已加入域的场景，请将其设置为“n”。
CTX_XDL_AD_INTEGRATION=’winbind|sssd|centrify|pbis|quest’ – Linux 虚拟投递代理需要 Kerberos 身份验证协议的配置设置，以便能够与交付控制器进行身份验证。Kerberos 身份验证协议的配置由系统上已安装并配置的活动目录集成工具来确定。
CTX_XDL_DDC_LIST=’<list-ddc-fqdns>‘ – Linux VDA 需要一个以空格分隔的交付控制器完全限定域名 (FQDN) 列表，用于向交付控制器注册。必须至少指定一个 FQDN 或 CNAME。
CTX_XDL_VDI_MODE=’y|n’ – 配置计算机是作为专用桌面交付模型 (VDI) 还是托管共享桌面交付模型。对于 HDX 3D Pro 环境，请将此值设置为 ‘y’。
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_START_SERVICE=’y|n’ – 此参数用于确定在配置完成后是否启动 Linux VDA 服务。
CTX_XDL_REGISTER_SERVICE=’y|n’ – 此参数用于指定 Linux 虚拟桌面服务是否在计算机启动后启动。
CTX_XDL_ADD_FIREWALL_RULES=’y|n’ – Linux VDA 服务要求允许传入网络连接通过系统防火墙。您可以自动在系统防火墙中为 Linux Virtual Desktop 打开所需的端口（默认端口为 80 和 1494）。
CTX_XDL_DESKTOP_ENVIRONMENT=gnome/gnome-classic/mate/’<none>‘ – Specifies the GNOME, GNOME Classic, or MATE desktop environment to use in sessions. If you set it to ‘<none>‘, the default desktop configured on the VDA is used.

您还可以通过运行命令或使用系统托盘在桌面环境之间切换。有关详细信息，请参阅桌面切换命令和系统托盘。
CTX_XDL_DOTNET_RUNTIME_PATH=path-to-install-dotnet-runtime – The path to install .NET for supporting the new broker agent service (ctxvda). The default path is ‘/usr/bin’.
CTX_XDL_VDA_PORT=port-number – The Linux VDA communicates with Delivery Controllers through a TCP/IP port.
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 ad2.mycompany.com:3268 ad3.mycompany.com:3268。要在活动目录林中启用更快的 LDAP 查询，请在域控制器上启用全局编录，并将相关的 LDAP 端口号指定为 3268。此变量默认设置为 ‘<none>‘。
CTX_XDL_SEARCH_BASE=search-base-set – The Linux VDA queries LDAP through a search base set to the root of the Active Directory Domain (for example, DC=mycompany,DC=com). To improve search performance, you can specify a search base (for example, OU=VDI,DC=mycompany,DC=com). If unnecessary, set to ‘<none>‘.
CTX_XDL_SUPPORT_DDC_AS_CNAME=’y|n’ – The Linux VDA supports specifying a Delivery Controller name using a DNS CNAME record.

设置环境变量，然后运行配置脚本：

export CTX_XDL_NON_DOMAIN_JOINED='n'
export CTX_XDL_AD_INTEGRATION=winbind|centrify|sssd|pbis|quest
export CTX_XDL_DDC_LIST='<list-ddc-fqdns>'
export CTX_XDL_VDI_MODE='y|n'
export CTX_XDL_HDX_3D_PRO='y|n'
export CTX_XDL_START_SERVICE='y|n'
export CTX_XDL_REGISTER_SERVICE='y|n'
export CTX_XDL_ADD_FIREWALL_RULES='y|n'
export CTX_XDL_DESKTOP_ENVIRONMENT= gnome|gnome-classic|mate|'<none>'
export CTX_XDL_DOTNET_RUNTIME_PATH='<path-to-install-dotnet-runtime>'
export CTX_XDL_VDA_PORT='<port-number>'
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_SUPPORT_DDC_AS_CNAME='y|n'
sudo -E /opt/Citrix/VDA/sbin/ctxsetup.sh --silent
<!--NeedCopy-->

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

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

sudo CTX_XDL_NON_DOMAIN_JOINED='n' \
CTX_XDL_AD_INTEGRATION=winbind|centrify|sssd|pbis|quest \
CTX_XDL_DDC_LIST='<list-ddc-fqdns>' \
CTX_XDL_VDI_MODE='y|n' \
CTX_XDL_HDX_3D_PRO='y|n' \
CTX_XDL_START_SERVICE='y|n' \
CTX_XDL_REGISTER_SERVICE='y|n' \
CTX_XDL_ADD_FIREWALL_RULES='y|n' \
CTX_XDL_DESKTOP_ENVIRONMENT= gnome|gnome-classic|mate|'<none>' \
CTX_XDL_DOTNET_RUNTIME_PATH='<path-to-install-dotnet-runtime>' \
CTX_XDL_VDA_PORT='<port-number>' \
CTX_XDL_SITE_NAME='<dns-site-name>'|'<none>' \
CTX_XDL_LDAP_LIST='<list-ldap-servers>'|'<none>' \
CTX_XDL_SEARCH_BASE='<search-base-set>'|'<none>' \
CTX_XDL_SUPPORT_DDC_AS_CNAME='y|n' \
/opt/Citrix/VDA/sbin/ctxsetup.sh --silent
<!--NeedCopy-->

删除已进行的配置更改

在某些情况下，您可能需要删除由 ctxsetup.sh 脚本所做的配置更改，而无需卸载 Linux VDA 软件包。

在继续之前，请查看有关此脚本的帮助：

sudo /usr/local/sbin/ctxcleanup.sh --help
<!--NeedCopy-->

要删除配置更改：

sudo /usr/local/sbin/ctxcleanup.sh
<!--NeedCopy-->

重要提示：

此脚本将删除数据库中的所有配置数据，并使 Linux VDA 无法运行。

配置日志文件

ctxsetup.sh 和 ctxcleanup.sh 脚本在控制台上显示错误，并将附加信息写入配置日志文件：

/tmp/xdl.configure.log

重新启动 Linux VDA 服务以使更改生效。

步骤 9：运行 XDPing

运行 sudo /opt/Citrix/VDA/bin/xdping 以检查 Linux VDA 环境中的常见配置问题。有关详细信息，请参阅 XDPing。

步骤 10: 运行 Linux 虚拟投递代理

使用 ctxsetup.sh 脚本配置 Linux VDA 后，您可以运行以下命令来控制 Linux VDA。

启动 Linux 虚拟桌面代理：

要启动 Linux 虚拟桌面代理服务：

sudo systemctl start ctxhdx

sudo systemctl start ctxvda
<!--NeedCopy-->

停止 Linux 虚拟投递代理：

要停止 Linux 虚拟投递代理服务：

sudo systemctl stop ctxvda

sudo systemctl stop ctxhdx
<!--NeedCopy-->

注意：

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

重新启动 Linux 虚拟投递代理 (VDA)：

要重新启动 Linux VDA 服务：

sudo systemctl stop ctxvda

sudo systemctl restart ctxhdx

sudo systemctl restart ctxvda
<!--NeedCopy-->

检查 Linux 虚拟投递代理 (VDA) 状态：

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

sudo systemctl status ctxvda

sudo systemctl status ctxhdx
<!--NeedCopy-->

步骤 11: 创建计算机目录

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

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

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

注意：

早期版本的 Citrix Studio 不支持“Linux 操作系统”的概念。但是，选择“Windows Server 操作系统”或“服务器操作系统”选项意味着等效的托管共享桌面交付模型。选择“Windows 桌面操作系统”或“桌面操作系统”选项意味着每个计算机一个用户的交付模型。

提示：

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

步骤 12：创建交付组

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

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

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

重要：

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

有关如何创建计算机目录和交付组的信息，请参阅 Citrix 虚拟应用和桌面 7 2402 LTSR。

本产品文档的官方版本为英语版本。任何非英语版本仅为方便您而提供，可能包括机器翻译的内容。有关详细信息，请参阅 Cloud Software Group home 上的“机器翻译免责声明”。

这是否有帮助？

关于如何在 SUSE 系统上进行 Linux VDA 的手动安装

August 3, 2026

投稿者:

C C

August 3, 2026

投稿者:

C C

这是否有帮助？

关于如何在 SUSE 系统上进行 Linux VDA 的手动安装

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

步骤 1a：启动 YaST 工具

步骤 1b：配置网络

配置主机名和域名系统 (DNS)

检查主机名

检查名称解析和服务可达性

步骤 1c：配置 NTP 服务

步骤 1d：安装 Linux VDA 依赖包

添加存储库

安装科尔贝罗斯客户端

安装并指定要使用的数据库

安装 PostgreSQL 数据库服务器

安装 SQLite 数据库

指定要使用的数据库

步骤 2：准备虚拟机管理程序

Fix time synchronization on XenServer (formerly Citrix Hypervisor™)

修复 微软 Hyper-V 上的时间同步

修复 ESX 和 ESXi 上的时间同步

步骤 3: 将 Linux 虚拟机 添加到 Windows 域

桑巴 视窗绑定

加入 视窗域

验证域成员身份

验证 克贝罗斯 配置

验证用户身份验证

Quest 身份验证服务

在域控制器上配置 Quest

启用域用户登录到 Linux VDA 计算机

在 Linux VDA 上配置 奎斯特

配置 VAS 守护程序

Configure PAM and NSS

Join Windows domain

验证域成员身份

验证用户身份验证

赛孚耐 直接控制

加入到 Windows 域中

验证域成员身份

SSSD

加入域并创建主机密钥表

配置 PAM 以用于 SSSD

设置 SSSD 服务

Enable SSSD

验证域成员身份

Verify Kerberos configuration

验证用户身份验证

派比斯

下载所需的 PBIS 软件包

使 PBIS 安装脚本可执行

运行 PBIS 安装脚本

将计算机加入 Windows 域

验证域成员身份

验证用户身份验证

步骤 4：安装 .NET

步骤 5：下载 Linux VDA 软件包

步骤 6：安装 Linux 虚拟桌面代理

步骤 6a：卸载旧版本

步骤 6b: 安装 Linux 虚拟投递代理

步骤 6c：升级 Linux VDA（可选）

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

步骤 8: 配置 Linux 虚拟投递代理

提示引导式配置

自动化的配置

删除已进行的配置更改

配置日志文件

步骤 9：运行 XDPing

步骤 10: 运行 Linux 虚拟投递代理

步骤 11: 创建计算机目录

步骤 12：创建交付组

在本文中

修复微软 Hyper-V 上的时间同步

步骤 3: 将 Linux 虚拟机添加到 Windows 域

桑巴视窗绑定

加入视窗域

验证克贝罗斯配置

在 Linux VDA 上配置奎斯特

赛孚耐直接控制