Aug 14, 2017
This topic provides an example of how to set up a Hyper-V virtual machine (along with the machine on which AppDNA runs) for use with Install Capture when migrating from Windows 7 to Windows 10. This example shows one possible approach and is not meant to suggest that this is the only method. For the generic setup requirements, see Set up a virtual machine.
Limitation: Connecting to local Hyper-V generates an error. The workaround is to run AppDNA as an administrator.
Either Hyper-V Server is configured on a separate machine from the one on which AppDNA is running or Windows 10 Hyper-V Client and the AppDNA client are installed on the same Windows 10 machine.
A Hyper-V virtual machine with a clean build of Microsoft Windows 7 already exists for use with Install Capture. For information about creating a Hyper-V virtual machine, refer to the Hyper-V documentation.
The virtual machine is connected to the same domain as the machine on which you are running AppDNA (called the AppDNA machine).
If you are using Hyper-V Server, you know the IP address or DNS name of the Hyper-V host server and have the user name and password of an administrative user account that has permissions to access Hyper-V and control the virtual machine. Alternatively, if you are using Hyper-V Client, your own Windows log on account must have administrative permissions to access Hyper-V and control the virtual machine.
The user account must be part of the Administrators or Hyper-V Administrators group on the Hyper-V machine. Alternatively, the user account can be granted explicit Hyper-V permissions to control virtual machines, as described in this MSDN article.
You have the user name and password of an administrative user account for the guest operating system.
In order for the virtual machine to access the shared folder on the AppDNA machine, this example configures the virtual machine for automatic log on with the same domain user account that you use to log on to Windows on the AppDNA machine. (This is called your domain user account below.)
Note: These instructions cover setting up the virtual machine after opening it in a console through Hyper-V Manager. If you do not have access to this, you must ask your Hyper-V administrator to install the Hyper-V Integration Services on the virtual machine and configure it to allow remote desktop connections. You can perform all of the other setup steps when you work through the AppDNA Virtual Machine Configuration wizard, which is documented in the next topic. (The wizard opens the virtual machine in a console.)
Use Hyper-V Manager to open the VM
This section provides instructions for using Hyper-V Manager to open the virtual machine in a console so that you can set up the virtual machine.
- On the Windows Start menu, choose Administrative Tools > Hyper-V Manager.
- In the tree in the left pane, select the Hyper-V server on which the virtual machine is hosted. The virtual machines that are hosted on that Hyper-V host appear in the Virtual Machines list.
- Right-click the virtual machine that you want to use for Install Capture and choose Connect.
- If the virtual machine is not running, choose Action > Start.
- When prompted, log on to the virtual machine using an administrative user account.
You are now ready to perform the virtual machine setup tasks that are described below.
Install Hyper-V Integration Services on the VM
In order to use a Hyper-V Windows 7 virtual machine for Install Capture, it must have the Hyper-V Integration Services installed on it. If you do not have access to Hyper-V Manager, ask your Hyper-V administrator to perform this step for you.
Note: The Hyper-V Integration Services are always required when the guest OS is Windows 7 or when you are using Windows 10 Hyper-V Client. They may also be required in some other configurations.
- In Hyper-V Manager, open the virtual machine and log on to it using an administrative user account.
- From the menus in the console window, choose Action > Insert Integration Services Setup Disk.
- In the AutoPlay window, select Install Hyper-V Integration Services. This starts the installation of the Hyper-V Integration Services.
- When the installation is complete, restart the virtual machine.
Configure the VM to allow remote desktop connections
In order to use the Hyper-V virtual machine for Install Capture, it must be configured to allow remote desktop connections. If you do not have access to Hyper-V Manager, ask your Hyper-V administrator to perform this step for you.
- Log on to the virtual machine.
- Open Control Panel > System. (If necessary, first switch to Classic View.)
- In the System Properties dialog box, click the Remote tab.
- Under Remote Desktop, select the Allow users to connect remotely to this computer check box.
- Click OK to preserve your changes.
Enable DCOM on the VM
Communication between the Hyper-V host and the VM requires that DCOM is enabled on the VM. To enable DCOM, see Enable or Disable DCOM. Also verify that port 135 is open for DCOM.
Create the shared folder on the AppDNA machine
These instructions describe how to create a folder on the AppDNA machine and share it so that the virtual machine can read and write to it.
- Create a folder (for example, C:\AppDNAOutput) on the AppDNA machine to store the Install Capture output.
Share the folder and give everyone read and write permissions. For example:
- Open Windows Explorer and locate the folder that you want to share.
- Right-click the folder and from the shortcut menu, choose Sharing > Advanced Sharing.
- Click Advanced Sharing and then in the Advanced Sharing dialog box, select the Share this folder check box.
- Click Permissions.
- In the Permissions dialog box, click Everyone, and then for Full Control, Change, and Read, select the Allow check box.
- Click OK twice.
Note: The virtual machine also needs access to the location of the input files. To use an existing shared folder that contains the applications deployed within your organization, ensure that it is accessible from within the virtual machine. Otherwise you can either store these input files in the same folder as the output, or you can create a separate shared folder for the input files. In all cases the virtual machine must have read access to the input files.
Add your domain user account as an administrator on the VM
Note: It is not necessary to perform this step if your domain user account has already been set up as an administrative user on the virtual machine.
- Log on to the virtual machine.
- Open Control Panel > Administrative Tools > Computer Management. (If necessary, first switch to Classic View.)
- In the tree in the left pane, click System Tools > Local Users and Groups > Groups.
- In the right pane, double-click Administrators.
- In the Administrators Properties dialog box, click Add.
- In the Select Users, Computers, or Groups dialog box, enter your domain-qualified username (for example, Domain\User) in the Enter the object names to select box.
- Click OK to close the Select Users, Computers, or Groups dialog box.
- Click OK to close the Administrators Properties dialog box.
Configure the virtual machine for automatic log on
This is an optional step that speeds up Install Capture. If you choose not to perform this step, you will need to log on to the virtual machine manually with your domain user account every time the virtual machine starts up.
On the virtual machine, follow the instructions in http://support.microsoft.com/kb/315231 to set up automatic log on with your domain username.
Turn off simple file sharing on the AppDNA and virtual machines
Carry out the following steps on both the AppDNA machine and the virtual machine.
- In Windows Explorer, choose Folder Options > View.
- Clear the Use simple file sharing (Recommended) check box.
- Click OK.
Anti-virus configuration on the AppDNA machine
You must configure the anti-virus software on the AppDNA machine to disable on-access scanning of the Install Capture output and input folders. For example, for Norton Anti-Virus, you disable the auto-protect option for the AppDNA output and input folders.
Verify access to the shared folder
You now need to check that the virtual machine can access the shared folder that you created earlier on the AppDNA machine.
On the virtual machine, type the following into the Windows Start > Run prompt:
\\<AppDNA machine name>\AppDNAOutput
Where <AppDNA machine name> is the name of the AppDNA machine.
If this opens the shared folder on the AppDNA machine, it verifies that the virtual machine can access it. For troubleshooting tips, see Troubleshooting Access to a Shared Folder from the Virtual Machine.
Install the AppDNA VM Configuration MSI on the virtual machine
To do this, you need the installer (called Citrix AppDNA VM Configuration.msi). This comes with AppDNA. It is copied into a Tools subfolder of the AppDNA installation folder when you install AppDNA. The default location is C:\Program Files\Citrix\AppDNA\Tools (C:\Program Files (x86)\Citrix\AppDNA\Tools on a 64-bit machine).
- Install the Citrix AppDNA VM Configuration MSI within the virtual machine, accepting the default file location.
- Restart the virtual machine.
Important: Ensure that the AppDNA VM Configuration MSI has the same version number as the version of AppDNA that you are using. This means that you need to upgrade the VM Configuration on the virtual machine when you upgrade AppDNA.
Configure AppDNA to run elevated
Note: This step is relevant only if you are using Windows 8 Hyper-V Client.
If you are using Windows 8 Hyper-V Client, you must run AppDNA to run as an administrator when interacting with the virtual machine – for example, when using the Virtual Machine Configuration wizard or running Install Capture.
You can configure AppDNA so that it is always run as an administrator as follows:
- If necessary, close AppDNA.
- In Windows Explorer, locate AppDNA.exe. The following table shows the default location of this file. | Machine type | Default location | | ———— | —————————————– | | 64-bit | C:\Program Files\Citrix\AppDNA\Client |
- Right-click the file and from the shortcut menu, choose Properties.
- Click the Compatibility tab.
- Under Privilege level, select the Run this program as an administrator check box.
- Click OK to save the changes.
Take a snapshot of the virtual machine
- Connect to the virtual machine in Hyper-V Manager.
- From the menus in the console, choose Action > Snapshot. In the Snapshot Name dialog box, enter a name for the snapshot, and then click Yes.
You are now ready to use the AppDNA Virtual Machine Configuration wizard to set up a virtual machine configuration for use with Install Capture. See Configure a Hyper-V VM for step-by-step instructions.