Linux Virtual Delivery Agent 2411

Linux VDA 自助更新 通过 Azure

此功能有助于自动更新您的 Linux VDA 软件,可立即更新,也可按计划时间更新。当您在 Citrix DaaS Standard for Azure(以前称为 Citrix Virtual Apps and Desktops Standard for Azure)中创建 Linux VDA 时,此功能非常有用。您无需拥有 Azure 中 VM 的管理员权限。有关详细信息,请参阅在 Citrix DaaS Standard for Azure 中创建 Linux VDA

配置

要使用此功能,请完成以下步骤:

步骤 1:将更新信息和新 VDA 软件包上传到您的 Azure 容器

步骤 1a:在您的 Azure 存储帐户下创建容器,并将容器访问级别设置为 Blob (仅限 Blob 的匿名读取访问)

注意:

Azure 容器和 Blob 专由客户持有和管理。Citrix® 对其造成的任何安全问题概不负责。为确保数据安全和成本效益,请在每次自助更新后将容器访问级别设置为专用(无匿名访问)

步骤 1b:将您的 VDA 更新信息整合到名为 UpdateInfo.json 的 JSON 文件中。有关文件格式示例,请参阅以下代码块:

{
 "Version": "21.04.200.4",
"Distributions":[
{
"TargetOS": "RHEL7_9",
"PackageName": "",
"PackageHash": ""
},
{
-  "TargetOS": "UBUNTU20_04",
-  "PackageName": "",
-  "PackageHash": ""
}
]
}
<!--NeedCopy-->

其中,“Version” 指示新的 VDA 版本,而 “Distributions” 是一个更新对象数组。每个对象包含三个项:

  • “TargetOS”:必须是“RHEL7_9”(适用于 RHEL 7、CentOS 7 和 Amazon Linux 2)或“UBUNTU20_04”。ctxmonitord 不识别任何其他分发版。
  • “PackageName”:指定版本的 VDA 软件包的全名。
  • “PackageHash”:您使用 shasum -a 256 <pkgname> 命令计算的 SHA-256 值。

步骤 1c:将 JSON 文件和新版本的 Linux VDA 软件包上传到您的 Azure 容器。

步骤 2:在主映像上或在每个 VDA 上启用自助更新功能

默认情况下,自助更新处于禁用状态。如果您在 Citrix DaaS Standard for Azure 中创建 Linux VDA,则必须在主映像上启用此功能。否则,请直接在每个目标 VDA 上启用此功能。

要启用自助更新,请运行类似于以下内容的命令来编辑 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\SelfUpdate 处的注册表项。

/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\SelfUpdate" -t "REG_DWORD" -v "fEnabled" -d "0x00000001" --force

/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\SelfUpdate" -t "REG_SZ" -v "ScheduledTime" -d "Immediately" --force

/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\SelfUpdate" -t "REG_SZ" -v "Url" -d "<Your-Azure-Container-Url>" --force

/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\SelfUpdate" -t "REG_SZ" -v "CaCertificate" -d "<Local-Certificate-Path-of-PortalAzureCom>" --force
<!--NeedCopy-->

下表介绍了注册表设置。

注册表设置 描述
fEnabled 此设置为必需项。默认情况下,值为 0,表示自助更新处于禁用状态。您可以将其设置为 1 以启用自助更新
Url 此设置为必需项。它设置您的 Azure 容器的 URL,以获取更新信息和新的 VDA 软件包。
ScheduledTime 此设置为必需项。您可以将其设置为立即下次启动立即表示在下载 VDA 软件包后立即运行更新。当下载速度快且更新紧急时,此选项适用。但是,如果在下载软件包时有任何活动会话,它可能会中断用户体验。下次启动表示在 ctxmonitord 下次启动时运行更新。当下载速度不快且更新不紧急时,此选项适用。
CaCertificate 此设置为可选。它设置 PEM 证书的完整路径,以验证您的 Azure 容器的 URL。对于 Azure Blob,它可以是 portal.azure.com 的证书,该证书从浏览器中检索并转换为 PEM。为了安全起见,我们建议您添加此注册表设置,但 Ubuntu 或 Debian 不支持此设置,因为 curl 命令在使用 Ubuntu 或 Debian 上指定的证书文件验证对等方时无法按预期工作。请确保设置证书的最低权限。

ctxmonitord 重新启动时,它首先查询 Url 以获取 UpdateInfo.json 文件,并从 JSON 文件中检索更新版本。然后,ctxmonitord 将更新版本与当前版本进行比较。如果当前版本较早,该服务将从 Azure 下载新版本的 VDA 软件包并将其保存在本地。之后,它会根据 ScheduledTime 的设置运行更新。对于本地部署,您可以直接重新启动 ctxmonitord 以触发更新。但是,在 Citrix DaaS Standard for Azure 中,由于您没有 VM 的管理员权限,因此 ctxmonitord 只能在 VDA 计算机重新启动后才能重新启动。如果更新失败,您的 VDA 将回滚到现有版本。

注意:

  • 您在主映像上配置的注册表设置无法更改。
  • 如果环境中的所有 VM 同时下载软件包,则本地网络可能会拥堵。
  • 要从提供的 URL 下载,您必须在目标 VM 上安装 curl
  • 如果更新和回滚都失败,用户数据将丢失。
  • 如果更新失败但回滚成功,同一网络上的用户可能拥有不同版本的 Linux VDA。这种情况并非最佳。
  • 更新通常需要几分钟才能完成。Citrix Studio 中没有状态指示器。
Linux VDA 自助更新 通过 Azure