Xenserver Virtual Machine Installation Guide: Published September 2008 1.0 Edition

XenServer Virtual Machine Installation
Guide
5.0.0
Published September 2008
1.0 Edition
XenServer Virtual Machine Installation Guide: Release 5.0.0
Published September 2008
Copyright © 2008 Citrix Systems, Inc.
Xen®, Citrix®, XenServer™, XenCenter™ and logos are either registered trademarks or trademarks of Citrix Systems, Inc. in the United States
and/or other countries. Other company or product names are for informational purposes only and may be trademarks of their respective owners.
This product contains an embodiment of the following patent pending intellectual property of Citrix Systems, Inc.:
1. United States Non-Provisional Utility Patent Application Serial Number 11/487,945, filed on July 17, 2006, and entitled “Using Writeable Page
Tables for Memory Address Translation in a Hypervisor Environment”.
2. United States Non-Provisional Utility Patent Application Serial Number 11/879,338, filed on July 17, 2007, and entitled “Tracking Current Time
on Multiprocessor Hosts and Virtual Machines”.
Table of Contents
1. About this document ....................................................................................................... 1
Overview .................................................................................................................. 1
How this Guide relates to other documentation ................................................................ 1
2. Creating VMs ................................................................................................................ 2
Overview .................................................................................................................. 2
Virtual memory and disk size limits .............................................................................. 2
XenServer product family virtual device support .............................................................. 3
Physical to Virtual Conversion (P2V) ............................................................................ 4
General Guidelines for Virtualizing Physical Servers ................................................. 5
Cloning an existing VM .............................................................................................. 6
Importing an exported VM ........................................................................................... 7
Exporting a VM ................................................................................................. 7
Importing a VM ................................................................................................. 8
VM Block Devices ............................................................................................. 8
3. Installing Windows VMs .................................................................................................. 9
Making the ISO available to XenServer Hosts ................................................................. 9
Copying ISOs to local storage ............................................................................. 10
Windows paravirtualized drivers .................................................................................. 11
Windows Volume Shadow Copy Service (VSS) provider ......................................... 11
Remote Desktop ....................................................................................................... 12
Preparing to clone a Windows VM .............................................................................. 12
Time Handling in Windows VMs ................................................................................ 13
Release Notes .......................................................................................................... 13
General Windows Issues .................................................................................... 13
Windows 2003 Server ....................................................................................... 14
Windows 2008 Server ....................................................................................... 14
Windows XP SP3 ............................................................................................. 14
Windows 2000 Server ....................................................................................... 14
Windows Vista ................................................................................................. 14
4. Installing Linux VMs ..................................................................................................... 15
Installation of a built-in distribution ............................................................................. 16
Installing Linux from vendor media to a VM ................................................................. 16
Installing Linux from a network installation server to a VM .............................................. 18
Physical-to-Virtual Installation of a Linux VM ............................................................... 19
Guest Installation Network ................................................................................. 19
Installing the Linux guest agent ................................................................................... 20
Preparing to clone a Linux VM ................................................................................... 21
Machine Name ................................................................................................. 21
IP address ........................................................................................................ 21
MAC address ................................................................................................... 21
Time handling in Linux VMs ...................................................................................... 21
Configuring VNC for VMs ......................................................................................... 22
Setting up Red Hat-based VMs for VNC .............................................................. 22
Setting up SLES-based VMs for VNC .................................................................. 24
Setting up Debian-based VMs for VNC ................................................................ 27
Checking runlevels ............................................................................................ 27
Release Notes .......................................................................................................... 27
Debian Sarge 3.1 and Etch 4.0 ............................................................................ 27
Red Hat Enterprise Linux 3 ................................................................................ 28
XenServer Virtual Machine Installation Guide iv
CentOS 4 ........................................................................................................ 30
CentOS 5 ........................................................................................................ 30
Oracle Enterprise Linux 5 .................................................................................. 30
SUSE Enterprise Linux 9 ................................................................................... 30
SUSE Enterprise Linux 10 SP1 ........................................................................... 31
5. Updating VMs .............................................................................................................. 32
Updating Windows operating systems .......................................................................... 32
Updating paravirtualized drivers for Windows VMs ........................................................ 32
Updating Linux kernels and guest utilities ..................................................................... 32
A. Creating ISO images ..................................................................................................... 34
B. Setting Up a Red Hat Installation Server ........................................................................... 35
Copy installation media ............................................................................................. 35
Enable remote access ................................................................................................. 35
NFS ................................................................................................................ 35
FTP ................................................................................................................ 36
HTTP ............................................................................................................. 36
C. Troubleshooting VM problems ........................................................................................ 37
VM crashes ............................................................................................................. 37
Controlling Linux VM Crashdump Behaviour ........................................................ 37
Controlling Windows VM Crashdump Behaviour ................................................... 38
Troubleshooting boot problems on Linux VMs ............................................................... 38
D. VM Virtual CPU allocation ............................................................................................ 39
Index .............................................................................................................................. 40
Chapter 1. About this document
Overview
This document is a guide to creating Virtual Machines with XenServer™, the platform virtualization solution from
Citrix™. It describes the various methods of getting VMs up and running on XenServer Hosts for each of the supported
operating systems.
This section summarizes the rest of the guide so that you can find the information you need. The following topics
are covered:
• general information about creating VMs

• creating Windows VMs
• creating Linux VMs
• updating VMs
• Creating and using ISO images of vendor media for installing VMs
• Setting up a network repository of vendor media for installing VMs
• Troubleshooting problems with VMs
How this Guide relates to other documentation

This document is primarily aimed at system administrators who need to set up deployments of XenServer VMs. Other
documentation shipped with this release includes:
• XenServer Installation Guide provides a high level overview of XenServer, along with step-by-step instructions on
installing XenServer Hosts and the XenCenter management console;
• XenServer Administrator's Guide describes the tasks involved in configuring a XenServer deployment -- how to
set up storage, networking and resource pools, and how to administer XenServer Hosts using the xe command line
interface (CLI).
• XenServer Software Development Kit Guide presents an overview of the XenServer SDK -- a selection of code
samples that demonstrate how to write applications that interface with XenServer Hosts.
• XenAPI Specification provides a programmer's reference guide to the XenServer API.
• Release notes provide a list of known issues that affect this release.
Chapter 2. Creating VMs
This chapter provides an overview of how VMs are created and lists virtual memory and virtual disk size minimums,
describes the differences in virtual device support for the members of the XenServer product family. This chapter also
discusses physical to virtual conversion (P2V), cloning templates, and importing previously-exported VMs.
Overview
VMs are created from templates. A template is a "gold image" that contains all the various configuration settings to
instantiate a specific VM. XenServer ships with a base set of templates, which range from generic "raw" VMs that can
boot an OS vendor installation CD (Windows) or run an installation from a network repository (Red Hat Enterprise
Linux, SUSE Linux Enterprise 10) to complete pre-configured OS instances (Debian Etch and Sarge).
Different operating systems require slightly different settings in order to run at their best. XenServer templates are
tuned to maximize operating system performance.
The Linux templates create Pure Virtual (PV) guests, as opposed to the HVM guests created by the Windows and
Other Install Media templates. Other Install Media template Linux installations are not supported.
There are three basic methods by which VMs are created using templates:
• using a complete pre-configured template (Debian Sarge and Etch Linux)

• Installing from a CD or an ISO image onto the appropriate template (Windows 2000 SP4/Windows 2003 Serv-
er/Windows XP SP2 or SP3/Windows Vista, RHEL 5.0, CentOS 5.0)
• Installing from vendor media on a network installation server directly onto a template (Red Hat Enterprise Linux
4.5+ and 5.0+, and SUSE Linux Enterprise Server 10 SP1)
Creating VMs by installing Windows operating systems onto the appropriate templates is described in Chapter 3,
Installing Windows VMs.
Creating VMs by installing Linux operating systems onto the appropriate templates is described in Chapter 4, Installing
Linux VMs.
Additionally, VMs can be created by
• performing a physical to virtual (P2V) conversion on an existing physical server (Red Hat Enterprise Linux 3.6,
3.8, 4.1-4.4, and SUSE Linux Enterprise Server 9 SP2/3/4)
• importing an existing, exported VM
• converting an existing VM to a template
These methods are described in this chapter.
Virtual memory and disk size limits

In general, when installing VMs, be sure to follow the memory and disk space guidelines of the operating system and
any relevant applications that you want to run when allocating resources such as memory and disk space.
Note that individual versions of the operating systems may also impose their own maximum limits on the amount of
memory supported (for example, for licensing reasons).
XenServer Virtual Machine Installation Guide Creating VMs 3
Operating System Minimum RAM Maximum RAM Disk

space
Windows Server 2008 32-bit/64-bit 512MB minimum supported, 2GB 32GB Minimum
or more recommended 10GB,
40GB or
more rec-
ommend-
ed
Windows Vista 32-bit 512MB minimum supported, 32GB 16GB

768MB or more recommended
Windows 2003 128MB minimum supported; 32GB 2GB

Windows XP SP2/3 128MB minimum supported; 32GB 1.5GB

Windows 2000 SP4 128MB minimum supported; 32GB 2GB

CentOS 4.5, 4.6, 4.7 256MB 16GB 800MB
CentOS 5.0, 5.1, 5.2 512MB 16GB 800MB
Red Hat Enterprise Linux 3.6 64MB 32GB 1.5GB
Red Hat Enterprise Linux 4.5, 4.6, 256MB 16GB 800MB

4.7
Red Hat Enterprise Linux 5.0, 5.1, 512MB 16GB 800MB

5.2
SUSE Linux Enterprise Server 9 256MB 32GB 1GB

SP2/3/4
SUSE Linux Enterprise Server 10 512MB 32GB 1.5GB

SP1/2
Debian Sarge, Etch 128MB 32GB 4GB
XenServer product family virtual device support

The current version of the XenServer product family has the following general limitations on virtual devices for VMs.
Note that specific guest operating systems may have lower limits for certain features. These limitations are noted in
the individual guest installation section.
Virtual device Linux VMs Windows VMs
Number of virtual CPUs 32* 8
Number of virtual disks 8 (including virtual CD-ROM) 7 (including virtual CD-ROM)

Virtual device Linux VMs Windows VMs
Number of virtual CD- 1 1

ROM drives
Number of virtual NICs 7† 7
Hotplugging virtual disks add/remove add/remove
Hotplugging virtual NICs add/remove add/remove

*
A maximum of 8 VCPUs are supported via XenCenter.
†
except for SLES 10 SP1 and RHEL 3.x and 4.x, which support 3. RHEL 5.0/5.1/5.2 support 3, but can support 7 when the kernel is patched with
the Citrix Tools for Virtual Machines. The same applies for Oracle and CentOS 5.0/5.1/5.2
Express Edition, Standard Edition, and Enterprise Edition also differ in the following ways that are relevant for creating
VMs:
Enterprise Edition Standard Edition Express Edition
Amount of physical RAM on up to 128GB up to 128GB up to 128GB

