When you want to create a Linux VM, create the VM using a template for the operating system you want to run on the VM. You can use a template that Citrix Hypervisor provides for your operating system, or one that you created previously. You can create the VM from either XenCenter or the CLI. This section focuses on using the CLI.
To create a VM of a newer minor update of a RHEL release than is supported for installation by Citrix Hypervisor, complete the following steps:
- Install from the latest supported media
yum updateto bring the VM up-to-date
This process also applies to RHEL derivatives such as CentOS and Oracle Linux.
We recommend that you install the Citrix VM Tools for Linux immediately after installing the operating system. For more information, see Install Citrix VM Tools for Linux.
The overview for creating a Linux VM is as following:
Create the VM for your target operating system using XenCenter or the CLI.
Install the operating system using vendor installation media.
Install the Citrix VM Tools for Linux (recommended).
Configure the correct time and time zone on the VM and VNC as you would in a normal non-virtual environment.
Citrix Hypervisor supports the installation of many Linux distributions as VMs.
The Other install media template is for advanced users who want to attempt to install VMs running unsupported operating systems. Citrix Hypervisor has been tested running only the supported distributions and specific versions covered by the standard supplied templates. Any VMs installed using the Other install media template are not supported.
For information regarding specific Linux distributions, see Installation notes for Linux distributions.
Supported Linux distributions
For a list of supported Linux distributions, see Guest operating system support.
Other Linux distributions are not supported. However, distributions that use the same installation mechanism as Red Hat Enterprise Linux (for example, Fedora Core) might be successfully installed using the same template.
Create a Linux VM
This section shows the CLI procedure for creating a Linux VM by installing the OS from a physical CD/DVD or from a network-accessible ISO.
Create a VM from the appropriate template. The UUID of the VM is returned:
xe vm-install template=template-name new-name-label=vm-name
Add a virtual CD-ROM to the new VM:
If you are installing from a CD or DVD, get the name of the physical CD drive on the Citrix Hypervisor server:
The result of this command gives you something like SCSI 0:0:0:0 for the
Use this value parameter as the
xe vm-cd-add vm=vm_name cd-name="host_cd_drive_name_label" device=3
If you are installing from a network-accessible ISO, use the name of the ISO from the ISO library-label as the value for the
xe vm-cd-add vm=vm_name cd-name="iso_name.iso" device=3
Insert the operating system installation CD into the CD drive on the Citrix Hypervisor server.
Open a console to the VM with XenCenter or an SSH terminal and follow the steps to perform the OS installation.
Start the VM. It boots straight into the operating system installer:
xe vm-start uuid=UUID
Install the guest utilities and configure graphical display. For more information, see Install the Citrix VM Tools for Linux.
Install Citrix VM Tools for Linux
Although all supported Linux distributions are natively paravirtualized (and don’t need special drivers for full performance), Citrix VM Tools for Linux provide a guest agent. This guest agent provides extra information about the VM to the host. Install the guest agent on each Linux VM to enable Dynamic Memory Control (DMC).
It is important to keep the Linux guest agent up-to-date as you upgrade your Citrix Hypervisor server. For more information, see Update Linux kernels and guest utilities.
Before installing the guest agent on a SUSE Linux Enterprise Desktop or Server 15 guest, ensure that
insserv-compat-0.1-2.15.noarch.rpmis installed on the guest.
To install the Citrix VM Tools for Linux:
Download the Citrix VM Tools for Linux file from the Citrix Hypervisor downloads page.
LinuxGuestTools-xxx.tar.gzfile to your Linux VM or to a shared drive that the Linux VM can access.
Extract the contents of the tar file:
tar -xzf LinuxGuestTools-xxx.tar.gz
Execute the installation script as the root user:
If the kernel has been upgraded, or the VM was upgraded from a previous version, reboot the VM now.
Installation notes for Linux distributions
This following section lists vendor-specific, configuration information to consider before creating the specified Linux VMs.
For more detailed release notes on all distributions, see Linux VM Release Notes.
Red Hat Enterprise Linux* 7.x (32-/64-bit)
The new template for these guests specifies 2 GB RAM. This amount of RAM is a requirement for a successful install of v7.4 and later. For v7.0 - v7.3, the template specifies 2 GB RAM, but as with previous versions of Citrix Hypervisor, 1 GB RAM is sufficient.
This information applies to both Red Hat and Red Hat derivatives.
Apt repositories (Debian)
For infrequent or one-off installations, it is reasonable to use a Debian mirror directly. However, if you intend to do several VM installations, we recommend that you use a caching proxy or local mirror. Either of the following tools can be installed into a VM.
Apt-cacher: An implementation of proxy server that keeps a local cache of packages
debmirror: A tool that creates a partial or full mirror of a Debian repository
Prepare to clone a Linux VM
Typically, when cloning a VM or a computer, unless you generalize the cloned image, attributes unique to that machine are duplicated in your environments. Some of the unique attributes that are duplicated when cloning are the IP address, SID, or MAC address.
As a result, Citrix Hypervisor automatically changes some virtual hardware parameters when you clone a Linux VM. When you copy the VM using XenCenter, XenCenter automatically changes the MAC address and IP address for you. If these interfaces are configured dynamically in your environment, you might not need to modify the cloned VM. However, if the interfaces are statically configured, you might need to modify their network configurations.
The VM may need to be customized to be made aware of these changes. For instructions for specific supported Linux distributions, see Linux VM Release Notes.
A cloned VM is another computer, and like any new computer in a network, it must have a unique name within the network domain.
A cloned VM must have a unique IP address within the network domain it is part of. Generally, this requirement is not a problem when DHCP is used to assign addresses. When the VM boots, the DHCP server assigns 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.
There are two situations when we recommend disabling MAC address rules before cloning:
In some Linux distributions, the MAC address for the virtual network interface of a cloned VM is recorded in the network configuration files. However, when you clone a VM, XenCenter assigns the new cloned VM a different MAC address. As a result, when the new VM is started for the first time, the network does recognize the new VM and does not come up automatically.
Some Linux distributions use
udevrules to remember the MAC address of each network interface, and persist a name for that interface. This behavior is intended so that the same physical NIC always maps to the same
ethn interface, which is useful with removable NICs (like laptops). However, this behavior is problematic in the context of VMs.
For example, consider the behavior in the following case:
1. Configure two virtual NICs when installing a VM 1. Shut down the VM 1. Remove the first NIC
When the VM reboots, XenCenter shows just one NIC, but calls it
eth0. Meanwhile the VM is deliberately forcing this NIC to be
eth1. The result is that networking does not work.
For VMs that use persistent names, disable these rules before cloning. If you do not want to turn off persistent names, you must reconfigure networking inside the VM (in the usual way). However, the information shown in XenCenter does not match the addresses actually in your network.
Update Linux kernels and guest utilities
The Linux guest utilities can be updated by rerunning the
install.sh script from the Citrix VM Tools for Linux (see Install the Citrix VM Tools for Linux).
yum-enabled distributions, CentOS and RHEL,
xe-guest-utilities installs a
yum configuration file to enable subsequent updates to be done using
yum in the standard manner.
/etc/apt/sources.list is populated to enable updates using apt by default.
When upgrading, we recommend that you always rerun
install.sh. This script automatically determines if your VM needs any updates and installs if necessary.
Upgrade from PV to HVM guests
To upgrade existing unsupported PV Linux guests to supported versions that operate in HVM mode, perform an in-guest upgrade. At this point, the upgraded guest only runs in PV mode - which is not supported and has known issues. Run the following script to convert the newly upgraded guest to the supported HVM mode.
On the Citrix Hypervisor server, open a local shell, log on as root, and enter the following command:
Restart the VM to complete the process.
Linux VM release notes
Most modern Linux distributions support Xen paravirtualization directly, but have different installation mechanisms and some kernel limitations.
RHEL graphical install support
To use the graphical installer, in XenCenter step through the New VM wizard. In the Installation Media page, in the Advanced OS boot parameters section, add
vnc to the list parameters:
graphical utf8 vnc
You are prompted to provide networking configuration for the new VM to enable VNC communication. Work through the remainder of the New VM wizard. When the wizard completes, in the Infrastructure view, select the VM, and click Console to view a console session of the VM. At this point, it uses the standard installer. The VM installation initially starts in text mode, and may request network configuration. Once provided, the Switch to Graphical Console button is displayed in the top right corner of the XenCenter window.
Red Hat Enterprise Linux 7
After migrating or suspending the VM, RHEL 7.x guests might freeze during resume. For more information, see Red Hat issue 1141249.
For the list of CentOS 7.x release notes, see Red Hat Enterprise Linux 7.
Oracle Linux 7
For the list of Oracle Linux 7.x release notes, see Red Hat Enterprise Linux 7.
Scientific Linux 7
For the list of Scientific Linux 7.x release notes, see Red Hat Enterprise Linux 7.
If you install Debian 10 (Buster) by using PXE network boot, do not add
console=tty0 to the boot parameters. This parameter can cause issues with the installation process. Use only
console=hvc0 in the boot parameters.
For more information, see Debian issues 944106 and 944125.
SUSE Linux Enterprise 12
Prepare a SLES guest for cloning
Before you prepare a SLES guest for cloning, ensure that you clear the
udevconfiguration for network devices as follows:
cat< /dev/null > /etc/udev/rules.d/30-net_persistent_names.rules
To prepare a SLES guest for cloning:
Open the file
Edit the line that reads:
Save the changes and reboot the VM.
For more information, see Prepare to Clone a Linux VM.
Ubuntu 18.04 offers the following types of kernel:
- The General Availability (GA) kernel, which is not updated at point releases
- The Hardware Enablement (HWE) kernel, which is updated at point releases
Some minor versions of Ubuntu 18.04 (for example 18.04.2 and 18.04.3) use a HWE kernel by default that can experience issues when running the graphical console. To work around these issues, you can choose to run these minor versions of Ubuntu 18.04 with the GA kernel or to change some of the graphics settings. For more information, see CTX265663 - Ubuntu 18.04.2 VMs can fail to boot on Citrix Hypervisor.