Most of this material for this blog entry is taken the documentation Guide named Chelsio iWARP installation and setup guide (pdf)  . This Blog Entry  “Chelsio iWARP Installation and Setup Guide for CentOS 5.4” is an modification from a user’s perpective of the original document.

1. Install RPMForge first
You will need some utilities from rpmforge to install iWARP successfully. For more information o install RPMForge, see Installing RPMForge (Linux Toolkits)  

2. Yum Install the following utilities which is required for the iWARP Installation  

# yum install libevent-devel nfs-utils-lib-devel tcl-devel

3.  Download the latest package that matched your Chelsio Network Adapters from Open Fabrics Alliance. Here is the  latest OFED Package Download Site  

4. Unpacked and install the OFED Drivers  

# wget http://69.55.239.13/downloads/OFED/ofed-1.5.1/OFED-1.5.1.tgz
# tar -zxvf OFED-1.5.1.tgz
# cd OFED-1.5.1
# ./install.pl

a. Inside the menu  

1. Choose option 2 to install OFED package.
2. Then choose option 3 to install all OFED libraries.
3. Then choose default options in which come while executing ./install.pl script
to build and install OFED OR 
4. If you are familiar with OFED installation you can choose option 2 then option 4 for
customized installation.

b. If you encounter error like  

file /lib/modules/2.6.18-164.el5/updates/kernel/drivers/net/cxgb3/cxgb3.ko from install of
kernel-ib-1.5.1-2.6.18_164.el5.x86_64 conflicts with file from package
cxgb3toe-1.4.1.2-custom.x86_64

*It is likely that you use the cxgb3toe-1.4.1.2-custom.x86_64.rpm to install the drivers. This immediately conflicts with kernel-ib-1.5.1-2.6.18_164.el5.x86_64.rpm. It is advisisable to install using make && make install. See Installing Chelsio 10GE Driver on CentOS 5.4  

c. Resolution for the error above problem  

# rpm -e  cxgb3toe-1.4.1.2-custom.x86_64.rpm

* Start from Step 4 and do the ./install.pl again.  

5. After installation reboot system for changes to take effect.  

6. Set Chelsio driver option for MPI connection changes.
Give the below command on all systems  

# echo 1 > /sys/module/iw_cxgb3/parameters/peer2peer

OR to make it permanent, add the following line to /etc/modprobe.conf to set the option at module load time:

options iw_cxgb3 peer2peer=1

*The option setting in file /etc/modprobe.conf shall take effect upon system reboot

7. Checking Chelsio iWARP Drivers compatibility with Chrlsio Linux Drivers. There is a whole list as shown in Chelsio iWARP Drivers compatibility with Chelsio Linux drivers. Do take a good look

8. Installing Chelsio cxgb3toe-W.X.YY.ZZZ driver with OFED-X.Y.Z package. Do follow the blog entry for 

a.  Check Blog Entry on Chelsio iWARP Drivers compatibility with Chelsio Linux drivers. You may not need to do the Performance Tuning.

9. To load the Chelsio iWARP drivers on RHEL 5.4 or CentOS 5.4, add this additional lines to /etc/modprobe.conf

options iw_cxgb3 peer2peer=1
install cxgb3 /sbin/modprobe -i cxgb3; /sbin/modprobe -f iw_cxgb3; /sbin/modprobe rdma_ucm
alias eth1 cxgb3 # assuming eth1 is used by the Chelsio interface

10. Reboot the system to load the new modules

11. After rebooting, you should be have loaded iw_cxgb3 and rdma_ucm module, you should be able to see the ethernet interface(s) for the T3 device. Do configure them with the appropriate ip addresses, netmask etc.

a. Test I: Test Ping
After setting the ipaddress, netmask, gateway etc, you should be able to ping the ethernet interface.

b. Test IIa: Test RDMA (Server Preparation)
To test RDMA, use the rping command that is included in the librdmacm-utils rpm
On the server machine:

# rping -s -a server_ip_address -p 9999

* The server will be “waiting mode” for the client connection

c. Test IIb: Test RDMA (Client Preparation)
You have to setup the clients from Pt 1 to Pt 10 again. If you are using xcat, you may wish to use it to automate the setup of the client.

# rping -c –Vv -C10 -a server_ip_addr -p 9999

* You should see ping data like this on the client

