XenConvert_Guide by Grupo Municipal Partido Popular de Tacoronte

Citrix® XenConvert™ Guide

XenConvert 2.0.1 Revision 1 June 10, 2009

Copyright Use of the product documented in this guide is subject to your prior acceptance of the End User License Agreement. Information in this document is subject to change without notice. Companies, names, and data used in examples herein are fictitious unless otherwise noted. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Citrix Systems, Inc. ÂŠ 2009 Citrix Systems, Inc. All rights reserved. Xen and Citrix are registered trademarks, and Citrix Provisioning Services, XenConvert and XenServer are trademarks of Citrix Systems, Inc. in the United States and other countries. Trademark Acknowledgements Microsoft, Windows, Windows Server are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. All other trademarks and registered trademarks are the property of their respective owners. Document Code: June 10, 2009 (MS)

C ONTENTS

Contents

Chapter 1

About This Document Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 Related Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 Contact Us. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

Chapter 2

Release Notes Whatâ&#x20AC;&#x2122;s New in This Release. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5 Known Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5 Windows Boot and System Drives Must Be on the Same Volume . . . . . . . . . . .5 Running From a Terminal Services Session. . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 Mapped Network Drive Can Interfere with Conversion . . . . . . . . . . . . . . . . . . .6 Problem Ejecting Citrix Virtual Hard Disk Messages . . . . . . . . . . . . . . . . . . . . .6

Chapter 3

Installing XenConvert Obtaining the Installation File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9 XenConvert System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9 Installing XenConvert Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13 Upgrading XenConvert. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 Remove XenConvert Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14

Chapter 4

Using XenConvert Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15 Converting From Physical Machines to Virtual Machines . . . . . . . . . . . . . . . .16 Converting From Microsoft Virtual Server . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 Converting Open Virtualization Format Packages. . . . . . . . . . . . . . . . . . . . . . .16 Converting From VMware Virtual Disks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 Starting the XenConvert Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

Citrix XenConvert Guide

Converting From a Physical Machine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18 Physical to VHD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18 Physical to XVA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19 Physical to XenServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20 Physical to OVF Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21 Physical to Provisioning Services vDisk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23 Converting Single Volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25 Converting From Microsoft Virtual Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26 VMC to XVA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26 VMC to XenServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27 VHD to XVA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28 VHD to XenServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29 Converting Open Virtualization Format Packages . . . . . . . . . . . . . . . . . . . . . . . . .30 XVA to OVF Package. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31 OVF Package to XenServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33 Converting From VMware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34 OVF to XenServer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34 VMDK to XenServer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35 VMDK to XVA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36 VMDK to VHD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37 XenConvert Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38 Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39 Troubleshooting Conversion Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39 Windows AutoPlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40 Search Indexing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40 Windows Automount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40 Security Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40

C HAPTER 1

About This Document

This document provides instructions on installing and using Citrix XenConvert software. This document is organized as follows: •

“Release Notes” provides information such as new features and known issues.

•

“Installing XenConvert” describes how to install the XenConvert software.

•

“Using XenConvert” describes how to change the default behavior of XenConvert.

Introduction Citrix® XenConvert™ converts a server or desktop workload from a physical machine to a XenServer virtual machine or Provisioning Services vDisk. It can also convert a virtual machine to a XenServer virtual machine. •

Converting to a XenServer VM produces an intermediate XVA containing a bootable XenServer VM and automatically imports it into a XenServer.

•

Converting to an XVA produces an offline package of a bootable XenServer VM ready to manually import into a XenServer.

•

Converting to a VHD produces a VHD compatible with Provisioning Services 5.x, if the target device software included with Provisioning Services 5.x was installed beforehand.

•

Converting to a OVF package produces an offline package of a bootable XenServer VM ready to manually import into a XenServer.

XenConvert includes a wizard, to use interactively, and a command line interface, to use from a script.

Citrix XenConvert Guide

Intended Audience This document is intended for XenServer and Provisioning Services system administrators and software installers. It is assumed that readers are familiar with basic installation and system management tasks for Microsoft Windows operating systems.

Related Information Information on XenConvert is provided with the software in the form of an online help file, which is available from the product, and as a PDF document. Additional information about Citrix XenServer and Citrix Provisioning Services may also be required during installation and use of this product. This information can be found at the following locations: â&#x20AC;˘

XenServer: http://support.citrix.com/product/xens/

â&#x20AC;˘

Provisioning Services: http://support.citrix.com/product/provsvr/

Contact Us Your feedback on Citrix XenConvert documentation is important to us. Use the Citrix Product Documentation Feedback form to send us your comments or suggestions about Citrix Product Documentation: http://support.citrix.com/docfeedback/

C HAPTER 2

Release Notes

This chapter contains information relevant to this release of XenConvert software. This information includes: •

“What’s New in This Release”

•

“Known Issues”

These release notes use the term virtual disk to encompass virtual disks that contain any type of operating system, including, but not limited to, Windows or Linux.

What’s New in This Release In this release, XenConvert provides enhanced support to consume VMware generated OVF and VMDK content. This support includes OVF content created from VMware vSphere 4, VMware Infrastructure 3, VMware Workstation 6.5.2, VMware Studio 1.0, VMware OVF Tool 0.9 and VMware Converter 3.03 and VMware Converter 4. VMware products whose OVF features are marked as experimental, are not supported.

