Netdisco - MIB Repository
Max Baker

---------------------------------------------------------------------------
UPGRADING MIB REPOSITORY
---------------------------------------------------------------------------
This document is to guide the process I go through to make a new version
of this repository.

---------------------------------------------------------------------------
RFC
---------------------------------------------------------------------------
Do the RFC mibs first so you can then remove the older versions 
that come with cisco's mibs, making sure you have the newest versions.

(From instructions inside of net-snmp)

1. wget http://easynews.dl.sourceforge.net/sourceforge/net-snmp/net-snmp-5.4.1.tar.gz
    (change 5.4.1 with newest version) 
   tar xvfz net-snmp*
   cd net-snmp*/mibs

2. Edit Makefile.mib
    Change PREFIX to .
    Change ALLDIR to rfc.orig
    Change INSTDIR to rfc

2.5. Update rfclist / ianalist
    See http://www.mail-archive.com/net-snmp-coders@lists.sourceforge.net/msg11519.html
    for background.

     i. Check for updates
        http://net-snmp.svn.sourceforge.net/viewvc/net-snmp/trunk/net-snmp/mibs/rfclist
        http://net-snmp.svn.sourceforge.net/viewvc/net-snmp/trunk/net-snmp/mibs/ianalist
    ii. Copy rfclist/ianalist from this package over if newer or use the above
    
3.  Download all IANA and RFC mibs into rfc/ dir

    make -f Makefile.mib rfc

4.  Check what's new.  sanity check, look at the output...
    
    diff_dir netdisco_mibs/rfc net-snmp*/mibs/rfc

5.  Copy new versions over old versions
    diff_dir netdisco_mibs/rfc net-snmp*/mibs/rfc 1

6.  Patch
    patch rfc < rfc1.diff

7.  Check
    ./chk_mibs rfc
    
    Fix and create new patches as necessary.

---------------------------------------------------------------------------
Cisco
---------------------------------------------------------------------------
1.  It seems that the .tar.gz files are horribly out of date, so we have to get the
individual files
    wget -r ftp://ftp-sj.cisco.com/pub/mibs/v2
    wget -r ftp://ftp-sj.cisco.com/pub/mibs/v1

2. Move the old dir out of the way
    mv cisco /tmp/cisco_old 

3. Make a new dir and unarchive
    mkdir cisco
    cd cisco
    tar xvfz ../v2.tar.gz
    tar xvfz ../v1.tar.gz

4. Remove Cruft
    rm -f *CAPABILITY.my
    rm -f *V1SMI.my
    rm -f CISCO-GENERAL-TRAPS.my

5. Remove duplicates
    Use cisco_remove as a good starting point
        for f in `cat cisco_remove`; do rm -f $f; done

    cd ..
    mkindex
    ./chk_dups > dups.txt    

    Review that file and make sure the newest file ends up in the right directory.
    Do not put non-cisco mibs in the cisco directory.

    Some cisco RFC's are updated and can be used, check to see which dups are left


All other duplicates in cisco/ are either out of date, modified
or exactly the same and should be removed.

    Remove the dups that don't diff
        ./mkindex
        ./rm_cisco_dups
        ./mkindex
        ./chk_dups

6. Move the original (CVS) directory back and then copy the new versions over.
    mv cisco cisco.new
    mv /tmp/cisco.old cisco
    cp -f cisco.new/* cisco
    rm -f cisco.new

7. Patch
    cd cisco
    patch < ../cisco1.diff
    patch < ../cisco2.diff
    rm -f *.rej *.orig
    cd ..

8. Check
    ./chk_mibs cisco

---------------------------------------------------------------------------
net-snmp:
---------------------------------------------------------------------------
    cp -f net-snmp*/mibs/*.txt net-snmp
    ./mk_index
    ./rm_cisco_dups mib_index.txt net-snmp
    ./chk_mibs net-snmp

---------------------------------------------------------------------------
HP
---------------------------------------------------------------------------
1. Get new MIBs from HP
    From: http://www.hp.com/rnd/software/MIBs.htm
          ftp://ftp.hp.com/pub/networking/software

2. Unarchive them into a new directory.  Set the old one aside for now.
    mv hp /tmp/hp.old
    mkdir hp.new
    cd hp.new && tar xvfZ ../mibs-*.tar.Z
    rm *.txt *.htm* cisco-* 
    chmod -x *

3. fix Case
    Some brain child decided to change the file names by capitalizing
    some letters along the way.  change to older all lower-case.

    cd hp.new
    ../to_locase *.mib
    
4. Check for the newest versions
    cd ..
    ./mkindex
    ./chk_dups

5. Remove older versions
    ./rm_cisco_dups mib_index.txt hp.new 
    ./mkindex
    ./chk_dups
     
6. Patch
    cd hp.new && patch < ../hp1.diff
    rm -f *.orig
    rm -f *.rej

7. Syntax check
    cd ..
    ./chk_mibs hp.new 
    Fix
    Create new patch

8. Copy over
    cp -f hp.new/* /tmp/hp.old
    rm -rf hp.new
    mv /tmp/hp.old hp

note: hp-sn-root-mib was missing in sept-07 update of mibs, probably needs an
update.

---------------------------------------------------------------------------
Package and Ship
---------------------------------------------------------------------------
1. Run one final set of checks
    ./mkindex
    ./chk_dups
    ./chk_mibs_all 2>&1 > check.txt

2. Update the VERSION code in README

3. CVS check in

4. cd .. & make mib-dist 

5. scp netdisco-mibs-VERSION.tar.gz user@frs.sourceforge.net:uploads

---------------------------------------------------------------------------
OTHER VENDORS NOTES
---------------------------------------------------------------------------
allied:
    I painstakingly merged AThub-mib and Allied 4.1 MIB together to form one
    ATI-MIB

aruba:
    ArubaOS 3.2.0 and AP80-PRIVATE-MIB

asante:

enterasys/cableron:
    From: ftp://ftp.enterasys.com/pub/snmp/mibs/ extract enterasys and cabletron
    directories.

extreme:
    v762b3 (01/09/06)
    From http://www.extremenetworks.com/products/mibs.aspx
    Run split-extreme to seperate into individual mib files.

nortel:
    Releases platform specific MIBs updated as required for specific software.
    The MIBs included are based on the following:
        Application Switch 3408 23.2 software (09/07)
        Ethernet Routing Switch 5510 version 5.1 software (09/07)
        Ethernet Routing Switch 1600 version 1.1 software
        BayRS MIBs version 15.5 software
        Centillion version 5.1.1 software
        Ethernet Routing Switch 8600 version 4.1 software (09/07)
        Nortel AP 2220 version 1.3 software     

    Use RAPID-CITY mib from the latest version of the 8600 product line since it
    has the largest feature set.  As of October 07, this requires a patch to
    identify 8300 series products (SF Patch [ 1815326 ]).
    
    patch rapid_city.mib < ../nortel.diff

    rm RFC* rfc*
    rm other rfcs in other names

foundry:
    FGL04000 (11/07)
    Run split-extreme to seperate into individual mib files.

juniper:
    - Looks like it needs a newer MPLS-LDP-MIB that has mplsLdpSesState as
      imported into JUNIPER-LDP-MIB

$Id: UPGRADE,v 1.10 2009/06/07 22:33:42 maxbaker Exp $
