Citrix DaaS™

将云配置迁移到本地部署

本文介绍如何备份云配置并将其迁移到本地站点。

迁移配置的先决条件

  • 具有至少一个已注册 VDA 的 Citrix Virtual Apps and Desktops™ 本地部署环境。
  • 运行以下版本之一的 Citrix Virtual Apps™ and Desktops 本地部署环境:
    • 最新的长期服务版本 (LTSR) - 2402。
    • 任何当前版本 (CR) - 2308、2311。
  • 在域加入的计算机上运行自动化配置工具 (ACT) 命令,该计算机需安装 .Net 4.7.2 或更高版本。
  • 具有 Citrix PowerShell SDK 的计算机。PowerShell SDK 包含在 Citrix Delivery Controller™ 安装程序中。

注意:

  • 如果您在其他计算机上运行 ACT,该计算机必须已加入域,并且 Studio 必须安装正确的 PowerShell 管理单元。要获取安装程序,请访问 Citrix Virtual Apps and Desktops 下载网站。
  • 在本地站点中,建议将 ACT 安装在 DDC 上。可以通过桌面图标启动 ACT。
  • 如果打算从标准 PowerShell 窗口使用 ACT,请运行以下命令: Import-Module Citrix.AutoConfig.Commands

ACT 不在系统 PowerShell 路径中,因此必须显式导入。

关键步骤

请按照说明操作,完成将云配置迁移到本地部署:

  1. 备份云配置。
  2. 修改 YML 文件。
  3. 将配置导入本地部署。

备份云配置

  1. 安装 自动化配置
  2. 双击 Auto Config 图标。将出现一个 PowerShell 窗口。
  3. 运行 New-CvadAcCustomerInfoFile 以创建 CustomerInfo.yml 文件。有关详细信息,请参阅填充客户信息文件
  4. 运行命令 Backup-CvadAcToFile 以备份您的云配置。

    注意:

    • 首次运行任何 cmdlet 后,将创建一个包含 .yml 配置文件和日志的备份文件夹。该文件夹位于 %HOMEPATH%\Documents\Citrix\AutoConfig
    • 如果遇到任何错误或异常,请参阅日志文件中的 Fixups 部分。
    • Backup-CvadToFile 不支持参数 IncludeByNameExcludeByName

重要:

Citrix 建议同时备份所有组件。

修改 YML 文件

修改位于 %HOMEPATH%\Documents\Citrix\AutoConfig.yml 文件,以包含下表所述的本地部署详细信息:

YML 文件 参数 描述 示例
CustomerInfo.yml Environment 将 Environment 更改为 OnPrem。environment 参数值区分大小写。  
ZoneMapping.yml DaaS:CVAD 将您的云资源位置映射到您的本地区域。 必须是旧区域:新区域
CvadAcSecurity.yml Hypervisor: ConnectionType: ‘ ‘ Username: ‘ ’ Password: ‘ ‘ 添加管理程序用户名和密码。 如果管理程序是 XenServer,则为 XenServer: ConnectionType: ‘XenServer’ Username: ‘root’ Password: ‘ ‘

将配置导入本地部署

  1. 根据您的要求,在本地站点中运行以下任一命令:
    1. Merge-CvadAcToSite - 如果有本地站点正在运行,并且您希望将云配置合并到其中。
    2. Import-CvadAcToSite -Environment OnPrem - 如果本地配置不可用,并且您正在导入云配置以创建一个。

重要:

Citrix 建议一次导入一个组件,以避免冲突。

将云配置迁移到本地部署