                  ===========================
                  R E L E A S E    N O T E S
                  ===========================

          Broadcom Advanced Server Program (BASP) SNMP Agent
                 for Linux 2.2.x and 2.4.x kernel
                        Version 1.0.2

            Copyright (c) 2002 Broadcom Corporation
                     All rights reserved.
                       Jan 22, 2003

Table of Contents
-----------------
    Overview
    Limitation
    Install - TAR archive
    Install - RPM package
    Files
    Uninstall - RPM package
    Logs


Overview
--------
This SNMP agent is designed to support the configuration and 
statistics information pertaining to the Broadcom BASP driver.

BASP is a kernel module designed for the Linux 2.2.x and 2.4.x kernel that
provides load-balancing, fault-tolerance, and VLAN features. These features
are provided by creating teams that consist of multiple NIC interfaces.

BASP SNMP agent is available in two packaging formats: TAR archive and 
RPM. Both packages include the exact same script and MIB files.


Install - TAR archive
---------------------
To uncompress and expand the tar archive, run

    % tar xvf baspsnmp-{version}.tar

The installation process involves the following steps:

(1) Copy the getBaspInfo and genBaspTraps script files into /usr/bin 
    directory.

(2) Copy the BASP-Config-MIB.txt, BASP-Statistics-MIB.txt and 
    Brcm-BSAPTrap-MIB.txt into the /usr/share/snmp/mibs directory.

(3) Locate the snmpd.conf file.  It is normally located at:
    /etc/snmp or /usr/lib/snmp or $HOME/.snmp and add the following 
    lines to the snmpd.conf.
    
    pass .1.3.6.1.4.1.4413.1.2.1 /usr/bin/getBaspInfo
    pass .1.3.6.1.4.1.4413.1.2.2.1 /usr/bin/getBaspInfo
    pass .1.3.6.1.4.1.4413.1.2.2.2 /usr/bin/getBaspInfo
    pass .1.3.6.1.4.1.4413.1.2.2.3 /usr/bin/getBaspInfo

(4) Stop the snmpd daemon and restart it again.

    % /etc/init.d/snmpd stop
	% /etc/init.d/snmpd start

(5) Run the genBaspTraps script to allow monitoring of the BASP trap 
    events:
    
    % genBaspTraps 
    
    This script can be terminated by hitting Ctrl-C keys if	BASP trap event 
    monitoring is no longer needed.

(6) snmpget and snmpgetnext command can be used to receive the BASP snmp
    objects such as:

    % snmpget localhost public BASP-Config-MIB::btTeamNumber
    % snmpgetnext localhost public BASP-Config-MIB::btTeamNumber

    BASP SNMP objects are provided in the 
    
    BASP-Config-MIB.txt, 
    BASP-Statistics-MIB.txt
	Brcm-BSAPTrap-MIB.txt


Install - RPM package
---------------------
Complete the following steps to install BASP SNMP agent from the RPM package.

(1) To install the RPM package, run

    % rpm -i baspsnmp-{version}.i386.rpm

    The BASP script and MIB files will be installed.  The snmpd.conf 
    configuration file will me modified to add support for the BASP SNMP agent.

(2) Follow steps 4 - 6 in the "Install - TAR Archive" section.

Caveat:
  The current RPM installation fails to append the additional directives needed 
  to the snmpd.conf file to support Basp objects.  Thus please follow the 
  instruction (3) in the Install - TAR archive to modify the snmpd.conf file.


Files
-----
    genBaspTrap			script monitoring the BASP trap events
    getBaspInfo	                script to process SNMP get/getnext inquiries
    BASP-Config-MIB.txt,        SNMP MIB file for BASP configuration objects
    BASP-Statistics-MIB.txt     SNMP MIB file for BASP statistics objects
    Brcm-BSAPTrap-MIB.txt       SNMP MIB file for BASP trap objects
    release.txt                 this file


Uninstall - RPM package
-----------------------
To uninstall RPM package, 

    % rpm -e baspsnmp-{version}.i386.rpm

and to reboot the system,

    % reboot


Logs
----
v1.0.2
- Converted all DOS formatted files to Linux format.

v1.0.1
- Changed Tar options described in the release.txt file.

v1.0.0
- The current RPM installation fails to append the additional directives needed 
  to the snmpd.conf file to support Basp objects.  Thus please follow the 
  instruction (3) in the Install - TAR archive to modify the snmpd.conf file.