Known Issues This section describes known limitations and issues for the XenConvert software. Wherever possible, a workaround for the problem is included.

Windows Boot and System Drives Must Be on the Same Volume XenConvert can only convert a workload from a source machine on which the system drive is the same as the boot drive. For example, boot.ini and the \Windows must both reside on C:\. However, this limitation does not apply to the conversion to a Provisioning Services vDisk.

Citrix XenConvert Guide

Running From a Terminal Services Session XenConvert cannot run from a Terminal Services session when the Terminal Server is a Window 2000 operating system. Mounting a VHD either fails after several minutes or does not appear to finish. This issue does not occur when connecting using Virtual Network Computing (VNC). To workaround this issue, run XenConvert from the Console. To change the amount of time that XenConvert waits to mount the VHD, change the registry key value VhdPluginTimeoutAsMs described in “XenConvert Configuration File” section.

Mapped Network Drive Can Interfere with Conversion If a network drive is mapped to the next available drive letter (for example, F:\ when last local drive was E:\), XenConvert is unable to get the drive letter for the new VHD that it just created, mounted, and formatted. This is because Windows assigned it to the same drive letter as the network drive. The workaround is, before running XenConvert, remap the network drive to a drive letter other than the lowest one available. For information about a similar issue, see http://support.microsoft.com/kb/ 297694/. While this article pertains to Windows XP, the problem also affects Windows Server 2003 when automount is enabled.

Problem Ejecting Citrix Virtual Hard Disk Messages The following messages might appear during the intermediary (VHD to XVA) stage of a conversion: •

Problem Ejecting Citrix Virtual Hard Disk: The device 'Generic volume' cannot be stopped right now. Try stopping the device again later.

•

Problem Ejecting Citrix Virtual Hard Disk: The device 'Citrix Virtual Hard Disk' cannot be stopped because of an unknown error. Since the device is still being used, do not remove it.

These messages may appear if applications or services, such as a virus scan or the Windows Autorun feature, open a file on the mounted VHD. This is because the open file prevents a dismount. Increasing the time that XenConvert waits before automatically dismounting a VHD might resolve this issue. For details about changing this value, see “XenConvert Configuration File”. Disabling Autorun may also resolve this issue.

Chapter 2

Issue # 7308

Release Notes

Citrix XenConvert Guide

C HAPTER 3

Installing XenConvert

Obtaining the Installation File Citrix XenConvert software is distributed electronically. Consult with your sales representative for information on obtaining the software. The product distribution contains this guide and the product installation wizard: â&#x20AC;˘

XenConvert_Install.exe

â&#x20AC;˘

XenConvert_Install_x64.exe

XenConvert System Requirements The following table lists the system requirements for the system on which XenConvert software runs Requirements for Machine on which XenConvert Runs Supported Operating Systems

Microsoft Windows 64-bit Windows Server 2003; Standard, Enterprise SP1/SP2 Windows Server 2003 R2; Standard, Enterprise SP1/SP2 Microsoft Windows 32-bit Windows Server 2003; Standard, Enterprise SP1/SP2 Windows Server 2003 R2; Standard, Enterprise SP1/SP2 Windows Small Business Server 2003 SP1/SP2 Windows XP SP1/SP2/SP3 Windows 2000 SP4 with KB 835732 (install KB 835732 before installing .NET Framework 2.0 SP1)

Supported File System Types

NTFS

CPU

Same as the requirements specified for the installed operating system.

XenServer

XenServer Versions 4.0, 4.1, and 5.0 (Updates 1, 2 and 3), and 5.5 support import of VMs created with XenConvert.

Memory

Same as the requirements specified for the installed operating system.

XenConvert Installation Guide

Requirements for Machine on which XenConvert Runs VHD disk space requirements

When converting to VHD, the required amount of free space is 101% of the used space on the source physical disk. When converting to XVA or XenServer, the required amount of free space is typically 115% of the used space on the source disks. Note that these conversions involve compression that depends on the disk contents. Therefore, the required free space could be greater. The absolute worst case would be 200% of the used space on the source physical disk.

Software disk space requirements

XenConvert XenConvert 2.0 32-bit = 4 MB XenConvert 2.0 64-bit = 4 MB Microsoft .NET Framework Microsoft .NET Framework version 2.0 SP1 installs automatically if not already installed. Disk space requirements for .NET are as follows: .NET 2.0 32-bit (up to 500 MB may be required) .NET 2.0 64-bit (up to 500 MB may be required)

Additional requirements for Windows Server 2003

Prior to converting from a physical machine that serves as both the source and host machine, enable automount on Windows Server 2003.

Chapter 3

Installing XenConvert

The following table lists the virtual machine/ virtual disk system requirements that are necessary to run XenConvert software

XenConvert Installation Guide

Virtual Machine/Virtual Disk Requirements Supported Operating Systems

