Importing the Demo Linux Virtual Appliance

Citrix provides a fully functional installation of a Demo Linux Virtual Appliance, based on a CentOS 5.5 distribution. This is available for download, in a single xva file from the Citrix XenServer 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 allows a quick and simple VM deployment and can be used to test XenServer product features such as XenMotion, Dynamic Memory Control and High Availability. XenServer PV Tools are preinstalled in the Demo Linux Virtual Appliance and it also includes pre-configured networking connectivity in addition to a Web Server for test purposes.

Warning

The Demo Linux Virtual Appliance should NOT be used for running production workloads.

To Import the Demo Linux Virtual Appliance Using XenCenter

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

    Customers will 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 XenServer host 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 will be prompted to enter a root password. The IP address of the VM will then be displayed. Ensure you record this, as it will be 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
    

    Other installed networking tools include:

    • ifconfig

    • netstat

    • 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 should display. This page shows simple information about the VM mounted disks, their size, location and usage.

You can also use the webpage to mount a disk.

Mounting a disk using the Demonstration Linux Virtual Machine Web Page

  1. In XenCenter, add a virtual disk to your VM. Select the VM in the Resources pane, click 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.

    You should make sure that the storage repository (SR) on which the virtual disk will be stored has sufficient space for the new virtual disk.

  4. Select the SR where the new virtual disk will be 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 mounts the disk, and filesystem information is displayed.

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