**************************************** README **************************************** Chelsio T5/T4 Family Network Driver for XenServer Version : 2.1.2.0 (Beta) Date : 01/13/2016 Overview ================================================================================ Chelsio’s Network driver package for XenServer is an ISO image which installs Network driver v2.1.2.0 for Chelsio’s T5/T4 Unified Wire Adapters. Note: The driver is not certified. ================================================================================ CONTENTS ================================================================================ - 1. Requirements - 2. Supported Operating System - 3. Supported Cards - 4. How to Use - 5. Customer Support 1. Requirements ================================================================================ 1.1. XenServer Requirements ---------------------------- Chelsio T5 40/10/1Gb or T4 10/1Gb adapter and system with supported platforms mentioned in section 2. 1.2. Resource Requirements --------------------------- a. Control Domain (Dom0) memory Based on the number of 40/10/1G ports, driver allocates memory enough to run at the desired rate. It is suggested to increase the control domain memory to 2GB using the procedure explained in http://support.citrix.com/article/CTX134951 b. SW-IOMMU Size Increasing SW-IOMMU size by appending "swiotlb=128" to /boot/extlinux.conf avoids "PCI-DMA: Out of SW-IOMMU space for bytes at device " messages. 2. Supported Operating System ================================================================================ - Citrix XenServer Host 6.5.0 Kernel version : 3.10.0+2 Other versions have not been tested and are not guaranteed to work. 3. Supported Cards ================================================================================ - T520-BT - T580-CR - T580-SO-CR - T520-LL-CR - T520-SO-CR - T520-CR - T580-LP-CR - T540-CR - T420-CR - T440-CR - T404-BT - T422-CR - T420-SO-CR - T420-BCH - T440-LP-CR - T420-LL-CR - T420-CX - T420-BT 4. How to Use ================================================================================ 4.1. Installation ================= Chelsio Network driver must be installed by the root user. Any attempt to install the software as a regular user will fail. There are two methods of installation: During OS installation and Runtime. i. During OS installation -------------------------- a. If you haven't done so already, download the driver (ISO image) from Chelsio Download Center, http://service.chelsio.com b. Start an interactive install of XenServer. c. Opt for installing drivers through supplementary packs during initial XenServer installation. The installation will prompt to install drivers through supplementary pack at the end of installation. d. Use the downloaded software. ii. Runtime installation ------------------------ a. Copy the downloaded driver (ISO image) on to a host running XenServer. b. Mount the image onto a directory [root@host~]# mkdir /tmp/iso [root@host~]# mount -o loop /tmp/iso [root@host~]# cd /tmp/iso c. Run the "install.sh" script to install the drivers and tools: [root@host~]# ./install.sh d. Finally, unmount the ISO image: [root@host~]# cd [root@host~]# umount /tmp/iso 4.2. Firmware Update ==================== The T5(1.12.25.0) and T4(1.12.25.0) firmwares are installed on the system, typically in /lib/firmware/updates/3.10.0+2/cxgb4/, and the driver will auto-load them if an update is required. The firmware version can be verified using ethtool: [root@host~]# ethtool -i 4.3. Loading Network Driver =========================== The driver must be loaded by the root user. Any attempt to load the driver as a regular user will fail. Run the following command to load Network driver: [root@host~]# modprobe cxgb4 4.4. Instantiating Virtual Functions ==================================== To instantiate the Virtual functions, load the cxgb4 driver with 'num_vf' parameter with a non-zero value. For example: [root@host~]# modprobe cxgb4 num_vf=1,0,0,0 Each number instantiates the specified number of Virtual Functions for the corresponding Physical Function. The Virtual Functions can be assigned to Virtual Machines(Guest OS). A maximum of 64 Virtual Functions can be instantiated with 16 Virtual Functions per Physical Function. NOTE: To get familiar with physical and virtual function terminologies, please refer the PCI Express specification. 4.5. Unloading ============== Run the following command to unload Network driver: [root@host~]# rmmod cxgb4 4.6. Uninstallation =================== i. Use the following query commands to determine the RPMs installed: [root@host~]# rpm -qa | grep -i cxgb4 [root@host~]# rpm -qa | grep -i chelsio ii. Now, with the results from the above queries, execute the following command to uninstall all related packages: [root@host~]# rpm -e 5. Customer Support ================================================================================ Please contact Chelsio support at support@chelsio.com for any issues regarding the product. ******************************************************************************** Copyright (C) 2016 Chelsio Communications. All Rights Reserved. The information in this document is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Chelsio Communications. Chelsio Communications assumes no responsibility or liability for any errors or inaccuracies that may appear in this document or any software that may be provided in association with this document. Except as permitted by such license, no part of this document may be reproduced, stored in a retrieval system,or transmitted in any form or by any means without the express written consent of Chelsio Communications.