book
Article ID: CTX277730
calendar_today
Updated On:
Description
The Automated Configuration Tool is designed to migrate configurations (such as policies, applications, machine catalogs, and others) for the following use cases:
- Virtual Apps and Desktop from one or more On-Premises site(s) to the Citrix DaaS hosted on Citrix Cloud
- Migration between different Cloud regions or tenants
When errors occur, the tool will safely migrate as much as possible. Components with errors will be skipped. Just follow the recommendations below and re-run the tool until you achieve the desired-state configuration.
NOTE: Ensure you are using the latest published version of the tool from the Citrix downloads page. If the current version is earlier than V2, you must download the latest version to avoid problems using the tool.
Contents
Watch this video on how to use the ACT tool.
Error Message | Action |
The Automated Configuration tool cannot be run on the connector. Ensure the Automated Configuration tool is not installed and running from a Citrix Cloud Connector (detailed documentation). |
- Install the Virtual Apps and Desktops PowerShell SDK corresponding to the on-premise deployment version. NOTE - Do not install the Remote POSH SDK used to manage your CVAD service site on this machine.
|
The needed CitrixPowershell SDKs are not installed. |
- Install Citrix Studio from the Citrix Virtual Apps and Desktop, then rerun to the Export operation.
- Make sure you installed the POSH SDK corresponding to the on-premise deployment version
- Check the currently logged-on user is a full administrator of the on-premise site.
- Ensure you have followed all prerequisites from the detailed documentation. Refer to the section "Prerequisites for migrating your configuration."
|
You have insufficient execution privilege to execute the Export action, or you need to specify an -AdminAddress. You must be a member of the Full Administrator Role to execute this PowerShell Export. |
- Check the currently logged-on user is a full administrator of the on-premise site.
|
Error Message | Action |
- A PVS Machine Catalog was exported; be sure to update PVS security information in CvadAcSecurity.yml
- The PVS security information has not been updated for the PVS machine named <machine name>; the PVS machine cannot be added.
|
- Ensure you have provided the correct PVS server credentials in the CvadAcSecurity.yml file.
- Check for formatting issues with the YML file. e.g., Spacing, indentation, quotes.
- Follow the section "Migrating objects when you have Provisioning Services-based machine catalogs" in the detailed documentation for more information
|
- A machine named <machine name> in Machine Catalog <machine catalog name> was not found in Active Directory and was removed from the Machine Catalog. Correct and rerun the export to include the machine.
- A machine named <machine name> in Delivery Group <delivery group name> was not found in Active Directory and was removed from the Machine Catalog. Correct and rerun the export to include the machine
|
- Check if the machine exists in the Active directory
- If the machine does not exist, then remove the machine entry from the machine catalog in the YML file and re-run the import/merge command to get the machine catalog imported into your Citrix Virtual Apps and Desktops service
|
- There are no master images associated with this Machine Catalog
|
- Ensure there is no encryption of cloud connectors interfering with the master image creation process
|
- Machines in MCS Machine Catalogs named <Machine Catalog> cannot be updated in this version
|
- We do not support trying to re-merge and update the same MCS catalogs. The recommended recourse is to remove the MCS Machine Catalogs from the Cloud setup and then merge which will add them as new MCS Machine Catalogs
|
- The specified master VM snapshot could not be found
|
- Check if the image path has changed but has not been updated on the On-Prem DDC. If the snapshots are present at another path, edit the MachineCatalog.yml file to correct the paths.
|
Error Message | Action |
|
- The host connection information may have changed since the initial export. Update the CvadAcSecurity.yml file with the most up-to-date information, then attempt to merge once more.
|
- Host Connection Error: Internal Error Citrix.AutoConfig.HostConnection.HostConnectionData is inaccessible due to its protection level.
|
|
Error Message | Action |
- A user was not found in Active Directory and has been removed from the User Filter in the policy named <group policy name>
|
- Check if the user exists in the Active Directory. If the user does not exist, remove the user entry from the group policy filter in the YML file and re-run the import/merge command to import the machine catalog into your Citrix Virtual Apps and Desktops service
|
- The filter containing the Tag <tag name> in policy <group policy name> is missing; the filter has been disabled.
|
- Check to ensure the specific tag has been successfully imported into your CVAD account
|
- The Delivery Group, <delivery group name>, in a Delivery Group Filter for Policy: <group policy name> is missing; the filter has been removed. Correct by adding the Delivery Group and rerunning the Group Policy Import.
|
- Check to ensure the specific delivery group was successfully imported into your CVAD account
|
Error Message | Action |
- The Machine Catalog named <machine name> referenced by the Delivery Group named <delivery group name> was not found; the <operation name> operation will fail. The Delivery Group has been removed from the <operation name> operation. <Machine name> Machine Catalogs and then retry Delivery Groups.
|
- Check to ensure the specific machine catalog has been successfully imported into your CVAD account
|
- Access control policies are not supported in the automated configuration service
|
|
- Failure due to the reboot schedule name uniqueness/spacing issue
|
- Ensure there are no spaces in reboot schedules, and they have unique names across all delivery groups.
|
Error Message | Action |
- The Delivery Group named <Delivery Group name> referenced by the Application Group named <Application Group name> was not found; the <operation name> operation will fail. The Application Group has been removed from the <operation name> operation. <operation name> Delivery Groups and then retry Application Groups.
|
- Check to ensure the specific delivery group has been successfully imported into your CVAD account
|
- The Delivery Group named <Delivery Group name> referenced by the Application named <Application name> was not found; the <operation name> operation will fail. The Application has been removed from the <operation name> operation. <operation name> Delivery Groups and then retry Applications
|
- Make sure you have imported the corresponding Delivery group for this application
|
- The Application Group named <Application Group name> referenced by the Application named <Application name> was not found; the <operation name> operation will fail. The Application has been removed from the <operation name> operation. <operation name> Application Groups and then retry Applications.
|
- Make sure you have imported the corresponding Application referenced by this Application Group
|
Error Message | Action |
- The user <user name> was not found in Active Directory and has been removed from component <component name> for member <member name>
|
- Verify if the user is still present in the referenced Active Directory domain. Remove the user from the Delivery Group or Application Group and re-run the command to 'Import' or 'Merge'
|
Error Message | Action |
- No Items were exported; if not running on the DDC, then -AdminAddress must be specified. If running on the DDC, then either there is an insufficient privilege for the current user, or there are no items to export
|
- Make sure you installed the POSH SDK corresponding to the on-premise deployment version
- Check whether the currently logged-on user is a full administrator of the on-premise site.
- Ensure you have followed all prerequisites in the detailed documentation. Refer to the section "Prerequisites for migrating your configuration"
|
- Insufficient execution privilege to execute the Export action, or you need to specify an -AdminAddress. You must be a member of the Full Administrator Role to execute this PowerShell Export
|
- If migrating MCS-provisioned static/persistent machine catalogs, check that the machine used to run the tool has database access. When migrating, the operation imports low-level details stored in the database; therefore, you must run this process from a machine with database access.
|
Error Message | Action |
- Unable to determine the correct URL for accessing the Citrix Virtual Apps and Desktops Service. Verify that the Customer ID, Client ID, and Secret are present and correct.

|
- Please note that when migrating from Cloud to Cloud using ACT, when you run the Backup command, the information in the customerinfo.yml file has to be from the source customer. When you run the Restore, the information in the file has to be about the destination.
|
Error Message | Action |
- Error message: "Network not found"
*When the network path in the hosting unit differs from machine catalog creation requests.
|
- You can remove the ResourcePool (HostingUnit) and then create a new one again with the correct subnets, e.g., East US region/virtualprivatecloud.folder/z0use2pcsrsg001. resourcegroup/z0use2pvdvnt004.virtualprivatecloud/z0use2px1snt417.network.
OR
- Change the Machine Catalog creation NetworkMapping NetworkPath to the following and try again:: XDHyp:\\HostingUnits\\EastUS_2
virtualprivatecloud.folder East US 2.region\\virtualprivatecloud.folder\\z0use2pcsrsg001.resourcegroup z0use2pvdvnt004.virtualprivatecloud z0use2px1snt417.network
|
For general formatting rules and field guidelines of YAML files, you may refer to resources similar to: https://docs.octoprint.org/en/master/configuration/yaml.htm
Error Message | Action |
Customerinfo.yml |
- Customer information is missing; check that the following are present as a command line parameter(s) or present in the CustomerInfo.Yml file
- Customer Id
- Client Id
- Secret
|
- Run the command Get-CvadAcStatus. Check the output for errors
- Check for formatting issues with the YML file, e.g., Spacing, indentation, and quotes.
- Check for network connectivity for the domains *.xendesktop.net, *.cloud.com, *.citrixworkspacesapi.net
- Check if the customer ID, client ID, and secret key are correct. Refer to detailed documentation
- Ensure the 'Environment' field is set to the correct control plane
- ProductionJP' for Japanese customers
- ProductionGov' for Government customers
- Production' for every other region/control plane
- Check for formatting issues with the YML file, e.g., Spacing, indentation, quotes.
- Check for network connectivity for the domains *.xendesktop.net, *.cloud.com
- Check if the customer ID, client ID, and secret key are correct. Refer to detailed documentation
|
- The Bearer Token allocation failed; check that the following are present and correct on the command line or customerinfo.yml file: <error message>
- Customer Id
- Client Id
- Secret
|
- Check for network connectivity and latency to the following domains *.xendesktop.net, *.cloud.com
- Check if the customer ID, client ID, and secret key are correct. Refer to detailed documentation

|
ZoneMapping.yml |
- No zones/resource locations are defined in the cloud
- A zone mapping for zone <zone name> could not be found; the component <component name> may fail to import to <Member name>.
- The Zone Mapping file has not been updated with the correct mapping; operations will fail as a result. Please update and rerun the operation.
- A zone mapping to <zone name> was not found in the cloud Site
|
- Check ZoneMapping.yml file has the correct mapping defined between the zone defined in the on-premise site and the resource location was created in your Citrix Cloud account
- Check for formatting issues with the YML file, e.g., Spacing, indentation, quotes.
|
CvadAcSecurity.yml |
- No Security Info was found for <member name> for value named <security info name>. Adding/updating the component to the cloud may fail.
- A security entry for component <component name> - <info name> was added for member <member name>. Be sure to update CvadAcSecurity.yml with the correct security information for future cloud-accessing operations to be successful.
|
- Refer to detailed documentation for the file CvadAcSecurity.yml and ensure the information provided is correct.
- Check for formatting issues with the YML file, e.g., spacing, indentation, quotes.

|
Support Forum
If Contacting Citrix for help, please complete these steps in order to expedite your case.
- Run --> New-CvadAcZipInfoForSupport
- Include the .Zip file located at: .\Citrix\AutoConfig\CvadAcSupport_2021_09_dd_hh_mm_ss.zip
NOTE: Customer-sensitive information (CustomerInfo.yml and CvadAcSecurity.yml) are not included in the zip file. The Icon.yml file is also excluded due to its potential large size.