XenServer Host
Number of concurrent VMs 50 50 50
Multiple hosts in XenCenter yes yes no
Support for VLANs yes yes no
Support for shared storage yes no no
Support for resource pools yes no no
Support for High Availability yes no no
Support for additional QoS control yes no no
If you attempt to create a VLAN with an Express Edition license, for example, an error message will appear suggesting
that you can upgrade your license. Licenses are applied per-host, and so for a resource pool setup you must apply an
Enterprise Edition license across all hosts before joining them into a pool.
If you downgrade a license on a host, it does not take any immediate action on running domains, but ensures that the
restrictions are enforced from that point onwards. License downgrade is disallowed in the case of a host that is actively
participating in a pool, so it must be ejected and then downgraded.
License expiry on a host also does not take any immediate action on running domains, but prevents new domains being
started. XenCenter will also regularly warn you if your hosts are approaching license expiry thresholds, in advance of it.
For more information about XenServer licensing, see Chapter 3, XenServer Licensing in XenServer Installation Guide
Physical to Virtual Conversion (P2V)

Physical to Virtual Conversion (P2V) is the process by which an existing operating system on a physical server -
its filesystem, configuration, etc. - is cast into a virtualized instance of the same operating system and filesystem,
transferred, instantiated, and started as a VM on the XenServer Host.
For existing physical instances of Windows servers, the XenConvert tool is now included with the XenServer 5.0.0
release. XenConvert runs on the physical Windows machine and converts it live into a VHD-format disk image or an
XVA template suitable for importing into a XenServer host. The physical host does not need to be restarted during this
process, and device drivers are automatically modified to make them compatible with running in a virtual environment.
For more information, please refer to the XenConvert documentation for installation and usage guidelines.
For existing physical instances of Linux servers, this is accomplished by booting from the XenServer installation CD
and choosing the P2V option. The filesystem is copied across the network onto a XenServer Host, where it appears
as a normal VM. We recommend that you perform P2V operations during off-peak hours since the process involves
transferring a large amount of data, which could impact other Virtual Machines running on the XenServer Host.
The P2V tool requires a 64-bit capable CPU by default. If you have an existing Linux instance on an older machine that
you want to transfer via P2V, you can boot the CD via the p2v-legacy option at the initial prompt. This does require
at least a PAE-enabled machine, so for very old machines you can physically move the hard drive to a PAE-enabled
machine and perform the operation from there.
To P2V an existing Linux server directly to a XenServer Host
1. Reboot the physical server that you want to convert and boot from the XenServer installation CD. If the boot
fails, start again and use the p2v-legacy option.
2. After the initial boot messages, you will see the "Welcome to XenServer" screen. (In this and the screens that
follow, use Tab or Alt+Tab to move between elements, Space to select, and F12 to move to the next screen.)
Click OK to proceed.
3. The installer does some hardware detection and initialization, then presents a screen with four choices.
Select Convert an existing OS on this machine to a VM (P2V) and click OK to proceed.

4. The Welcome to XenServer P2V screen with a descriptive message is displayed next. Click OK to proceed and
follow the on-screen prompts.
When the P2V process is complete and the new VM is created, you will need to create and attach a VIF for it to
have external network connectivity. Similarly, extra disks may also be added to take advantage of additional storage
capacity available to the XenServer host.
Since the VM has new virtual network hardware, the MAC addresses it sees will also be different. Follow the Linux
cloning guidelines (see the section called “Preparing to clone a Linux VM”) for customizing the configuration files to
make the VM re-run any hardware detection scripts at startup.
General Guidelines for Virtualizing Physical Servers

When considering how to best begin virtualizing a collection of physical servers, it is best to gain some comfort level
and experience with virtualizing servers that are more simply configured, moving later to servers with more complex
configurations.
Good candidates typically include servers that are used for test and development environments, and servers used for
in-house IT infrastructure (intranet web servers, DNS, NIS, and other network services, etc.). Typically servers that are
doing heavily CPU-intensive tasks (sophisticated mathematical modeling, video rendering) or are I/O-intensive (high-
traffic commercial web sites, highly-used database servers, streaming audio/video servers) are not the best candidates
for virtualization at the start.
Once you have identified some physical servers that seem reasonable to work on first, you should take a close look
at how you are currently using them. What applications are they hosting? How I/O intensive are they? How CPU-
intensive are they?
To make a reasonable assessment, you should gather a reasonable amount of data on the current physical servers that
you are thinking about virtualizing. Look at system monitoring data for disk usage, CPU usage, memory usage, and
network traffic, and consider both peak and average values.
Good candidates for virtualization are:
• servers whose CPU and memory usage and NIC and disk throughput are low will be more likely to coexist as a VM
on a XenServer Host with a few other VMs without unduly constraining its performance.
• servers that are a few years old - so their performance as VMs hosted on a newer server would be comparable to
their existing state.
• servers that do not use any incompatible hardware which cannot be virtualized, such as dongles, serial or parallel
ports, or other unsupported PCI cards (serial cards, cryptographic accelerators, etc.).
Once you have identified a set of machines that you want to virtualize, you should plan the process to accomplish the
task. First, provision the physical servers that will serve as your XenServer Hosts. The chief constraint on the number
of VMs you can run per XenServer Host is system memory.
Next, plan how you will create the VMs. Your choices are to P2V an existing server, install a fresh server from
network-mounted vendor media, or install a base operating system using a pre-existing template.
If you P2V an existing server, it's best to P2V a test instance of the server, and run it in parallel with the existing
physical server until you are satisfied that everything works properly in the virtual environment before re-purposing
the existing physical machine.
Next, plan how to arrange the desired VMs on the XenServer Hosts. Don't "mix up" servers - assign VMs to specif-
ic XenServer Hosts, giving consideration to complementary resource consumption (mixing CPU-intensive and I/O-
intensive workloads) and complementary peak usage patterns (for instance, assigning overnight batch processing and
daytime interactive workloads to the same XenServer Host).
For configuring individual VMs themselves, keep these guidelines in mind:
• create single-processor VMs unless you are serving a multi-threaded application that will perform demonstrably
better with a second virtual CPU.
• when you configure the memory settings for a VM, consult the documentation for the guest operating system you
plan to run in that VM and for the applications you plan to run on them.
Cloning an existing VM
You can make a copy of an existing VM by cloning from a template. Templates are just ordinary VMs which are
intended to be used as master copies to instantiate copies from. A VM can be customized and converted into a template,
but be sure to follow the appropriate preparation procedure for the VM (see the section called “Preparing to clone a
Windows VM” for Windows and the section called “Preparing to clone a Linux VM” for Linux). Templates cannot
be used as normal VMs without first cloning them.
XenServer has two mechanisms for cloning VMs: a full copy, or a faster "Copy-on-Write" (CoW) mode which only
writes modified blocks to disk. The CoW mode is only supported for file-backed VMs. CoW is designed to save disk
space and allow fast clones, but will slightly slow down normal disk performance. A template can be fast-cloned
multiple times without slowdown, but if a template is cloned into a VM and the clone converted back into a template,
disk performance can linearly decrease depending on the number of times this has happened. In this event, the vm-
copy CLI command can be used to perform a full copy of the disks and restore expected levels of disk performance.
Resource pools introduce some complexities around creating custom templates and cloning them. If you create a
template on a server in the pool, and all virtual disks of the source VM are on shared storage repositories (SR), the
operation of cloning that template will be forwarded to any server in the pool that can see those shared SRs. However,
if you create the template from a source VM that has any virtual disks on a local SR, then the clone operation can only
execute on the server that can see this SR.
Importing an exported VM
You can make a VM by importing an existing exported VM. Like cloning, exporting and importing a VM is a means
for creating additional VMs of a certain configuration. You might, for example, have a special-purpose server config-
uration that you use many times. Once you have set up a VM the way you want it, you can export it, and import it later
at any time you want to create another copy of your specially-configured VM. Export and import also provides a way
to move a VM to another XenServer Host that is not part of a resource pool.
When importing a VM, you can choose to preserve the MAC address on any virtual network interfaces associated
with it. If you do choose to generate a new MAC address, be sure to follow the appropriate preparation procedure for
the imported VM (see the section called “Preparing to clone a Windows VM” for Windows and the section called
“Preparing to clone a Linux VM” for Linux).
Importing an exported VM will take some time, and depends on the size of the VM and the speed and bandwidth of
the network connection between the XenServer Host and XenCenter.
Note
Note that an exported VM that originated on one XenServer Host might or might not be able to be resumed on a
different XenServer Host. For example, if a Windows VM created on a XenServer Host with an Intel VT-enabled
CPU is exported, then imported to a XenServer Host with an AMD-V CPU, it will not start.
When importing VMs using the CLI, networks on which the virtual interfaces (VIFs) get connected to are matched by
their name on the server the VM was exported from. The default name of the standard pool-wide networks changed
between versions 4.0.1 and 4.1.0, which means that it may be necessary to re-create the virtual interfaces associated
with a VM on the desired network. If using XenCenter, the Import wizard will allow you to remap interfaces as desired
as part of the import operation.
Exporting a VM
An existing VM can be exported via XenCenter or via the CLI. This section describes using the CLI. For details on
exporting using XenCenter, see the XenCenter online Help.
The following procedure assumes that you have multiple XenServer Hosts and that you are administering them using
the CLI on a separate machine (that is, a machine that is not one of the XenServer Hosts) where you can maintain a
library of export files. Avoid exporting a VM to a XenServer Host filesystem.
To export a VM using the CLI
1. If it is running, shut down VM that you want to export.

2. Export the VM:
xe vm-export -h <hostname> -u <root> -pw <password> vm=<vm_name> \

filename=<pathname_of_file>
Note
Be sure to include the .xva extension when specifying the export filename. If the exported VM does not have this
extension and you attempt to import it via XenCenter, it will fail to recognize the file as a valid XVA file.
3. The export process will probably take some time. When finished, the command prompt returns.
Importing a VM
An existing exported VM file can be imported via XenCenter or via the CLI. This section describes using the CLI. For
details on importing using XenCenter, see the XenCenter online Help.
The following procedure assumes that you are administering the XenServer Host using the CLI on a separate machine
(that is, a machine that is not one of your XenServer Hosts) where you maintain a library of export files.
To import a VM using the CLI
1. To import the VM to the default SR on the target XenServer Host:
xe vm-import -h <hostname> -u <root> -pw <password> \

filename=<pathname_of_export_file>
You can import the VM to another SR on the target XenServer Host by adding the optional sr-uuid parameter:

filename=<pathname_of_export_file> sr-uuid=<uuid_of_target_sr>
You can also preserve the MAC address of the original VM by adding the optional preserve set to true:

filename=<pathname_of_export_file> preserve=true
2. The import process will probably take some time. When finished, the command prompt returns the UUID of the
newly-imported VM.
VM Block Devices
In the PV Linux case, block devices are passed through as PV devices. XenServer does not attempt to emulate SCSI
or IDE, but instead provides a more suitable interface in the virtual environment in the form of xvd* devices. It is
also possible to get an sd* device using the same mechanism, where the PV driver inside the VM takes over the SCSI
device namespace. This is not desirable so it is best to use xvd* where possible for PV guests (this is the default for
Debian and RHEL).
For Windows or other fully virtualized guests, XenServer emulates an IDE bus in the form of an hd* device. When
using Windows, installing the Citrix Tools for Virtual Machines installs a special PV driver that works in a similar
way to Linux, except in the fully virtualized environment.
Chapter 3. Installing Windows VMs
XenServer allows you to install Windows 2000 SP4, Windows Server 2003 (32-/64- bit), Windows Server 2008, or
Windows XP SP2/3 into a VM. Installing Windows VMs on XenServer Host requires hardware virtualization support
(Intel VT or AMD-V).
Installing a Windows VM can be broken down into two main steps:
• installing the Windows operating system

• installing the paravirtualized device drivers known as the Citrix Tools for Virtual Machines
Windows VMs are installed by cloning an appropriate template from either XenCenter or the CLI. The templates
for individual guests have predefined platform flags set which define the configuration of the virtual hardware. For
example, all Windows VMs are installed with the ACPI Hardware Abstraction Layer (HAL). If you subsequently
change one of these VMs to have multiple virtual CPUs, Windows automatically switches the HAL to multi-processor
mode.
The available Windows templates are:
• Windows Server 2008

can be used to install Windows Server 2008 32-bit in enlightened mode.
• Windows Server 2008 x64
can be used to install Windows Server 2008 64-bit in enlightened mode.
can be used to install Windows Server 2003 32-bit SP0, SP1, SP2, and R2. The Server, Enterprise, Data Centre,
and SBS editions are supported.
can be used to install Windows Server 2003 64-bit. The Server, Enterprise, Data Centre, and SBS editions are
supported.
• Windows Server 2003, optimized for Citrix XenApp
can be used to install Windows Server 2003 32-bit SP0, SP1, SP2, and R2. The Server, Enterprise, Data Centre, and
SBS editions are supported. This template is specially tuned to optimize XenApp performance.
• Windows Server 2003 x64, optimized for Citrix XenApp
can be used to install Windows Server 2003 64-bit. The Server, Enterprise, Data Centre, and SBS editions are
supported. This template is specially tuned to optimize XenApp performance.
• Windows 2000 SP4
can be used to install Windows 2000 Server Service Pack 4. Earlier service packs are not supported.
• Windows Vista
can be used to install Windows Vista 32-bit. The Enterprise edition is supported.
• Windows XP SP3
can be used to install Windows XP Service Pack 3. Earlier service packs are not supported.
• Windows XP SP2
can be used to install Windows XP Service Pack 2. Earlier service packs are not supported.
The Windows VM can be installed either from an install CD in a physical CD-ROM on the XenServer Host, or from
an ISO image of your Windows media (see Appendix A, Creating ISO images for information on how to make an ISO
image from a Windows install CD and make it available for use).
Making the ISO available to XenServer Hosts

To make an ISO library available to XenServer Hosts, create an external NFS or SMB/CIFS share directory. The NFS
or SMB/CIFS server must be set to allow root access to the share. For NFS shares, this is accomplished by setting the
no_root_squash flag when you create the share entry in /etc/exports on the NFS server.
XenServer Virtual Machine Installation Guide Installing Windows VMs 10
Then either use XenCenter to attach the ISO library, or connect to the host console and type in:
xe-mount-iso-sr host:/volume
Additional arguments to the mount command may be passed in, for advanced use.
If making a Windows SMB/CIFS share available to the XenServer host, either use XenCenter to make it available,
or connect to the host console and type in:
xe-mount-iso-sr unc_path -t smbfs -o username=myname/myworkgroup
The unc_path argument should have back-slashes replaces by forward-slashes. -t cifs can be used for CIFS
instead of SMB. Examples:
xe-mount-iso-sr //server1/myisos -t cifs -o username=johndoe/mydomain

xe-mount-iso-sr //server2/iso_share -t smbfs -o username=alice
After mounting the share, any ISOs in it should be available by name from the CD pulldown list in XenCenter, or as
CD images from the CLI commands. The ISO should be attached to an appropriate Windows template:

• Windows 2000 SP4
• Windows XP SP3
Copying ISOs to local storage

In XenServer 3.2 and earlier, ISOs could be copied directly to the control domain into the /opt/xensource/pack-
ages/iso directory. In XenServer 5.0.0 hosts, this directory is reserved for use of the built-in ISO images, and is not
intended for general use. This directory is considered to be identical across hosts in a resource pool, and CD images
may fail to attach if the contents are modified.
To use local ISO storage from the control domain
1. Log onto the host console.

2. Create a directory to copy the local ISOs into:
mkdir -p /var/opt/xen/iso_import
3. Create an ISO storage repository by:
xe sr-create name-label=<name> type=iso \

device-config:location=/var/opt/xen/iso_import/<name> \
device-config:legacy_mode=true content-type=iso
4. Copy the ISO images into this directory, taking care not to fill up the control domain filesystem.
5. Verify that the ISO image is available for use by xe vdi-list, or checking the CD drop-down box in XenCenter.
Warning
Be extremely careful with copying ISOs directly onto the control domain filesystem, as it has limited space available.
A network share is a much safer mechanism for storing large numbers of ISO images. If the control domain does
fill up, unpredictable behavior will result.
Windows paravirtualized drivers

The Citrix paravirtualized network and SCSI drivers (Citrix Tools for Virtual Machines) provide high performance I/O
services without the overhead of traditional device emulation found in first-generation virtualization products. During
the installation of a Windows operating system, Xen will use traditional device emulation to present a standard IDE
controller and a standard network card to the Virtual Machine. This allows Windows to complete its installation using
built-in drivers, but with reduced performance due to the overhead inherent in emulation of the controller drivers.
After Windows is installed, you install the Citrix high-speed paravirtualized drivers. These are on an ISO available to
the virtual CD-ROM drive of the Virtual Machine. These drivers replace the emulated devices and provide high-speed
transport between Windows and the XenServer product family software.
Note
While a Windows VM will function without them, performance is significantly hampered unless these drivers are
installed. Running Windows VMs without these drivers is not supported. Some features, such as live relocation
across physical hosts, will only work with the paravirtual drivers installed and active.
The Windows paravirtualized drivers ISO can be attached to the VM by using the Install Tools menu in XenCenter,
or by directly inserting the built-in xs-tools.iso ISO image to the VM using the CLI. Once the ISO is attached,
double-click on the xensetup.exe installer executable and follow the on-screen prompts.
Note
To silently install the Citrix Tools for Virtual Machines and prevent the system from rebooting afterwards, use the
/S and /norestart options:
<install_dir>/xensetup.exe /S /norestart
The Windows paravirtualized drivers are installed by default in the directory C:\Program Files\Citrix\Xen-
Tools on the VM.
The Citrix Tools for Virtual Machines can also be installed on a provisioned Windows machine by running the exe-
cutable windows-pvdrivers-xensetup.exe in the client_install/ directory of the installation CD.
Windows Volume Shadow Copy Service (VSS) provider

The Windows tools also include a Xen VSS provider that is used to quiesce the guest filesystem in preparation for a
VM snapshot. The VSS provider is not installed by default, but is bundled with the PV driver installation.
To install the Windows Xen VSS provider
1. Install the Windows paravirtualized drivers.

2. Navigate to the directory where the drivers have been installed (by default c:\Program Files\Cit-
rix\XenTools, or available in the Windows Registry via HKEY_LOCAL_MACHINE\Software\Cit-
rix\XenTools\Install_dir).
3. Double-click the install-XenProvider.cmd command to install and activate the VSS provider.
Note that the VSS provider is uninstalled automatically when the PV drivers are uninstalled, and will need to be
activated again upon reinstallation. They can be uninstalled separately from the PV drivers by using the unin-
stall-XenProvider.cmd in the same directory.
Remote Desktop
The graphical console for Windows can be either a standard console via emulated graphics card, or an RDP connection.
For Windows VMs, there is a Switch to Remote Desktop button on the Console tab. Clicking it disables the standard
graphical console, and switches to using Remote Desktop instead.
The button will be grayed out if you do not have Remote Desktop enabled in the VM, and the paravirtualized drivers
must be installed.
To enable Remote Desktop on a Windows VM
1. From the Start menu, select Control Panel.

2. From the Control Panel window, select System.
3. In the System Properties dialog box, select the Remote tab.
4. In the Remote Desktop section of this dialog box, check the checkbox labeled Allow users to connect remotely
to this computer (Windows XP) or Enable Remote Desktop on this computer (Windows 2003 Server).
5. If you want to select any non-administrator users that can connect to this Windows VM, click the Select Remote
Users... button and provide the usernames. (Users with Administrator privileges on the Windows domain can
connect by default.)
Preparing to clone a Windows VM

You need to use the Windows utility sysprep to prepare a Windows VM for cloning. This is the only supported way
to properly clone a Windows VM.
Computers running Windows operating systems use a Security ID (SID) to uniquely identify themselves. When cloning
a Windows VM, it is important to take steps to ensure the uniqueness of these Security IDs. Cloning an installation
without taking the recommended system preparation steps can lead to duplicate SIDs and other problems. Because
the SID identifies the computer or domain as well as the user, it is critical that it is unique. Refer to the Microsoft
KnowledgeBase article 162001, "Do not disk duplicate installed versions of Windows," for more information.
sysprep modifies the local computer Security ID (SID) to make it unique to each computer. The sysprep binaries are
on the Windows product CDs in the \support\tools\deploy.cab file.
Here are the overall steps you need to follow to clone Windows VMs:
Cloning Windows VMs
1. Create, install, and configure the Windows VM as desired.

2. Apply all relevant Service Packs and updates.

3. Install the Citrix PV drivers.
4. Install any applications and perform any other tailoring that is desired.
5. Copy the contents of \support\tools\deploy.cab from the Windows product CD to a new \sysprep
folder in the VM.
6. Run sysprep (this will shut down the VM when it completes).
7. In XenCenter, convert the VM into a template.
8. Clone the newly created template into new VMs as required.
9. When the cloned VM starts, it will get a new system ID and name, then run a mini-setup to prompt for configu-
ration values as necessary, and finally restart, before being available for use.
Note
The original, sysprepped VM (the "source" VM) should not be restarted again after the sysprep stage, and should
be converted to a template immediately afterwards to prevent this. If the source VM is restarted, sysprep must be
run on it again before it can be safely used to make additional clones.
For more information on using sysprep, refer to the Microsoft TechNet page "Windows System Preparation Tool."
Time Handling in Windows VMs

For Windows guests, time is initially driven from the control domain clock. However, XenServer also stores for each
Windows VM a time offset. This represents the difference between the control domain time and the guest, and is
persisted for each VM. We recommend running a reliable NTP service in the control domain to set a global time
accurately across all VMs in the host, and not one NTP service in each individual Windows VM.
So if you manually set a VM to be 2 hours ahead of the control domain (e.g. via a time-zone offset within the guest),
then it will remember that. If you subsequently change the control domain time (either manually or if it is automatically
corrected via NTP), then the guest will shift accordingly but maintain the 2 hour offset. Note that changing the control
domain time-zone does not affect guest time-zones or offset; it is only the hardware clock setting which is used by
Xen to synchronize the guests.
When doing suspend/resume operations or live relocation via XenMotion, it is important to have up-to-date Windows
PV drivers installed, as they notify the Windows kernel that a time synchronization is required after resuming (poten-
tially on a different physical host).
Release Notes
There are many versions and variations of Windows with different levels of support for the features provided by
XenServer. This section lists notes and errata for the known differences.
General Windows Issues

• When installing Windows virtual machines, users should start off with fewer than four disks. Once the VM and
XenServer tools have been installed, users can then add additional virtual disks. The boot device should always be
on the lower four disks so that the VM can boot without the Citrix Tools for Virtual Machines.
• Multiple VCPUs are exposed as CPU sockets to Windows guests, and are subject to the licensing limitations present
in the guest. The number of CPUs present in the guest can be confirmed by checking the Device Manager. The
number of CPUs actually being used by Windows can be seen in the Task Manager.
• The disk enumeration order in a Windows guest may differ from the order in which they were initially added. This
is a behavioral artifact between the paravirtualized drivers and the PnP subsystem in Windows. For example, the
first disk may show up as Disk 1, the next disk hotplugged as Disk 0, a subsequent disk as Disk 2, and then
upwards in the expected fashion.
• There is a bug in the VLC player DirectX backend that causes yellow to be replaced by blue when playing video
if the Windows display properties are set to 24-bit color. VLC using OpenGL as a backend works correctly, and
any other DirectX- or OpenGL-based video player works fine, too. It is not a problem if the guest is set to use 16-
bit color rather than 24.
• The PV Ethernet Adapter reports a speed of 2 Gbps in Windows VMs. This speed is a hardcoded value and is not
relevant in a virtual environment because the virtual NIC is connected to a virtual switch. The NIC will actually
perform at the same rate as the physical NIC.
Windows 2003 Server

Windows Server 2003 32-bit does not boot successfully if any virtual disks larger than 2TB (terabytes) in size are
attached to the VM. See this article in the Windows Hardware Developer Central website.
Windows 2008 Server

Quiesced snapshots taken on Windows Server 2008 guests will not be directly bootable. Instead, you must attach the
snapshot disk to an existing Windows Server 2008 VM to access files for restoration purposes.
Windows XP SP3
Windows XP does not support disks larger than 2TB (terabytes) in size. See this article in the Windows Hardware
Developer Central website.
Windows 2000 Server

No known issues.
Windows Vista
Microsoft Vista recommends a root disk of size 20GB or higher. The default size when installing this template is
24GB, which is 4GB greater than the minimum. However, users should consider increasing this to comply with the
Microsoft recommendations for Vista VM.
Chapter 4. Installing Linux VMs
XenServer supports the installation of many Linux distributions into paravirtualized VMs. There are four installation
mechanisms at present: complete distributions provided as built-in templates, Physical-to-Virtual (P2V) conversion of
an existing native instance (see the section called “Physical to Virtual Conversion (P2V)”), using the vendor media in
the server's physical DVD/CD drive, and using the vendor media to perform a network installation.
Installing Linux VMs requires the Linux Pack to be installed onto the XenServer Host.
Warning
If you have not installed the Linux Pack, and you are using XenCenter to install VMs, the New VM wizard will
show only Windows choices in the list. You might be tempted to select Other install media to install a Linux VMs.
This will not work properly and is not supported.
The Other install media template is meant for advanced users who want to attempt installing VMs running other
unsupported operating systems. XenServer has been tested running only the supported distributions and specific
versions covered by the standard supplied templates, and any VMs installed using the Other install media template
are not supported.
The supported Linux distributions are:
Distribution Built-in P2V Vendor Install from Vendor Install from

CD network repository
Debian Sarge 3.1 X
Debian Etch 4.0 X
Red Hat Enterprise Linux 3.6-3.8 X
Red Hat Enterprise Linux 4.5-4.7 X X
Red Hat Enterprise Linux 5.0-5.2 32- X X

bit
Red Hat Enterprise Linux 5.0-5.2 64- X X

bit
SUSE Linux Enterprise Server 9 X

SP1/2/3
SUSE Linux Enterprise Server 9 SP4 X X X
SUSE Linux Enterprise Server 10 X X

SP1/2 32-bit/64-bit
CentOS 4.5, 4.6 X X
CentOS 4.7 X
XenServer Virtual Machine Installation Guide Installing Linux VMs 16
Distribution Built-in P2V Vendor Install from Vendor Install from

CD network repository
CentOS 5.0-5.2 32-bit X X
CentOS 5.0-5.2 64-bit X X
Oracle Enterprise Linux 5.0-5.2 32-bit X X
Oracle Enterprise Linux 5.0-5.2 64-bit X X
Note
Distributions which use the same installation mechanism as Red Hat Enterprise Linux 5 (e.g. Fedora Core 6) might be
successfully installed using the same template. However, distributions not present in the above list are not supported.
Installation of a built-in distribution

This is the simplest way of installing a VM. The template provided with XenServer can be used to directly create a
VM running version 3.1 (Sarge) or 4.0 (Etch) of the Debian Linux distribution without need for vendor installation
media and without performing a P2V conversion of an existing physical server.
The VMs are instantiated by using the vm-install from the CLI, or by cloning the template using XenCenter. For
example, using the CLI on Linux:
xe vm-install template=Debian\ Etch\ 4.0 new-name-label=ExampleVM

f21cd819-5b7d-002d-7a1e-861a954e770
When the VM is first booted, it will prompt you for a root password, a VNC password (for graphical use), and a
hostname. After values are entered for these, it will finish at a standard login prompt, ready for use. You will need to
add a network interface if installed via the CLI.
Installing Linux from vendor media to a VM

This version of XenServer supports installation of the following Linux operating systems from vendor media in the
XenServer Host DVD/CD-ROM drive:
• Red Hat Enterprise Linux 5.0-5.2, 32-bit

• Red Hat Enterprise Linux 5.0-5.2, 64-bit
• CentOS 4.5-4.6
• CentOS 5.0-5.2, 32-bit
• CentOS 5.0-5.2, 64-bit
• Oracle Enterprise Linux 5.0-5.2, 32-bit
• Oracle Enterprise Linux 5.0-5.2, 64-bit
Other Linux operating systems need to be installed from a network installation server. See the section called “Installing
Linux from a network installation server to a VM”.
To install a supported Linux VM from vendor media via the CLI
1. Insert the vendor installation CD into the XenServer Host's CD drive.

2. Enter the command
xe template-list
to find the name of the template corresponding to the OS you want to install.
3. Enter the command
xe vm-install template="<template_name>" new-name-label=<name_for_vm>
This returns the UUID of the new VM.

4. Get the UUID of the new VM's root disk:
xe vbd-list vm-uuid=<vm_uuid> userdevice=0 params=uuid --minimal
5. Using the UUID returned, set the root disk to not be bootable:
xe vbd-param-set uuid=<root_disk_uuid> bootable=false
6. Get the name of the physical CD drive on the XenServer Host:
xe cd-list
The result of this command should give you something like SCSI 0:0:0:0 for the name-label field.
7. Add a virtual CD-ROM to the new VM using the XenServer Host's CD drive name-label in the cd-name
argument:
xe vm-cd-add vm=<vm_uuid> cd-name="<host_cd_drive_name_label>" device=3
8. Get the UUID of the VBD corresponding to the new virtual CD drive:
xe vbd-list vm-uuid=<vm_uuid> type=CD params=uuid --minimal
9. Make the virtual CD's VBD bootable:
xe vbd-param-set uuid=<cd_drive_uuid> bootable=true
10. Set the VM's install repository to be the CD drive:
xe vm-param-set uuid=<vm_uuid> other-config:install-repository=cdrom
11. Start the VM:
xe vm-start uuid=<vm_uuid>
12. Open a text console to the VM with XenCenter or an SSH terminal and follow the steps to perform the OS
installation.
Note
The console in XenCenter does not support VNC during the OS installation. However, it is possible to perform a
graphical installation rather than the text-based installation if you connect an external VNC client to the new VM.
You must also set a couple of additional other-config parameters for the VM before starting it. The command
to set these is
xe vm-param-set uuid=<vm_uuid> other-config:install-vnc=1 \

other-config:install-vncpasswd=<vnc_password>
Installing Linux from a network installation server to a VM

The XenServer guest installer allows you to install an operating system from a network-accessible copy of vendor
media into a VM. In preparation for installing from vendor media, you need to make an exploded network repository of
your vendor media (not ISO images), exported via NFS, HTTP or FTP accessible to the XenServer host administration
interface. See Appendix B, Setting Up a Red Hat Installation Server for information on how to copy a set of installation
CDs to a network drive.
The network repository must be accessible from the control domain of the XenServer host, normally via the manage-
ment interface. The URL should point to the base of the CD/DVD image on the network server, and be of the form:
• HTTP
http://<server>/<path>
• FTP
ftp://<server>/<path>
• NFS
nfs:<server>:/<path>
The XenServer New VM Wizard provides an additional step for vendor-installable templates which prompts for the
repository URL. When using the CLI, install the template as normal using vm-install and then set the other-con-
fig-install-repository key to the value of the URL. When the VM is subsequently started, it will begin the network
installation process.
Note
When installing a new Linux-based VM, it is important to fully finish the installation and reboot it before performing
any other operations on it. This is analogous to not interrupting a Windows installation, which would leave you
with a non-functional VM.
To install a Linux VM from a network-accessible copy of vendor media via the CLI
1. Issue the command
xe vm-install template=<template> new-name-label=<name_for_vm> \

sr-uuid=<storage_repository_uuid>
This returns the UUID of the new VM.

2. Find the UUID of the network that you want to connect to. For example, if it's the one attached to xenbr0:
xe network-list bridge=xenbr0 --minimal
3. Create a VIF to connect the new VM to this network:

xe vif-create vm-uuid=<vm_uuid> network-uuid=<network_uuid> mac=random device=0
4. Set the install-repository key of the other-config parameter to the path of your network repository. For
example, we'll use http://server/RedHat/5.0 as the URL of the vendor media:
xe vm-param-set uuid=<vm_uuid> \
other-config:install-repository=<http://server/redhat/5.0>
5. Start the VM:
xe vm-start uuid=<vm_uuid>
6. Connect to the VM console via XenCenter or VNC and perform the OS installation.
Installing RHEL Linux using a Custom Kickstart File

