**************************************** README **************************************** Chelsio T5 iWARP RDMA Driver for Hadoop Version : 1.0.0.0 (Beta) Date : 04/19/2016 Overview ================================================================================ Chelsio T5 iWARP RDMA driver is developed for Chelsio's T5 40/10GbE family of adapters and provides support for Hadoop - Apache's open-source framework for big data processing across clusters of servers. The driver package contains an easy to use utility that installs the following components: - Hadoop software package v2.6.0 - iWARP RDMA driver v2.12.0.3 - Unstructured Data Accelerator (UDA) Plug-in for Hadoop taken from repository https://github.com/larrystevenwise/uda-plugin ================================================================================ 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/10Gb adapter and system with supported platforms mentioned in section 2. - Java SE Development Kit 7 2. Supported Operating Systems ================================================================================ - RHEL 7.2, 3.10.0-327.el7 - RHEL 7.1, 3.10.0-229.el7 - RHEL 6.7, 2.6.32-573.el6 - RHEL 6.6, 2.6.32-504.el6 - RHEL 6.5, 2.6.32-431.el6 3. Supported Cards ================================================================================ - T580-CR - T580-LP-CR - T540-CR - T520-CR - T520-LL-CR - T520-BT 4. How to Use ================================================================================ 4.1. Pre-requisites =================== Please ensure that Java SE Development Kit 7 is installed before proceeding. Download from http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html 4.2. Installation ================= a. Download the tarball Chelsio-hadoop-x.x.x.x.tar.gz b. Untar the tarball [root@host~]# tar zxvfm Chelsio-hadoop-x.x.x.x.tar.gz c. Change your current working directory to Chelsio-hadoop-x.x.x.x directory [root@host~]# cd Chelsio-hadoop-x.x.x.x d. Run the following command to invoke the installer: [root@host~]# ./install.sh -i 4.3. Firmware Update ==================== The T5 firmware(v1.15.36.0) is installed on the system, typically in /lib/firmware/cxgb4, and the driver will auto-load the firmware if an update is required. The kernel must be configured to enable userspace firmware loading support: Device Drivers -> Generic Driver Options -> Userspace firmware loading support The firmware version can be verified using ethtool: [root@host~]# ethtool -i 4.4. Driver Loading =================== IMPORTANT: Please ensure that all inbox drivers are unloaded before proceeding: The driver must be loaded by the root user. Any attempt to load as a regular user will fail. Run the following commands to load Chelsio iWARP(iw_cxgb4)and Transport Connection Manager(rdma_ucm) drivers: [root@host~]# modprobe iw_cxgb4 [root@host~]# modprobe rdma_ucm 4.5. Running Tests ================== After the driver package is installed successfully on master and all slave nodes, the Hadoop software needs to be configured before running any tests. Please refer the User's Guide for step-by-step instructions. 4.6. Driver Unloading ===================== Run the following commands to unload the iWARP driver: [root@host~]# rmmod rdma_ucm [root@host~]# rmmod iw_cxgb4 [root@host~]# rmmod cxgb4 4.7. Driver Uninstallation =========================== a. Change your working directory to Chelsio-hadoop-x.x.x.x directory: [root@host~]# cd Chelsio-hadoop-x.x.x.x b. Run the following command to uninstall: [root@host~]# ./install.sh -u 5. Support Documentation ================================================================================ The documentation for this release can be found in the Chelsio-hadoop-x.x.x.x/docs directory in the package. It contains: - README - Release Notes - User's Guide 6. 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.