Migrating from on-premises to cloud
自动配置允许您to automate moving your on-premises configuration to a cloud site.
The following image is a high-level view of what Automated Configuration can do to migrate your configuration to the cloud.
Prerequisites for migrating your configuration
Forexportingyour configuration from Citrix Virtual Apps and Desktops, you need:
- Citrix Virtual Apps and Desktops: current release and its immediate predecessor or Citrix Virtual Apps and Desktops, XenApp and XenDesktop LTSRs: all versions
- A domain-joined machine with .NET Framework 4.7.2 or later and the Citrix PowerShell SDK. This is automatically installed on the Delivery Controller. (To run on machine other than the on-premises Delivery Controller, Citrix Studio must be installed, as Studio installs the correct PowerShell snap-ins. The Studio installer can be found on the Citrix Virtual Apps and Desktopsinstallation media.)
Forimportingyour configuration into Citrix DaaS (formerly Citrix Virtual Apps and Desktops service), you need:
- 一台机器with access to Citrix Cloud. This does not have to be a Delivery Controller or a domain-joined machine.
- Citrix DaaS provisioned.
- An active resource location with Connector installed and domain-joined to the same domain as the on-premises setup.
- Connectivity to sites accessing Citrix Cloud must be allowed and available. For more information, seeSystem and Connectivity Requirements.
Note:
Automated Configuration cannot be installed on a Cloud Connector system.
Exporting your Citrix Virtual Apps and Desktops on-premises configuration
Important:
- You must have your CustomerInfo.yml file with your customer ID, client ID, and the secret key information included. For more information on how to retrieve your customer ID, client ID and secret key, seeGenerating the customer ID, client ID, and secret key. For information on how to add this information to the CustomerInfo.yml file, seePopulating customer info file.
- The ZoneMapping.yml file must include information that maps your on-premises zone to Resource Locations in the cloud. For more information on how to map your zones, seePopulating zone mapping file.
- If you have host connections, you must input the corresponding info in the CvadAcSecurity.yml file.
- Install Automated Configuration.
- Double-click theAuto Configicon. A PowerShell window appears.
Run the following command to export all components. Exporting your on-premises configuration doesnotchange it in any way.
Export-CvadAcToFile
After you run any cmdlet for the first time, an export folder with the .yml configuration files and logs is created. The folder is at%HOMEPATH%\Documents\Citrix\AutoConfig. Each successive export creates a subfolder. The parent folder%HOMEPATH%\Documents\Citrix\AutoConfigalways contains the exported files from the most recent export.
Note:
If Automated Configuration is not installed on the Delivery Controller, run
import-module Citrix.AutoConfig.Commands
before using the tool through PowerShell. This step is not needed if you open Automated Configuration using theAuto Configicon.
If you encounter any errors or exceptions, see theFixupssection in the log file.
Importing your configuration to Citrix DaaS
Important:
- You must have your CustomerInfo.yml file with your customer ID, client ID, and the secret key information included. For more information on how to retrieve your customer ID, client ID and secret key, seeGenerating the customer ID, client ID, and secret key. For information on how to add this information to the CustomerInfo.yml file, seePopulating customer info file.
- The ZoneMapping.yml file must include information that maps your on-premises zone to resource locations in the cloud. For more information on how to map your zones, seePopulating zone mapping file.
- If you have host connections, you must input the corresponding info in the CvadAcSecurity.yml file.
Running an import
- Double-click theAuto Configicon. A PowerShell window appears.
Run the following command to import all components.
Merge-CvadAcToSite
Verify the expected state with the new current state. Various import options control whether the import results are identical or a subset of the on-premises site.
After you run the cmdlet, an export folder with the .yml configuration files and logs is created. The folder is at%HOMEPATH%\Documents\Citrix\AutoConfig.
If you encounter any errors or exceptions, see theFixupssection in the log file.
Note:
If Automated Configuration is not installed on the Delivery Controller, run
import-module Citrix.AutoConfig.Commands
before using the tool through PowerShell. This step is not needed if you open Automated Configuration using theAuto Configicon.
To revert to your original Citrix DaaS configuration, seeBacking up your Citrix DaaS configuration.
Import operation in detail
The import process is designed to accurately perform updates, only perform needed updates and verify that all updates have been correctly made. The steps followed in all import operations follow.
- Read the exported .yml file (expected state).
- Read the cloud (current state).
- Back up the pre-import cloud state to .yml files (pre-backup can be restored if necessary).
- Evaluate the differences between the expected and current state. This determines which updates to make.
- Make the updates.
- Reread the cloud (new current state).
- Back up the post-import cloud state to .yml files (post-backup can be restored if necessary).
- Compare the new current state with the expected state.
- Report the results of the comparison.
Granular migration
Important:
For more information on component migration order, seeComponent migration order.
You can selectively migrate components only or even component names only.
- Component parameters supported include
MachineCatalogs
,Tags
and more. - Component name parameters supported include
IncludeByName
andExcludeByName
parameters, and others.
For more information on parameters and how to use them, seeGranular migration parameters.
Activating sites
Site activation allows you to control which site is active and controls your resources. For more information, seeActivating sites.