============================
                           Installation Note
                     ============================

              Broadcom NetXtreme Gigabit Ethernet - Driver 
              compilation instructions for use with ZENworks
              (linux) for Desktops by Novell.

              Copyright (c) 2000-2003 Broadcom Corporation
                          All rights reserved.



You will need a full installation of Linux to be able to use the ZENworks
Linux Imaging Build scripts and compile the Broadcom driver for use with the
Linux kernel in ZENworks.  The limited Linux installation provided on the
ZEN partitions is not sufficient.

While any full version of Linux is sufficient, this document assumes you have
installed RedHat Linux v7.1. All step-by-step instructions given here will
assume this setup, but all steps should function on any version of Linux and
any graphical environment with slight modifications.

(NOTE:  The version of Linux shipped with ZENworks for Desktops is a generic
kernel with BSD- or GNU-licensed utilities and drivers.)

System Requirements:
The ZENworks Linux Imaging Build Scripts have no system requirements beyond
those of Linux itself.

Linux Installation:
During the Linux install, make sure you include the following optional features:
                                                                              
1.      Compilers and programmer tools.  These are required to build new
drivers and modify the kernel.  They are also required to upgrade your kernel
to version 2.4.18 with the Novell patches.

2.	A text editor.  This is required so that you can modify the various
scripts and read the documentation that comes with application packages.  The
editors "vi" and "emacs" come standard with Linux, but have steep learning
curves for novices.  We recommend "pico" for those that are uncomfortable
with "vi" and "emacs."

3.      Bash shell.  This is the default shell for RedHat Linux.

4.      Gzip and tar.  These are installed by default, and are used for
compression and archiving in the build scripts.

Build and Install Kernel version 2.4.18 with Novell Patches
ZENworks for Desktops ships with a modified version of the Linux kernel
v2.4.18.  It is necessary to have your Linux computer run this same kernel
in order to build new drivers for use with ZENworks. (All Linux drivers
compile differently based on the kernel used to compile them.)

You must apply the Novell patches to the kernel before rebuilding the kernel
in preparation to build the Broadcom driver.

This section tells you how to build and install the Linux kernel on your Linux
computer.  Additional steps are provided for applying the Novell patches.

1.      Obtain the file "linux-2.4.18.tar.gz" from www.kernel.org. Full path:
"/pub/linux/kernel/v2.4/linux-2.4.18.tar.gz" ,place it in the "/root"
directory of your Linux computer.

2.	Obtain the tarball "zfdimgkrnlpatch-2.4.18.tgz" from
<http://www.novell.com/coolsolutions/zenworks/resources_4.html>. Our testing
shows the patch for ZENworks 4 will allow you to compile the Broadcom driver
for use on ZENworks v4sp1 and ZENworks v3.2sp2.

3.      Untar the ZfDImgKrnlPatch-2.4.18.tgz tarball into the "/root" directory.  
cd /root
tar zxvf zfdimgkrnlpatch-2.4.18.tgz

4.	You should now have 2 files in your root directory:
zenpatch-2.4.18.patch and .config. (You will not be able to see .config unless
you use the "-a" option of "ls.")

5.      Extract the tarball which contains the Linux kernel.
cd /usr/src
tar zxvf /root/linux-2.4.18.tar.gz

6.	Copy the file zenpatch-2.4.18.patch to the directory "/usr/src/linux"
and apply the patch.

cd /usr/src/linux
cp /root/zenpatch-2.4.18.patch .
patch -p0 < zenpatch-2.4.18.patch

7.	Copy the ".config" supplied within the ZENworks patch to the directory
"/usr/src/linux."

cd /usr/src/linux
cp /root/.config .

8.	Use the following steps to build the kernel and all modules:
make dep
make bzImage
make modules
make modules_install

9.	Copy the new kernel (/usr/src/linux/arch/i386/boot/bzImage) to your
"/boot" directory and modify your "/etc/lilo.conf" file to allow you to boot
the new kernel.  See the Linux man pages for help. It is suggested that you
make an additional configuration to preserve the current linux kernel. This
will enable you to test the new kernel while allowing you to boot the
currently installed kernel. Run "lilo" to save the new configuration contained
in the lilo.conf file.

10.	Reboot your computer into the new kernel.

11.	Verify that you are now running kernel version 2.4.18:
uname -r

12.     Obtain a copy of the Broadcom linux driver bcm5700-<version>.tar.gz
and copy it to a temporary directory.

13.     Extract the Broadcom files to the temporary directory:
cd /<temporary directory>
tar xvzf bcm5700-<version>.tar.gz

14.     Build the driver bcm5700.o as a loadable module for the running kernel:
cd /<temporary directory>/src
make clean
make

15.     The resulting bcm5700.o file can now be copied and used on your
linux based ZENworks system.



Broadcom NetExtreme is a registered trademark of Broadcom Corporation 
and/or its subsidiaries in the United States and certain other countries.
Novell and ZENworks are registered trademarks of Novell, Inc. RedHat Linux
is a trademark of Red Hat, Inc. All other trademarks are the property of
their respective owners. 

Broadcom Corporation disclaims any proprietary interest in trademarks
and trade names other than its own.