64-bit Windows Server 2003; Standard, Enterprise SP1/SP2 Windows Server 2003 R2; Standard, Enterprise SP1/SP2 CentOS 5.2 Oracle Enterprise Linux 5.0 Red Hat Enterprise Linux Server 5.2 Novell SUSE Enterprise Linux 10 SP1/SP2 32-bit Windows Server 2003; Standard, Enterprise SP1/SP2 Windows Server 2003 R2; Standard, Enterprise SP1/SP2 Windows Small Business Server 2003 SP1/SP2 Windows XP SP1/SP2/SP3 Windows 2000 SP4 CentOS 5.2 Oracle Enterprise Linux 5.0 Red Hat Enterprise Linux Server 5.2 Suse Linux Enterprise Server 5.2 Novell SUSE Enterprise Server 9 SP2/SP3/SP4 Novell SUSE Enterprise Server 10 SP1 Debian 4.0 Microsoft Virtual Server 2005 R2 SP1 Virtual Machine Configuration (*.vmc) Fixed VHD Dynamic VHD XenServer XVA Version 2 VMware (VMDK formats) OVF Stream-optimized Monolithic VMDK

Chapter 3

Installing XenConvert

Virtual Machine/Virtual Disk Requirements Experimental Features

64-bit Windows Server 2008 Windows Vista SP1 32-bit Windows Server 2008 Windows Vista SP1 Hyper-V Fixed VHD Dynamic VHD VMware Virtual Machine Configuration (*.vmx) Flat Monolithic VMDK Sparse Monolithic VMDK Flat Extent VMDK Sparse Extent VMDK

Installing XenConvert Programs Note If XenConvert Technology Preview 2.0 is installed, it must be uninstalled before installing XenConvert 2.0.

On the target system, close all Windows applications.

In My Computer or Windows Explorer, navigate to the directory where the self extracting installer was downloaded to, then double-click on the installer file: XenConvert_install.exe

The XenConvert Welcome screen is displayed. Click Next to begin the installation.

The License Agreement screen appears. Click I accept..... and Next to continue the installation. Click I do not accept to terminate the installation. Click Print to print a copy of the License Agreement.

XenConvert Installation Guide

The Destination Folder screen appears. Click Next to install XenConvert in the default directory. Click Change to select a directory other than the default. Click Next after the directory is selected.

The Ready to Install the Program screen appears. Click Install to begin the installation. The Installing XenConvert screen displays, showing the installation progress.

When the installation is complete, the InstallShield Wizard Complete screen appears. Click Finish to exit the installer.

For details on using the XenConvert Wizard, refer to the chapter titled “Using XenConvert”.

Upgrading XenConvert To upgrade XenConvert to a later version, download and run the respective installer.

Note If XenConvert Technology Preview 2.0 is installed, it must be uninstalled before installing XenConvert 2.0. If upgrading from XenConvert 1.0, eject all VHDs by running the following command line from the installation folder: cvhdmount -u 0

Remove XenConvert Programs Use the Windows Control Panel to remove XenConvert programs. 1.

To remove XenConvert programs, access Control Panel > Add or Remove Programs and select XenConvert.

Click Remove to begin removing XenConvert programs.

The ‘Are you sure you want to remove XenConvert from your computer?’ dialog box appears. Click Yes to uninstall the software from your system, then wait for the uninstall to finish.

C HAPTER 4

Using XenConvert

This chapter provides the following information that is necessary to use the XenConvert wizard and command line interface: •

“Introduction”

•

“Starting the XenConvert Wizard”

•

“Converting From a Physical Machine”

•

“Converting From Microsoft Virtual Server”

•

“Converting Open Virtualization Format Packages”

•

“Converting From VMware”

•

“XenConvert Configuration File”

Introduction Citrix XenConvert converts a server or desktop workload from either a physical machine, or from another type of virtual machine, to a XenServer virtual machine.

Note Converting multi-boot physical and virtual machines is not supported. Only Windows Basic Disk type is supported as a source. Converting to or from a file or folder on a shared network folder or mapped drive is not supported.

Citrix XenConvert Guide

Converting From Physical Machines to Virtual Machines XenConvert supports the following physical-to-virtual conversions: •

“Physical to VHD”

•

“Physical to XVA”

•

“Physical to XenServer”

•

“Physical to OVF Package”

•

“Physical to Provisioning Services vDisk”

•

“Converting Single Volumes”

Converting From Microsoft Virtual Server XenConvert supports the following virtual-to-virtual machine conversions: •

“VMC to XVA”

•

“VMC to XenServer”

•

“VHD to XVA”

•

“VHD to XenServer”

Converting Open Virtualization Format Packages XenConvert supports the following Open Virtualization Format (OVF) Package conversions: •

“XVA to OVF Package”

•

“OVF Package to XenServer”

Converting From VMware Virtual Disks XenConvert supports the following conversions from VMware Virtual Machine Disk Format (VMDK): •

“OVF to XenServer”

•

“VMDK to XenServer”

•

“VMDK to XVA”

•

“VMDK to VHD”

Chapter 4

Using XenConvert

The OVF to XenServer conversion is preferable because it is faster and can be simpler for a workload consisting of multiple virtual disks. There are several tools to choose from when converting to OVF. A partial list follows: •

Virtual Center 2.5/ESX 3.5 Update 3

•

VMware ESX 4.0

•

VMware Workstation 6.5

•

VMware Converter 3.0.3

•

Ovftool

•

VMware Studio 1.0

Starting the XenConvert Wizard Supported conversion methods are selected and performed using the XenConvert Wizard. To start the wizard

From the Windows Start menu, click All Programs > Citrix > XenConvert > XenConvert 2.0. The Citrix XenConvert Welcome screen appears. Refer to the appropriate conversion method for conversion specific details.

