                    D-Link Software v1.2 for Linux
                            April 10, 2002

This version of the D-Link Software for Linux provides Load Balancing and 
Failover. This version currently supports Linux Kernel versions 2.2.18,
2.2.19, and 2.4.2 through 2.4.16. In order for the 2.2 versions to work,
you must download a patch for each version. They are located at 
http://bridge.sourceforge.net. Select kernel patches and download 
bridge-0.0.9-against-2.2.18.diff or ~.19.diff files. Apply each patch to the 
appropriate kernel. You will need to do this before performing step #2 below. 
These patches are only required for the 2.2.18 and 2.2.19 versions.
 
The installation will ask you if you want to automatically configure your
network interfaces. If you want all interfaces placed into a single group
with (eth0) as the primary interface, then answer "yes". If you answer "yes",
the group will also be assigned the IP of eth0. Therefore, you need to
make sure that eth0 contains the IP address you want to propagate to your
network. If you answer "no", a utility will run that will allow you to create
1 or more groups and will allow you to select the primary adapter for each
group. 

D-Link has provided script files to install and uninstall D-Link Software for
Linux. Please perform the following steps before installing the product.

 1) Ensure that the desired Kernel version is installed and is a loadable 
    option on your Linux system. If you are building kernel versions
    2.4.7-10 or 2.4.9-21, edit the Makefile located in the directory
    /usr/src/linux.  On the fourth (4th) line, remove the word "custom"
    from behind the -10 or -21.

 2) Run 'make menuconfig' to make sure 'mod versions' are disabled and to
    set 802.1d Ethernet Bridging to 'module'. You must be in the /usr/src/linux
    directory to run this configuration tool. To check for 'mod versions', you
    select 'Loadable Module Support' from menuconfig's main selection window.
    Make sure that 'Set version information on all module symbols' is empty. 
    Then from the main selection window, select the 'Networking Options'. Find 
    the 802.1d Ethernet Bridging and select 'M'. Bridging is not performed, we 
    are just enabling the bridging hooks so the D-Link Software can use them.

 3) Save this configuration, rebuild the kernel ('make dep clean bzlilo'), and 
    reboot the system.

 4) Place the DLink.bin on your hard drive and run ./DLink.bin. This
    install script will validate your current kernel configuration to 
    determine if it is configured correctly for D-Link Software.
    Follow the installation steps to setup and install D-Link Software.
    You are provided with the option to load the product
    immediately or instructions on how to install at a later time.

    If the actions required in step #2 are were not performed, the install
    process will fail with error messages.

 5) D-Link has provided two interfaces to monitor the D-Link Software.
    The first is a console interface called nexcui. This will show
    the current status of the NICs and their statistics.  If you
    would like to see the statistics continously updated, use the -c
    option. To exit the console interface, press Control-Z. Other options
    can be seen by using the -? option. 
	
    The other interface is a graphical interface written in Java.  Since the 
    standard Linux distributions do not include Java, you must download the 
    Java Runtime Environment (JRE) from Sun Microsystems.  To download the JRE,
    go to http://java.sun.com/j2se/1.3/jre/download-linux.html. From this page 
    you can download the JRE in a RedHat RPM file or in a GZip tar file. The 
    instructions for installing either file are also on that page. The
    installation should place all files in the /usr/java/jre1.3.1_01/ 
    directory. To launch the java interface from a command line, execute the 
    shell script called nexjui.  There has been a few users that have reported 
    errors running the nexjui script.  To resolve the problem, change 
    directory to /usr/local/DLink/UI and enter the command
      /usr/java/jre1.3.1_02/bin/java NicX

    Symbolic links have been created for these two interface methods and can be
    executed from anywhere.

 6) To unload the D-Link Software driver, run nexunload. After unloading the
    software, verify the IP addresses on your ethernet interfaces. 

 7) D-Link has provided a utility to re-configure your arrays/groups.
    With the utility, nexconfig, you can configure multiple groups, define
    the primary adapter for each group and define the default gateway IP
    address for each group.

