Virtual Machine Configuration Check

Aug 14, 2017

By default, AppDNA performs a number of checks on the virtual machine configuration when you click Import in the Import Applications screen if any applications are selected for import on the Install Capture tab.

Connection to the Hyper-V server fails

During a virtual machine configuration check, the connection to the Hyper-V server fails with this error message if DCOM is not enabled:

The Hyper- connection failed because Hyper-V does not exist on the specified server, or DCOM is not enabled. Full Error: The RPC server is unavailable. [Exception from HRESULT: 0x800706BA]

To enable DCOM, see Enable or Disable DCOM. Also verify that port 135 is open.

“Connecting to Remote Admin agent” fails

The “Connecting to Remote Admin agent” check fails if the virtual machine has an old version of the Citrix AppDNA VM Configuration tools installed on it. Click the link to see the detailed error message, which will tell you if this is the problem. See Upgrade AppDNA tools for step-by-step instructions for upgrading the Citrix AppDNA VM Configuration tools.

The “Connecting to Remote Admin agent” check also fails if the virtual machine requires any user interaction when AppDNA reverts the virtual machine – for example, if the virtual machine snapshot was taken when the virtual machine was powered off (as recommended) but the virtual machine was not configured for automatic logon. The “Connecting to Remote Admin agent” check fails in these circumstances because the virtual machine waits for you to log on before Remote Admin starts up. However, AppDNA does not open the virtual machine in the console and so you cannot log on. This scenario does not cause a problem during Install Capture, provided you are present to physically log on to the virtual machine when it opens in the console.

If the “Connecting to Remote Admin agent” check fails for any other reason, rerun the Virtual Machine Configuration wizard to diagnose the problem as explained next.

Diagnose problems

Citrix recommends that use the Virtual Machine Configuration wizard to troubleshoot issues. To do this:

  1. From the AppDNA menus, choose Edit > Settings.

  2. On the left side of the Settings dialog box, click Install Capture.

  3. In the Install Capture page, click the Virtual Machines tab.

  4. In the list of virtual machine configurations, select the one that you are using and then click Edit.

    This opens the virtual machine configuration in the Virtual Machine Configuration Wizard. Work through the steps in the wizard. When you click Next on each step, the wizard performs a number of checks and provides information about any problems.

  5. Click Save to preserve your changes.

Turn off these VM configuration checks

You can permanently turn off these automatic checks as follows:

  1. From the AppDNA menus, choose Edit > Settings.
  2. On the left side of the Settings dialog box, click Install Capture.
  3. In the Install Capture page, click the Settings tab.
  4. Select Skip virtual machine system check.
  5. Click Save.