FILE NAME: 	vlan-1.8.0-12.src.rpm

TITLE:     	HP Tested and Approved Linux 802.1q VLAN Driver

VERSION:   	1.8.0-12

LANGUAGE:  	English

CATEGORY:  	Software Solutions

DIVISIONS: 	Enterprise and Mainstream Servers

PRODUCTS AFFECTED:
		HP NC3120 Fast Ethernet Adapter  (e100)
		HP NC3121 Fast Ethernet Adapter  (e100)
		HP NC3122 Fast Ethernet Adapter  (e100)
		HP NC3123 Fast Ethernet Adapter  (e100)
		HP NC3131 Fast Ethernet Adapter  (e100)
		HP NC3132 Fast Ethernet Adapter  (e100)
		HP NC3133 Fast Ethernet Adapter  (e100)
		HP NC3134 Fast Ethernet Adapter  (e100)
		HP NC3135 Fast Ethernet Adapter  (e100)
		HP NC3163 Fast Ethernet Adapter  (e100)
		HP NC6132 Gigabit Server Adapter  (e1000)
		HP NC6133 Gigabit Server Adapter  (e1000)
		HP NC6134 Gigabit Server Adapter  (e1000)
		HP NC6136 Gigabit Server Adapter  (e1000)
		HP NC6170 Gigabit Server Adapter  (e1000)
		HP NC6770 Gigabit Server Adapter  (bcm5700)
		HP NC7131 Gigabit Server Adapter  (e1000)
		HP NC7132 Gigabit Server Adapter  (e1000)
		HP NC7170 Gigabit Server Adapter  (e1000)
		HP NC7760 Gigabit Server Adapter  (bcm5700)
		HP NC7761 Gigabit Server Adapter  (bcm5700)
		HP NC7770 Gigabit Server Adapter  (bcm5700)
		HP NC7771 Gigabit Server Adapter  (bcm5700)
		HP NC7780 Gigabit Server Adapter  (bcm5700)
		HP NC7781 Gigabit Server Adapter  (bcm5700)

		                   
OPERATING SYSTEM:
		Red Hat Linux 8.0 Professional
			- Errata kernel 2.4.20-20 (SMP,UP and BigMem)
		Red Hat Linux 7.3 Professional
			- Errata kernel 2.4.20-20 (SMP,UP and BigMem)
		Red Hat Linux 7.2 Professional
			- Errata kernel 2.4.20-20 (SMP,UP and BigMem)
		Red Hat Enterprise Linux 3
		SuSE Linux Enterprise Server 7 (SLES-7)
			- Errata kernel 2.4.18-280 (SMP)
			- Errata kernel 2.4.18-280 (UP)
		Conectiva Linux Enterprise Edition, SCO Linux 4.0, SuSE Linux
			Enterprise Server 8 and Turbolinux 8 all powered by
			UnitedLinux 1.0.
			- Service Pack 3

NOTE: For Red Hat Linux 7.2 Professional BigMem installations,
      the system needs to be pre-configured before setting up
      the kernel sources and building the NIC and intermediate
      drivers. Refer to the Customer Advisory EU030812_CW01 
      for details on how to pre-configure the system. To access 
      the customer advisory, visit www.hp.com and search for 
      EU030812_CW01.

PREREQUISITES:	
		Pentium based computer
		128MB RAM minimum
		Latest HP system ROM
		bcm5700 driver version 6.2.17a
		e100 driver version 2.2.21c
		e1000 driver version 5.0.43c

		Note: Please visit the following URL to upgrade the ROM
                        http://h18000.www1.hp.com/support/files

EFFECTIVE DATE: 11/23/2003

SUPERSEDES:     vlan-1.8.0-9.src.rpm

DESCRIPTION:	This driver enables the creation of 802.1q VLANs over
		HP Proliant NICs running under linux.

ENHANCEMENTS/FIXES:
		- The driver now properly removes a vlan even when /proc
			entries are not present for the vlan.
		- The driver now provides Kernel Warning messages when
			/proc entries cannot be created for a vlan device
		- The vlan startup script now provides a way to obtain current
			vlan status by means of the /etc/init.d/vlan status
			command
		- vlan.txt updated to indicate /proc file limitations
		- The driver no longer displays extraneous messages
			at boot time
		- The Makefile for this driver now builds with the compiler
			used to build the kernel
		- This driver now supports the following Linux distributions:
			Red Hat Enterprise Linux 3
			Red Hat Linux 7.3
			SuSE Linux Enterprise Server 7

Table of Contents
=================
  Introduction
  Packaging
  Kernel Source Code Setup
  Installing the RPM Package
  VLAN Configuration
  Driver Messages
  Statistics
  Limitations
  Uninstalling the RPM

		       
Introduction
============
This package provides a driver module(8021q.o) which implements the
802.1q VLAN implementation and the vconfig utility used to configure
VLANs. After installation,additional information can be found in the
manual page for vconfig, and in the vlan.txt file located at:

For Red Hat: /usr/share/doc/vlan-1.8.0/vlan.txt
For SuSE SLES7: /usr/share/doc/packages/vlan/vlan.txt
For UnitedLinux 1.0: /usr/share/doc/packages/vlan/vlan.txt

The References section in vlan.txt provides many useful articles on
VLANs and possible configurations of VLANs.  

Packaging
=========
The driver is released in source RPM format. The file name for the
package is vlan-<version>.src.rpm and is dependent on the kernel
source code.


