Product documentation
Citrix Virtual Apps and Desktops
Service Current Release 2407 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
View PDF

Backup and Restore using the Automated Configuration tool

December 5, 2024
Contributed by: 
C

Automated Configuration tool allows you to take on-demand backups in the following environments:

  • Citrix Virtual Apps and Desktops
  • DaaS

Autoconfiguration backup and restore

Citrix Virtual Apps and Desktops

Prerequisites for backing up your configurations

  • All versions of Citrix Virtual Apps and Desktops.

  • A machine to run Auto Config. This device can be either:

    • A delivery controller
    • A domain joined machine with .NET Framework 4.7.2 or later and the Citrix PowerShell SDK. For Citrix PowerShell, you must install Citrix Studio.

Back up

  1. Install Automated Configuration. For more information, see Download Automated Configuration.
  2. Double-click Auto-Config.
  3. On the PowerShell window, run the command Backup-CvadAcToFile to export all components. Exporting your on-premises configuration does not modify it.

After you run the command for the first time, the process creates a folder with the .yml configuration files at the following location: %HOMEPATH%\Documents\Citrix\AutoConfig.

The folder contains the backup files from the recent export, and each previous backup is stored in a subfolder.

Restore

  1. Double-click Auto-Config.

  2. Run the following command to do the restore:

    Restore-CvadAcToSite -Environment OnPrem -RestoreFolder <folder path of the backup files>
<!--NeedCopy-->
  3. After you run the command, verify the state of the export, and the log folder is available at: %HOMEPATH%\Documents\Citrix\AutoConfig.
  4. If there are any errors or exceptions, see the Fixups section in the log file.

DaaS

Prerequisites for backing up your configurations

  • A DaaS environment with an active resource location and Connector installed.
  • Connectivity to sites accessing Citrix Cloud. For more information, see System and Connectivity Requirements.

Note

You cannot backup MCS from the cloud using Automated Configuration.

Back up

Backs up the following files:

  • The CustomerInfo.yml file with your customer ID, client ID, and secret key information. For more information on the process to retrieve your customer ID, client ID, and secret key, see Generating the customer ID, client ID, and secret key. For information on how to add this information to the CustomerInfo.yml file, see Populating customer info file.
  • The ZoneMapping.yml file with information that maps your resource locations in the cloud. For more information on how to map your zones, see the Populating zone mapping file.
  • The CvadAcSecurity.yml file with information on host connections.
  1. Install Automated Configuration. For more information, see Install Automated Configuration.

Note

For DaaS backups, install the Automated Configuration on a machine with Internet access and to which the administrator has direct access as well.

  1. Double-click Auto Config.
  2. On the PowerShell window, run the following command to take a backup: Export-CvadAcToFile

After you run the command for the first time, the process creates a folder with the .yml configuration files at the following location: %HOMEPATH%\Documents\Citrix\AutoConfig

The folder contains the backup files from the recent export, and each previous backup is stored in a subfolder.

Restore

  1. Double-click the Auto Config.

  2. On the PowerShell window, run the following command to do the restore:

    Restore-CvadAcToSite -RestoreFolder <folder path of the backup files>
<!--NeedCopy-->

  3. After you run the command, verify the state of the export, and you can locate the log folder at %HOMEPATH%\Documents\Citrix\AutoConfig.

  4. If there are any errors or exceptions, see the Fixups section in the log file.

Granular migration

Note

For more information on the component migration order, see Component Migration Order.

Restore entire components

To restore a component, you must select one or more parameters.

For example, to restore the entire delivery group and machine catalog components, run the following command:

Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -DeliveryGroups -MachineCatalogs
<!--NeedCopy-->

Restore component members

To restore one or more component members, use the IncludeByName feature. You must invoke the Restore cmdlet with the Restorefolder parameter along with the selected component, and the inclusion list.

For example, to restore two group policies from a backup:

Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -GroupPolicies -IncludeByName Policy1,Policy2
<!--NeedCopy-->

Restore complete cloud site configuration

To restore all the components or the entire cloud site, run the following command:

Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss
<!--NeedCopy-->
Backup and Restore using the Automated Configuration tool
December 5, 2024
Contributed by: 
C
December 5, 2024
Contributed by: 
C

In this article

Site feedback | Your privacy choices footer linkYour Privacy Choices | Privacy and legal terms | Cookie preferences | Consent settings | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.