ping data: rdma-ping-0: ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqr
ping data: rdma-ping-1: BCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrs
ping data: rdma-ping-2: CDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrst
ping data: rdma-ping-3: DEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstu
ping data: rdma-ping-4: EFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuv
ping data: rdma-ping-5: FGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvw
ping data: rdma-ping-6: GHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwx
ping data: rdma-ping-7: HIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxy
ping data: rdma-ping-8: IJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz
ping data: rdma-ping-9: JKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyzA
client DISCONNECT EVENT...

12. Great you are done. Read more on how to enable and compile with MPI and iWARP

The material for this Blog Entry is taken from Chelsio iWARP Installation and Setup Guide.

Chelsio is one of the leaders for High Speed, Low Latency 10GE Adapters. On great interest to me is the TCP offloading and the iWARP capability of the Card. To complement this high-end quality cards, you have to use good quality high-end but very low latency from Blade Network Technologies (BNT) 

1. Documentation (Impt)

1. The various documentation list for Chelsio OEM-IBM Information can be found at my Linux Toolkit Blog.
2. The most critical page is to go to the Chelsio Drivers Downloads page  for a variety of OS can be found.

2. Installing the Drivers on CentOS 5.4

1. I have downgraded the OS from CentOS 5.5 to Centos 5.4 as the offloading bonding is not supported by latest latest CentOS 5.5 kernel

2. Download the Linux drivers under Terminator 3 (T3) family Ethernet Adapter drivers. At this point in writing, the latest Linux driver is cxgb3toe-1.4.1.2.tar.gz (TOE/NIC)

3. Untar the drivers and go into the directory

# tar -zxvf cxgb3toe-1.4.1.2.tar.gz
# cd cxgb3toe-1.4.1.2

4. Follow the instruction on the READ ME found at source directory ( $SOURCE_DIR/cxgb3toe-1.4.1.2)

5. The src directory contains the driver source files for building kernel modules. To build the TOE driver, change to the src/ directory and run:

make
make install

6. Go to the $SOURCE_DIR/cxgb3toe-1.4.1.2 directory/tools directory and copy the ifup-local and perftune.sh to the /sbin directory and perftune.sh will be run each time the interface is enabled.

# cd  /tmp/cxgb3toe-1.4.1.2 directory/tools
# cp ifup-tools /sbin
# cp perftune.sh /sbin

7. Run the performance Tuning

/sbin/perftune.sh

You should see output something like this.

/  > Extract internal utility to /var/tmp/mmapr64.           [ PASS ]
 > IRQ Balance daemon is not running.                      [ PASS ]
 > eth1: PCI-E x8 device using all lanes.                  [ PASS ]
 > eth1: Set IRQ  51 smp_affinity to CPU0.                 [ PASS ]
 > eth1: Set IRQ  59 smp_affinity to CPU1.                 [ PASS ]
 > eth1: Set IRQ  67 smp_affinity to CPU2.                 [ PASS ]
 > eth1: Set IRQ 202 smp_affinity to CPU3.                 [ PASS ]
 > eth1: Set IRQ 210 smp_affinity to CPU4.                 [ PASS ]
 > eth1: Set IRQ 218 smp_affinity to CPU5.                 [ PASS ]
 > eth1: Set IRQ 226 smp_affinity to CPU6.                 [ PASS ]
 > eth1: Set IRQ 234 smp_affinity to CPU7.                 [ PASS ]
 > TOM(toe0): Enable DDP.                                  [ PASS ]
 > TOM(toe0): Set 'delayed_ack=2'.                         [ PASS ]
 > TOM(toe0)[eth4]: Disable TCP timestamps.                [ PASS ]
 [ Set sysctls... ]
 > Set net.core.wmem_max="16777216"                        [ PASS ]
 > Set net.core.rmem_max="16777216"                        [ PASS ]
 > Set net.ipv4.tcp_timestamps="0"                         [ PASS ]
 > Set net.ipv4.tcp_rmem="4096 262144 16777216"            [ PASS ]
 > Set net.ipv4.tcp_wmem="4096 262144 16777216"            [ PASS ]
 > Set net.core.optmem_max="524288"                        [ PASS ]
 > Set net.core.netdev_max_backlog="200000"                [ PASS ]
 [ System tuning is complete. ]

8. Configuring iWARP….Coming your way