Note If you encounter issues with VHDs during conversion, see “XenConvert Configuration File” on page 38. You can modify some parameters in the XenConvert.ini file to correct VHD problems.

Citrix XenConvert Guide

Converting From a Physical Machine This section describes the following physical-to-virtual conversion methods supported by XenConvert: •

“Physical to VHD”

•

“Physical to XVA”

•

“Physical to XenServer”

•

“Physical to OVF Package”

•

“Physical to Provisioning Services vDisk”

•

“Converting Single Volumes”

Before Converting From a Physical Machine •

Disable “Windows AutoPlay”

Physical to VHD Select this method to convert a single volume on a physical disk to a volume on a VHD.

Note If this VHD is also to be used with Provisioning Services, install the Provisioning Services target device software before converting.

Start the XenConvert Wizard (for details, refer to “Starting the XenConvert Wizard”.)

On the Welcome to Citrix XenConvert dialog, choose the following conversion options, then click Next: From This Machine (your-computername) To XenServer Virtual Hard Disk (VHD)

Choose the volume to include in this conversion from the drop-down menu. (Optional.) Check the Empty Recycle Bin checkbox to reduce the disk space required by the conversion (enabled by default), then click Next.

Choose a folder to store the VHD in by typing or browsing for the appropriate location, then click Next.

Chapter 4

Using XenConvert

Verify that the conversion information entered is correct, then click Convert. The conversion is complete when the progress bar reaches 100% and the Status field indicates that the conversion was successful.

Click Finish to exit XenConvert (this button displays after the conversion completes or after cancelling the conversion process), or click Log to display the conversion log file in Notepad.

Note For each conversion run, detailed status information is stored in the log file. The log file, XenConvert.txt, is created in the installation directory and provides the following information: •

Start and stop time stamps

•

Error and informational messages

Physical to XVA Select this method to convert a single volume on a physical disk to an XVA. 1.

Start the XenConvert Wizard (for details, refer to “Starting the XenConvert Wizard”.)

On the Welcome to Citrix XenConvert dialog, choose the following conversion options, then click Next: From This Machine (your-computername) To Xen Virtual Appliance

Choose the volume to include in this conversion from the drop-down menu. (Optional.) Check the Empty Recycle Bin checkbox to reduce the disk space required by the conversion (enabled by default).

Click Next.

Choose a folder to store the XVA in by typing or browsing for the appropriate location, then click Next.

(Optional.) Edit the properties of the new XenServer VM. At this point, you can enter a new name for the VM you are creating. This name will be displayed as the VM name in the Resources pane of XenCenter.

Citrix XenConvert Guide

Click Finish to exit XenConvert (this button displays after the conversion completes or after cancelling the conversion process), or click Log to display the conversion log file in Notepad.

Note For each conversion run, detailed status information is stored in the log file. The log file, XenConvert.txt, is created in the installation directory and provides the following information: •

Start and stop time stamps

•

Error and informational messages

Physical to XenServer Select this method to convert a single volume of a physical disk to XenServer. 1.

Start the XenConvert Wizard (for details, refer to “Starting the XenConvert Wizard”.)

On the Welcome to Citrix XenConvert dialog, choose the following conversion options, then click Next: From This Machine (your-computername) To XenServer

Choose the volume to include in this conversion from the drop-down menu. (Optional.) Check the Empty Recycle Bin checkbox to reduce the disk space required by the conversion (enabled by default).

Click Next

Provide information about the XenServer that will be receiving the VM (that is, the XenServer that will host the converted physical disk), then click Next: Hostname Simple host name, fully qualified domain name, or IP address of the XenServer. User name Name of the account with import privileges. Consult the XenServer product documentation for information on account requirements. Password

Chapter 4

Using XenConvert

The password that is associated with User name. Workspace Type or browse to the location where you want the XVA files stored. XVA files are the intermediary files created during the conversion process. For conversion efficiency, Citrix recommends specifying a location on the local computer where you are running conversion, preferably on a different partition or drive. 6.

(Optional.) Edit the name of your new XenServer VM in the Name textbox.

Click Next.

Click Finish to exit XenConvert (this button displays after the conversion completes or after cancelling the conversion process), or click Log to display the conversion log file in Notepad.

Note For each conversion run, detailed status information is stored in the log file. The log file, XenConvert.txt, is created in the installation directory and provides the following information: •

Start and stop time stamps

•

Error and informational messages

Physical to OVF Package Use this method to convert a physical machine to an OVF Package that can be imported into XenServer. 1.

Start the XenConvert Wizard (for details, refer to “Starting the XenConvert Wizard”.)

On the Welcome to Citrix XenConvert dialog, choose the following conversion options, then click Next: From This Machine (your-computername) To Open Virtualization Format (OVF) Package

Choose the volume to include in this conversion from the drop-down menu.

Citrix XenConvert Guide

Check the Empty Recycle Bin checkbox to automatically empty the recycle bin before the conversion process begins (this option is enabled by default. Emptying the recycle bin reduces the disk space required by the conversion), then click Next to continue.

Choose a folder to store the OVF Package by typing or browsing for the appropriate location. Optionally, check: Create Open Virtual Appliance (OVA) Check this box to create an OVA from the OVF Package for distribution.

