FILE NAME: vlan-1.8.0-3.src.rpm TITLE: HP Tested and Approved Linux 802.1q VLAN Driver VERSION: 1.8.0-3 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 NC6770 Gigabit Server Adapter (bcm5700) HP NC7131 Gigabit Server Adapter (e1000) HP NC7132 Gigabit Server Adapter (e1000) HP NC7760 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.18-24 (SMP,UP and BigMem) Red Hat Linux 7.3 Professional - Errata kernel 2.4.18-24 (SMP,UP and BigMem) Conectiva Linux Enterprise Edition, SCO Linux 4.0, SuSE Linux Enterprise Server 8 and Turbolinux 8 all powered by UnitedLinux 1.0. PREREQUISITES: Pentium based computer 128MB RAM minimum Latest HP system ROM bcm5700 driver version 6.0.2a e100 driver version 2.1.29b e1000 driver version 4.4.19c Note: Please visit the following URL to upgrade the ROM http://h18000.www1.hp.com/support/files EFFECTIVE DATE: 03/14/2003 SUPERSEDES: vlan-1.7.0-6.src.rpm DESCRIPTION: This RPM Package contains the HP Tested and Approved Linux 802.1q VLAN driver for use with HP Server Adapters mentioned in the PRODUCTS AFFECTED section of this document ENHANCEMENTS/FIXES: Documentation enhancements Table of Contents ================= Introduction Packaging Kernel Source Code Setup Installing Source 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 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-.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- 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- # make mrproper # make -e KERNELRELEASE=`uname -r` oldconfig # make -e KERNELRELEASE=`uname -r` dep UnitedLinux 1.0 installation: If the /usr/src/linux- directory does not exist please install the kernel source code per UL 1.0 instructions. Once installed, please follow the commands listed below to setup the kernel source tree. # cd /usr/src/linux-.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 Source RPM Package ============================= 1. Install the RPM source package. # rpm -ivh vlan-.src.rpm 2. 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 UnitedLinux 1.0 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++- 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. 3. Install (Upgrade) the new binary RPM package using the following command. NOTE: To Preserve the current VLAN configuration ( if applicable ), the user is advised to backup the /etc/vlan.conf file before upgrading to the new package and restore the file after the upgrade finishes. Please refer to the section on "Startup Scripts & VLAN Automation" section in vlan.txt for more details. # rpm -Uvh RPMS/i386/vlan-.rpm --force The "force" rpm option is required since the VLAN driver is part of the kernel rpm. 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) All bugs added by David S. Miller (devem@redhat.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) All bugs added by David S. Miller (devem@redhat.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