Error: “Preparation of the Master VM Image failed” When UPDATING a Catalog

Description

NOTE: This article contains information about UPDATING a Catalog ONLY.
For information on CREATING a Catalog see: CTX140734

Updating a catalog might fail during Image Preparation because of many reasons. In order to identify what caused the failure we need to collect preparation Image logs according to article CTX140734 - Error: “Preparation of the Master VM Image failed” when Creating MCS Catalog in XenApp or XenDesktop.

However, after running the commands from the preceding article successfully, the Preparation Image Shuts down and we are not able to collect the logs.

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

Run Get-ProvScheme and identify the Provisioning Scheme associated with the catalog in question (Provisioning Scheme name is same as the name of the catalog).
Make a note of the "ProvisioningSchemeUid" associated with the catalog.
Run the command "Set-ProvSchemeMetadata -ProvisioningSchemeUid xxxxxxx -Name ImageManagementPrep_NoAutoShutdown -Value $True.
Now, enable logs on the master image according to the article CTX140734 and start the catalog Update

Additional Steps that are performed during image Preparation

During the Image Preparation following steps are performed by MCS

Enable DHCP
Microsoft Windows KMS Rearm
Microsoft Office KMS Rearm
Personal vDisk Inventory Collection
In Command Prompt Admin run del %WINDIR%\smscfg.ini
In PowerShell run Remove-Item -path HKLM:\Software\Microsoft\SystemCertificates\SMS\Certificates\* -Force
Unjoin device from Azure Active Directory

The following methods can be used to solve the problems during the Image Preparation

Skip "Enable DHCP":

Run the command "Set-ProvSchemeMetadata -ProvisioningSchemeUid xxxxxxx -Name ImageManagementPrep_Excluded_Steps -Value EnableDHCP

Skip "Microsoft Windows KMS Rearm"

Run the command "Set-ProvSchemeMetadata -ProvisioningSchemeUid xxxxxxx -Name ImageManagementPrep_Excluded_Steps -Value OsRearm

Skip "Microsoft Office KMS Rearm"

Run the command "Set-ProvSchemeMetadata -ProvisioningSchemeUid xxxxxxx -Name ImageManagementPrep_Excluded_Steps -Value OfficeRearm

Solve issues that occurred during the step of “Unjoin device from Azure Active Directory”:

Manually unjoin the Azure Active Directory joined master VM and redo the catalog updating.

Problem Cause

Commands described in the article CTX140734 will work only while creating new catalogs (New provisioning scheme) as it describes the metadata values for new provisioning schemes. When going for a catalog update, the existing provisioning scheme associated with the catalog is used, hence the metadata values for the existing provisioning scheme have to be changed.

Issue/Introduction

Error: “Preparation of the Master VM Image failed” When UPDATING a Catalog

Additional Information

1. Commands that can be used to perform the above actions when the issue is seen during catalog creation

The command Set-ProvServiceConfigurationData and this article uses the command Set-ProvSchemeMetadata
Explanation for the commands
- Set-ProvServiceConfigurationData – This command adds metadata values to a new prov scheme, i.e. when a new catalog is created (a new prov scheme is created), the values defined with the help of this command will take effect
- Set-ProvSchemeMetadata – This commands changes the metadata values of an existing prov scheme, i.e. an existing catalog

2. CTX140734 - Error: “Preparation of the Master VM Image failed” when Creating MCS Catalog in XenApp or XenDesktop.

Welcome to "KB Articles"