Using Intel(R) Network Adapters with Linux* --
Information for Specific Linux Distributions
==============================================

February 1, 2002


Contents
========

- Caldera OpenLinux* 3.1
  - Installing Intel ANS
  - Compiling Intel Drivers on Itanium(TM)-Based Systems
- Red Hat* 7.0
   - Compiling Intel Drivers
- Red Hat 7.0 Enterprise* Edition
   - Matching the Kernel Source
- Red Hat 7.2
   - Driver Installation on Itanium-Based Systems
- SuSE* 7.1
  - Compiling Intel ANS or PROCfg on the 2.4.0 Kernel
- Support


Caldera* OpenLinux 3.1
======================

  Installing Intel ANS
  --------------------

  In Caldera OpenLinux* 3.1, the super-user's executable path does not include 
  /usr/sbin/, the default location selected by the makefile for Intel ANS 
  installation. This causes problems later during the configuration stage. To 
  solve this, either permanently add /usr/sbin to root's executable path, or 
  modify the makefile to set BIN_DIR to a preferred directory that is super-
  user specific and that appears in $PATH.

  Compiling Intel Drivers on Itanium(TM)-Based Systems
  ----------------------------------------------------

  When compiling the e100 and e1000 drivers, various unresolved symbol errors 
  may appear. These messages may be disregarded as the drivers will install 
  and function properly on Caldera OpenLinux 3.1 Itanium(TM)-based systems.


Red Hat* 7.0
============

  Compiling Intel Drivers
  -----------------------

  To install Intel's e100, e1000, and iANS drivers on systems running Red Hat* 
  Linux 7.0, you MUST have the kernel source package and kgcc. Without kgcc, 
  the modules compiled for the stock kernel are compiled with gcc and may be 
  unstable.
 
  You can check for the required packages by typing:

     rpm -q kernel-source
     rpm -q kgcc
  
  If you are missing a package, install it with the following commands:

     mount /dev/cdrom /mnt/cdrom  (or copy from the web)
     cd /mnt/cdrom/RedHat/RPMS/  (or directory copied from the web)
     rpm -i kernel-source-2.2.16-22.i386.rpm
     rpm -i kgcc-1.1.2-40.i386.rpm

  Then, you MUST reboot. This ensures that version.h is updated. You may then
  install the Intel driver(s) as indicated in the driver's readme file. 
   

Red Hat 7.0 Enterprise* Edition
==============================

  Matching the Kernel Source
  --------------------------

  The 7.0 Enterprise* kernel version was built using extra patches and does
  not match the kernel-RPM installed source. You must install and apply the
  patches from the kernel SRPM to recreate the proper source tree. 

  NOTE: The Enterprise kernel was developed to allow the 2.2.16 kernel large 
        memory access and other Enterprise features. If you require Enterprise
        capability, we strongly suggest using the 2.4.X series of kernels, 
        which have native large memory support.

  Use the following instructions to recreate the 2.2.16-22 Enterprise kernel
  source:

  1) Install kernel-2.2.16-22.src.rpm and kernel-source-2.2.16-22.i386.rpm.

  2) Make a copy of the source tree installed from kernel-source-2.2.16-22.i386.rpm.

  3) Apply the following patches from the kernel SRPM to the new kernel source
     tree:

        /usr/src/RedHat/SOURCES/linux-2.2.16-lfs.patch
        /usr/src/RedHat/SOURCES/linux-2.2.16-lfs-bigmem.patch

     NOTE: Unresolved failure message have been observed on some systems. These 
           message may be ignored as the patches do install cleanly.

  4) Clean out the kernel source tree and reconfigure for the Enterprise 
     kernel: 
	
	make mrproper
	cp configs/kernel-2.2.16-i686-enterprise.config .config
	make oldconfig
	make dep

  5) Ensure /usr/src/linux is a symlink pointing to the new Enterprise kernel
     source.

  6) Build the driver.


Red Hat 7.2
===========

  Driver Installation on Itanium-Based Systems with Red Hat 7.2 or Higher
  ---------------------------------------------------------------------------

  When compiling the e100 and e1000 drivers with 'make install', the binary is 
  installed as:
  
     For e100:  /lib/modules/[KERNEL_VERSION]/kernel/drivers/addon/e100.o

     For e1000: /lib/modules/[KERNEL_VERSION]/kernel/drivers/addon/e1000.o


SuSE* 7.1
=========

  Compiling Intel ANS on the 2.4.0 Kernel
  ---------------------------------------

  When trying to compile Intel ANS on the 2.4.0 kernel on SuSE* 7.1 systems, a 
  compilation failure occurs, and a message regarding a missing config.h file 
  is displayed. This failure occurs because the kernel source trees supplied, 
  Linux-2.4.0.SuSE and Linux-2.4.0-4GB, are both empty and do not contain the 
  necessary config.h and version.h files. A possible solution is to install 
  either a new kernel from http://www.kernel.org or a new kernel tree package 
  supplied by SuSE.

  When installing and compiling openssl, a prerequisite for PROCfg, a 
  compilation failure occurs, and a message regarding a missing errno.h file 
  is displayed. This is another instance of the missing kernel source tree 
  described above for ANS. Use the solution above to restore the missing 
  file.


Support
=======

For general information and support, go to the Intel support website at:

     http://support.intel.com

If an issue is identified with the released source code on the supported 
kernel with a supported adapter, email the specific information related to the 
issue to linux.nics@intel.com.


Copyright and Legal Disclaimers
===============================

Copyright(c) 2002 Intel Corporation. All rights reserved. 

Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497 

Intel Corporation assumes no responsibility for errors or omissions in this 
document. Nor does Intel make any commitment to update the information 
contained herein. 

Intel, Itanium, and Pentium are trademarks or registered trademarks of Intel 
Corporation or its subsidiaries in the United States and other countries. 

*Other names and brands may be claimed as the property of others. 
