# mib2zabbix

This Perl script will generate a Zabbix Template in XML format for an OID tree
in an SNMP MIB file.

### Usage

    mib2zabbix.pl [ -l | -t ] -o <OID> [OPTIONS]...

    Export loaded SNMP MIB OIDs to Zabbix Template XML

        --export-maps           export value maps directly to Zabbix database
    
        -t, --template          generate a Zabbix template
        -f, --filename=PATH     output filename (default: stdout)
   
        -N, --name=STRING       template name (default: OID label)
        -G, --group=STRING      template group (default: 'Templates')
        -e, --enable-items      enable template items (default: disabled)
                                * enable with caution *
    
        -o, --oid=STRING        OID tree root to export
    
        -v, --snmpver=1|2|3     SNMP version (default: 1)
        -p, --port=PORT         SNMP UDP port number (default: 161)

    SNMP Version 1 or 2c specific

        -c, --community=STRING  SNMP community string (default: 'public')

    SNMP Version 3 specific

        -L, --level=LEVEL           security level (noAuthNoPriv|authNoPriv|authPriv)
        -n, --context=CONTEXT       context name
        -u, --username=USERNAME     security name
        -a, --auth=PROTOCOL         authentication protocol (MD5|SHA)
        -A, --authpass=PASSPHRASE   authentication protocol passphrase
        -x, --privacy=PROTOCOL      privacy protocol (DES|AES)
        -X, --privpass=PASSPHRASE   privacy passphrase
    
        --check-delay=SECONDS   check interval in seconds (default: 300)
        --disc-delay=SECONDS    discovery interval in seconds (default: 86400)
        --history=DAYS          history retention in days (default: 365)
        --trends=DAYS           trends retention in days (default: 3650)
    
        -h, --help              print this message

### Requirements

* Perl v5+
* Pod::Usage
* XML::Simple
* Net-SNMP
* Correctly configured [MIB files](http://net-snmp.sourceforge.net/tutorial/tutorial-5/commands/mib-options.html)

### Translations

* Scalar OID -> Zabbix SNMP Item
* Table OID -> Zabbix SNMP Discovery Rule
* Table Column OID -> Zabbix Discovery Prototype
* Trap/Notification OID -> Zabbix SNMP Trap Item 
* OID Enums -> Zabbix Value Map