...
model_discovery.pl was released in NMIS8.7.0G but was early version, check with Opmantek Support or grab a more recent version from GitHub:model_discovery.pl
Automated Base Model Detection and Creation
This tool started a little more generically but it can now generate a base model automatically. Based on what it discovers, when starting with a new device type to become and NMIS node this is where you should start, it will take a default model and add all the things it can find which are already modelled, this would include things from the standard MIBs. First add your new thing into NMIS and get SNMP working, NMIS will use the Default model for this node which means SNMP is working and you can get more!
For example where ASGARD is the name of your node in NMIS.
| Code Block |
|---|
/usr/local/nmis8/admin/model_discovery.pl node=ASGARD model=CiscoRouter-auto common_exclude="Windows|^tcp" |
A file called /usr/local/nmis8/models/Model-CiscoRouter-auto.nmis would be created, you can now edit the node in Nodes.nmis and change model from auto to be CiscoRouter-auto and use this model.
You probably want to add some additional graphs to the nodegraph element but that can come later.
Discover What Existing Models Work on an NMIS Node
What existing modelling is there which could be useful. For example where ASGARD is the name of your node in NMIS.
| Code Block |
|---|
/usr/local/nmis8/admin/model_discovery.pl node=ASGARD file=/tmp/ASGARD.txt errors=false |
The resulting file is a TAB delimited CSV and looks like below, it will help you understand which other existing modelling might work on this node :
| node | nodeModel | Type | File | Path | Supported | SNMP_Object | SNMP_OID | OID_Used | result |
| ASGARD | CiscoRouter | system | Common-Cisco-netflow.nmis | Common/system/rrd/NetFlowStats/snmp/PktsExported | YES | 1.3.6.1.4.1.9.9.387.1.4.4.0 | 1.3.6.1.4.1.9.9.387.1.4.4.0 | 1.3.6.1.4.1.9.9.387.1.4.4.0 | 307129 |
| ASGARD | CiscoRouter | system | Model-CatalystIOS.nmis | Model/system/rrd/nodehealth/snmp/RouteNumber | YES | ipCidrRouteNumber | 1.3.6.1.2.1.4.24.3 | 1.3.6.1.2.1.4.24.3 | 18 |
| ASGARD | CiscoRouter | system | Common-mib2ip.nmis | Common/system/rrd/mib2ip/snmp/ipFragFails | YES | ipFragFails | 1.3.6.1.2.1.4.18 | 1.3.6.1.2.1.4.18 | 0 |
| ASGARD | CiscoRouter | system | Common-tcp.nmis | Common/system/rrd/tcp/snmp/tcpActiveOpens | YES | tcpActiveOpens | 1.3.6.1.2.1.6.5 | 1.3.6.1.2.1.6.5 | 15892 |
| ASGARD | CiscoRouter | system | Common-mib2ip.nmis | Common/system/rrd/mib2ip/snmp/ipForwDatagrams | YES | ipForwDatagrams | 1.3.6.1.2.1.4.6 | 1.3.6.1.2.1.4.6 | 141405097 |
| ASGARD | CiscoRouter | system | Model-CGESM.nmis | Model/system/rrd/nodehealth/snmp/avgBusy1 | YES | avgBusy1 | 1.3.6.1.4.1.9.2.1.57 | 1.3.6.1.4.1.9.2.1.57 | 8 |
| ASGARD | CiscoRouter | system | Model-CircuitMonitor.nmis | Model/system/sys/modem/snmp/InstalledModems | YES | cmSystemInstalledModem | 1.3.6.1.4.1.9.9.47.1.1.1 | 1.3.6.1.4.1.9.9.47.1.1.1 | 0 |
| ASGARD | CiscoRouter | system | Common-mib2ip.nmis | Common/system/rrd/mib2ip/snmp/ipReasmReqds | YES | ipReasmReqds | 1.3.6.1.2.1.4.14 | 1.3.6.1.2.1.4.14 | 0 |
| ASGARD | CiscoRouter | system | Model-ACME-Packet.nmis | Model/system/sys/standard/snmp/sysDescr | YES | sysDescr | 1.3.6.1.2.1.1.1 | 1.3.6.1.2.1.1.1 | Cisco IOS Software, 1841 Software (C1841-ADVENTERPRISEK9-M), Version 12.4(25f), RELEASE SOFTWARE (fc2)\nTechnical Support: http://www.cisco.com/techsupport\nCopyright (c) 1986-2011 by Cisco Systems, Inc.\nCompiled Tue 16-Aug-11 06:21 by prod_rel_team |
| ASGARD | CiscoRouter | system | Common-Cisco-netflow.nmis | Common/system/rrd/NetFlowStats/snmp/SampledPacket | YES | 1.3.6.1.4.1.9.9.387.1.4.1.0 | 1.3.6.1.4.1.9.9.387.1.4.1.0 | 1.3.6.1.4.1.9.9.387.1.4.1.0 | 0 |
| ASGARD | CiscoRouter | systemHealth | Common-Cisco-cbqos.nmis | Common/systemHealth/sys/Cisco_CBQoS | YES | cbQosIfType | 1.3.6.1.4.1.9.9.166.1.1.1.1.2 | 1.3.6.1.4.1.9.9.166.1.1.1.1.2 | $VAR1 = { '1.3.6.1.4.1.9.9.166.1.1.1.1.2.1085' => 1 }; |
| ASGARD | CiscoRouter | system | Model-CGESM.nmis | Model/system/rrd/nodehealth/snmp/bufferElFree | YES | bufferElFree | 1.3.6.1.4.1.9.2.1.9 | 1.3.6.1.4.1.9.2.1.9 | 1117 |
| ASGARD | CiscoRouter | system | Common-mib2ip.nmis | Common/system/rrd/mib2ip/snmp/ipReasmOKs | YES | ipReasmOKs | 1.3.6.1.2.1.4.15 | 1.3.6.1.2.1.4.15 | 0 |
| ASGARD | CiscoRouter | system | Common-Cisco-system.nmis | Common/system/sys/extra/snmp/chassisVer | YES | chassisVersion | 1.3.6.1.4.1.9.3.6.2 | 1.3.6.1.4.1.9.3.6.2 | 7 |
And what modelling will NOT work on this node.
| node | nodeModel | Type | File | Path | Supported | SNMP_Object | SNMP_OID | OID_Used | result |
| ASGARD | CiscoRouter | system | Model-Teldat-iM8.nmis | Model/system/rrd/modem/snmp/InstalledModem | NO | 1.3.6.1.4.1.2007.1.2.1.5 | 1.3.6.1.4.1.2007.1.2.1.5 | 1.3.6.1.4.1.2007.1.2.1.5 | noSuchObject |
| ASGARD | CiscoRouter | system | Model-PulseSecure.nmis | Model/system/sys/extra/snmp/iveTotalHits | NO | 1.3.6.1.4.1.12532.14.0 | 1.3.6.1.4.1.12532.14.0 | 1.3.6.1.4.1.12532.14.0 | noSuchObject |
| ASGARD | CiscoRouter | systemHealth | Model-AlcatelASAM.nmis | Model/systemHealth/sys/eqptBoard | NO | eqptSlotPlannedType | 1.3.6.1.4.1.637.61.1.23.3.1.2 | 1.3.6.1.4.1.637.61.1.23.3.1.2 | $VAR1 = undef; |
| ASGARD | CiscoRouter | systemHealth | Common-Cisco-memory.nmis | Common/systemHealth/sys/ciscoMemoryPool | NO | MemPoolName | $VAR1 = undef; | ||
| ASGARD | CiscoRouter | system | Model-HuaweiSwitchesCore.nmis | Model/system/rrd/nodehealth/snmp/hwMemoryDevFree | NO | 1.3.6.1.4.1.2011.6.3.5.1.1.2.0.1.0 | 1.3.6.1.4.1.2011.6.3.5.1.1.2.0.1.0 | 1.3.6.1.4.1.2011.6.3.5.1.1.2.0.1.0 | noSuchObject |
| ASGARD | CiscoRouter | system | Model-Eltek.nmis | Model/system/rrd/power/snmp/ACMains | NO | 1.3.6.1.4.1.12148.9.7.1.11.0 | 1.3.6.1.4.1.12148.9.7.1.11.0 | 1.3.6.1.4.1.12148.9.7.1.11.0 | noSuchObject |
| ASGARD | CiscoRouter | system | Model-CiscoASR.nmis | Model/system/rrd/nodehealth/snmp/avgBusy1 | NO | cpmCPUTotal1minRev.2 | 1.3.6.1.4.1.9.9.109.1.1.1.1.7.2 | 1.3.6.1.4.1.9.9.109.1.1.1.1.7.2 | noSuchInstance |
| ASGARD | CiscoRouter | system | Model-MGE-ups.nmis | Model/system/rrd/upsvolt/snmp/upsinputvolt3 | NO | upsInputVoltage.3 | 1.3.6.1.2.1.33.1.3.3.1.3.3 | 1.3.6.1.2.1.33.1.3.3.1.3.3 | noSuchObject |
| ASGARD | CiscoRouter | systemHealth | Common-lldp.nmis | Common/systemHealth/sys/lldpLocal | NO | lldpLocPortDesc | 1.0.8802.1.1.2.1.3.7.1.4 | 1.0.8802.1.1.2.1.3.7.1.4 | $VAR1 = undef; |
| ASGARD | CiscoRouter | systemHealth | Model-f5big_ip.nmis | Model/systemHealth/sys/F5_CPU | NO | sysPlaneStatEntry | .1.3.6.1.4.1.3375.2.1.12.2.2.1 | .1.3.6.1.4.1.3375.2.1.12.2.2.1 | $VAR1 = undef; |
Check the Existing Models
...
| Code Block |
|---|
/usr/local/nmis8/admin/modelcheck.pl
--snip--
Processing /usr/local/nmis8/models/Common-Windows-interface.nmis
Processing /usr/local/nmis8/models/Model-TELDATL1.nmis
String found where operator expected at (eval 483) line 38, near "}
'calls'"
(Missing operator before
'calls'?)
Processing /usr/local/nmis8/models/Graph-lockstat.nmis
--snip-- |
Show the model Structure
Useful for some people
| Code Block |
|---|
/usr/local/nmis8/ |
| Code Block |
-rwxrwx--- 1 nmis nmis 20864 Jun 1 17:57 admin/model_discovery.pl -rwxrwx--- 1 nmis nmis 1573 Oct 24 2018 admin/show_model_structure.pl -rwxrwx--- 1 nmis nmis 17324 Dec 4 18:39 admin/upgrade_models.pl |