You can use the internal VM debug mode to troubleshoot internal virtual machines in instant-clone farms. With the internal VM debug mode, you can analyze failed internal virtual machines before these virtual machines are deleted.

Prerequisites

  • Create an instant-clone farm.

Procedure

  1. In the vSphere Web Client, select the master 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 master 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 master VM has the cloneprep.debug.mode parameter, you can change the value of the parameter to ON or OFF.

  3. Enable or disable 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 Server.

    • To disable the internal VM debug mode, set the value of cloneprep.debug.mode to OFF. If you disable the internal VM debug mode, the internal VMs are locked and can be deleted by Horizon Server.

    For instant clones actions such as prime, provision, resync, or unprime, the internal virtual machines use the value set in the master virtual machine. If you do not disable the internal VM debug mode, then the VMs remain in vSphere till you delete the VMs.