QLogic 1GB iSCSI TOE Expansion Card for IBM eServer BladeCenter
Network Driver for Red Hat Enterprise Linux 3 & 4 Advanced Server
  and SUSE Linux Enterprise Server 9
Version 1.00

QMC4052_LinuxNetworkDriver.txt   Version 1.00	07/20/05

________

CONTENTS
________

	1.0   Overview
	2.0   Change History
	3.0   Installation and Setup Instructions
	4.0   Configuration Information
	5.0   Known Issues
	6.0   Unattended Mode
	7.0   Web Sites and Support Phone Number
	8.0   Trademarks and Notices
	9.0   Disclaimer

_______________ 

1.0   Overview  
_______________
 
This README describes current Linux Network Driver version for the QLogic 1GB iSCSI 
TOE Expansion Card and procedure for updating the driver for the expansion card. 


	1.1   Dependencies:

	None
 
____________________

2.0   Change History
____________________

	QLogic iSCSI Expansion Card Linux Kernel Storage Driver 1.00
	------------------------------------------------------------

	-Initial Version

_________________________________________

3.0   Installation Instructions
_________________________________________


This section is divided into the following sections:
1. Saving he Saving the Driver Source to Diskette
2. Installing the driver
3. Building the driver
4. Load the driver
5. Loading the driver at boot time
6. Driver Command Line Parameters
7. Unloading the driver
8. Extract the kernel-headers and kernel-sources RPM 
   files from the first RedHat CD


The kernel sources should be already installed on the system for the relevant kernel 
or install it from the RedHat/SuSE source CD(s) before proceeding further. Most 
distributions include the kernel source on the first disc of the distribution CDs.  
Also see section 3.8.

NOTE: Refer to the file BUILD_KERNEL.txt for instructions on how to build a custom 
      kernel with the QLogic Driver embedded.  Refer to the Driver Disk Kit 
      documentation for the procedure to build Driver Diskettes for iSCSI bootable 
      systems.

3.1 Saving the Driver Source to Diskette
---------------------------------------
Note: This step assumes that the user does not have the current version
      already, and that the driver is posted on the website.

1. Download qla3022ipsrc-v1.xx.tgz file from QLogic's website. If 
   prompted "What would you like to do with this file?" choose "Save this 
   file to disk". Insert a blank diskette and download to the diskette
   directly.


2. If prompted "What would you like to do with this file?" choose 
   "Save this file to disk."

3. Insert a blank diskette and download to the diskette directly.



3.2 Installing the driver
------------------------
Install and unzip the driver archive file using Diskette you created 
in Section.

1. Please perform the following steps:

       # mkdir qla3xxx
       # cd qla3xxx
       # mount /mnt/floppy
       # cp /mnt/floppy/qla3022ipsrc-vx.xx.tgz . (the period at the end is required)
       # tar xvzf qla3022ipsrc-vx.xx.tgz


3.3 Building the Driver
---------------------------------------------------------
1. Verify super user rights by typing:

       #su
	   #<enter password>

2. Build the driver from the Source Code by typing:

       # make install

   The files will be copied to /lib/modules/<KERNEL VERSION>/kernel/drivers/net.

   NOTE: Please refer to Makefile for additional supported command
         line parameters.
   
   NOTE: If the kernel header files are not found refer to section 3.8.
         


3.4 Load the Driver
-------------------

1. To load the driver directly from the local build  directory, type 
   the following:

       # insmod qla3022ip.[k]o

	Note: For Linux Kernel 2.6.x, the k is included. For Kernel 2.4.x it is 
	      omitted. 

2. Set the IP address for the new interface.

	ifconfig ethx <IP Address>

3. Test the new interface by pinging from a remote station.

	ping <IP Address>

               
3.5  Loading the Driver at Boot time
------------------------------------

The most efficent way to install a network driver to load automatically is to use 
one of the network configuration applications that are supplied with the GUI.  The 
steps outlined below apply to Redhat Advanced Server 3.  The steps required for 
other distributions may differ.  Refer to your distribution documentation for 
detailed instructions.

1. Build the driver binary files (see 3.3).

2. Copy the files to /lib/modules/<kernel version>/kernel/drivers/net
   by typing:

       # make install

3. Modify the /etc/modules.conf(2.4.k kernel) or /etc/modprobe.conf(2.6.x     
   kernel) file Add the following line to /etc/modules.conf or etc/modprobe.conf

	alias eth2 qla3022ip

	In this sample, the ethernet device number is 2.  In your system
	it may be different.  The safest thing to do is to use the next 
	number after the last one that was already in the file.  An 
	example of a modules.conf file is provided here:

		alias parport_lowlevel parport_pc
		alias eth0 eepro100
		alias eth1 eepro100
		alias usb-controller usb-uhci
		alias eth2 qla3022ip

	NOTE: For the QMC4052, there are two network interfaces.  One line must be 
		Added for each interface.  For example:

		alias eth2 qla3022ip 
		alias eth3 qla3022ip 

4. Create a new file for your device in the 
   /etc/sysconfig/network-scripts/ directory:

	Following our example from above, our new file will be called
	ifcfg-eth2.  The device may be configured for a static IP
	address, or for DHCP. Both examples are shown here.

	ifcfg-eth2 file contents for static IP address:
####################################################
# File: ifcfg-eth2
# Set device up with Static IP address.
#
DEVICE=eth2
IPADDR=<YOUR IP ADDRESS>
NMASK=<YOUR NET MASK>
NETWORK=<YOUR NETWORK ADDRESS>
BCAST=<YOUR BCAST ADDRESS
ONBOOT=yes
BOOTPROTO=none
####################################################
	
	ifcfg-eth2 file contents for DHCP client:
