使用简易安装创建非域加入的 Linux VDA (预览版)
本文将指导您使用简易安装方法在 Citrix DaaS 中创建非域加入的 Linux VDA。
重要：
- 对于 Citrix DaaS，支持未加入域的 VDA。
- 您的控制平面必须通过 Citrix DaaS 进行部署。
- 您可以在公有云或本地数据中心部署非域加入的 VDA。非域加入的 VDA 由 Citrix DaaS 中的控制平面管理。
- 要创建非域加入的 VDA，使用 Citrix Gateway 服务的客户必须确保 Rendezvous V2 已启用。仅当您计划在本地管理程序上预配计算机或希望在 Workspace 中使用 Active Directory 作为身份提供程序时，才需要 Cloud Connector。
- 要创建非域加入的 VDA，您还可以使用 MCS。有关详细信息，请参阅 使用 MCS 创建非域加入的 Linux VDA。
- MCS 不支持裸机服务器。
- 非域加入的 Linux VDA 提供以下功能：
步骤 1：创建计算机目录
创建一个不包含任何计算机的空计算机目录。例如，使用 Citrix Remote PowerShell SDK 并运行以下命令来创建一个名为 Your-catalog-name 且支持单会话操作系统计算机的空计算机目录。
New-BrokerCatalog -AllocationType 'Static' -Description 'Your description' -MinimumFunctionalLevel 'L7_20' -Name 'Your-catalog-name' -SessionSupport 'SingleSession' -PersistUserChanges 'OnLocal' -ProvisioningType 'Manual' -MachinesArePhysical $true
<!--NeedCopy-->
记录所创建目录的 UUID。稍后创建注册令牌时需要此 UUID。
创建计算机目录和添加 Linux VDA 计算机的过程与传统的 Windows VDA 方法类似。有关如何完成这些任务的更详细说明，请参阅创建计算机目录 和管理计算机目录。
对于包含 Linux VDA 计算机的计算机目录，有一些限制使其与为 Windows VDA 计算机创建计算机目录的过程有所不同：
-
对于操作系统，请选择：
- 对于托管共享桌面交付模型，选择“多会话操作系统”选项。
- 对于 VDI 专用桌面交付模型，选择“单会话操作系统”选项。
- 请勿在同一个计算机目录中混合使用 Linux 和 Windows VDA 计算机。
- 请勿在同一个计算机目录中混合使用已加入域和未加入域的计算机。
- 远程电脑访问计算机目录仅支持已加入域的计算机，不支持未加入域的计算机。
注意：
Citrix Studio 的早期版本不支持“Linux 操作系统”的概念。但是，选择“Windows Server 操作系统”或“服务器操作系统”选项意味着等效的托管共享桌面交付模型。选择“Windows 桌面操作系统”或“桌面操作系统”选项意味着每台计算机一个用户的交付模型。
步骤 2：创建 VDA 注册令牌
要使用简易安装创建未加入域的 VDA，您需要一个令牌文件来将 VDA 注册到计算机目录并将 VDA 验证到 Citrix Cloud™ 控制平面。Linux VDA 不支持使用令牌文件注册到电源管理的计算机目录。
要创建注册令牌，请向以下 URL 发送类似于以下内容的 HTTP POST 消息：[DdcServerAddress]/citrix/orchestration/api/techpreview/{customerid}/{siteid}/enrollments。
POST https://[DdcServerAddress]/citrix/orchestration/api/techpreview/[customerid]/[siteid]/enrollments HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
Authorization: Bearer <bearer-token>
{
"TokenName": "string",
"IssuedToUser": "string",
"ExpirationDate": "2023-10-13T08:00:25.796Z",
"NotValidBeforeDate": "2023-10-13T08:00:25.796Z",
"NumMachinesAllowed": number,
"CatalogId": "string"
}
<!--NeedCopy-->
在 HTTP POST 消息中，将 CatalogId 设置为您之前创建的计算机目录的 UUID，并根据需要将 [DdcServerAddress] 设置为以下之一：
- 商业版
https://[customerid].xendesktop.net - 日本版
https://[customerid].apps.citrixworkspacesapi.jp - 政府版
https://[customerid].xendesktop.us
步骤 3：安装 .NET
在安装 Linux VDA 之前，请按照 系统要求 安装 .NET
安装 .NET 后，运行 which dotnet 命令以查找运行时路径。
根据命令输出，设置 .NET 运行时二进制路径。例如，如果命令输出为 /aa/bb/dotnet，则使用 /aa/bb 作为 .NET 二进制路径。
步骤 4：下载 Linux VDA 软件包
- 转到 Citrix 虚拟应用和桌面下载页面。
- 展开相应版本的 Citrix 虚拟应用和桌面。
-
展开 组件 以查找 Linux VDA。例如：
-
单击 Linux 虚拟桌面代理链接，以访问 Linux 虚拟桌面代理下载。
-
下载与您的 Linux 发行版匹配的 Linux VDA 软件包。
-
下载可用于验证 Linux VDA 软件包完整性的 GPG 公钥。例如：
要使用公钥验证 Linux VDA 软件包的完整性：
-
对于 RPM 软件包，运行以下命令将公钥导入 RPM 数据库并检查软件包完整性：
rpmkeys --import <path to the public key> rpm --checksig --verbose <path to the Linux VDA package> <!--NeedCopy--> -
对于 DEB 软件包，运行以下命令将公钥导入 DEB 数据库并检查软件包完整性：
sudo apt-get install dpkg-sig gpg --import <path to the public key> dpkg-sig --verify <path to the Linux VDA package> <!--NeedCopy-->
-
步骤 5：安装 Linux VDA 软件包
要为 Linux VDA 设置环境，请运行以下命令。
For Amazon Linux 2, CentOS, RHEL, and Rocky Linux distributions:
注意：
对于 RHEL 和 CentOS，请先安装 EPEL 存储库，然后才能成功安装 Linux VDA。有关如何安装 EPEL 的信息，请参阅 https://docs.fedoraproject.org/zh-cn/epel/ 处的说明。
在 RHEL 9.3/9.2/9.0 和 Rocky Linux 9.3/9.2/9.0 上安装 Linux VDA 之前，请将 libsepol 软件包更新到 3.4 或更高版本。
sudo yum -y localinstall <PATH>/<Linux VDA RPM>
<!--NeedCopy-->
注意：
在 GCP 上托管的 RHEL 8.x/9.x 和 Rocky Linux 8.x/9.x 上安装 Linux VDA 后，以太网连接可能会丢失，并且在 VM 重启后 Linux VDA 可能无法访问。要解决此问题，请在首次登录 VM 时设置 root 密码，并确保您可以以 root 身份登录 VM。然后，在重启 VM 后在控制台中运行以下命令：
nmcli dev connect eth0 systemctl restart NetworkManager <!--NeedCopy-->
以下是针对 Ubuntu/Debian 发行版的说明：
sudo dpkg -i <PATH>/<Linux VDA deb>
sudo apt-get install -f
<!--NeedCopy-->
注意：
要为 Debian 11 发行版安装必要的依赖项，请将
deb http://deb.debian.org/debian/ bullseye main行添加到 /etc/apt/sources.list 文件中。For Ubuntu 20.04 on GCP, disable RDNS. To do so, add the rdns = false line under [libdefaults] in /etc/krb5.conf.
对于 SUSE 发行版：
-
对于在 AWS、Azure 和 GCP 上运行的 SUSE 15.5，请确保：
- 您使用的是 libstdc++6 版本 12 或更高版本。
- The Default_WM parameter in /etc/sysconfig/windowmanager is set to “gnome”.
-
运行以下命令以安装 Linux VDA：
zypper -i install <PATH>/<Linux VDA RPM> <!--NeedCopy-->
步骤 6：安装 NVIDIA GRID 驱动程序
启用 HDX™ 3D Pro 需要您在管理程序和 VDA 计算机上安装 NVIDIA GRID 驱动程序。
要在特定管理程序上安装和配置 NVIDIA GRID 虚拟 GPU 管理器（主机驱动程序），请参阅以下指南：
要安装和配置 NVIDIA GRID 客户机 VM 驱动程序，请执行以下常规步骤：
- 确保客户机虚拟机已关闭。
- 在管理程序控制面板中，为虚拟机分配一个 GPU。
- 启动虚拟机。
- 在虚拟机上安装客户机虚拟机驱动程序（来自您的云供应商或 NVIDIA）。
步骤 7：指定要使用的数据库
在安装 Linux VDA 软件包后，您可以通过编辑 /etc/xdl/db.conf 文件来指定使用 SQLite 或 PostgreSQL 数据库。
To do so, edit /etc/xdl/db.conf before running sudo /opt/Citrix/VDA/sbin/ctxinstall.sh or /opt/Citrix/VDA/bin/easyinstall.
注意：
- 我们建议您仅在 VDI 模式下使用 SQLite。
- 对于轻松安装和 MCS，您可以指定使用 SQLite 或 PostgreSQL，而无需手动安装它们。除非通过 /etc/xdl/db.conf 另行指定，否则 Linux VDA 默认使用 PostgreSQL。
- 您还可以使用 /etc/xdl/db.conf 文件来配置 PostgreSQL 数据库的端口号。
步骤 8：运行轻松安装以配置环境和 VDA 以完成安装
安装 Linux VDA 软件包后，使用 ctxinstall.sh 脚本配置运行环境。
注意：
在设置运行时环境之前，请确保您的操作系统中已安装 en_US.UTF-8 区域设置。如果您的操作系统中没有该区域设置，请运行 sudo locale-gen en_US.UTF-8 命令。对于 Debian，请编辑 /etc/locale.gen 文件，取消注释 # en_US.UTF-8 UTF-8 行，然后运行 sudo locale-gen 命令。
ctxinstall.sh
ctxinstall.sh 是一个轻松安装脚本，用于执行一些预配置并设置 VDA 运行环境变量。
-
只有 root 用户才能运行此脚本。
- 轻松安装使用 /opt/Citrix/VDA/sbin/ctxinstall.conf 作为其配置文件，用于设置、保存和同步所有使用的环境变量的值。我们建议您仔细阅读模板 (ctxinstall.conf.tmpl)，然后自定义您自己的 ctxinstall.conf。首次创建配置文件时，请使用以下任一方法：
- By copying the /opt/Citrix/VDA/sbin/ctxinstall.conf.tmpl template file and saving it as /opt/Citrix/VDA/sbin/ctxinstall.conf.
- By running ctxinstall.sh. Each time you run ctxinstall.sh, your input is saved in /opt/Citrix/VDA/sbin/ctxinstall.conf.
-
轻松安装支持模块化运行。模块包括预检查、安装、域配置、设置和验证。
- 此脚本的调试详细信息可在 /var/log/xdl/ctxinstall.log 中找到。
有关详细信息，请使用帮助命令 ctxinstall.sh -h。
注意：
- 遵循最小权限原则，请确保只有 root 用户才能读取 /opt/Citrix/VDA/sbin/ctxinstall.conf，因为域加入密码可能在此文件中设置。
- Uninstalling the Linux VDA removes files under /opt/Citrix/VDA. We recommend you back up /opt/Citrix/VDA/sbin/ctxinstall.conf before uninstalling the VDA.
您可以在交互模式或静默模式下运行 ctxinstall.sh。运行脚本之前，请设置以下环境变量：
-
CTX_XDL_NON_DOMAIN_JOINED=’y|n’ – 是否将计算机加入域。 默认值为 ‘n’。对于非域加入方案，请将其设置为 ‘y’。
-
CTX_XDL_NDJ_ENROLLMENT_TOKEN_FILE=’<path-to-token-file-on-vda-machine>‘ – 要使用轻松安装创建非域加入 VDA，您需要一个令牌文件才能将 VDA 注册到 Delivery Controller 的计算机目录中。将令牌保存到具有最小权限的适当路径下的文件中。
- 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 – Specifies the GNOME, GNOME Classic, or MATE desktop environment to use in sessions. If you leave the variable unspecified, 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.
注意事项
-
您还可以通过完成以下步骤更改目标会话用户的桌面环境：
- 在 VDA 上的 $HOME/<username> 目录下创建
.xsession或.Xclients文件。如果您使用的是 Amazon Linux 2，请创建.Xclients文件。如果您使用的是其他分发版，请创建.xsession文件。 -
编辑
.xsession或.Xclients文件以根据分发版指定桌面环境。-
对于 MATE 桌面
MSESSION="$(type -p mate-session)" if [ -n "$MSESSION" ]; then exec mate-session fi <!--NeedCopy--> -
对于 GNOME 经典桌面
GSESSION="$(type -p gnome-session)" if [ -n "$GSESSION" ]; then export GNOME_SHELL_SESSION_MODE=classic exec gnome-session --session=gnome-classic fi <!--NeedCopy--> -
对于 GNOME 桌面
GSESSION="$(type -p gnome-session)" if [ -n "$GSESSION" ]; then exec gnome-session fi <!--NeedCopy-->
-
- 将 700 文件权限与目标会话用户共享。
从版本 2209 开始，会话用户可以自定义其桌面环境。要启用此功能，您必须提前在 VDA 上安装可切换的桌面环境。有关详细信息，请参阅会话用户自定义桌面环境。
- 在 VDA 上的 $HOME/<username> 目录下创建
交互模式
要在交互模式下运行 ctxinstall.sh 脚本，请使用不带 -S 选项的 sudo /opt/Citrix/VDA/sbin/ctxinstall.sh 命令。在命令行界面中的每个提示符处键入相关的变量值。如果变量已设置，ctxinstall.sh 会要求确认，以防您想要更改它。
静默模式
在静默模式下，您必须使用 /opt/Citrix/VDA/sbin/ctxinstall.conf 或 export 命令设置上述变量。之后，运行 ctxinstall.sh -S（请注意，这里的字母 S 是大写）。如果并非所有必需变量都已设置或某些值无效，ctxinstall.sh 将中止执行，除非存在默认值。
如果您设置了此项，那么每个变量的导出值都将覆盖 /Citrix/VDA/sbin/ctxinstall.conf 文件中的现有值。所有经过更新的值都将自动保存到 /Citrix/VDA/sbin/ctxinstall.conf 文件中。
export CTX_XDL_NON_DOMAIN_JOINED='y'
export CTX_XDL_NDJ_ENROLLMENT_TOKEN_FILE='<token-file-path>'
export CTX_XDL_VDI_MODE='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_HDX_3D_PRO='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>'
sudo -E /opt/Citrix/VDA/sbin/ctxinstall.sh -S
<!--NeedCopy-->
运行 sudo 命令时，键入 -E 选项以将现有环境变量传递给它创建的新 shell。我们建议您使用 #!/bin/bash 作为第一行，从上述命令创建一个 shell 脚本文件。
或者，您可以使用单个命令指定所有变量。
要设置 VDA 运行环境变量（以“CTX_XDL_”开头的变量），您可以运行 ctxinstall.sh -s（请注意，这里的字母 s 是小写）。
步骤 9：运行 XDPing
运行 sudo /opt/Citrix/VDA/bin/xdping 以检查 Linux VDA 环境中的常见配置问题。有关详细信息，请参阅XDPing。
步骤 10：运行 Linux 虚拟投递代理
启动 Linux 虚拟投递代理：
要启动 Linux 虚拟投递代理服务：
sudo systemctl start ctxhdx.service
sudo systemctl start ctxvda.service
<!--NeedCopy-->
停止 Linux 虚拟交付代理：
要停止 Linux VDA 服务，请执行以下操作：
sudo systemctl stop ctxvda.service
sudo systemctl stop ctxhdx.service
<!--NeedCopy-->
注意：
在停止 ctxvda 和 ctxhdx 服务之前，请运行 systemctl stop ctxmonitord 命令以停止监视器服务守护程序。否则，监视器服务守护程序会重新启动您停止的服务。
重新启动 Linux 虚拟交付代理：
要重新启动 Linux VDA 服务，请执行以下操作：
sudo systemctl stop ctxvda.service
sudo systemctl restart ctxhdx.service
sudo systemctl start ctxvda.service
<!--NeedCopy-->
检查 Linux VDA 的运行状态：
要检查 Linux VDA 服务的运行状态，请执行以下操作：
sudo systemctl status ctxvda.service
sudo systemctl status ctxhdx.service
<!--NeedCopy-->
步骤 11：创建交付组
创建交付组和添加包含 Linux VDA 计算机的计算机目录的过程与 Windows VDA 计算机几乎相同。有关如何完成这些任务的更详细说明，请参阅创建交付组。
对于创建包含 Linux VDA 计算机目录的交付组，适用以下限制：
- 确保您选择的 AD 用户和组已正确配置为登录到 Linux VDA 计算机。
- 不允许未经身份验证（匿名）的用户登录。
- 请勿将交付组与包含 Windows 计算机的计算机目录混合使用。
重要提示：
发布应用程序受 Linux VDA 1.4 版及更高版本支持。但是，Linux VDA 不支持将桌面和应用程序交付到同一台计算机。
有关如何创建计算机目录和交付组的信息，请参阅 思杰虚拟应用和桌面 7 2402 LTSR。