Troubleshooting Instant Clones in the Internal VM Debug Mode

You can use the internal VM debug mode to troubleshoot internal virtual machines in instant-clone desktop pools and instant-clone farms. With the internal VM debug mode, you can analyze failed internal virtual machines before these virtual machines are deleted. You must enable the internal VM debug mode before you create an instant-clone desktop pool or farm.

Procedure

1. In vSphere Client, select the golden-image VM, and click Manage > Configure > VM Options > Edit > VM Options > Advanced > Edit Configuration.

   The Configuration Parameters window displays a list of parameter names and values.

2. In the Configuration Parameters window, search for the cloneprep.debug.mode parameter.

   If the golden-image VM does not have the cloneprep.debug.mode parameter, you must add cloneprep.debug.mode as the parameter name and add a value of ON or OFF. If the golden VM has the cloneprep.debug.mode parameter, you can change the value of the parameter to ON or OFF.

3. Enable or deactivate the internal VM debug mode for internal VMs.

   • To enable the internal VM debug mode, set the value of cloneprep.debug.mode to ON. If you enable the internal VM debug mode, the internal VMs are not locked and cannot be deleted by Horizon Connection Server.

   • To deactivate the internal VM debug mode, set the value of cloneprep.debug.mode to OFF. If you deactivate the internal VM debug mode, the internal VMs are locked and can be deleted by Horizon Connection Server. For instant-clone actions such as prime, provision, resync, or unprime, the internal virtual machines use the value set in the golden virtual machine. If you do not deactivate the internal VM debug mode, then the VMs remain in vCenter Server till you delete the VMs. For further debugging on instant clone actions, you can also log in to the internal VM and view the instant clone logs. You can also see the following KB articles for further debugging of instant-clone actions:

   • Initial publish of an Instant Clone desktop pool image fails and the template VMs are deleted KB 2144938

   • How to change SVGA settings for Instant Clone Pools KB 2151745