XenServer

Mar 28, 2016

This topic provides an example of how to set up a Citrix XenServer virtual machine (along with the machine on which AppDNA runs) for use with Install Capture when migrating from Windows XP to Windows 8.1. This example shows one possible approach. For the generic setup requirements, see Set up a virtual machine.

Pre-requisites

XenServer is already installed and configured on a separate machine from the one on which AppDNA is running.

A XenServer virtual machine with a clean build of Windows XP already exists for use with Install Capture. For information about creating a XenServer virtual machine, refer to the Citrix XenCenter documentation. (XenCenter is a desktop tool that you can use to manage your XenServer environment and deploy, manage, and monitor virtual machines from your Windows desktop machine.)

The virtual machine is connected to the same network as the machine on which you are running AppDNA (called the AppDNA machine).

You know the IP address or DNS name of the XenServer host server and have the username and password of an account that enables you to connect to XenServer and perform advanced virtual machine operations (including creating and rolling back snapshots).

You have the username and password of an administrative user account for the guest operating system.

The user account has advanced operations" permissions. Typically this means that the user account must have at least the "VM power admin" role.

Open the VM in XenCenter

This section provides instructions for logging on to the virtual machine in the console in XenCenter so that you can set up the virtual machine. If you do not have access to XenCenter, you can do the setup steps when you work through the AppDNA Virtual Machine Configuration wizard. (The wizard opens the virtual machine in a console.)

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.

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:

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).

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.

Take a snapshot of the virtual machine

This step requires access to XenCenter. If you do not have access to XenCenter, the AppDNA Virtual Machine Configuration wizard provides an option to create a snapshot.

Select the virtual machine in the Resources pane on the left side of the XenCenter window.

Click the Snapshots tab.

On the toolbar, click Take Snapshot.

In the Take Snapshot dialog box, enter the Name of the new snapshot and optionally a Description.

Under Snapshot mode, select the Snapshot the virtual machine's disks and memory option if it is available. Otherwise select the Snapshot the virtual machine's disks option. The Snapshot mode options depend on the XenServer license.

Click Take Snapshot.

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 XenServer VM for step-by-step instructions.