Citrix Xentools Upgrade

Knowledgebase: Citrix Xentools Upgrade

Citrix Xentools Upgrade

The following document is intended for clients wishing to get the best performance and stability out of their instance running on the NSP infrastructure.

Recently, 05/12/2015 the TL Hypervisors in IPX IDC have been upgraded to Xenserver 6.5 SP1.

Throughout the lifecycle of the NSP infrastructure, the underlying hypervisor infrastructure has been upgraded a number of times to the latest stable Xenserver version.

For optimization, it is recommended to install the latest xentools drivers that is available after a Xenserver upgrade.

The below procedure will provide clients with a step by step process to upgrade their running instance to the latest version of xenserver tools.

This document walks through installing XenServer Tools version 6.5.

Upgrade, don't uninstall

 

Mounting xentools ISO through the NSP Portal

  1. Login to the NSP Portal https://portal.testlabs.com.au/portal
  2. Browse to the Instance tab
  3. Select the instance you wish to update xentools on
  4. Attach ISO

    5. Select xen-pv-drv.iso

If there are any errors attaching ISO and you do not receive message "Attach ISO Succeeded" please log a support request by email support@nsp.nectar.org.au.

Error message may be similar to "Attach ISO Action failed - Service Exception : Failed to attach iso"

CentOS/Redhat Xentools Upgrade

  1. Login to the instance where you mounted xen-pv-drv-iso through the portal or using a ssh client. You will require privileged access (root).
  2. mkdir /cdrom ; mount /dev/cdrom /cdrom

 

      3. Go to the /cdrom/Linux directory on the mount point you just created: cd /cdrom/Linux/

      4. From here you have two options: Install the two 64bit rpm packages manually or run the bash script.

          The bash script will automatically detect the OS type and install the required packages.

          If the script fails you will need to install manually.

      5. Run the automatic upgrade bash script by executing "./install"

    

        6. Upgrade the packages manually using rpm. Note: for 64bit centos/redhat there are two packages.

            xe-guest-utilities-6.5.0-1423.x86_64.rpm and xe-guest-utilities-xenstore-6.5.0-1423.x86_64.rpm

            rpm -Uvh xe-guest-utilities-6.5.0-1423.x86_64.rpm xe-guest-utilities-xenstore-6.5.0-1423.x86_64.rpm

        6.  Reboot the instance at a suitable time to load the new network and storage drivers.

Restart the instance

After the installer is complete, reboot the server so the change will take effect.

Ubuntu Xentools Upgrade

  1. Login to the instance where you mounted xen-pv-drv-iso through the portal or using a ssh client. You will require privileged access (root).
  2. mkdir /cdrom ; mount /dev/cdrom /cdrom

      3. Go to the /cdrom/Linux directory on the mount point you just created: cd /cdrom/Linux/

      4. From here you have two options: Install the amd64bit deb packages manually or run the bash script.

          The bash script will automatically detect the OS type and install the required packages.

          If the script fails you will need to install manually. The script may fail if you are running debian instead of ubuntu or if it fails to detect OS type.

      5. Run the automatic upgrade bash script by executing "./install"

    

        6. Upgrade the packages manually using dpkg. Note: for 64bit ubuntu/debian there is just one package.

            xe-guest-utilities_6.5.0-1423_amd64.deb

            dpkg -i xe-guest-utilities_6.5.0-1423_amd64.deb

 

        6.  Reboot the instance at a suitable time to load the new network and storage drivers.

Restart the instance

After the installer is complete, reboot the server so the change will take effect.

Windows Xentools Upgrade

Warning, windows will require a automatic restart. Please schedule outage for windows before proceeding.

  1. Login to the instance where you mounted xen-pv-drv-iso through the portal or using a remote desktop client. You will require privileged access (Administrator).
  2. Go to "My Computer" and open up the CDROM drive. Double click on the installwizard executable file.

      3. The Xentools installer window will open, click next and accept the License Agreement.

       4. Use default installation paths and select Install. Wait a moment and you will need to select "Install Tools"

    

        6.  Reboot the instance at a suitable time to load the new network and storage drivers.

Restart the instance

After the installer is complete, reboot the server so the change will take effect.

Note: In our lab we had to press cancel and restart the windows server manually.

     7. Once booted again, windows may ask to restart the server again to apply further changes.

Restart the instance

    8. Finally once restarted, from the console you should see the following screen:

Nothing to display