====== Rate NAVs product support ======

FIXME
''This page is not finished (and may not ever be) - please ignore it for the time being
''

====== Introduction ======

We have put a lot of effort into making the SNMP collection system as general as possible. All SNMP OIDs are i.e.
structured in a separate OID database. Whenever possible we have chosen standard MIBs for our collection. In certain
circumstances however, this is not possible and proprietary vendor MIBs are used. There may also be cases when
a proprietary MIB is used even when not neccessary. If so, we should improve.

As evident NAV has its outspring from a Cisco based environment. HP support is also good. We would like to strengthen support for other vendor's equipment as well. With our
general design we are optimistic. Added support can in many cases be done with not so much work.

We do however need help in this process! We need help to test and verify the extent of support for equipment
types that are familiar to NAV. And we need assistance in pinpointing what OIDs we should use for new equipment.

As seen on this page, NAV support for a product can be characterized by many attributes (of varying importance). We describe over 20 different features that NAV are able to support. Keep in mind that we here are addressing the basic support for individual boxes, not the value added ability of understanding the intercennection between boxes, the layer 3 structere or the vlan topologies.

===== Inspiration =====

We are inspired by the [[http://snmp-info.sourceforge.net/DeviceMatrix.html|NetDisco product page]]. For long we
have wanted a simular overview of our own. This is our brave attempt :)


====== List of NAV supported products ======

And here is our ProductsSupported page.


====== List of attributes ======

Here is a list of attributes that NAV can support. The list is organized into four categories; box, router ports, switch ports and module attributes.

 || **Category** ||**Attribute** ||  **Description** ||
 || box  || serial || Serial number  ||
 || box  || sw || Software version ||
 || box  || mem || Memory information, including //statistics// ||
 || box  || cpu || CPU //statistics//  ||
 || box  || temp || Temperature //statistics//  ||
 || box  || cdp || CDP data (in the future we would like to see LLDP support)||
 || router port  || ports || All router ports with ifindex, interface name, speed, gateway IP address ||
 || router port  || descr || Router port description (ifAlias, will be stored raw in NAV 3.2) ||
 || router port || hsrp || Support for Cisco HSRP (we would like to see VRRP support)||
 || router port || metric || Support for OSPF metrics (we would like to see ISIS support) ||
 || router port || static || Support for static routes ||
 || router port || arp || Support for arp data collection ||
 || router port || stat || Octets and error counter //statistics// for all interfaces ||
 || switch port || ports || All switch ports with ifindex, interface name, link, speed and media ||
 || switch port || duplex || Duplex value for all ports ||
 || switch port || descr || Description value / port name for all switch port ||
 || switch port || vlan || Vlan value and trunk flag set for all port ||
 || switch port || cam || Bridge table data collected ||
 || switch port || stp || Spanning tree data collected ||
 || switch port || stat || Octets and error counters //statistics// for all ports ||
 || module || serial || serial numbers of all modules in the box ||
 || module || sw || software of all modules ||
 || module || p2mod || correctly relation from module to ports; i.e. the interfaces are sitting on the correct modules ||


====== Description of each attribute ======

We give a detailed description of each attribute.

For the products you are testing, please verify support for each of the attributes listed. In many cases you can
classify support simply by using the NAV web. You may also need to go in depth and query the database and/or snmp
walk the product (typically using ''snmpwalk -v2c -c yourcommunity yourbox oid''). We provide the necessary
information below.

Each attribute is scored on a scale from 0-3:

 || 0 || No support ||
 || 1 || Moderate support ||
 || 2 || Most important aspects covered ||
 || 3 || Fully supported ||

------

===== Attribute: box: serial =====

==== Description ====

The serial number for the box.

==== Look out for ====

  * Is the collected serial number same as the physical visable serial number of the box/chassis?

==== Study the NAV web ====

Currently, we do not show the serial for the box on NAV web. In 3.2 IP device center will show this.

==== Query NAVdb ====

<code>
   SELECT sysname, serial FROM netbox 
   JOIN device USING (deviceid) 
   WHERE sysname='yourrouter';
</code>

==== SNMP walk the equipment ====

We check a number of serial OIDs, try the ones we use, see the list produced from this
query:

<code>
   SELECT oidkey,oidname,snmpoid FROM snmpoid WHERE oidkey LIKE '%eria%';
</code>

------

===== Attribute: box: sw =====

==== Description ====

Software version of the box

==== Look out for ====

  * Not much

==== Study the NAV web ====

Take a look at IP device center for the box:

<code>
http://yournav.yourdomain/browse/yourbox/
</code>

==== Query NAVdb ====

<code>
   SELECT sysname, sw_ver FROM netbox 
   JOIN device USING (deviceid) 
   WHERE sysname='yourrouter';
</code>

==== SNMP walk the equipment ====

Software is picked from a substring in sysDescr with a regexp that at least works for Cisco,
HP and Nortel (it seems):

 || **Variable** || **OID name** || **OID** ||
 || software || sysDescr ||   1.3.6.1.2.1.1.1.0 ||

------

===== Attribute: box: mem =====

==== Description ====

Memory information, including //statistics//

==== Look out for ====
  * Currently we only support Cisco here.

==== Study the NAV web ====

For the inventory information:

<code>
http://yournav.yourdomain/report/mem?sysname=yourrouter
</code>

For the statistics, you should have a "mem"-link from the router and switch pages in Cricket:

<code>
https://yournav.yourdomain/cricket/?target=%2Fswitches
https://yournav.yourdomain/cricket/?target=%2Frouters
</code>

==== Query NAVdb ====

<code>
   SELECT memtype,device,size,used 
   FROM mem 
   JOIN netbox USING (netboxid) 
   WHERE sysname=yourbox;
</code>

==== SNMP walk the equipment ====

SNMP walk using these OIDs:

<code>
   SELECT oidkey,oidname,snmpoid,mib FROM snmpoid WHERE mib LIKE '%MEMORY%' OR mib LIKE '%FLASH%' ORDER BY snmpoid;
</code>

------

===== Attribute: box: cpu =====

==== Description ====

CPU statistics

==== Look out for ====
  * Cisco and HP is currently supported

==== Study the NAV web ====

Look for the 'cpu' link from:

<code>
https://yournav.yourdomain/cricket/?target=%2Fswitches
https://yournav.yourdomain/cricket/?target=%2Frouters
</code>

==== Query NAVdb ====
  * Not relevant

==== SNMP walk the equipment ====

SNMP walk these OIDs:

<code>
SELECT oidkey,snmpoid,mib,oidname,oidsource FROM snmpoid WHERE oidkey LIKE '%cpu%';
</code>

------

===== Attribute: box: temp =====

==== Description ====

Temperature statistics

==== Look out for ====

  * Currently only Cisco
 
==== Study the NAV web ====

Look for the 'temp' link from:

<code>
https://yournav.yourdomain/cricket/?target=%2Fswitches
https://yournav.yourdomain/cricket/?target=%2Frouters
</code>
==== Query NAVdb ====

  * Not relevant

==== SNMP walk the equipment ====

SNMP walk these OIDs:

<code>
SELECT oidkey,snmpoid,mib,oidname,oidsource FROM snmpoid WHERE oidkey LIKE '%temp%';
</code>


------

===== Attribute: box: CDP =====

==== Description ====

CDP data from the box. 
==== Look out for ====

  * CDP is Cisco proprietary. HP supports it (maybe not on newer software). Requires the CDP MIB
==== Study the NAV web ====

  * Not relevant. CDP is used as additional information (along with bridge table data) to derive the physical topology.
 
==== Query NAVdb ====
  * We also insert data inte netboxinfo related to CDP. In 3.2 this will be in a report. Try this query:

<code>
   SELECT sysname,key,var AS ifindex,val 
   FROM netboxinfo JOIN netbox USING (netboxid) 
   WHERE key LIKE '%CDP%' AND sysname='yourbox';
</code>

==== SNMP walk the equipment ====

SNMP walk these OIDs:

<code>
SELECT oidkey,snmpoid,mib,oidname FROM snmpoid WHERE oidkey LIKE '%cdp%';
</code>

------

===== Attribute: router port: ports =====

==== Description ====

 All router ports with ifindex, interface name, speed, gateway IP address (including secondary addresses)

==== Look out for ====

  * Check that speeds of 10Gig and above are correct! There is a separate ifHighSpeed oid for this.
  * Check that subinterfaces (if relevant) are correctly represented in NAV. You may need to upgrade your router software if you have errors here.
  * Check that secondary IP addresses is supported.

==== Study the NAV web ====

<code>
https://yournav.yourdomain/report/gwport?sysname=yourrouter
</code>

The report should show all interfaces for yourrouter with names, speed and IP addresses. Not ifindex (it will
in NAV 3.2...).


==== Query NAVdb ====

This query will list all interfaces sorted by ifindex for yourrouter. If secondary IP addresses is used
the interface is listed multiple times.

<code>
   SELECT ifindex,interface,speed,gwip
   FROM gwport
   JOIN gwportprefix USING (gwportid)
   JOIN prefix USING (prefixid)
   JOIN vlan USING (vlanid)
   JOIN module USING (moduleid)
   JOIN netbox USING (netboxid)
   WHERE nettype !='static' AND sysname='yourrouter'
   ORDER by ifindex;
</code>

==== SNMP walk the equipment ====

Walk these OIDs:

 || **Variable** || **OID name** || **OID** ||
 || ifIndex || ifIndex ||  1.3.6.1.2.1.2.2.1.1 ||
 || interface || ifDescr || 1.3.6.1.2.1.2.2.1.2 ||
 || speed     || iSpeed ||  1.3.6.1.2.1.2.2.1.5 ||
 || speed     || ifHighSpeed || 1.3.6.1.2.1.31.1.1.1.15 ||
 || gwip ||   	 ipAdEntIfIndex || 1.3.6.1.2.1.4.20.1.2 ||
 || gwip ||   	 ipAdEntIfNetMask || 1.3.6.1.2.1.4.20.1.3 ||


===== Attribute: router port: descr =====

==== Description ====

 Router port description (ifAlias, will be stored raw in NAV 3.2)

==== Look out for ====
  * Not much

==== Study the NAV web ====

Not stored raw today, the closest you get is the vlan.netident value. See the gwport report:

<code>
https://yournav.yourdomain/report/gwport?sysname=yourrouter
</code>

==== Query NAVdb ====

We will provide this when the gwport table is extended.

==== SNMP walk the equipment ====

   || **Variable** || **OID name** || **OID** ||
   || ifAlias || ifAlias ||  1.3.6.1.2.1.31.1.1.1.18 ||

------

===== Attribute: router port: hsrp =====

==== Description ====

==== Look out for ====

==== Study the NAV web ====

==== Query NAVdb ====

==== SNMP walk the equipment ====

------

===== Attribute: router port: metric =====

==== Description ====

==== Look out for ====

==== Study the NAV web ====

==== Query NAVdb ====

==== SNMP walk the equipment ====

------



===== Attribute: router port: static =====

==== Description ====

==== Look out for ====

==== Study the NAV web ====

==== Query NAVdb ====

==== SNMP walk the equipment ====

------


===== Attribute: router port: arp =====

==== Description ====

==== Look out for ====

==== Study the NAV web ====

==== Query NAVdb ====

==== SNMP walk the equipment ====

------



===== Attribute: router port: stat =====

==== Description ====

==== Look out for ====

==== Study the NAV web ====

==== Query NAVdb ====

==== SNMP walk the equipment ====

------


===== Attribute: switch port: ports =====

==== Description ====

==== Look out for ====

==== Study the NAV web ====

==== Query NAVdb ====

==== SNMP walk the equipment ====

------

===== Attribute: switch port: duplex =====

==== Description ====

==== Look out for ====

==== Study the NAV web ====

==== Query NAVdb ====

==== SNMP walk the equipment ====

------
===== Attribute: switch port: descr =====

==== Description ====

==== Look out for ====

==== Study the NAV web ====

==== Query NAVdb ====

==== SNMP walk the equipment ====

------
===== Attribute: switch port: vlan =====

==== Description ====

==== Look out for ====

==== Study the NAV web ====

==== Query NAVdb ====

==== SNMP walk the equipment ====

------
===== Attribute: switch port: cam =====

==== Description ====

==== Look out for ====

==== Study the NAV web ====

==== Query NAVdb ====

==== SNMP walk the equipment ====

------
===== Attribute: switch port: stp =====

==== Description ====

==== Look out for ====

==== Study the NAV web ====

==== Query NAVdb ====

==== SNMP walk the equipment ====

------
===== Attribute: switch port: stat =====

==== Description ====

==== Look out for ====

==== Study the NAV web ====

==== Query NAVdb ====

==== SNMP walk the equipment ====

------

===== Attribute: module: serial =====

==== Description ====

==== Look out for ====

==== Study the NAV web ====

==== Query NAVdb ====

==== SNMP walk the equipment ====

------

===== Attribute: module: sw =====

==== Description ====

==== Look out for ====

==== Study the NAV web ====

==== Query NAVdb ====

==== SNMP walk the equipment ====

------

===== Attribute: module: p2mod =====

==== Description ====

==== Look out for ====

==== Study the NAV web ====

==== Query NAVdb ====

==== SNMP walk the equipment ====

------