1. From within XenCenter, choose the appropriate RHEL template
2. Specify the kickstart file to use as a kernel command-line argument in the new VM wizard, just as it would be
specified in the PXE config file, for example:
ks=http://server/fileksdevice=eth0
3. On the command line, use vm-param-set to set the PV-args parameter to make use of a Kickstart file
xe vm-param-set uuid=<vm_uuid> PV-args=<"ks=http://server/path ksdevice=eth0">
4. Set the repository location so XenServer knows where to get the kernel and initrd from for the installer boot:
xe vm-param-set uuid=<vm_uuid> other-config:install-repository=<http://server/path>
Physical-to-Virtual Installation of a Linux VM

Older Linux distributions such as Red Hat Linux Enterprise 3.6 do not support Xen directly, and are typically legacy
installations which benefit from virtualization for the purposes of server consolidation or hardware upgrades. The
XenServer P2V feature analyzes existing installations and converts them into VMs.
When an installation is converted into a VM using P2V (see the section called “Physical to Virtual Conversion (P2V)”),
the kernel used is also automatically switched to a Xen paravirtualized kernel. XenServer contains ports of the Red
Hat Enterprise Linux 3/4 and SUSE Enterprise Linux 9 kernels to support the native Xen hypervisor interface directly.
These kernels are present in the built-in xs-tools.iso image in the default CD list, or via the Install XenServer
Tools command in the VM menu in XenCenter.
Warning
While a VM is in the process of being installed via P2V, do not attempt to perform any operations on it.
Guest Installation Network

During the installation of a VM via P2V, a special network is used to assign a temporary IP address to the VM to
enable the installation to proceed. It is possible that the range of IP addresses used might conflict with real IP addresses
already in use in your network. The default range of IP addresses is 192.168.128.1 to 192.168.128.254, and
the default netmask is 255.255.255.0.
To change the guest installer network values
1. Open a text console on the XenServer Host or install the CLI for remote use.
2. Find the guest installer network:
xe network-list
The command will return the list of networks available to the XenServer Host. The one you want has the name-
label Guest installer network.
3. Examine the other-config parameters of the guest installer network:
xe network-param-list uuid=<guest_installer_network_uuid>
The command will a subset of the guest installer network's parameters, including the other-config parameter. If
the values are set to the default described above, you will see the line:
other-config (MRW): is_guest_installer_network: true; ip_begin: 169.254.0.1; \

ip_end: 169.254.255.254; netmask: 255.255.0.0
4. To change the IP address range the guest installer network will use, edit the ip_begin, ip_end, and netmask
values as follows:
xe network-param-set uuid=<guest_installer_network_uuid> \
other-config:ip_begin=<desired_ip_range_beginning> \
other-config:ip_end=<desired_ip_range_end> \
other-config:netmask=<desired_netmask>
Do not change the value of the parameter is_guest_installer_network.
Installing the Linux guest agent

Although all the supported Linux distributions are natively paravirtualized (and thus do not need special drivers for
full performance), XenServer includes a guest agent which provides additional information about the VM to the host.
This additional information includes:
• Linux distribution name and version (major, minor revision).

• Kernel version (uname).
• IP address of each Ethernet interface.
• Total and free memory within the VM.
It is important to install this agent and keep it up-to-date (see Chapter 5, Updating VMs) as you upgrade your XenServer
host.
To install the guest agent
1. The files required are present on the built-in xs-tools.iso CD image, or alternatively by using the “Install
Tools” option in XenCenter.
2. Mount the image into the guest via:
mount /dev/xvdd /mnt
3. Execute the installation script as the root user:

/mnt/Linux/install.sh
4. If the kernel has been upgraded, or the VM was upgraded from a previous version, reboot the VM now.
Note
CD-ROM drives and ISOs attached to Linux Virtual Machines appear as /dev/xvdd instead of as /dev/cdrom
as you might reasonably expect. This is because they are not "true" CD-ROM devices, but normal devices. When
the CD is ejected by either XenCenter or the CLI, it hot-unplugs the device from the VM and the device disappears.
This is different from Windows Virtual Machines, where the CD remains in the VM in an empty state.
Preparing to clone a Linux VM

When a Linux VM is cloned, some virtual hardware parameters are changed in the new VM. The VM may need to be
customized in order to be aware of these changes. For instructions for specific supported Linux distributions, please
see the section called “Release Notes”.
Machine Name
Of course, a cloned VM is another computer, and like any new computer in a network, it must have a unique name
within the network domain it is part of.
IP address
A cloned VM must have a unique IP address within the network domain it is part of. This is not a problem in general
if DHCP is used to assign addresses; when the VM boots the DHCP server will assign it an IP address. If the cloned
VM had a static IP address, the clone must be given an unused IP address before being booted.
MAC address
In some cases, the MAC address of a cloned VM's virtual network interface is recorded in the network configuration
files. After the VM is cloned, the new cloned VM has a different MAC address. Therefore, when started, the network
does not come up automatically.
Some Linux distributions use udev rules to remember the MAC address of each network interface, and persist a name
for that interface. This is intended so that the same physical NIC always maps to the same ethn interface, which
is particularly useful with removable NICs (like laptops). But this behavior is problematic in the context of Virtual
Machines. For example, if you configure two virtual NICs when you install a VM, and then shut it down and remove
the first NIC, on reboot XenCenter shows just one NIC, but calls it eth0. Meanwhile the VM is deliberately forcing
this to be eth1. The result is that networking doesn't work.
If the VM uses persistent names, the best thing to do is to turn these rules off. If for some reason you do not want to
turn persistent names off, be aware that you will need to reconfigure networking inside the VM in the usual way, and
the information shown in XenCenter will be out of sync with reality.
Time handling in Linux VMs

By default, the clocks in a Linux VM are synchronized to the clock running on the control domain, and cannot be
independently changed. This mode is a convenient default, since only the control domain needs to be running the
NTP service to keep accurate time across all VMs. Upon installation of a new Linux VM, make sure you change the
time-zone from the default UTC to your local value (see the section called “Release Notes” for specific distribution
instructions).
To set individual Linux VMs to maintain independent times
1. From a root prompt on the VM, type the command: echo 1 > /proc/sys/xen/independent_wallclock
2. This can be persisted across reboots by changing the /etc/sysctl.conf configuration file and adding:
# Set independent wall clock time

xen.independent_wallclock=1
3. As a third alternative, the independent_wallclock=1 may also be passed as a boot parameter to the VM.
Configuring VNC for VMs

With the exception of VMs based on the Debian templates, VMs might not be set up to support VNC by default. For
example, if you P2V a server that does not have a VNC server installed, the resulting VM won't have VNC installed
either. Before you can connect with the XenCenter graphical console, you need to ensure that the VNC server and
an X display manager are installed on the VM and properly configured. This section describes the procedures for
configuring VNC on each of the supported Linux operating system distributions to allow proper interactions with the
XenCenter graphical console.
CentOS-based VMs should use the instructions for the Red Hat-based VMs below, as they use the same base code
to provide graphical VNC access. CentOS 4 is based on Red Hat Enterprise Linux 4, and CentOS 5 is based on Red
Hat Enterprise Linux 5.
Setting up Red Hat-based VMs for VNC
Note
Before setting up your Red Hat VMs for VNC, be sure that you have installed the Linux guest agent. See the section
called “Installing the Linux guest agent” for details.
In order to configure VNC on Red Hat VMs, you need to modify the GDM configuration. The GDM configuration is
held in a file whose location varies depending on the version of Red Hat Linux you are using. Before modifying it, we
first must determine the location of this configuration file; this file will then be modified in a number of subsequent
procedures in this section.
Determining the location of your VNC configuration file

If you are using Red Hat Linux version 3 or 4 the GDM configuration file is /etc/X11/gdm/gdm.conf. This
is a unified configuration file that contains both default values as specified by the provider of your version of GDM
in addition to your own customized configuration. This type of file is used by default in older versions of GDM, as
included in these versions of Red Hat Linux.
If you are using Red Hat Linux version 5 the GDM configuration file is /etc/gdm/custom.conf. This is a split
configuration file that contains only user-specified values that override the default configuration. This type of file is
used by default in newer versions of GDM, as included in these versions of Red Hat Linux.
Configuring GDM to use VNC

1. As root at the prompt in the VM's text console, type in rpm -q vnc-server gdm. The package names vnc-
server and gdm should appear, with their version numbers specified.
If these package names are displayed, the appropriate packages are already installed. If you see a message saying
that one of the packages is not installed, then you may not have selected the graphical desktop options during
installation. You will need to install these packages before you can continue. See the appropriate Red Hat Linux
x86 Installation Guide for details regarding installing additional software on your VM.
2. Open the GDM configuration file with your preferred text editor and add the following lines to the file:
[server-VNC]
name=VNC Server
command=/usr/bin/Xvnc -SecurityTypes None -geometry 1024x768 -depth 16 \
-BlacklistTimeout 0
flexible=true
• With configuration files as found on Red Hat Linux 3 and 4, this should be added above the [server-Stan-
dard] section.
• With configuration files as found on Red Hat Linux 5, this should be added into the empty [servers] section.
3. Modify the configuration so that the Xvnc server is used instead of the standard X server:
• If you are using Red Hat Linux 3 or 4, there will be a line just above that says:
0=Standard
Modify it to read:
0=VNC
• If you are using Red Hat Linux 5 or greater, you will need to add the above line just below the [servers]
section and before the [server-VNC] section.
4. Save and close the file.
Restart GDM for your change in configuration to take effect, by running /usr/sbin/gdm-restart.
Note that, for Red Hat Linux, runlevel 5 is used for graphical startup. If your installation is configured to start up in
runlevel 3, you will need to change this in order for the display manager to be started (and therefore to get access to a
graphical console). Please refer to the section called “Checking runlevels” for further details.
Firewall settings
The firewall configuration by default does not allow VNC to traffic to go through. If you have a firewall between the
VM and XenCenter, you need to allow traffic over the port that the VNC connection uses. By default, a VNC server
listens for connections from a VNC viewer on TCP port 5900 + N, where N is the display number (usually just zero).
So a VNC server setup for Display-0 will listen on TCP port 5900, Display-1 is TCP-5901, etc. Consult your firewall
documentation to make sure these ports are open.
You might want to further customize your firewall configuration if you want to use IP connection tracking or limit
the initiation of connections to be from one side only.
To customize Red Hat-based VMs firewall to open the VNC port
1. For Red Hat Linux 3, use redhat-config-securitylevel-tui.

For Red Hat Linux 4 and 5, use system-config-securitylevel-tui.

