-
-
Backup or Migrate your Configuration
-
Migrate Cloud configurations to on-premises
-
Troubleshoot Automated configuration and additional information
-
-
-
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!
Migrate Cloud configurations to on-premises
This article describes backing up and migrating your Cloud configurations to on-premises sites.
Prerequisites for migrating your configuration
- Citrix Virtual Apps and Desktops on-premises environment with at least one registered VDA.
- Citrix Virtual Apps and Desktops on-premises environment running on one of the following versions:
- The most recent Long-Term Service Release (LTSR) version - 2402.
- Any of the Current Releases (CR) versions - 2308, 2311.
- Run the Automated Configuration tool (ACT) commands on a domain-joined machine with .Net 4.7.2 version or higher.
- A machine with the Citrix PowerShell SDK. PowerShell SDK is available within the Citrix Delivery Controller installable.
Note:
- If you are running the ACT on a different machine, it must be domain-joined and Studio must have the correct PowerShell snap-ins installed. To get the installer, go to Citrix Virtual Apps and Desktopsdownloads website.
- In the on-prem site, we recommend ACT be installed on the DDC. ACT can be started via the desktop icon.
- If ACT is intended to be used from the standard Powershell window then the following command must be executed:
Import-Module Citrix.AutoConfig.Commands
ACT is not part of the system PowerShell path so must be explicitly imported
Procedure
Follow the instructions to complete the migration of your Cloud configurations to on-premises:
- Backup Cloud configuration
- Modify YML files
- Import configurations to on-premises
Backup Cloud configuration
- Install the Automated Configuration.
- Double-click the Auto Config icon. A PowerShell window appears.
- Run
New-CvadAcCustomerInfoFileto create a CustomerInfo.yml file. For more information, see Populating customer info file. - Run the command
Backup-CvadAcToFileto take a backup of your Cloud configurations.Note:
- 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. - If you encounter any errors or exceptions, see the Fixups section in the log file.
- Backup-CvadToFile does not support the parameters
IncludeByNameorExcludeByName.
- 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
Important:
Citrix recommends backing up all the components together.
Modify YML files
Modify the .yml files located at ` %HOMEPATH%\Documents\Citrix\AutoConfig ` to include the on-prem details as described in the following table:
| YML File | Parameter | Description | Examples |
|---|---|---|---|
| CustomerInfo.yml | Environment | Change Environment to OnPrem. The environment parameter value is case-sensitive. | |
| ZoneMapping.yml | DaaS:CVAD | Map your Cloud resource locations to your on-premises zones. | It has to be old:new zones |
| CvadAcSecurity.yml | Hypervisor: ConnectionType: ‘ ‘ Username: ‘ ’ Password: ‘ ‘ | Add the hypervisor username and passwords. | If the hypervisor is XenServer,XenServer: ConnectionType: ‘XenServer’ Username: ‘root’ Password: ‘ ‘ |
Import configurations to on-premises
- Run either of the following commands in your on-prem site based on your requirements:
-
Merge-CvadAcToSite- if there is an on-premises site running and you want to merge the Cloud configurations to it. -
Import-CvadAcToSite -Environment OnPrem- If on-premises configurations are not available and you are importing the Cloud configurations to create one.
-
Important:
Citrix recommends importing one component at a time to avoid conflicts.
Share
Share
In this article
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.