Citrix Hypervisor

Demo Linux virtual appliance

Important:

Citrix Hypervisor 8.2 Cumulative Update 1 becomes End of Life on June 25, 2025. Plan your upgrade to XenServer 8 now to ensure a smooth transition and continued support. For more information, see Upgrade.

If you are using your Citrix Virtual Apps and Desktops license files to license your Citrix Hypervisor 8.2 Cumulative Update 1 hosts, these license files are not compatible with XenServer 8. Before upgrading you must acquire XenServer Premium Edition socket license files to use with XenServer 8. These socket license files are available as an entitlement of the Citrix for Private Cloud, Citrix Universal Hybrid Multi-Cloud, Citrix Universal MSP, and Citrix Platform License subscriptions for running your Citrix workloads. Citrix customers who have not yet transitioned to these new subscriptions can request to participate in a no-cost promotion for 10,000 XenServer Premium Edition socket licenses. For more information, see XenServer.

If you do not get a compatible license for XenServer 8 before upgrading, when you upgrade your hosts they revert to the 90-day Trial Edition. Trial Edition provides the same features as Premium Edition with some limitations. For more information, see XenServer 8 Licensing Overview.

We provide a fully functional installation of a Demo Linux Virtual Appliance, based on a CentOS 7.5 distribution.

The appliance is available for download, in a single xva file from the Citrix Hypervisor Download page.

The xva file can be quickly imported into XenCenter to create a fully working Linux Virtual Machine. No additional configuration steps are required.

The Demo Linux Virtual Appliance enables you to deploy a VM quickly and simply. Use this appliance to test Citrix Hypervisor product features such as live migration and high availability.

The Demo Linux Virtual Appliance comes with the following items already set up:

  • Citrix VM Tools for Linux
  • Pre-configured networking connectivity
  • A web server for test purposes

Warning:

Do not use the Demo Linux Virtual Appliance for running production workloads.

Import the Demo Linux virtual appliance

  1. Download the Demo Linux Virtual Appliance from the Citrix Hypervisor Download page.

    Customers require access to My Account to access this page. If you do not have an account, you can register on the Citrix home page.

  2. In the Resources pane, select a host or a Pool, then right-click and select Import. The Import Wizard is displayed.

  3. Click Browse and navigate to the location of the downloaded Demo Linux Virtual Appliance xva file on your computer.

  4. Click Next.

  5. Select the target Citrix Hypervisor server or pool, then click Next.

  6. Select a storage repository on which to create the virtual appliance’s disk, then click Next.

  7. Click Finish to import the virtual appliance.

Note:

When you first start the VM, you are prompted to enter a root password. The IP address of the VM is then displayed. Ensure that you record the IP address, as it is useful for test purposes.

Useful tests

This section lists some useful tests to carry out to ensure that your Demo Linux Virtual Appliance is correctly configured.

  1. Test that you have external networking connectivity.

    Log in to the VM from the XenCenter console. Run this comment to send ping packets to Google and back:

    ping -c 10 google.com
    <!--NeedCopy-->
    

    Other installed networking tools include ifconfig, netstat, and tracepath.

  2. Using the IP address displayed on VM boot, test that you can ping the VM from an external computer.

  3. Test that the web server is configured.

    In a web browser, enter the VM IP address. The “Demonstration Linux Virtual Machine” page opens. This page displays simple information about the VM mounted disks, their size, location, and usage.

You can also use the webpage to mount a disk.

Mount a disk using the Demonstration Linux Virtual Machine webpage

  1. In XenCenter, add a virtual disk to your VM. Select the VM in the Resources pane, open the Storage tab, and then click Add.

  2. Enter the name of the new virtual disk and, optionally, a description.

  3. Enter the size of the new virtual disk.

    Ensure that the storage repository where the virtual disk is stored has sufficient space for the new virtual disk.

  4. Select the SR where the new virtual disk is stored.

  5. Click Create to add the new virtual disk and close the dialog box.

  6. Click the Console tab, and user your normal tools to partition and format the disk as required.

  7. Refresh the Demonstration Linux Virtual Machine webpage, the new disk is displayed.

  8. Click Mount. This action mounts the disk, and filesystem information is displayed.

For more information on adding virtual disks, see the XenCenter documentation.

Demo Linux virtual appliance