2. Select “Customize” and add 5900 to the other ports list.
Alternatively, you can disable the firewall until the next reboot by using service iptables stop, or permanently by
using chkconfig iptables off. This can of course expose additional services to the outside world and reduce the overall
security of your VM.
VNC screen resolution

If, after connecting to a Virtual Machine with the graphical console, the screen resolution is mismatched (for example,
the VM's display is too big to comfortably fit in the Graphical Console pane), you can control it by setting the VNC
server's geometry parameter as follows:
1. Open the GDM configuration file with your preferred text editor. Please refer to the section called “Determining
the location of your VNC configuration file” for information about determining the location of this file.
2. Find the [server-VNC] section you added above.
3. Edit the command line to read, for example,
command=/usr/bin/Xvnc -SecurityTypes None -geometry 800x600
where the value of the geometry parameter can be any valid screen width and height.
Setting up SLES-based VMs for VNC
Note
Before setting up your SUSE Linux Enterprise Server VMs for VNC, be sure that you have installed the Linux guest
agent. See the section called “Installing the Linux guest agent” for details.
SLES has support for enabling “Remote Administration” as a configuration option in YaST. You can select to enable
Remote Administration at install time, available on the Network Services screen of the SLES installer. This will allow
you to connect an external VNC viewer to your guest to view the graphical console; the methodology for using the
SLES remote administration feature is slightly different than that provided by XenCenter, but it is possible to modify
the configuration files in your SUSE Linux VM such that it is integrated with the graphical console feature.
Checking for a VNC server

Before making configuration changes, you should verify that you have a VNC server installed. SUSE ships the tightvnc
server by default; this is a suitable VNC server, but you can also use the standard RealVNC distribution if you prefer.
You can check that you have the tightvnc software installed by running the command:
rpm -q tightvnc
Enabling Remote Administration

If Remote Administration was not enabled during installation of the SLES software, you can enable it as follows:
1. Open a text console on the VM and run the YaST utility:
# yast
2. Use the arrow keys to select Network Services in the left menu, then Tab to the right menu and use the arrow
keys to select Remote Administration. Press Enter.
3. In the Remote Administration screen, Tab to the Remote Administration Settings section. Use the arrow keys
to select Allow Remote Administration and press Enter to place an X in the checkbox.
4. Tab to the Firewall Settings section. Use the arrow keys to select Open Port in Firewall and press Enter to
place an X in the checkbox.
5. Tab to the Finish button and press Enter.
6. A message box appears telling you that you will need to restart the display manager for your settings to take
effect. Press Enter to acknowledge the message.
7. The original top-level menu of YaST appears. Tab to the Quit button and press Enter.
Modifying the xinetd configuration

After enabling Remote Administration, you need to modify a configuration file if you want to allow XenCenter to
connect, or else use a third party VNC client.
1. Open the file /etc/xinetd.d/vnc in your preferred text editor.
The file contains sections like the following:
service vnc1
{
socket_type = stream
protocol = tcp
wait = no
user = nobody
server = /usr/X11R6/bin/Xvnc
server_args = :42 -inetd -once -query localhost -geometry 1024x768 -depth 16
type = UNLISTED
port = 5901
}
2. Edit the port line to read
port = 5900

4. Restart the display manager and xinetd service with the following commands:
/etc/init.d/xinetd restart
rcxdm restart
SUSE Linux uses runlevel 5 for graphical startup. If your remote desktop does not appear, verify that your VM is
configured to start up in runlevel 5. Refer to the section called “Checking runlevels” for details.
Firewall settings
The firewall configuration by default does not allow VNC to traffic to go through. If you have a firewall between the
VM and XenCenter, you need to allow traffic over the port that the VNC connection uses. By default, a VNC server
listens for connections from a VNC viewer on TCP port 5900 + N, where N is the display number (usually just zero).
So a VNC server setup for Display-0 will listen on TCP port 5900, Display-1 is TCP-5901, etc. Consult your firewall
documentation to make sure these ports are open.
You might want to further customize your firewall configuration if you want to use IP connection tracking or limit
the initiation of connections to be from one side only.
To customize SLES-based VMs firewall to open the VNC port
1. Open a text console on the VM and run the YaST utility:
# yast
2. Use the arrow keys to select Security and Users in the left menu, then Tab to the right menu and use the arrow
keys to select Firewall. Press Enter.
3. In the Firewall screen, Tab to the Firewall Configuration: Settings section. Use the arrow keys to select the
Allowed Services in the left menu.
4. Tab to the Firewall Configuration: Allowed Services fields on the right. Use the arrow keys to select the
Advanced... button (near the bottom right, just above the Next button) and press Enter.
5. In the Additional Allowed Ports screen, type 5900 in the TCP Ports field. Tab to the OK button and press Enter.
6. Tab back to the list of screens on the left side and use the arrow keys to select Start-Up. Tab back to the right
and Tab to the Save Settings and Restart Firewall Now button and press Enter.
7. Tab to the Next button and press Enter, then in the Summary screen Tab to the Accept button and press Enter,
and finally on the top-level YaST screen Tab to the Quit button and press Enter.
8. Restart the display manager and xinetd service with the following commands:
rcxdm restart
Alternatively, you can disable the firewall until the next reboot by using the rcSuSEfirewall2 stop command, or
permanently by using YaST. This can of course expose additional services to the outside world and reduce the overall
security of your VM.
VNC screen resolution

If, after connecting to a Virtual Machine with the Graphical Console, the screen resolution is mismatched (for example,
the VM's display is too big to comfortably fit in the Graphical Console pane), you can control it by setting the VNC
server's geometry parameter as follows:
1. Open the /etc/xinetd.d/vnc file with your preferred text editor and find the service_vnc1 section
(corresponding to displayID 1).
2. Edit the geometry argument in the server-args line to the desired display resolution. For example,
server_args = :42 -inetd -once -query localhost -geometry 800x600 -depth 16
where the value of the geometry parameter can be any valid screen width and height.
4. Restart the VNC server:
rcxdm restart
Setting up Debian-based VMs for VNC

The built-in Debian Sarge and Etch templates come pre-configured with VNC setup and ready use. However, the
default VNC configuration in Debian does not permit the root administration user to log in by default. To log in by
VNC, you can either:
• Log in to the text console and create a new, unprivileged user via the adduser command. This is the recommended
course of action.
• At the graphical console login prompt, select Actions, Configure the Login Manager, type in your root password,
then select Security, Allow local system administrator login, and finally select Close.
If you need to reset the VNC password, use the command
vnc4passwd /etc/vncpass
Checking runlevels
Red Hat and SUSE Linux VMs use runlevel 5 for graphical startup. This section describes how to verify that your VM
is configured to start up in runlevel 5 and how to change it if it is not.
1. Check /etc/inittab to see what the default runlevel is set to. Look for the line that reads:
id:n:initdefault:
If n is not 5, edit the file to make it so.

2. You can run the command telinit q ; telinit 5 after this change to avoid having to actually reboot to switch
runlevels.
Release Notes
Most modern Linux distributions support Xen paravirtualization directly, but have different installation mechanisms
and some kernel limitations.
Debian Sarge 3.1 and Etch 4.0

XenServer includes a custom Xen kernel for Debian guests installed via the built-in template. This kernel is a cut-down
version of the dom0 kernel used in XenServer, and as such is the most heavily tested and reliable guest kernel available.
When a Debian VM is first booted, it will have a custom script which will prompt for details such as hostname and root
passwords. Since these are executed at a low run-level, it will prevent a freshly installed Debian guest from rebooting
until the requested information is entered. In order to bypass the first-boot scripts and boot non-interactively, you must
pass the noninteractive flag to the kernel arguments.
After installation, the time-zone in a Debian VM defaults to UTC (see the section called “Time handling in Linux
VMs”). It can be changed to your local value by using the tzconfig command.
To prepare a Debian guest for cloning (see the section called “MAC address”), Ethernet name persistence
must be disabled. For Debian Sarge and Etch VMs, name persistence is controlled through /etc/udev/
rules.d/z45_persistent-net-generator.rules, which is used to generate /etc/udev/rules.d/
z25_persistent-net.rules. To prepare an Etch VM for cloning, remove /etc/udev/rules.d/
z25_persistent-net.rules:
rm -f /etc/udev/rules.d/z25_persistent-net.rules
Persistence will be re-enabled on reboot. To permanently disable persistence, remove /etc/udev/rules.d/

z45_persistent-net-generator.rules
Red Hat Enterprise Linux 3

XenServer includes a custom port of the RHEL3.8 kernel with native Xen paravirtualized guest support. This kernel
is installed during the P2V process for RHEL3.6-3.8 guests. Since the kernel is based on Linux 2.4, the following
limitations apply:
• Only 3 virtual network interfaces are supported.

• VMs with multiple VCPUs cannot be suspended. If you wish to suspend these guests, you must reduce the number
of VCPUs to 1 while the guest is halted.
Before performing a P2V conversion from an existing RHEL3 installation, ensure that the /etc/fstab file in the
guest contains an entry for the /boot mount point. This partition contains the files which are changed by the P2V
process to give the resulting VM a para-virtual kernel.

XenServer includes the RHEL 4.7 kernel with additional bug fixes and expanded Xen support. This kernel is installed
with the Citrix Tools for Virtual Machines installation, but not in the RHEL 4.5/4.6/4.7 default installations.
The issues below have been reported upstream to Red Hat and are already fixed in our kernel (which can be installed
by using the /mnt/Linux/install.sh script in the built-in xs-tools.iso CD image):
• During the resume operation on a suspended VM, allocations can be made that can cause swap activity which cannot
be performed because the swap disk is still being reattached. (Red Hat Bugzilla 429103).)
• The NetFront driver in the RHEL 4.5 and 4.6 kernel has issues with the iptables firewall due to the use of checksum
offloading. To work around this issue, either install the Citrix Tools for Virtual Machines or disable checksum
offload on the VIF associated with the device in the control domain of the XenServer Host on which your RHEL
4.6 VM runs. First determine the UUID of the VIF, by:
xe vif-list vm-name-label=examplevm
Then disable checksum offload on the VIF by:
xe vif-param-set uuid=vif_uuid other_config:ethtool-tx=off

• The xen kernel in versions 4.5, 4.6 and 4.7 can occasionally enter tickless mode when an RCU is pending. When this
triggers, it is usually in synchronize_kernel() which means the guest essentially hangs until some external
event (such as a SysRQ) releases it (Red Hat Bugzilla 427998)
• Occasional kernel crash on boot in queue_work() (Red Hat Bugzilla 246586)
• Incorrect network device initialization order can cause kernel panic on boot. (456653)
• Disks sometimes do not attach correctly on boot (Red Hat Bugzilla 247265)
• Live migration can occasionally crash the kernel under low memory conditions (Red Hat Bugzilla 249867)
• Guest kernel can occasionally hang due to other XenStore activity (Red Hat Bugzilla 250381)
• If you attempt to install RHEL 4.x on a VM that has more than 2 virtual CPUs (which RHEL 4.x does not support),
an error message incorrectly reports the number of CPUs detected.
• RHEL 4.7 contains a bug which normally prevents it from booting on a host with more than 64GiB of RAM (Red
Hat Bugzilla 311431). For this reason XenServer RHEL 4.7 guests are only allocated RAM addresses in the range
below 64GiB by default. This may cause RHEL 4.7 guests to fail to start even if RAM appears to be available, in
which case rebooting or shutting down other guests can cause suitable RAM to become available. If all else fails,
temporarily shut down other guests until your RHEL 4.7 VM can boot.
Once you have succeeded in booting your RHEL 4.7 VM, install the Citrix Tools for Virtual Machines and run
the command:
xe vm-param uuid=<vm_uuid> param-name=other-config param-key=machine-address-size
to remove the memory restriction.
To prepare a RHEL4 guest for cloning (see the section called “MAC address”), edit /etc/sysconfig/net-
work-scripts/ifcfg-eth0 before converting the VM into a template and remove the HWADDR line. Note
that Red Hat recommend the use of Kickstart to perform automated installations, instead of directly cloning disk im-
ages (see Red Hat KB Article 2415).
Preparing a RHEL 4.x guest for P2V

Before performing a P2V conversion from an existing RHEL4 installation, ensure that the /etc/fstab file in the
guest contains an entry for the /boot mount point. This partition contains the files which are changed by the P2V
process to give the resulting VM a para-virtual kernel.
After a successful P2V, some modifications may be needed in older Red Hat Linux 4.x distributions. In order to get
LVM working on xvd* devices, you should add the following line under the devices { line in /etc/lvm/
lvm.conf:
types = ["xvd", 16]
RHEL Graphical Network Install Support

To perform a graphical installation, add VNC to the list of advanced OS boot parameters when creating the VM:
graphical utf8 vnc
You will be prompted to provide networking configuration for the new VM so that VNC communication can be
enabled. The standard graphical installer will then be displayed.

XenServer includes the RHEL 5.2 kernel with additional bug fixes and expanded Xen support. This kernel is installed
with the Citrix Tools for Virtual Machines installation, but not in the RHEL 5 default installations.
• During the resume operation on a suspended VM, allocations can be made that can cause swap activity which cannot
be performed because the swap disk is still being reattached. (Red Hat Bugzilla 429102).
• After resuming a suspended VM, it might crash with the message kernel BUG at mm/rmap.c:590! (Red Hat Bugzilla
294811)
• Only 3 virtual network interfaces are supported in versions below 5.2. For 5.2 and above, 7 virtual network interfaces
are supported.
• Random segmentation faults on loading ELF binaries (Red Hat Bugzilla 247261)
• Disks sometimes do not attach correctly on boot (Red Hat Bugzilla 247265). This has been fixed in Red Hat En-
terprise Linux 5.1.
• Soft lockup messages after suspend/resume or live migration (Red Hat Bugzilla 250994). These messages are harm-
less, but there may be a period of inactivity in the guest during live migration as a result of the lockup.
• Network blackout during live relocation for up to a minute (Red Hat Bugzilla 251527). After migration has com-
pleted, the kernel sends a gratuitous ARP to cause ARP caches to get refreshed and minimize network downtime.
However, carrier detect is delayed in the kernel and so there is a network blackout until the ARP caches expire or
the guest generates an ARP for some other reason.
• RHEL 5.2 contains a bug which normally prevents it from booting on a host with more than 64GiB of RAM (Red
Hat Bugzilla 311431). For this reason XenServer RHEL 5.2 guests are only allocated RAM addresses in the range
below 64GiB by default. This may cause RHEL 5.2 guests to fail to start even if RAM appears to be available, in
which case rebooting or shutting down other guests can cause suitable RAM to become available. If all else fails,
temporarily shut down other guests until your RHEL 5.2 VM can boot.
Once you have succeeded in booting your RHEL 5.2 VM, install the Citrix Tools for Virtual Machines and run
the command ...
xe vm-param uuid=<vm_uuid> param-name=other-config param-key=machine-address-size
... to remove the memory restriction.
When you install the XenServer xe-guest-utilities RPM, it adds an entry to the yum configuration, allowing
you to pick up kernel updates provided by Citrix as they become available.
CentOS 4
Please refer to the section called “Red Hat Enterprise Linux 4” for the list of CentOS 4 release notes.
Unlike RHEL4, CentOS includes a third-party updates mechanism known as yum. The xe-guest-utilities
RPM will install a XenServer entry for yum, allowing you to pick up kernel updates provided by Citrix via the standard
update mechanism as they become available.
• CentOS 4.7 was not yet released at the time of release of XenServer 5.0.0. The CentOS 4.7 template should work
fine when the operating system becomes available. Note, however, that installation from CD/ISO will not work.
You will have to install it from an exploded vendor repository.
CentOS 5
Please refer to the section called “Red Hat Enterprise Linux 5” for the list of CentOS 5 release notes.
Oracle Enterprise Linux 5

Please refer to the section called “Red Hat Enterprise Linux 5” for the list of Oracle Enterprise Linux 5 release notes.
SUSE Enterprise Linux 9

In the current version of XenServer we have switched to a SUSE-provided kernel. (Earlier versions included a Cit-
rix-provided version of the SLES9 which had a more mature version of the hypervisor, but which was out of date
with SUSE's version, particularly with regard to security updates.) As a result, suspending and resuming a VM, and
XenMotion, are not 100% reliable, especially with multiple VCPUs.
To prepare a SUSE Linux guest for cloning (see the section called “MAC address”), edit /etc/sysconfig/net-
work/config and edit the line:
FORCE_PERSISTENT_NAMES=yes
to
FORCE_PERSISTENT_NAMES=no
When you P2V a SLES 9 server, the networking configuration files that were present on the physical server will remain
on the VM. You may wish to move these aside, or update them accordingly, when you add virtual interfaces to the VM.
SUSE Enterprise Linux 10 SP1

XenServer uses the standard Novell kernel supplied with SLES 10 SP1 as the guest kernel. Any bugs found in this
kernel are reported upstream to Novell and listed below:

• Disks sometimes do not attach correctly on boot. (Novell Bugzilla 290346).
Chapter 5. Updating VMs
This chapter discusses updating VMs with new Linux kernel revisions, updating Windows operating systems, applying
Windows Service Packs, and updates to XenServer paravirtualized drivers and VM utilities.
Upgrades to VMs are typically required when moving to a new version of XenServer. The following are current issues
involving upgrading VMs running on XenServer to this version:
• XenMotion of Windows VMs is not supported until the paravirtualized drivers are upgraded.
• Suspend/Resume of Windows VMs is not supported until the paravirtualized drivers are upgraded.
• The use of certain anti-virus and firewall applications may crash the Windows VM unless the paravirtualized drivers
are upgraded.
Updating Windows operating systems

Windows installation disks typically provide an upgrade option if you boot them on a server which has an earlier
version of Windows already installed. So if, for example, you have a Windows 2000 server, and you wish to update
it to Windows 2003, you can insert the Windows 2003 installation CD in the CD drive and run the setup program
to update it.
Similarly, you can update the operating system of Windows VMs. Before doing so, you need to uninstall the paravir-
tualized device drivers. If they are present during the attempt to update, the update will fail.
To uninstall the paravirtualized drivers

1. Select Control Panel from the Start menu.
2. In Windows XP, 2000, or 2003, select Add or Remove Programs.
In Windows Vista, select Programs, then select Programs and Features.

3. A list of programs installed on the computer is displayed. Scroll down if necessary and select Citrix XenServer
Windows PV drivers Add-on.
4. In Windows XP, 2000, or 2003, click the Remove button.
In Windows Vista, select Uninstall from the toolbar above the list of programs.
This will remove the PV drivers add-on. At the end, a message is displayed. Click OK to close the message box.
Once the operating system update is complete, reinstall the PV drivers just as you would after installing a fresh Win-
dows VM. See the section called “Windows paravirtualized drivers” for details.
Updating paravirtualized drivers for Windows VMs

The paravirtualized drivers are present on the built-in xs-tools.iso available to XenCenter via the Install
XenServer Tools command from the VM menu, which attaches the CD image containing the drivers to the VM. You
can either wait for the auto-run facility, or manually click on the xensetup.exe program. Follow the on-screen
prompts to install the new drivers, which will automatically deactivate and upgrade the old drivers.
Updating Linux kernels and guest utilities

The Linux guest utilities can be updated by re-running the Linux/install.sh script from the built-in xs-
tools.iso CD image (see the section called “Installing the Linux guest agent”). From time to time, Citrix also
supplies updated Linux kernels for supported distributions. Supported distributions are:
XenServer Virtual Machine Installation Guide Updating VMs 33
• Red Hat Enterprise Linux 5.x

• CentOS 5.x
• CentOS 4.x
• Debian Sarge and Etch
The updates are posted online at: http://updates.xensource.com/XenServer/5.0.0/.
For example, the RHEL 3.x kernel would be at: http://updates.xensource.com/XenServer/5.0.0/rhel3x/.
This is of particular importance for RHEL 4.5/4.6 and CentOS 4.5/4.6, where you will get the upstream kernel by
default, which has certain limitations (see the section called “Release Notes”).
For yum-enabled distributions (CentOS 4 and 5, RHEL 5), xe-guest-utilities installs a yum configuration
file to enable subsequent updates to be done via yum in the standard manner. Note that RHEL 4 in particular does
not use yum.
For Debian, /etc/apt/sources.list is populated to enable updates via apt by default.

Appendix A. Creating ISO images
XenServer can use ISO images of CD-ROM or DVD-ROM disks as installation media and data sources
for Windows or Linux VMs. This section describes how to make ISOs from CD/DVD media.
On a Linux computer
1. Put the CD- or DVD-ROM disk into the drive. The disk should not be mounted. To check, type the
command:
mount
If the disk is mounted, unmount the disk. Refer to your operating system documentation for assistance
if required.
2. As root, type the command
dd if=/dev/cdrom of=/path/cdimg_filename.iso
This will take some time. When the operation is completed successfully, you should see something
like
1187972+0 records in
1187972+0 records out
Your ISO file is ready.
On a Windows computer
• Windows computers do not have an equivalent operating system command to create an ISO. Most
CD-burning tools have a means of saving a CD as an ISO file.
One simple and free utility is ISO Recorder. It works on Windows XP SP2/SP3, Windows 2000, and
Windows Server 2003. Once installed, you simply right-click on a CD/DVD drive and select Create
image from CD from the context menu.
Appendix B. Setting Up a Red Hat
Installation Server
This chapter explains how to set up a server as an installation server for Red Hat Linux.
For a server to act as a Red Hat Linux network installation server, you need space on your server to copy
the entire contents of each CD onto your server. This is typically the number of CDs or ISO images times
650MB.
Ensure that the space you intend to use is formatted with your chosen filesystem and is mounted. You can
check this space with the command:
df -h
Copy installation media

1. First create a directory to contain the installation files, for example /install
2. Mount your CD. Refer to your operating system documentation for assistance if needed. This example
assumes that it is mounted at /mnt/cdrom:
mount /mnt/cdrom
3. Copy the data from the CD to the installation directory:
cp -var /mnt/cdrom/RedHat /install
4. Unmount the CD:
umount /mnt/cdrom
5. Remove the first CD, put in the next one, and repeat for each of your CDs you have.
Note
Copying the subsequent disks will overwrite some files, but these are generic files such as license.txt that
appear on each CD, and is not a problem.
Enable remote access

Next, you need to make your installation data available to other machines on the network. You can use
NFS, HTTP, or FTP protocols. You can enable all three services on your server or any subset of the three.
NFS
To install over NFS you need to meet certain conditions on the server:
• The installation directory must be exported
To export your installation directory, edit the /etc/exports file and add an entry for /install
to it:
XenServer Virtual Machine Installation Guide Setting Up a Red Hat Installation Server 36
/install *(ro)
Save the edited exports file and tell the NFS daemon to reread its configuration file:
exportfs -r
This configures the most basic read-only export to all hosts on our network. If you want to include more
advanced options in your export, such as exporting to certain hosts only, or on a certain subnet only,
see the man page for the exports file at exports (5).
• NFS needs to be installed and running
To check, type the command:
showmount -e hostname
Entering the showmount command without the hostname parameter will check the local system.
If NFS is not active, you will see a message similar to
showmount: ServerA: RPC: Program not registered
• portmap needs to be running, and can be checked with the command:
service portmap status
FTP
To enable installing over FTP, you need to allow FTP access to the installation directory on the server.
This can be either anonymous FTP access or access through a named account with a password.
If you want anonymous FTP to point to a different directory, you can use symlinks to point to the instal-
lation directory on the server.
HTTP
If you have a web server running and want to enable HTTP access to your installation server, then add
symlinks from your document root to the installation server directory to grant access.
The installation server is now ready to use. Make sure you note the server name or IP address and the
directory path to the installation directory you created.
Appendix C. Troubleshooting VM
problems
If you experience odd behavior, application crashes, or have other issues, this chapter is meant to help you
solve the problem if possible and, failing that, describes where the application logs are located and other
information that can help your XenServer Solution Provider and Citrix track and resolve the issue.
Troubleshooting of installation issues is covered in the XenServer Installation Guide. Troubleshooting of

XenServer Host issues is covered in the XenServer Administrator's Guide.
Note
We recommend that you follow the troubleshooting information in this chapter solely under the guidance of your
XenServer Solution Provider or Citrix Support.
Citrix provides two forms of support: you can receive free self-help support via the Support site, or you
may purchase our Support Services and directly submit requests by filing an online Support Case. Our free
web-based resources include product documentation, a Knowledge Base, and discussion forums.
VM crashes
If you are experiencing VM crashes, it's possible that a kernel crash dump might help identify the problem.
If the crash is reproducible, follow this procedure to send the dumps to Citrix.
Controlling Linux VM Crashdump Behaviour

For Linux VMs, the crashdump behavior can be controlled through the actions-after-crash pa-
rameter. The following are the possible values:
Value Description
preserve leave the VM in a paused state (for analysis)
coredump_and_restart record a core dump, then reboot the VM
coredump_and_destroy record a core dump, leave VM halted
restart no core dump, just reboot VM (this is the default)
destroy no coredump, leave VM halted
To enable saving of Linux VM crash dumps

1. On the XenServer Host, determine the UUID of the desired VM using the command:
xe vm-list name-label=<name> params=uuid --minimal
2. Change the actions-after-crash value using xe vm-param-set; for example:

XenServer Virtual Machine Installation Guide Troubleshooting VM problems 38
xe vm-param-set uuid=<vm_uuid> actions-after-crash=coredump_and_restart
Controlling Windows VM Crashdump Behaviour

For Windows VMs, the core dump behavior cannot be controlled through the actions-after-crash
parameter. By default Windows crash dumps are put into %SystemRoot%\Minidump in the Windows
VM itself.
You can configure the VMs dump level by following the menu path My Computer > Properties > Ad-
vanced > Startup and Recovery.
Troubleshooting boot problems on Linux VMs

There is a utility script named xe-edit-bootloader in the XenServer Host control domain which can be
used to edit the bootloader configuration of a shutdown Linux VM. This can be used to fix problems which
are preventing it from booting.
To use:
1. Use the command
xe vm-list
to ensure that the VM in question is shut down (the value of power-state will be halted).
2. You can use the UUID as follows:
xe-edit-bootloader -u <linux_vm_uuid> -p <partition_number>
or the name-label as follows:
xe-edit-bootloader -n <linux_vm_name_label> -p <partition_number>
The partition number represents the slice of the disk which has the filesystem. In the case of the
default Debian template, this will be 1 since it is the first partition.
3. You will be dropped into an editor with the grub.conf file for the specified VM loaded. Make the
changes to fix it, and save the file, exit the editor, and start the VM.
Appendix D. VM Virtual CPU allocation
XenServer dynamically allocates Virtual CPU (VCPU) load to physical CPUs. The control domain is
allocated one VCPU. The number of physical CPUs used on a host at any one time will not exceed the
total number of VCPUs assigned to the control domain and the VMs running on a host.
Index R
Release notes
Linux VMs, 27
A Windows VMs, 13
AMD-V (AMD hardware virtualization), 7, Remote Administration, SUSE Linux, 24
C S
Cloning VMs, 6, 21 Sysprep, for preparing Windows VM for cloning
Configuring VNC sysprep, 12
firewall settings, RHEL, 23
firewall settings, SLES, 25 T
for Debian VMs, 27 Template
for Red Hat VMs, 22 definition of,
for SUSE VMs, 24 Linux VMs, 2
Converting a VM to a template, 2 pre-configured (Debian), 2
Creating an ISO image, 34 Windows VMs, 2
Creating VMs Time handling, in Linux VMs
converting VM to a template, 2 time handling, in VMs, 21
from pre-configured template, 2 Troubleshooting
importing an exported VM, 2 Linux VM boot problems, 38
installing OS from a CD or ISO, 2 Linux VM general problems, 37
installing OS from a network repository, 2 Windows VM general problems, 38
overview,
physical to virtual conversion (P2V), 2, 2 V
Windows, 2 Virtual devices, limitations on, 3
VMs
D installing by P2V, 4
Drivers, Windows paravirtualized, 11 non-paravirtualized (Windows),
paravirtualized, 16
I Paravirtualized, 16, 18
Importing VMs, 2, 7 Remote Desktop, 12
Installation server, for installing Red Hat VMs, 35 VT (Intel hardware virtualization), 7
Intel VT (Intel hardware virtualization), 7
W
L Windows
Limits, virtual disk space, 2 multi-processor HAL,
Linux SMB/CIFS share, mounting ISO from, 10
guest agent, 20
runlevels, 27 X
XenConvert, 5
N XenServer product family, differences, 4
NFS server, mounting ISO from, 9
P
P2V, 2
general guidelines for virtualizing physical servers, 5
guest installation network, 19
Linux, 15, 19
p2v-legacy option, 5
Windows, 5
XenConvert, 5
Physical to virtual conversion (see P2V)

Xenserver Virtual Machine Installation Guide: Published September 2008 1.0 Edition

Uploaded by

Copyright:

Available Formats

Xenserver Virtual Machine Installation Guide: Published September 2008 1.0 Edition

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Xenserver Virtual Machine Installation Guide: Published September 2008 1.0 Edition

Uploaded by

Copyright:

Available Formats

XenServer Virtual Machine Installation

• general information about creating VMs

How this Guide relates to other documentation

• using a complete pre-configured template (Debian Sarge and Etch Linux)

Additionally, VMs can be created by

These methods are described in this chapter.

Virtual memory and disk size limits

Operating System Minimum RAM Maximum RAM Disk

Windows Vista 32-bit 512MB minimum supported, 32GB 16GB

Windows 2003 128MB minimum supported; 32GB 2GB

Windows XP SP2/3 128MB minimum supported; 32GB 1.5GB

Windows 2000 SP4 128MB minimum supported; 32GB 2GB

CentOS 4.5, 4.6, 4.7 256MB 16GB 800MB

CentOS 5.0, 5.1, 5.2 512MB 16GB 800MB

Red Hat Enterprise Linux 3.6 64MB 32GB 1.5GB

Red Hat Enterprise Linux 4.5, 4.6, 256MB 16GB 800MB

Red Hat Enterprise Linux 5.0, 5.1, 512MB 16GB 800MB

SUSE Linux Enterprise Server 9 256MB 32GB 1GB

SUSE Linux Enterprise Server 10 512MB 32GB 1.5GB

Debian Sarge, Etch 128MB 32GB 4GB

XenServer product family virtual device support

Virtual device Linux VMs Windows VMs

Number of virtual CPUs 32* 8

Number of virtual disks 8 (including virtual CD-ROM) 7 (including virtual CD-ROM)

Virtual device Linux VMs Windows VMs

Number of virtual CD- 1 1

Number of virtual NICs 7† 7

Hotplugging virtual disks add/remove add/remove

Hotplugging virtual NICs add/remove add/remove

Enterprise Edition Standard Edition Express Edition

Amount of physical RAM on up to 128GB up to 128GB up to 128GB

Number of concurrent VMs 50 50 50

Multiple hosts in XenCenter yes yes no

Support for VLANs yes yes no

Support for shared storage yes no no

Support for resource pools yes no no

Support for High Availability yes no no

Support for additional QoS control yes no no

Physical to Virtual Conversion (P2V)

To P2V an existing Linux server directly to a XenServer Host

Select Convert an existing OS on this machine to a VM (P2V) and click OK to proceed.

General Guidelines for Virtualizing Physical Servers

Good candidates for virtualization are:

For configuring individual VMs themselves, keep these guidelines in mind:

To export a VM using the CLI

1. If it is running, shut down VM that you want to export.

xe vm-export -h <hostname> -u <root> -pw <password> vm=<vm_name> \

To import a VM using the CLI

1. To import the VM to the default SR on the target XenServer Host:

xe vm-import -h <hostname> -u <root> -pw <password> \

xe vm-import -h <hostname> -u <root> -pw <password> \

xe vm-import -h <hostname> -u <root> -pw <password> \

Installing a Windows VM can be broken down into two main steps:

• installing the Windows operating system

The available Windows templates are:

• Windows Server 2008

Making the ISO available to XenServer Hosts

xe-mount-iso-sr unc_path -t smbfs -o username=myname/myworkgroup

xe-mount-iso-sr //server1/myisos -t cifs -o username=johndoe/mydomain