-
Backup or Migrate your configuration
-
Migrate configuration to Citrix Cloud
-
Migrate from on-premises to cloud
-
-
Troubleshoot Automated Configuration and additional information
-
Migrate workloads between resource locations using Image Portability Service
-
-
-
This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已经过机器动态翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
이 콘텐츠는 동적으로 기계 번역되었습니다. 책임 부인
Este texto foi traduzido automaticamente. (Aviso legal)
Questo contenuto è stato tradotto dinamicamente con traduzione automatica.(Esclusione di responsabilità))
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.책임 부인
Este artigo foi traduzido automaticamente.(Aviso legal)
这篇文章已经过机器翻译.放弃
Questo articolo è stato tradotto automaticamente.(Esclusione di responsabilità))
Translation failed!
Migrating from on-premises to cloud
Automated Configuration allows you 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
For exporting your 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 Desktops installation media.)
For importing your configuration into Citrix DaaS (formerly Citrix Virtual Apps and Desktops service), you need:
- A machine 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, see System 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, 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 must include information that maps your on-premises zone to Resource Locations in the cloud. For more information on how to map your zones, see Populating zone mapping file.
- If you have host connections, you must input the corresponding info in the CvadAcSecurity.yml file.
- Install Automated Configuration.
- Double-click the Auto Config icon. A PowerShell window appears.
-
Run the following command to export all components. Exporting your on-premises configuration does not change 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\AutoConfig always 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 the Auto Config icon.
If you encounter any errors or exceptions, see the Fixups section 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, 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 must include information that maps your on-premises zone to resource locations in the cloud. For more information on how to map your zones, see Populating zone mapping file.
- If you have host connections, you must input the corresponding info in the CvadAcSecurity.yml file.
- When migrating an on-premises deployment to cloud, make sure that the domain and OU GPOs that contain the Citrix settings are migrated to cloud. Citrix Web Studio does not support GPMC and hence, the domain and OU GPOs are not visible in the Web Studio. The Citrix policy engine enforces the domain and OU GPOs on VDAs and users that are in the domains and OUs. Post log in to a VDA, a user might see that the policies from the domain and OU GPOs are applied to their session. However, administrators cannot see these policies and settings which might lead to confusions.
Running an import
- Double-click the Auto Config icon. 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 the Fixups section 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 the Auto Config icon.
To revert to your original Citrix DaaS configuration, see Backing 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, see Component 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, see Granular migration parameters.
Activating sites
Site activation allows you to control which site is active and controls your resources. For more information, see Activating sites.
Share
Share
This Preview product documentation is Citrix Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Citrix Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Citrix product purchase decisions.
If you do not agree, select I DO NOT AGREE to exit.