Note The OVA cannot include a file with a size greater than 8 GB because of a limitation of the TAR format specified in the OVF Specification. Compress Open Virtual Appliance (OVA) Check this box to reduce the size of the OVA. This option is only available if the Create Open Virtual Appliance box is checked. Sign with Certificate Check this box to sign this OVF Package with a certificate in the X.509 format. •

Browse for the appropriate file to include using the File... button

•

Enter the password in the Password textbox.

•

Click View to view certificate information.

Encrypt Select this option to encrypt the OVF Package. If the Create Open Virtual Appliance (OVA) is selected, encryption occurs before creating the OVA. Enter the passphrase with which to encrypt, in the Passphrase” text box. Confirm the passphrase by entering it again in the Confirm text box.

Note Encrypting an OVF Package will reduce the effectiveness of compression.

Click Next.

Optionally edit the name of your new OVF Package in the Name textbox.

Click Next.

Chapter 4

Using XenConvert

10.

Click Finish to exit XenConvert (this button displays after the conversion completes or after cancelling the conversion process), or click Log to display the conversion log file in Notepad.

Note For each conversion run, detailed status information is stored in the log file. The log file, XenConvert.txt, is created in the installation directory and provides the following information: •

Start and stop time stamps

•

Error and informational messages

Physical to Provisioning Services vDisk Use this method to convert a physical machine to a connected Provisioning Services vDisk. 1.

Start the XenConvert Wizard (for details, refer to “Starting the XenConvert Wizard”.)

On the Welcome to Citrix XenConvert dialog, choose the following conversion options, then click Next: From This Machine (your-computername) To Provisioning Services vDisk The Convert This Machine to a Provisioning Services vDisk dialog appears.

XenConvert provides the option to image up to four volumes on a vDisk. By default, the first four volumes, beginning with drive C:\, are selected (for example C:\, D:\, E:\ and F:\).

Note During the conversion process, if the Windows boot volume (contains the Windows folder) and Windows system volume (contains the boot configuration data) reside on separate partitions, XenConvert combines them onto the same partition. Refer to http://support.microsoft.com/kb/314470 for the definitions of the Windows boot and system volumes.

Citrix XenConvert Guide

To include additional volumes, under the Volumes column, select the volumes to be imaged from the drop-down menu in the order in which those volumes should be imaged. The following information displays for each selected volume. •

Capacity (MB); total size of the original volume.

•

Usage (MB); amount of space required to image this volume on the master target device.

•

Usage (%); percentage of space used on the original volume.

•

File System; the file system must be NTFS.

The following information displays for the vDisk image containing the selected volumes. •

Capacity (MB); total size of the vDisk.

•

Usage (MB); amount of space required to image all selected volumes on the vDisk.

•

Usage (%); percentage of vDisk capacity required to image all selected volumes.

Check the Empty Recycle Bin checkbox to avoid adding its contents to the vDisk.

Check the Log copied files checkbox to log the name of each copied file to XenConvert.txt.

If the vDisk image is going to be used by multiple target devices in Standard Image mode, click the Optimize button. Optimizer does not need to be run on Private Image vDisks.

Click Next, then verify that the conversion information that displays is correct.

Note Windows Vista and later, will display a format dialog for every partition being created. Cancel all format dialogs requests. XenConvert will automatically format each partition.

Chapter 4

Using XenConvert

On the warning message that displays, click Yes to confirm the conversion. This will take several minutes to complete. The progress bar indicates when the imaging progress is complete.

10.

Click Finish.

Converting Single Volumes Use this conversion method to convert a single volume to another volume. Typically the source and destination volumes are on different disks. The source volume can be a Windows boot volume (the volume containing the WINDOWS directory) or an ordinary volume. When the source volume is a Windows boot volume, the files and the Windows registry are copied to the destination volume. In addition, the destination volume is configured as a Windows boot volume. When the source volume is an ordinary volume, only its files are copied to the destination volume. 1.