Kernel Source Code Setup
========================
The Linux VLAN driver requires the presence of the kernel source code
and configuring the kernel source before building the VLAN driver. The
following steps need to be done once for each kernel that is booted. For
example, if the current kernel is UP (uni-processor) and an SMP
(symmetrical-multi-processor) kernel is booted, these steps must be 
performed again to configure the kernel source for SMP before building
the VLAN driver for the SMP kernel.

	Red Hat installation:
	If the /usr/src/linux-<kernel-version> directory does not exist
	install the kernel source code per Red Hat instructions.  Once
	installed, follow the commands listed below to configure the
	kernel source to match the running kernel.

	# cd /usr/src/linux-<kernel_version>
	# make mrproper
	# make -e KERNELRELEASE=`uname -r` oldconfig
	# make -e KERNELRELEASE=`uname -r` dep

	UnitedLinux 1.0 Installation:
	If the /usr/src/linux-<kernel-version> directory does not exist
	please install the kernel source code per SuSE instructions.
	Once installed, please follow the commands listed below to setup
	the kernel source tree.

	# cd /usr/src/linux-<kernel_version>.SuSE
	# make mrproper
	# make cloneconfig
	# make dep

	SuSE SLES 7 Installation:
	If the /usr/src/linux-<kernel-version> directory does not exist
	please install the kernel source code per SuSE instructions.
	Once installed, please follow the commands listed below to setup
	the kernel source tree.

	# cd /usr/src/linux-<kernel_version>.SuSE
	# cp /boot/vmlinuz.config .config
	# cp /boot/vmlinuz.version.h include/linux/version.h
	# cp /boot/vmlinuz.autoconf.h include/linux/autoconf.h
	# make oldconfig
	# make dep

Installing the RPM Package
=============================
1. Check for the existence of a current version of the vlan package as
   follows:

        # rpm -q vlan

        If an old version of the package exists the RPM package should be
        removed.

        # rpm -e vlan

        Then remove the loaded vlan module.

        # rmmod 8021q.o

        Verify that the old vlan package has been removed as follows:

        # rpm -q vlan

2. Install the RPM source package.

	# rpm -ivh vlan-<version>.src.rpm

3. Change to the following directory and build the binary RPM for the
   VLAN driver.

   Red Hat

	# cd /usr/src/redhat
	# rpmbuild -bb SPECS/vlan.spec

   SuSE SLES 7 and UnitedLinux 1.0 Installations:

	Note: On UnitedLinux 1.0 installations, the g++ compiler
	does not get installed by default. Since the vlan package
	depends on the g++ compiler, please install the 
	gcc-c++-<version> rpm package before building the vlan binary
	rpm package.

        # cd /usr/src/packages
        # rpm -bb SPECS/vlan.spec

   Note: If an error is encountered while building the driver or this 
   directory doesn't exist, please refer to the "Kernel Source Code
   Setup" section of this document.

4. Install the new binary RPM package using the following command. Don't use
   the U (Upgrade) flag in the RPM command below - previous vlan drivers
   must be removed as described in step one above before installing this
   version.

   NOTE: To Preserve the current VLAN configuration ( if applicable ),
	the user is advised to backup the /etc/vlan.conf file before
	installing the new package and restore the file after the
	installation finishes. Please refer to the section on "Startup
	Scripts & VLAN Automation" section in vlan.txt for more
	details.

	# rpm -ivh RPMS/i386/vlan-<version>.i386.rpm --force

    The "force" rpm option is required since the VLAN driver is part of
    the kernel rpm.

4. The vlan ( Module Name: 8021q.o ) driver is installed in the
   /lib/modules/<kernel_version>/kernel/net/8021q directory.

VLAN Configuration
==================
   The VLAN driver can be configured either as a stand alone adapter or
   with a team of adapters using the Bonding driver.

   Please refer to the "VLAN Configuration (stand alone adapters)"
   section in vlan.txt for details on how to setup VLANs with stand
   alone adapters.

   Please refer to the "VLAN configuration (teamed with Bonding driver)"
   section in vlan.txt for details on how to setup VLANs in a teamed 
   environment using the Bonding driver.


Driver Messages
===============
The following messages will appear on the console when the 8021q.o
module loads:

      802.1Q VLAN Support V1.8 Ben Greear (greear@candelatech.com)

If the user attempts to configure VLANs without loading the 8021q.o
module, the following messages will appear on the console after which
the 8021q.o will automatically get loaded.

   WARNING: could not open /proc/net/vlan/config. Maybe you need to load 
	the 8021q module, or you are not using PROCFS
	802.1Q VLAN Support V1.8 Ben Greear (greear@candelatech.com)
	set name-type for VLAN subsystem. Should be visible in 
		/proc/net/vlan/config


Statistics
==========
Please refer to "Verification of VLAN Configuration" in vlan.txt for
detailed information regarding statistics and configuration information
of VLANs.


Limitations
===========
The "Limitations" Section of vlan.txt provides information on the
current limitations and some possible configuration changes that can
be done to avoid some limitations.

Uninstalling the RPM
====================
 
The following command will uninstall the vlan RPM.
 
     # rpm -e vlan

Copyright 2002, 2003  Hewlett-Packard Development Company, L.P.
Product names mentioned herein may be trademarks and/or registered
trademarks of their respective companies
