README for IBM Network Dispatcher, Dispatcher Component for Red Hat Linux

This README contains late-breaking information that is not included in the
documentation that is available on the Web site.
-------------------------------------------------------------------------------

To get the latest version of the Network Dispatcher product with any fixes,
go to www.software.ibm.com/network/dispatcher/downloads/.


TROUBLESHOOTING:
---------------
1) When defining a collocated server in a Network Dispatcher machine which
   contains multiple network interface adapters, you must define the server
   in the Network Dispatcher cluster/port/server hierarchy using the
   Non-Forwarding Address (NFA) of the Network Dispatcher machine or set 
   collocated to yes, otherwise unexpected results can occur.
2) The MIB, ibmENetDispatcherMIB.01, will not load using Tivoli NetView
   xnmloadmib2 program.  To fix this problem, comment out the
   NOTIFICATION-GROUP section of the MIB.  That is, insert '--' in front
   of the line "indMibNotificationsGroup NOTIFICATION-GROUP", and the
   6 lines which follow.
3) Unexpected GUI behavior: 
   Under some circumstances, the GUI may display duplicate nodes.  To correct,
   stop all Dispatcher clients and servers, stop any remaining Dispatcher Java 
   processes, and restart the servers and clients.  Also, upgrading the level
   of Java frequently corrects this problem.


DOCUMENTATION:
--------------
1) For command line and GUI parameter values: Parameter values must be entered in 
   English characters.  The only exceptions are hostnames (used in cluster, server, 
   high availability commands and panels) and filenames (used in file commands and 
   panels.)
2) Command line syntax correction to Network Dispatcher User's Guide, Appendix B.
   Number 7 in the list should read: rule add {c:p:r} type port
3) Command line syntax correction to Network Dispatcher User's Guide, Chapter 8,
   section "Using remote advisors with wide area support."  Correct syntax for
   example of aliasing the cluster address to the loopback adapter for Linux is:  
    ifconfig lo:1 9.67.34.123 netmask 255.255.255.255 up
   (Note: netmask must be 255.255.255.255 and "alias" should not appear in 
   command line.)
4) Under configuration example for configuring wide area Dispatcher support 
   (correction for IBM Network Dispatcher User's Guide):  Network Dispatcher
   does not support Token ring LAN for Red Hat Linux. Assume the example is
   for an Ethernet connection.
5) For Linux kernel versions 2.2.12 and 2.2.13: Command line syntax correction 
   to Network Dispatcher User's Guide, Chapter 5, section "Installing the 
   Linux Kernel Patch (for aliasing the loopback device)." Step 8 should be:
      echo 1 > /proc/sys/net/ipv4/conf/lo/arp_invisible
6) For Linux kernel versions 2.2.14 or higher: No Linux kernel patch
   is required. However, there are special instructions to alias the
   loopback device on back end servers that were omitted from Network
   Dispatcher User's Guide, Chapter 5, "Step 1. Alias the loopback
   device." The following steps must be performed for Linux kernel
   versions 2.2.14 or higher: 
    a.) Issue the following commands -
          echo 1 > /proc/sys/net/ipv4/conf/all/hidden
          echo 1 > /proc/sys/net/ipv4/conf/lo/hidden
        These commands will only last until the machine is rebooted.
        Once rebooted, it will be necessary to rerun this and the
        following command. 
    b.) Alias the loopback device -
          ifconfig lo:1 cluster netmask 0.0.0.0 up 
7) Correction to the subdirectory listed for running a custom advisor (Network 
   Dispatcher User's Guide, Chapter 8, section "Create custom (customizable)
   advisors."  To run the custom advisor, you must first copy the class file to the
   proper subdirectory of the Dispatcher or CBR component. The correct subdirectory
   for the example is:
   lib/CustomAdvisors/ADV_fred.class
8) For high availability (and mutual high availability), at least one heartbeat
   pair must have the NFAs of the pair as the source and destination address.