Read Me

MIB Parser Script

v2.0 8/29/10

DESCRIPTION:
mibParser will parse mibs in a user specified directory, and create the 
desired mib analysis spreadsheet.  The user is expected to provide a file preface 
name as well as mib directory. When the file is created, it will be created as:
		filePrefaceName.xls
The spreadsheet workbook will contain the following sheets
1) MibStats - this sheet contains the mib directory, mib filename, mib module name, 
	number of v1 traps and the number of v2 notifications.
2) MibVars - this sheet contains the variable descriptions for all 
	of the variables in the mibs.
3) Traps - this sheet contains the trap analysis info.
4) TrapVars - this sheet contains the variable descriptions for all 
	of the traps/notifications.


INSTALLATION:
1) Install ActiveState perl 5.10.1.1006 by invoking ActivePerl-5.10.1.1006-MSWin32-x86-291086.msi
This package can be found at 
http://www.activestate.com/Products/Download/Download.plex?id=ActivePerl
Please follow all defaults.
2) Install Spreadsheet::WriteExcel v2.37 perl module by invoking
ppm install Spreadsheet::WriteExcel
3) Install UCD Net-SNMP 5.5.0 by invoking net-snmp-5.5.0-1.x86.exe
This package can be found at 
http://prdownloads.sourceforge.net/net-snmp/net-snmp-5.5.0-1.x86.exe?download
Please follow all defaults.
3) Verify both installations by bringing up a dos command prompt, and typing the following
cd c:\usr\perl
ppm install NetSNMP.ppd
net-snmp-perl-test.pl

The test should result in a success message.
It is recommended that you place the mibParser.pl in the c:\usr\bin directory.
UPGRADING FROM A PREVIOUS VERSION:
Simply copy the new mibParser.pl script from the zip file over your old mibParser.pl script.
Ensure that you have the proper version of ActiveState Perl and net-snmp.

UNINSTALLING:
1) Delete your mibParser.pl script.
2) Uninstall activePerl according to the activePerl instructions.


USING mibParser.pl:
Bring up a dos command prompt, and cd to the directory that you placed mibParser.pl.  Invoke
mibParser.pl without any arguments to get the instructions.


For problems contact:
Carmody Quinn
carmody.quinn@opennet.com
Please include any related mibs or output files with a detailed description of the problem.

KNOWN PROBLEMS:
* net-snmp compiler cannot handle embedded comments - so get rid of multiple dashes within 
comment statements
* it is illegal to have redundant module definitions - do not have 2 versions of the same mib
in the directory or else you will have a mismatch on total number of events in mibstats and 
number of events found in the rulesAnalysis file.
* MIBs are not supposed to have underlines in labels.  To support illegal underlines, 
alter your net-snmp configuration snmp.conf file (see net-snmp help).

##############################################################################
# HISTORY:
#
# v1.0 CHANGES - 3/30/05:
# * Initial draft.
# v2.0 CHANGES - 8/29/10:
# * Add output to excel spreadsheet.
##############################################################################