XenClient Enterprise Installation Best Practices

XenClient Enterprise Installation FAQ
XenClient Enterprise Version 4.1
June 28, 2012
Table of Contents
About this Document ..................................................................................................................... 3
Download and run the Compatibility Checker ................................................................................ 3
Check for Compatibility ........................................................................................................... 3
General Installation Issues ............................................................................................................. 3
Installation from Optical Media ...................................................................................................... 4
Installation from USB Media .......................................................................................................... 4
CPU Compatibility Problems........................................................................................................... 5
Disk Configuration Issues ............................................................................................................... 5
Hardware Compatibility Problems .................................................................................................. 5
BIOS Settings ........................................................................................................................... 6
Dual Boot Installation Problems ..................................................................................................... 6
Problems with XenClient Enterprise Engine PXE Boot Installs ......................................................... 7
Problems with XenClient Enterprise Engine Installer ...................................................................... 7
General Troubleshooting Techniques ............................................................................................. 8
Copyright © 2012 Citrix All Rights Reserved.
Version: 2.1
Citrix, Inc.
851 West Cypress Creek Road
Fort Lauderdale, FL 33309
United States of America
This document is furnished "AS IS." Citrix, Inc. disclaims all warranties regarding the contents of this document, including, but
not limited to, implied warranties of merchantability and fitness for any particular purpose. This document may contain
technical or other inaccuracies or typographical errors. Citrix, Inc. reserves the right to revise the information in this document
at any time without notice. This document and the software described in this document constitute confidential information of
Citrix, Inc. and its licensors, and are furnished under a license from Citrix, Inc.
Citrix Systems, Inc., the Citrix logo, Citrix XenClient, are trademarks of Citrix Systems, Inc. in the United States and other
countries. All other products or services mentioned in this document are trademarks or registered trademarks of their
respective companies.
Citrix Systems, Inc. acknowledges all trademarks used in this document. Linux is a registered trademark of Linus Torvalds and
Ubuntu is registered trademark of Canonical Ltd. Windows is a registered trademarks of Microsoft Corporation. All trademarks
are the property of their respective owners.
2
About this Document
This document provides information about installation issues that may occur when installing XenClient
Enterprise Engine.
Installing the XenClient Enterprise Engine on a computer can remove the native operating system
and any data. Before installing, back up any data from the computer that you want to preserve.
Download and run the Compatibility Checker
Citrix makes it easy to determine if your computer will work with XenClient Enterprise Engine. Access
the XenClient Platform Check on the Citrix web site to verify if your existing Windows machine supports
the virtualization required to run XenClient Enterprise Engine.
Check for Compatibility
XenClient Enterprise Engine runs on a wide variety of personal computers. Hardware requirements
include:
•
Intel or AMD dual-core processor with Intel-VT (VT-x) or AMD-V hardware virtualization
technology
Intel provides a tool to determine if the chip in your computer supports virtualization:
http://processorfinder.intel.com/.
•
2 GB RAM; Citrix strongly recommends 4 GB to facilitate running multiple virtual machines
simultaneously)
•
60 GB free disk space; running multiple operating systems may require significantly more disk
space.
General Installation Issues
The following issues may arise when installing XenClient Enterprise Engine:
•
The ISO file might be incomplete or corrupt.
In some cases it may be necessary to check the validity of the ISO file by verifying the MD5
checksum. A number of free ware tools are available for calculating and comparing MD5 files (for
example: http://download.cnet.com/MD5-Checksum-Calculator/3000-2092_4-10964258.html).
•
•
Use the latest PV drivers, they are critical for local VMs to get USB and network support along
with good performance.
Bad memory may cause the installation to fail in a variety of ways.
3
•
Some graphics cards can cause the installation to fail.
If you are installing XenClient Enterprise Engine on a desktop with an ATI or NVIDIA graphics card,
remove it and use the onboard Intel graphics processor instead.
Installation from Optical Media
The following issues may arise when installing from optical media:
•
•
•
•
•
Using CD media instead of DVD media
Bad optical media
Bad burn
Optical media incompatible with optical drive
USB optical drives can be problematic
Installation from USB Media
The following issues may arise when installing from USB media:
•
Unetbootin version compatibility issues
If you retrieve the UNetbootin distribution from another location, ensure that it is at least
version 549 or newer.
•
•
•
•
USB storage device has insufficient size; you should have at least a 2GB USB stick in order to
install XenClient Enterprise Engine using this method.
USB storage device not formatted before running Unetbootin
Running Unetbootin against ISO files on network storage can be problematic
Installation may appear to succeed, then begins reinstalling. This issue occurs because the BIOS
is configured to set to boot from USB first; if the USB memory stick is still installed when the
installation completes, the Engine re-reads the drive once it restarts, effectively restarting the
installation process. To resolve this issue, remove the USB stick after installation.
Consider the following when installing using a USB drive:
•
Ensure that the computer’s BIOS setting enables booting from USB-based media.
•
You can set your computer’s boot sequence so that it boots automatically from any installed USB
device; in the BIOS>BOOT configuration section, move the USB drive above the local disk in the
machine boot order.
If you arrange the boot order so that the USB drive is the primary boot device, keep in mind that
you must remove the USB stick containing the installer before you reboot the next time. Failure
to do so may result in re-installing the Engine.
•
If the boot order for the USB device is lower than local disk, or if it is not specified, select the
boot order menu key, usually F12.
4
CPU Compatibility Problems
The following compatibility issues should be considered:
•
•
For best results use Intel CPUs
Virtualization Technology not present or not enabled
Intel provides a tool to determine if the chip in your computer supports virtualization:
http://processorfinder.intel.com/.
•
•
64-bit not present or not enabled
If VT-d is causing problems, disable it
Disk Configuration Issues
The following disk configuration issues may pose problems during installation:
•
•
Only a single local SATA drive is supported
Installing over some Linux-based products may be problematic
Linux virtual machines are primarily for experimental use.
•
Installing over products with disk encryption may be problematic (BitLocker)
An encrypted hard drive cannot be accessed unless the registered owner’s password is entered.
The user’s password needs to be entered before the XenClient Enterprise Engine can start. Once
the user logs in, the hard drive is accessible and the user experiences no difference due to the
encryption. This is a strong security measure – the encrypted disk cannot be accessed without
the proper authentication. The only cost is a very slight (few percent) increase in CPU use
•
Can’t install over disks configured with GPT or other non-simple partition layouts
Hardware Compatibility Problems
The following compatibility problems issues may arise:
Citrix recommends that you use business-class laptops/desktops with all Intel components (CPU,
GPU, and networking), and 7200 RPM or faster hard drives are best.
•
Insufficient memory
Minimally, use 2GB RAM; Citrix strongly recommends 4GB to facilitate running multiple virtual
machines simultaneously.
5
•
•
•
XenClient Enterprise Engine runs best with Intel graphics
NVIDIA/Optimus systems are often problematic
o Must disable Optimus in the BIOS, even then it might not work
o The experimental NVIDIA driver should never be used
Limited support for newer NVIDIA and ATI graphics cards
BIOS Settings
To use XenClient Enterprise Engine, the system must support virtualization. BIOS settings must also be
configured to match the following criteria:
Virtualization:
enabled (checked)
VT:
enabled (checked)
Trusted Execution:
off (unchecked)
For Lenovo computers:
Timer wake with battery:
enabled
You need to restart the computer for changes to the BIOS to take effect. On some systems, it
may be necessary to power down the computer for a few minutes, then restart.
Dual Boot Installation Problems
The following dual boot issues may be encountered:
•
Only dual-boot with WinXP and Win7 is supported
Windows 7 uses a tremendous amount of disk space. To prevent problems during dual-boot
installations, use a third part tool (for example, gparted) to shrink the partition to a manageable
size, then reboot native Windows. Run checkdsk to verify that native Windows booted
successfully. Once you verify that native Windows booted, return to the dual-boot installation.
•
•
Sufficient free disk space required
A free primary disk partition is required
There are numerous disk partition tools. For Windows XP-based computers, Citrix has tested the
procedures in this document using the EASEUS Partition Master Home Edition. For Vista and
Windows 7, use the native Disk Manager to create a partition.
•
Dual boot will not work if Windows is using disk encryption (BitLocker)
Consider that the dual boot installation consists of two phases:
•
In phase 1, you resize the partitions on the hard drive to create unallocated space (minimum
60GB). Install third party partitioning software to install XenClient Enterprise Engine on a
6
machine with Windows XP; Windows 7 includes a partitioning tool. Use the instructions for
Windows 7 if you have both Windows operating systems on your hard drive.
It may be necessary to perform a disk defrag before repartitioning a system that has been in use
for an extended period of time. Failure to do so may result in the OS being unable to free up
enough space to shrink the volume due to lack of a contiguous free space.
•
In phase 2, you install XenClient Enterprise Engine to the unallocated space on the hard drive
created in phase 1. XenClient Enterprise Engine can be installed from CD, DVD, USB storage
device, or from a PXE server.
After installing, the user can select to boot either a native Windows operating system or the XenClient
Enterprise Engine each time the system is powered up.
The XenClient Enterprise Engine and any virtual machines you plan to include on the Engine need
to fit in the unallocated space, so select the space accordingly.
Problems with XenClient Enterprise Engine PXE Boot Installs
The following dual boot issues may be encountered:
•
•
For PXE boot procedures involving a virtual machine (i.e., a personal virtual machine), ensure
that the NIC is in bridge mode so that the personal VM's DHCP service is used rather than the
Engine's DHCP service in NAT mode.
PXE boot installations may fail if the computer has 2 GB RAM or less.
Problems with XenClient Enterprise Engine Installer
The following issues may arise when using the XenClient Enterprise Engine Installer:
•
•
•
•
•
•
Running the XenClient Enterprise Engine Windows Installer permanently alters your system disk;
Windows partitions are shrunk to make room for the installation. To avoid possible data loss, be
certain to make a backup image of your entire hard drive before starting the installer.
There is currently no way to reclaim the disk space that the installer uses for Windows without
manually repartitioning your disk.
Do not perform an installation on a machine that you need to return to its original configuration
unless you have backed up your image.
Be certain that you are running on AC power while installing, and DO NOT shut the power off on
your PC while running the installer; this may lead to a corrupted system.
Installation time varies, and depends on the size of the disk and how full the disk partition is; the
entire process may take up to twenty minutes.
Most hard disks have a limit of 4 physical partitions. To install XenClient Enterprise Engine, you
must have at least one free partition available. To install XenClient Enterprise Engine with a
recovery partition, you must have at least two free partitions available. Refer to the Windows
Disk Manager for information on determining the number of disk partitions available.
7
There are numerous disk partition tools. For Windows XP-based computers, Citrix has tested the
procedures in this manual using the EASEUS Partition Master Home Edition. For Vista and
Windows 7, use the native Disk Manager to create a partition.
The recovery partition requires approximately 2 GB of space. Your computer must have at least
two free partitions available; if no free partition is available, the recovery partition cannot be
created and the process will be aborted. Use the Windows Disk Manager for information about
the number of available disk partitions.
•
The installer does not determine how much space to use; during installation, 90% of available
disk space is consumed by the installed the Engine.
Ensure that your Windows drive has sufficient disk space. Approximately 90% of the NTFS
partition will be used for the installation; the amount of free space on Windows will NOT match
up exactly with the amount space that the XenClient Enterprise Engine Windows Installer can
shrink.
General Troubleshooting Techniques
Consider the following general troubleshooting techniques:
•
•
Use the latest version of XenClient Enterprise Engine. Visit the Citrix download site for the latest
version.
Verify install ISO file downloads
In some cases it may be necessary to check the validity of the ISO file by verifying the MD5
checksum. A number of free ware tools are available for calculating and comparing MD5 files (for
example: http://download.cnet.com/MD5-Checksum-Calculator/3000-2092_4-10964258.html).
•
•
•
•
If installation from optical media fails, try USB, or vice-versa
Verify installation media before installing
Enable installation debug mode
Check hardware compatibility
If you are using an Intel processor, Intel provides a tool to determine if the chip in your computer
supports virtualization: http://processorfinder.intel.com/.
•
Try a different computer
8