Observium IS-IS / SPBM / I-SID support for Extreme VOSS/FabricEngine and BOSS/ERS
=================================================================================

Target
------
Built/tested around Observium Professional 26.6 / SVN Rev 14882.

Main features
-------------
- IS-IS polling and discovery for ISIS-MIB and RC-ISIS-MIB/RAPID-CITY.
- Extreme VOSS/FabricEngine/SPBM support:
  - Areas
  - Circuits/ports
  - Adjacencies
  - Fabric nodes
  - I-SIDs with origin information such as manual/eap-local/auto-sense.
- Extreme BOSS/ERS support via ISIS-MIB where available.
- Device page:
  - Device -> Routing -> IS-IS
  - Known IS-IS / Fabric Nodes
  - I-SIDs
- Global pages:
  - /routing/protocol=isis/
  - /isid/
- Main menu:
  - Network -> IS-IS
  - Network -> I-SIDs
- Graph support:
  - IS-IS adjacency count
  - IS-IS adjacency states
  - IS-IS port count
  - IS-IS area count
  - IS-IS packet counters where available
- Alert Checker support:
  - Entity type: IS-IS Instance
  - Entity type: IS-IS Adjacency
  - Metrics such as isis_adjacencies_up, isis_adjacencies_down, isis_adj_state.
- Port view:
  - IS-IS/SPBM adjacency in the port link/neighbour column, similar to LLDP/CDP.

SQL
---
Schema changes are consolidated into:

  update/533.sql

The number 533 is only a proposal. Upstream should renumber it to the next free
Observium update number if needed.

Apply
-----
  cd /opt/observium
  patch -p0 < observium-isis-spbm-isid-rev14882-final-developer.patch

Then run the normal Observium update process, or apply update/533.sql as appropriate.

Basic syntax checks
-------------------
  php -l includes/polling/isis.inc.php
  php -l includes/polling/isis/isis-mib.inc.php
  php -l includes/polling/isis/rc-isis-mib.inc.php
  php -l includes/definitions/entities/routing.inc.php
  php -l includes/definitions/mibs/nortel.inc.php
  php -l includes/definitions/rrdtypes/isis.inc.php
  php -l html/includes/navbar.inc.php
  php -l html/includes/entities/port.inc.php
  php -l html/pages/device.inc.php
  php -l html/pages/device/routing/isis.inc.php
  php -l html/pages/routing.inc.php
  php -l html/pages/routing/isis.inc.php
  php -l html/pages/isid.inc.php

Runtime tests
-------------
  ./discovery.php -h <voss-or-ers-device> -m mibs
  ./poller.php -h <voss-or-ers-device> -m isis

Alert examples
--------------
Entity Type: IS-IS Instance
  isis_adjacencies_up < <expected-number>
  isis_adjacencies_down > 0

Entity Type: IS-IS Adjacency
  isis_adj_state notequals up

Notes
-----
Alert Checker entity selection matters:
- isis_adjacencies_up belongs to IS-IS Instance.
- isis_adj_state belongs to IS-IS Adjacency.

Files changed
-------------
See observium-isis-spbm-isid-rev14882-final-filelist.txt.