head	1.1;
access;
symbols;
locks; strict;
comment	@# @;


1.1
date	99.02.10.15.35.58;	author trockij;	state Exp;
branches;
next	;


desc
@@


1.1
log
@Initial revision
@
text
@$Id$

Introduction
------------

A3Com is a set of Perl 5 modules which allow manipulation of 3Com
SuperStack II 3900/9300 and CoreBuilder 3500 LAN switches. Currently
there are modules which can use either the SNMP or telnet interface to
query the ARP tables, dump bridge tables, change passwords in batch mode,
and collect per-port ethernet details like current autonegotiation mode
and duplex settings.

A3Com requires:

    -the Perl Expect, available from CPAN
    -the UCD SNMP libraries, http://www.ece.ucdavis.edu/ucd-snmp/
    -Joe Marzot's SNMP-1.8 Perl 5 module, available from CPAN
	and ftp://ftp.corpeast.baynetworks.com/netman/snmp/perl5/SNMP.tar.gz

You switches must be configured to have "inifinte" screen height in
order to collect. Log in as "adm" and type the following:

Select menu option: sys screen 0 y
Do you want this to be the new default screen height (n,y) [y]: 


Installation
------------

perl Makefile.PL
make
make install


Examples
--------

In the examples/ directory are the following:

a3compasswd
    Allows changing of adm passwords on switches in batch-mode. Supply
    a list of switches on the command line.

btdump
    This dumps bridge tables for a list of switches, or searches for the
    port where a particular IP address, hostname, or MAC address is seen.
    You'll need to configure where your routers are by modifying the
    sections where it says "$helium = new A3Com::ARP" and
    "$hydrogen = new A3Com::ARP".


Documentation
-------------

Someone needs to write it.


Future Plans
------------

I'm currently working on the historical storage of ARP data (including
conflicts and changes), and the historical tracking of bridge table
port/MAC mappings.

Good luck. You'll need it.


Jim Trocki <trockij@@transmeta.com>
Computer System and Network Engineer
Transmeta Corporation
Santa Clara, CA
@
