Filename : nxtn_dd_nic_3.4.216_linux_noarch.txt NetXen 10Gb Ethernet Expansion Card for IBM eServer BladeCenter Linux 2.4 and 2.6 Kernel Driver 3.4.216 Version 1.1 Nov 14 2007 ________ CONTENTS ________ 1.0 Overview 2.0 Change History 3.0 Installation and Setup Instructions 4.0 Configuration Information 5.0 Unattended Mode 6.0 Web Sites and Support Phone Number 7.0 Trademarks and Notices 8.0 Disclaimer ____________ 1.0 Overview ____________ 1.1 Overview This readme describes the basic installation and configuration of the 10GbE adapter, and its associated software release. It also includes the requirements, update information, and contents specific to this release. Linux Release Contents for 3.4.216 1. Release Package 3.4.216 2. Linux Driver Version 3.4.216 3. Firmware Version 3.4.216 4. Documentation Readme-Linux-3.4.216-v2 1.2 Limitations (Linux) 1. During the first boot after the card is installed, the card might attempt a network boot using PXE (Pre-Boot Execution Environment). During this process, the user might not be able to use the normal BIOS function keys (for e.g., the BIOS setup menu) on certain BIOS versions. If the network boot is not desired, make sure the associated kernel image files and servers (DHCP, TFTP) are not accessible by the XG NIC during this first boot. 2. After using the recover option on the flash tool, incorrect version number of the firmware is displayed 1.3 Enhancements NONE 1.4 Level of Recommendations and Prerequisites for the Update: NONE 1.5 Dependencies: System Requirements Summary System Memory: Minimum 2GB Platforms:AMD,Intel OS(32bit and 64Bit): RHEL3U8,RHEL4U3,RHEL4U4,RHEL5, SLES9 SP3, SLES10 Linux Software Requirements Summary NIC Linux: Linux kernel source/headers LSA Linux: Linux kernel source/headers, LSA and intercept driver Linux NIC and LSA drivers are distributed in source code ___________ 2.0 Change History ____________ 1. Performance optimizations 2. Driver update ____________ 3.0 Installation and Setup Instructions ____________ NIC Driver Installation: 1. Untar the file, build, install, and load the driver: a. Un-tar the driver package i. tar xzf [version].tar.gz b. Build and install the driver module i. cd [version] ii. make iii. make install c. Load the driver module i. insmod ./driver/nx_nic.ko d. Bring up and verify all the Ethernet interfaces i. Identify the 2 NetXen Ethernet interfaces by running the following commands. 1. cat /proc/net/nx_nic/dev0 | grep eth 2. cat /proc/net/nx_nic/dev1 | grep eth ii. Verify the Ethernet interface using ethtool on Linux OS 1. ethtool -i eth[n] iii. Assign an IP address: 1. ifconfig eth[n] [IP address] iii. To check status of the loaded driver module. 1. lsmod | grep nx iv. To check for system messages related to the card. 1. dmesg e. Test the Ethernet interface using ping f. The man page for the NIC driver can be invoked using the command i. man nx_nic Linux LSA Driver Installation: 1. First, bring up the interface with the NIC driver (nx_nic.ko) 2. Verify that the NIC driver can ping 3. Untar the file, build, and load the drivers. a. tar xzf [version]-lsa.tar.gz b. cd [version]-lsa c. make d. make install 4. Load the Intercept driver a. insmod ./driver/nx_intercept.ko 5. Load the Linux LSA driver a. insmod ./driver/nx_lsa.ko 6. To verify the LSA driver is operating, execute the following command: a. cat /proc/net/nx_nic/lsa_1/stats 7. Use offload rules, by using the nxoffload application, to display command and usage: a. ./nxoffload/nxoffload b. Example for offloading iperf. i. ./nxoffload/nxoffload -a -n iperf 8. To display the current offload rules execute the following: a. ./nxoffload/nxoffload -s 9. To unload LSA driver, first remove the offload rules a. ./nxoffload/nxoffload -r -n b. rmmod nx_lsa Updating the Firmware NOTE: Firmware is always included with the card that is shipped. Updating the firmware is NOT required unless asked to do so for the specific release. The following steps show how to update the firmware 1. Verify Link Status a. With the existing driver and firmware installed, verify that the interface is up using ifconfig before continuing with the firmware update. 2. Identify the current Firmware and Driver information a. From the release directory, use the flash utility located in the bin sub-directory i. cd [version]/bin ii. ./nxflash -i eth[n] -- info 3. Update to New Firmware a. Run the following command from the bin directory of the driver. i. ./nxflash -i eth[n] --all 4. Unload and Reload the Existing Driver a. Unload the current driver. i. ifconfig eth[n] down ii. rmmod nx_nic b. Reoad driver and updated firmware i. cd [version] ii. insmod ./driver/nx_nic.ko _________________ 4.0 Configuration Information _________________ Follow the configuration guidelines outlined in the respective software release notes. _________________ 5.0 Unattended Mode _________________ This release does not support unattended installation. ________________ 6.0 WEB Sites and Support Phone Number ________________ 6.1 IBM Support Web Site: http://www.ibm.com/pc/support ________________ 7.0 Trademarks and Notices ________________ 7.1 The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM BladeCenter eServer Linux is a registered trademark of Linus Torvalds. RHEL is a trademark of RedHat. SLES is a trademark of Novell Corp. Other company, product, and service names may be trademarks or service marks of others. ________________ 8.0 Disclaimer ________________ THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS.