**************************************** README **************************************** Chelsio T5 Family Native Network Driver for VMware ESXi 6.0 Version : 0.0.1.18 (Alpha) Date : 12/11/2015 Overview ================================================================================ The driver package is to install Native Network driver for Chelsio T5 ASIC based 40/10/1Gb PCI Express adapters on VMware ESXi 6.0 installations. **NOTE: This driver is not VMware certified. ================================================================================ CONTENTS ================================================================================ - 1. Requirements - 2. Supported Operating Systems - 3. Supported Cards - 4. How to Use - 5. Support Documentation - 6. Customer Support 1. Requirements ================================================================================ - Chelsio T5 40/10/1Gb adapter and system with supported platform mentioned in section 2. 2. Supported Operating Systems ================================================================================ - ESXi 6.0 3. Supported Cards ================================================================================ - T580-SO-CR - T580-LP-CR - T580-CR - T520-SO-CR - T520-CR - T520-LL-CR - T540-CR - T520-BT 4. How to Use ================================================================================ 4.1. Driver Installation ======================== a. Download the driver package from http://service.chelsio.com b. Unzip the driver package: [root@host:~] unzip .zip c. Put the host in maintenance mode using the vSphere Client: (Inventory->Host->Enter Maintenance Mode): d. Install the driver: [root@host:~] cp /cxl-*.vib /productLocker/ [root@host:~] esxcli software vib install -v /productLocker/cxl-*.vib --no-sig-check e. After host updates successfully, exit from maintenance mode and reboot the system. 4.2. Firmware Update ==================== Driver will auto-load the firmware (v1.15.22.0) if an update is required. The version can be verified using: [root@host:~] esxcli network nic get -n vmnicX 4.3. Driver Loading =================== After rebooting the ESXi Host, the driver loads automatically. However, it is possible to manually load the driver by using the command below: [root@host:~] vmkload_mod cxl Execute the below command so that device manager performs a rescan: [root@host:~] kill -SIGHUP $(cat /var/run/vmware/vmkdevmgr.pid) 4.4. Connecting a virtual machine ================================= To connect Chelsio adapter to a virtual machine: a. Create a new virtual switch: [root@host:~] esxcfg-vswitch -a vSwitchN b. Link a chelsio NIC to the newly created virtual switch: [root@host:~] esxcfg-vswitch -L vmnicN vSwitchN c. Create a new portgroup on the vSwitch: [root@host:~] esxcfg-vswitch -A vSwitchN d. From the vSphere client, right-click on the virtual machine, select the virtual network adapter to be used, and set the portgroup to be the newly created one. 4.5. Driver Unloading ===================== Execute the command below to unload the driver: [root@host:~] vmkload_mod -u cxl 4.6. Driver Uninstallation ========================== a. Put the host in maintenance mode using the vSphere Client: (Inventory->Host->Enter Maintenance Mode). b. Uninstall the driver: [root@host:~] esxcli software vib remove -n cxl c. Reboot the host: [root@host:~] reboot 4.7. cxgbtool ============= Installation: ------------- Follow the steps mentioned below to install cxgbtool: [root@host:~] cp /CHELSIO-*.vib /productLocker/ [root@host:~] esxcli software vib install -v /productLocker/CHELSIO-*.vib --no-sig-check Usage: ------ To use cxgbtool, use the syntax: [root@host:~] /opt/chelsio/bin/cxgbtool NOTE: For information on available parameters and their usage, refer to cxgbtool help by running the "/opt/chelsio/bin/cxgbtool -h" command. Uninstallation: --------------- Run the following command to uninstall cxgbtool: [root@host:~] esxcli software vib remove -n chelsio-esx-cxgbtool 5. Support Documentation ================================================================================ The documentation for this release can be found in the "docs" directory in the package. It contains: - README - Release Notes 6. Customer Support ================================================================================ Please contact Chelsio support at support@chelsio.com for any issues regarding the product. ******************************************************************************** Copyright (C) 2015 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.