Start the XenConvert Wizard (for details, refer to â&#x20AC;&#x153;Starting the XenConvert Wizardâ&#x20AC;?.)

On the Welcome to Citrix XenConvert dialog, choose the following conversion options, then click Next: From Volume To Volume

Choose the source volume from the drop-down menu, then click Next. (Optional.) Check the Empty Recycle Bin checkbox to reduce the disk space required by the conversion (enabled by default).

Choose the destination volume from the drop-down menu, then click Next.

Click Finish to exit XenConvert (this button displays after the conversion completes or after cancelling the conversion process), or click Log to display the conversion log file in Notepad.

Citrix XenConvert Guide

Converting From Microsoft Virtual Server This section describes the methods available when converting from Microsoft Virtual Server (VMC) or a Microsoft Virtual Hard Disk (VHD). •

“VMC to XVA”

•

“VMC to XenServer”

•

“VHD to XVA”

•

“VHD to XenServer”

Before Converting From Microsoft Virtual Server •

Disable “Windows AutoPlay”

•

Remove any ISO file from the virtual CD/DVD file.

•

Shutdown VM.

After Converting From Microsoft Virtual Server XenConvert will schedule the automatic removal of the Microsoft VM Additions program after the first boot of the converted workload on XenServer. If Microsoft VM Additions was not removed automatically, then manually remove it as follows: 1.

Boot the new XenServer VM.

Use Add/Remove Programs feature of Windows to remove the program named ‘Virtual Machine Additions’.

VMC to XVA Select this method to convert a Microsoft Virtual Server 2005 VM to a XVA. 1.

Start the XenConvert Wizard (for details, refer to “Starting the XenConvert Wizard”.)

On the Welcome to Citrix XenConvert dialog, choose the following conversion options, then click Next: From Microsoft Virtual Server Virtual Machine To Xen Virtual Appliance

Chapter 4

Using XenConvert

Browse for the virtual machine to include in this conversion, then click Next.

Choose a folder to store the XVA in by typing or browsing for the appropriate location, then click Next.

Click Finish to exit XenConvert (this button displays after the conversion completes or after cancelling the conversion process), or click Log to display the conversion log file in Notepad.

Note For each conversion run, detailed status information is stored in the log file. The log file, XenConvert.txt, is created in the installation directory and provides the following information: •

Start and stop time stamps

•

Error and informational messages

VMC to XenServer Select this method to convert a Microsoft Virtual Server 2005 VM to a XenServer VM. This conversion requires a XenServer accessible on the network and a valid account on that XenServer. The conversion creates an intermediate XVA that remains on the host. 1.

Start the XenConvert Wizard (for details, refer to “Starting the XenConvert Wizard”.)

On the Welcome to Citrix XenConvert dialog, choose the following conversion options, then click Next: From Microsoft Virtual Server Virtual Machine To XenServer

Browse for the virtual machine to include in this conversion, then click Next.

Provide the following conversion information, then click Next: Hostname

Citrix XenConvert Guide

Simple host name, fully qualified domain name, or IP address of the XenServer. User name Name of the account with import privileges. Consult the XenServer product documentation for information on account requirements. Password The password that is associated with User name. Workspace Type or browse for the folder in which intermediate files should be stored. For conversion efficiency, Citrix recommends specifying a location on the local computer where you are running conversion, preferably on a different partition or drive. 5.

Optionally, edit the name of your new XenServer VM in the Name textbox.

Click Finish to exit XenConvert (this button displays after the conversion completes or after cancelling the conversion process), or click Log to display the conversion log file in Notepad.

Note For each conversion run, detailed status information is stored in the log file. The log file, XenConvert.txt, is created in the installation directory and provides the following information: •

Start and stop time stamps

•

Error and informational messages

VHD to XVA Select this method to convert a single VHD to a XVA. 1.

Start the XenConvert Wizard (for details, refer to “Starting the XenConvert Wizard”.)

On the Welcome to Citrix XenConvert dialog, choose the following conversion options, then click Next: From Microsoft Virtual Hard Disk (VHD)

Chapter 4

Using XenConvert

To Xen Virtual Appliance 3.

Browse for the VHD to include in this conversion, then click Next.

Choose a folder to store the XVA in by typing or browsing for the appropriate location, then click Next.

Optionally, edit the name of your new XenServer VM in the Name textbox.

Click Finish to exit XenConvert (this button displays after the conversion completes or after cancelling the conversion process), or click Log to display the conversion log file in Notepad.

Note For each conversion run, detailed status information is stored in the log file. The log file, XenConvert.txt, is created in the installation directory and provides the following information: •

Start and stop time stamps

•

Error and informational messages

VHD to XenServer Convert a single VHD to a XenServer. This conversion requires a XenServer accessible on the network and a valid account on that XenServer. The conversion creates an intermediate XVA that remains on the host. 1.

Start the XenConvert Wizard (for details, refer to “Starting the XenConvert Wizard”.)

On the Welcome to Citrix XenConvert dialog, choose the following conversion options, then click Next: From Microsoft Virtual Hard Disk To XenServer

Browse for the VHD to include in this conversion, then click Next.

Provide the following conversion information, then click Next: Hostname

Citrix XenConvert Guide

Optionally, edit the name of your new XenServer VM in the Name textbox.

Click Finish to exit XenConvert (this button displays after the conversion completes or after cancelling the conversion process), or click Log to display the conversion log file in Notepad.

Note For each conversion run, detailed status information is stored in the log file. The log file, XenConvert.txt, is created in the installation directory and provides the following information: â&#x20AC;˘

Start and stop time stamps

â&#x20AC;˘

Error and informational messages

Converting Open Virtualization Format Packages XenConvert permits converting Open Virtualization Format (OVF) Packages. An OVF Package consists of a descriptor file (*.ovf) and any other files representing the following attributes of the package: Signature Digital signature used by a public key certificate in the X.509 format to authenticate the producer of the package. Manifest

Chapter 4

Using XenConvert

SHA-1 digest of every file in the package to verify its contents by detecting any corruption. Virtual disks Files comprising virtual disks in the VHD format to contain a guest operating system.

Note A virtual disk can contain a Windows or Linux operating system.

An OVA is a single archive file, in the Tape Archive (tar), containing the files that comprise an OVF Package. The following conversions support virtual machines in the OVF. •

“XVA to OVF Package”

•

“OVF Package to XenServer”

XVA to OVF Package Select this method to convert an XVA to an OVF Package. 1.

Start the XenConvert Wizard (for details, refer to “Starting the XenConvert Wizard”.)

On the Welcome to Citrix XenConvert dialog, choose the following conversion options, then click Next: From Xen Virtual Appliance To Open Virtualization Format (OVF) Package

Browse for the XVA to include in this conversion, then click Next.

Note The OVA cannot include a file with a size greater than 8 GB because of a limitation of the TAR format specified in the OVF Specification.

Citrix XenConvert Guide

Compress Open Virtual Appliance (OVA) Check this box to reduce the size of the OVA. This option is only available if the Create Open Virtual Appliance box is checked. Sign with Certificate Check this box to sign this OVF Package with a certificate in the X.509 format. •

Browse for the appropriate file to include using the File... button

•

Enter the password in the Password textbox.

•

Click View to view certificate information.

Encrypt Select this option to encrypt the OVF Package. If the Create Open Virtual Appliance (OVA) is selected, encryption occurs before creating the OVA. Enter the passphrase with which to encrypt in the Passphrase text box. Confirm the passphrase by entering it again in the Confirm text box.

Note Encrypting an OVF Package will reduce the effectiveness of compression.

Click Next.

Optionally edit the name of your new XenServer VM in the Name textbox.

Click Finish to exit XenConvert (this button displays after the conversion completes or after cancelling the conversion process), or click Log to display the conversion log file in Notepad.

Note For each conversion run, detailed status information is stored in the log file. The log file, XenConvert.txt, is created in the installation directory and provides the following information: •

Start and stop time stamps

•

Error and informational messages

Chapter 4

Using XenConvert

OVF Package to XenServer Select this method to convert an OVF Package to XenServer. 1.

Start the XenConvert Wizard (for details, refer to â&#x20AC;&#x153;Starting the XenConvert Wizardâ&#x20AC;?.)

On the Welcome to Citrix XenConvert dialog, choose the following conversion options, then click Next: From Open Virtualization Format (OVF) Package To XenServer

Browse for the OVF Package to include in this conversion.

Optionally, select for the following checkbox options: Verify Content To verify the content in the manifest at conversion time, check this checkbox. Verify Author To verify the author is the source of the manifest at conversion time, check this checkbox. If the manifest or source can not be found, a message displays and allows you to select Yes to continue, or No to return to the previous dialog.

Click Next. After clicking Next, XenConvert must always check if the package was encrypted. The amount of time to check for encryption is proportional to the size of the package. If the OVF Package was found to be encrypted, please enter the encryption passphrase in the text box in order to continue.

Citrix XenConvert Guide

Click Next.

Click Finish to exit XenConvert (this button displays after the conversion completes or after cancelling the conversion process), or click Log to display the conversion log file in Notepad.

Note For each conversion run, detailed status information is stored in the log file. The log file, XenConvert.txt, is created in the installation directory and provides the following information: •

Start and stop time stamps

•

Error and informational messages

Converting From VMware This section describes converting from VMware Virtual Disks (VMDK) using the following conversion methods: •

“OVF to XenServer”

•

“VMDK to XenServer”

•

“VMDK to XVA”

•

“VMDK to VHD”

The OVF to XenServer conversion is preferable because it is faster and can be simpler for a workload consisting of multiple virtual disks. You’ll need a tool, such as one of the following, to create an OVF from VMware. •

Virtual Center 2.5 / ESX 3.5 Update 3

•

VMware Workstation 6.5

•

VMware Converter 3.0.3

•

Ovftool

•

VMware Studio 1.0

OVF to XenServer 1.

Create an OVF from a VMware.

Chapter 4

Using XenConvert

Import the OVF into XenServer using the “OVF Package to XenServer” conversion method.

Note If the selected XenServer is configured with bonded network interfaces, you may need to reconfigure the NIC(s) of your new VM.

VMDK to XenServer Select this method to convert a single VMDK to XenServer. 1.

Start the XenConvert Wizard (for details, refer to “Starting the XenConvert Wizard”.)

On the Welcome to Citrix XenConvert dialog, choose the following conversion options, then click Next: From VMware Virtual Hard Drive (VMDK) To XenServer

Browse for the VMDK to include in this conversion, then click Next.

Provide the following conversion information, then click Next: Hostname Simple host name, fully qualified domain name, or IP address of the XenServer. User name Name of the account with import privileges. Consult the XenServer product documentation for information on account requirements. Password The password that is associated with User name. Workspace Type or browse for the folder in which intermediate files should be stored. For conversion efficiency, Citrix recommends specifying a location on the local computer where you are running conversion, preferably on a different partition or drive.

Optionally edit the name of your new XenServer VM in the Name textbox.

Click Next.

Citrix XenConvert Guide

Click Finish to exit XenConvert (this button displays after the conversion completes or after cancelling the conversion process), or click Log to display the conversion log file in Notepad.

Note For each conversion run, detailed status information is stored in the log file. The log file, XenConvert.txt, is created in the installation directory and provides the following information: •

Start and stop time stamps

•

Error and informational messages

VMDK to XVA Select this method to convert a single VMDK to a XVA. 1.

Start the XenConvert Wizard (for details, refer to “Starting the XenConvert Wizard”.)

On the Welcome to Citrix XenConvert dialog, choose the following conversion options, then click Next: From VMware Virtual Hard Disk (VMDK) To Xen Virtual Appliance

Browse for the VHD to include in this conversion, then click Next.

Enter or browse for the folder where this VHD is to be stored, then click Next.

Optionally, edit the name of the new VMDK.

Click Next.

Chapter 4

Using XenConvert

Click Finish to exit XenConvert (this button displays after the conversion completes or after cancelling the conversion process), or click Log to display the conversion log file in Notepad.

Note For each conversion run, detailed status information is stored in the log file. The log file, XenConvert.txt, is created in the installation directory and provides the following information: •

Start and stop time stamps

•

Error and informational messages

VMDK to VHD Select this method to convert a single VMDK to a VHD. 1.

Start the XenConvert Wizard (for details, refer to “Starting the XenConvert Wizard”.)

On the Welcome to Citrix XenConvert dialog, choose the following conversion options, then click Next: From VMware Virtual Hard Disk (VMDK) To XenServer Virtual Hard Disk (VHD)

Browse for the VMDK to include in this conversion, then click Next.

Enter or browse for the folder where this VHD is to be stored, then click Next.

Citrix XenConvert Guide

Click Finish to exit XenConvert (this button displays after the conversion completes or after cancelling the conversion process), or click Log to display the conversion log file in Notepad.

Note For each conversion run, detailed status information is stored in the log file. The log file, XenConvert.txt, is created in the installation directory and provides the following information: •

Start and stop time stamps

•

Error and informational messages

XenConvert Configuration File XenConvert reads parameters from the configuration file, XenConvert.ini, which is located in the product installation folder. Section and parameter names are case sensitive. An example XenConvert.ini follows: [parameters] AutoDismountTimeoutAsMs = 30000 VhdPluginTimeoutAsMs= 300000 XvaChunkSize = 500000000 ServerClusterSize = 4095 WindowsFreePercentage = 25 FreeLowLimitPercentage = 5 [exclude] %SYSTEMDRIVE%\recycled %SYSTEMDRIVE%\recycler %SYSTEMDRIVE%\$recycle.bin %SYSTEMDRIVE%\pagefile.sys %SYSTEMDRIVE%\boot.ini %SYSTEMDRIVE%\hiberfil.sys %SYSTEMDRIVE%\system volume information %SYSTEMDRIVE%\.vdiskcache %SYSTEMDRIVE%\windows\csc %SYSTEMDRIVE%\windows\memory.dmp *.vhd

Chapter 4

Using XenConvert

*.xva

Parameters The parameters section may be followed by zero or more parameter entries in the <name> = <value> format. Valid parameter names are described in the table that follows. Name

Description

AutoDismountTimeoutAs Ms

Number of milliseconds to wait before retrying to automatically dismount a VHD. Default is 60 seconds. Default is 60000 (60 seconds).

VhdPluginTimeoutAsMs

Number of milliseconds to wait for a VHD to mount. Default is 600000 (10 minutes).

XvaChunkSize

Maximum size of a file that is part of a compressed virtual disk within an XVA. Dividing an XVA virtual disk into â&#x20AC;&#x153;chunksâ&#x20AC;? simplifies their transfer over a network. Default is 1000000000 (bytes).

ServerClusterSize

The number of bytes in a file system cluster on the system serving a vDisk. Set this parameter to optimize access of the vDisk by a system serving the vDisk from a simple file, such as Provisioning Services. For example: If a vDisk resides in a Provisioning Services store that is located on an NTFS volume with a cluster size of 16384, set the ServerClusterSize to 16384. Set the value to zero to disable optimization. Default is 4095.

WindowsFreePercentage

The percentage of free space to reserve in the volume on the vDisk that will contain the Windows operating system. Default is 25%.

FreeLowLimitPercentage

The minimum percentage of free space to require in a partition. The range is between 1 and 99, inclusively. The default is 5%.

Troubleshooting Conversion Issues Some features, such as those that follow, of Windows and other software can interfere with the conversion process.

Citrix XenConvert Guide

Windows AutoPlay Windows AutoPlay (also termed AutoRun), can prevent XenConvert from dismounting a VHD or formatting a volume that it creates. Consider disabling AutoPlay before converting. This procedure can vary by Windows versions. Please refer to the Microsoft article for details: Article ID: 967715 - Last Review: May 6, 2009 - Revision: 3.0 How to disable the autorun functionality in Windows

Search Indexing Disable, pause, or snooze the indexing of a search service, such as Windows Desktop Search, Windows Search, and Google Desktop.

Windows Automount The Windows Automount feature must be enabled for XenConvert to discover volumes that it creates on a VHD and Provisioning Services vDisk. This feature is disabled by default on Windows Server 2003 Enterprise Edition. To Enable Automount

On Windows Server 2003, enable the Windows Automount feature. â&#x20AC;˘

Enter the following command at a command shell prompt: DISKPART

â&#x20AC;˘

Enter the following command at the DISKPART prompt: automount enable Automount will be enabled in the VM or Provisioning Services vDisk created using XenConvert. Automount can be disabled within the VM or when booted from a Provisioning Services vDisk that is in Private Image mode.

Security Services Security software such as antivirus and endpoint protection services can sometimes interfere with a conversion. If disabling Windows AutoPlay does not resolve the problem when XenConvert fails to dismount a VHD or format a volume that it creates, consider stopping the security software. Before stopping security services, you should also disconnect from the network, unless converting to XenServer (this conversion type requires the network).