***************************************** README ***************************************** Open-iSCSI Data Path Accelerator Version : 2.0.0.1 Date : 06/20/2011 Overview ================================================================================================ The cxgb3i driver interfaces with open-iscsi initiator and provides the iSCSI acceleration through Chelsio hardware wherever applicable. This package comes with the follwing driver versions: cxgb3i v2.0.0.1 libcxgbi v0.9.2 ================================================================================================ CONTENTS ================================================================================================ -1. Requirements -2. Supported Operating System -3. Supported Cards -4. How to Use -5. Support Documentation -6. Customer Support 1. Requirements ================================================================================================ - Open iSCSI initiator (v2.0-872) and cxgb3-toe (v1.5.1.6) should be installed before installing cxgb3i. For RHEL 5.6, open iSCSI initiator is available in the Operating System installation DVD. 2. Supported Operating System ================================================================================================ - Redhat Enterprise Linux 5 update 6 kernel (RHEL5.6), 2.6.18-238.el5 (64-bit) 3. Supported Cards ================================================================================================ - S302E - S320E-CR - S320E-LP-CR - S320EM-BCH - S320EM-BS 4. How to Use ================================================================================================ 1) Installing cxgb3toe v1.5.1.6 Although make && make install is enough, the following command is recommended: [root@chelsio]# make disable_bonding=1 && make install 2) Compiling and Installing cxgb3i To compile cxgb3i, run [root@chelsio]# make CXGB3TOE_SRC= Install using:- [root@chelsio]# make CXGB3TOE_SRC= install If you need to re-compile open-iscsi for any reason, make sure to run the following command to remove any leftover patch applied by the cxgbi [root@chelsio]# make OISCSI_SRC= clean and to clean the whole module, use the following command: [root@chelsio] make clean 3) Loading and using modules [root@chelsio]# modprobe cxgb3 And manually load the open-iscsi modules [root@chelsio]# cd /kernel [root@chelsio]# insmod ./scsi_transport_iscsi.ko [root@chelsio]# insmod ./libiscsi.ko [root@chelsio]# insmod ./libiscsi_tcp.ko 4) start iscsi run [root@chelsio]# iscsid You can check if module was loaded correctly by looking for the message in dmesg: iscsi: registered transport (cxgb3i) This part is important, do not run open-iscsi restart/stop as that will replace the outbox modules with inbox one, and generally give an error. Note: a. For login to work properly, Please edit /etc/iscsi/iscsid.conf change the setting for MaxRecvDataSegmentLength: node.conn[0].iscsi.MaxRecvDataSegmentLength = 8192 The login would fail for a normal session if MaxRecvDataSegmentLength is too big. An error message in the format of "ERR! MaxRecvSegmentLength too big. Need to be <= ." would be logged to dmesg. b In /etc/iscsi/iface/ create iface file using command:- [root@chelsio]# iscsiadm -m iface OR manually create file:- e.g.:- iface.iscsi_ifacename = cxgb3i.00:07:43:04:5b:da iface.hwaddress = 00:07:43:04:5b:da iface.transport_name = cxgb3i iface.net_ifacename = eth3 iface.ipaddress = 102.2.2.137 Here, *iface.iscsi_ifacename denotes the name of iface file in /etc/iscsi/iface/ in case of when you are using outbox open-iscsi, where as it's at /var/lib/iscsi/iface when you are using inbox open-iscsi. *iface.hwaddress denotes the MAC address of the chelsio interface via which iSCSI traffic will be running. *iface.net_ifacename is the chelsio interface name ethX (that appears on running ifconfig) through which you want to login. NOTE- In case of login through VLAN interface use :- iface.net_ifacename = ethX.Y where X is chelsio interface name and Y is VLAN Id. *iface.transport_name denotes the transport name, which is cxgb3i. *iface.ipaddress denotes the ipaddress which is assigned to the interface. b. Discovery can be done using:- iscsiadm -m discovery -t st -p : -I e.g.:- [root@chelsio]# iscsiadm -m discovery -t st -p 102.2.2.155:3260 -I cxgb3i.00:07:43:04:5b:da c. Login can be done using:- iscsiadm -m node -T -p : -I -l e.g:- [root@chelsio]# iscsiadm -m node -T iqn.2004-05.com.chelsio.target1 -p 102.2.2.155:3260,1 -I cxgb3i.00:07:43:04:5b:da -l d. Logout can be done using:- iscsiadm -m node -T -p : -I -u e.g:- [root@chelsio]# iscsiadm -m node -T iqn.2004-05.com.chelsio.target1 -p 102.2.2.155:3260,1 -I cxgb3i.00:07:43:04:5b:da -u Please Note: Other options can be found by typing 'iscsiadm --help' 5) Uninstalling cxgb3i module Run the following command to uninstall the module: [root@chelsio] make uninstall 5. Support Documentation ================================================================================================ The documentation for this release can be found in the cxgb3i-2.x.x.x directory. 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) 2011 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.