####################################################
# File: ifcfg-eth2
# Set device up for DHCP.
#
DEVICE=eth32
ONBOOT=yes
BOOTPROTO=dhcp
####################################################

5. Add entry to /boot/module-info file:		(Optional)

	This file is a database with information on various network 
	and storage devices.  The list is sorted by device type and then
	alphabetically based on the device name.  To insert an entry for
	the QLA3022, search for the proper slot in the network
	devices and install the following 3 lines:

	qla3022ip
	eth
	"Qlogic Gigabit Ethernet"

	This will usually follow the entry for "plip" or "ppp".



3.6 Driver Command Line Parameters
----------------------------------

Command line parameters are added to the insmod command line to change the behavior 
of the driver as follows:

	# insmod qla3022ip.[k]o parameter=value

	  base_mem - This parameter is used to selectively load only the specified 
	  qla3022ip devices.

		Note: This parameter requires a 2-step process.  The first step
		load the driver with no parameters to help find the base addresses
		of each Qlogic Network adapter that is installed in the system.
		The seconds step is for reloading the driver with specific
		base address of the desired adapters.

1. Load the driver with no parameters:

	# insmod qla3022ip.[k]o
	
2. Use the proc file system to select the specific device for the
   driver to load.  Below is an exerpt from the following command. In 
   this case there are two adapters present in the system:

	# /proc/pci/iomem | grep Qlogic

The display should look something like this:

	fc200000-fc200fff : Qlogic 3022 Network Driver
	fc202000-fc202fff : Qlogic 3022 Network Driver

	Note:
	There is a Network controller for each qlogic adapter in 
	the system.  Select the Ethernet controller you would like 
	to the driver to control, and record the memory address 
	assigned to it.  The memory address is the left-most number.  
	In this example it would be fc200000 and/or fc202000.

3. Unload the driver:

	# rmmod qla3022ip

4. Load the specific adapter with the following command line:

	# insmod qla3022ip.o base_mem=fc200000
		or
	# insmod qla3022ip.o base_mem=fc202000


3.7 Unloading the driver
------------------------

1. The driver can be unloaded manually with the following commands:
         # ifconfig ethx down
         # rmmod qla3022ip

2. To remove the driver from being automatically loaded at boot time. 
   
   a. type the following command:

      # make uninstall

   b. type the following command:

     # rm -f /etc/sysconfig/nework-script/ifcfg-eth2
	NOTE: The "eth2" may be a different device number on your
	      system.

   c. Modify /etc/modules.conf or /etc/modprobe.conf and remove or comment any lines 
      that contain "qla3022ip".



3.8 Extract the kernel-headers and kernel-sources RPM files from the first RedHat CD
------------------------------------------------------------------------------------

       # cd /mnt/cdrom/RedHat/RPMS
       # rpm -iv kernel-headers*.rpm (not required for Red Hat 9.0)
       # rpm -iv kernel-source*.rpm (not required for Red Hat 9.0)




_______________________________

4.0   Configuration Information
_______________________________


4.1 Changing the IP address when driver is automatically loaded
---------------------------------------------------------------------
This is usually done through the network configuration utility in
the GUI that is part of a Linux distribution.  The following will
describe how to perform this operation on Redhat AS 2.1.  For other
distributions, please see the distribution documentation.

1. Modify the IP address in the /etc/sysconfig/network-script/ifcfg-ethx
   file.
2. Issue the following command to restart the network:

	# /etc/init.d/network restart

The network will be restarted with the new paramters and will maintain
them whenever the system is rebooted.


4.2  Jumbo Frames
---------------------------------------------------------------------

1. Jumbo Frames can be enabled with the following:

         # ifconfig ethx mtu 9000

   The maximum acceptable value is 9214.  Changing the mtu is not
   a trivial task as the values should match between any two systems
   that expect to benefit.  Users should understand the details
   of changing this parameter before make the change.


_______________________________

5.0   Known Issues
_______________________________

No known issues
 
_____________________

6.0   Unattended Mode
_____________________

This package does not support Unattended Mode

________________________________________

7.0   WEB Sites and Support Phone Number
________________________________________

	     IBM Support Web Site:
                   http://www.ibm.com/pc/support

 
	     IBM Marketing Netfinity Web Site:
                   http://www.pc.ibm.com/netfinity


		If you have any questions about this update, or problems
		applying the update go to the following Help Center World
		Telephone Numbers URL: 1-800-772-2227
		http://www.pc.ibm.com/qtechinfo/YAST-3P2QYL.html.



____________________________
 
8.0   Trademarks and Notices
____________________________

 

	        The following terms are trademarks of the IBM Corporation
		in the United States or other countries or both:

    			IBM
    			BladeCenter 
    			eServer

		Microsoft, Windows, and Windows NT are trademarks of Microsoft
		Corporation in the United States, other countries, or both. 

		Linux is a registered trademark of Linus Torvalds. 

                Intel trademarks or registered trademarks are trademarks
                of Intel Corporation.

 		Other company, product, and service names may be
                trademarks or service marks of others.

________________
 
9.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.

	      Note to Government Users

		Note to U.S. Government Users -- Documentation related to
		restricted rights -- Use, duplication or disclosure is
		subject to restrictions set forth in GSA ADP Schedule
		Contract with IBM Corporation.