Errors on MCS Catalogs on VMWare Hypervisors With Images using Special Characters

Errors on MCS Catalogs on VMWare Hypervisors With Images using Special Characters

book

Article ID: CTX215864

calendar_today

Updated On:

Description

Possible Errors:
ErrorId: XDDS:0DAA3833
ErrorId : UnknownError

MCS Exception Possibilities:
"An Error Occurred when Preparing the Image"
"ImagePreparationFinalizationFailed"
"Unable to upload disk Unable to upload disk"

Error Stack Trace:
 

    Citrix.Console.Models.Exceptions.ProvisioningTaskException An error occurred while preparing the image.
       at Citrix.Console.PowerShellSdk.ProvisioningSchemeService.BackgroundTasks.ProvisioningSchemeTask.CheckForTerminatingError(SdkProvisioningSchemeAction sdkProvisioningSchemeAction)
       at Citrix.Console.PowerShellSdk.ProvisioningSchemeService.BackgroundTasks.ProvisioningSchemeTask.WaitForProvisioningSchemeActionCompletion(Guid taskId, Action`1 actionResultsObtained)
       at Citrix.Console.PowerShellSdk.ProvisioningSchemeService.BackgroundTasks.ProvisioningSchemeCreationTask.StartProvisioningAction()
       at Citrix.Console.PowerShellSdk.ProvisioningSchemeService.BackgroundTasks.ProvisioningSchemeCreationTask.RunTask()
       at Citrix.Console.PowerShellSdk.BackgroundTaskService.BackgroundTask.Task.Run()

Environment

Citrix is not responsible for and does not endorse or accept any responsibility for the contents or your use of these third party Web sites. Citrix is providing these links to you only as a convenience, and the inclusion of any link does not imply endorsement by Citrix of the linked Web site. It is your responsibility to take precautions to ensure that whatever Web site you use is free of viruses or other harmful items.

Resolution

To resolve this issue, avoid using special characters in the names.

Problem Cause

Known issue with VMware:
The VMware vCenter Server and ESX/ESXi Server do not escape special characters used in the display names.
For example, if a virtual machine name contains the % character, it does not escape the character. This causes issues when querying for the name from vSphere Web Client or using the SDK.

Citrix uses the VMWare SDK on the Delivery Controller or Cloud Connector, via the VMWare Factory plugin, so Citrix will be affected by the limitations as well. 

This issue is seen when special characters like %, &, *, $, #, @, !, \, /, :, *, ?, ", <, >, |, ;, ' etc are contained in names of vSphere entities like virtual machine name, cluster name, datastore/folder/file name, the Domain organizational unit, etc.

Issue/Introduction

Errors are sometimes generated when a special character is used in the creating an MCS machine catalog

Additional Information

Error Id: XDDS:0DAA3833 while creating machine in MCS - https://discussions.citrix.com/topic/357648-error-id-xdds0daa3833-while-creating-machine-in-mcs/page-3
Troubleshooting issues with virtual machines or datastore names containing special characters (2046088) - https://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=2046088