Network Administration Visualized 4.2.5

Milestone information

Project:
Network Administration Visualized
Series:
4.2
Version:
4.2.5
Released:
 
Registrant:
Morten Brekkevold
Release registered:
Active:
No. Drivers cannot target bugs and blueprints to this milestone.  

Download RDF metadata

Activities

Assigned to you:
No blueprints or bugs assigned to you.
Assignees:
10 John-Magne Bredal, 10 Morten Brekkevold
Blueprints:
No blueprints are targeted to this milestone.
Bugs:
21 Fix Released

Download files for this release

After you've downloaded a file, you can verify its authenticity using its MD5 sum or signature. (How do I verify a download?)

File Description Downloads
download icon nav-4.2.5.tar.gz (md5, sig) NAV 4.2.5 source code tarball 131
last downloaded 8 days ago
Total downloads: 131

Release notes 

=================================================
 Network Administration Visualized release notes
=================================================

Please report bugs at https://bugs.launchpad.net/nav/+filebug . To browse
existing bug reports, go to https://bugs.launchpad.net/nav .

If you are upgrading from versions of NAV older than 3.7, please refer to the
release notes of the in-between versions before reading any further.

Known problems
==============

The recommended SNMP library for use with ipdevpoll is `pynetsnmp`. If you
choose to go with the original TwistedSNMP, the latest version (0.3.13)
contains a bug that manifests in table retrieval operations. Timeouts and
retries aren't handled properly, and this may cause slow or otherwise busy
devices to be bombarded with requests from NAV. The `contrib/patches`
directory contains a patch for TwistedSNMP that solves this problem. The
patch has been submitted upstream, but not yet accepted into a new release.

NAV 4.2
========

To see the overview of scheduled features and reported bugs on the 4.2 series
of NAV, please go to https://launchpad.net/nav/4.2 .

Dependency changes
------------------

There are none :-)

Rename some of your Whisper files to keep your statistics
---------------------------------------------------------

The 4.2.2 release adds commas to the list of characters escaped in Graphite
metric names; commas cause problems when constructing target names for
graphite-web, when rendering graphs and retrieving metrics. An out-of-place
comma will cause Graphite render requests to fail.

If your Graphite storage directory contains Whisper files with commas in
their filenames (under the `nav` hierarchy), and you want to keep your data
history, you will need to rename these files by replacing the commas with
underscores. Something like this should do the trick::

    cd /opt/graphite/storage/whisper/nav
    find -name '*,*' | xargs rename --verbose 's/,/_/g'

Multicast listener stats from IGMP snooping
-------------------------------------------

NAV 4.2 will use HP's STATISTICS-MIB to sum up the number of known multicast
group subscribers per HP switch (i.e. from each switch's IGMP snooping data).
Each multicast group address seen is logged to Graphite under the
`nav.multicast` hierarchy.

We wanted to support similar functionality for Cisco devices, but it seems
support for Cisco's own proprietary CISCO-IGMP-SNOOPING-MIB is very poor among
Cisco switches.

Graphite storage schema changes
-------------------------------

Be aware that the example Graphite storage schema
:file:`etc/nav/graphite/storage-schema.conf` has added a section for multicast
statistics. Be sure to update your running Carbon configuration.

Rewritten Status tool
---------------------

The Status tool has been rewritten from scratch.

The old Status tool hardcoded table listings for specific alert types, and not
all alert types were supported - meaning some alerts were never actually
displayed in the Status tool. This also made it very difficult to dynamically
add new alert types from plugins or third party software, without modifying
the Status tool code.

The new tool offers an in-page status filtering form, which can also be saved
as your personal status page filter preference.

Any filter configuration can also be saved as a new front-page status filter,
meaning you can have multiple status widgets, each with a different
configuration. When modifying the default/anonymous user's front page widgets,
this means you can also decide which types of alerts, if any, will be
displayed to unauthenticated users.

Alert acknowledgement
~~~~~~~~~~~~~~~~~~~~~

With the new Status tool comes the ability to acknowledge open alerts, with
comments. An acknowledged alert is not displayed under the default Status tool
filter configuration (but can be added by checking the "Acknowledged"
checkbox).

Stateless alerts
~~~~~~~~~~~~~~~~

The Status tool normally displays stateful alerts, i.e. states that have a
starting time and, eventually, an ending time. The can be actual problems, or
more information states, such as a device being on scheduled maintenance.

However, NAV will at times also issue stateless alerts (warnings). Before,
these were normally only accessible in the Device History tool, and through
alert subscriptions in Alert Profiles.

The Status page tool can now be configured to include recent stateless alerts,
within a set threshold (the default is 24 hours). The default is still to
leave them out.

New status widget
~~~~~~~~~~~~~~~~~

A widget version of the new Status tool is also introduced. Users who have the
old Status widget on their NAV front pages will see their widgets replaced
with a Status tool widget filtering for *boxState* events.

By default, NAV places a status widget on the front page of anonymous users.
With the new widget, you can also control what kind of alerts anonymous users
can see on the front page.

.. TIP:: To configure, remove or add more Status widgets to the front page of
         anonymous users, go to the User Admininstration tool, select the
         *default* user and click the button :guilabel:`Operate as this user`.

         While operating as the *default* user, configure the widgets on the
         front page to your liking. Click :guilabel:`Log back in as ...` to
         return to normal operation.

Netmap redesign
---------------

There was never time to clean up the Netmap tool's complicated user interface
during the design changes released in NAV 4.0. This has now been rectified.

The map portion of the page has been given more space, and the view options
are now contained in a hideable panel above the map. Your saved views should
still work.

SeedDB IP device form redesign
------------------------------

The form for adding and editing an IP device has been redesigned. It no longer
requires connectivity to add or edit an IP device, but you have the option to
verify the connectivity if you want. As a result of this, only one step is
required to complete the form. Should you go ahead and save a router with the
wrong SNMP community, NAV will shortly raise an *snmpAgentAlert* for this
device.

In addition to this, IP address verification has been added to the form. When
adding an IP device by its hostname in NAV versions prior to 4.2, if this
hostname resolved to multiple IP addresses, NAV would select an arbitrary IP
address from these as its management address for the device. The new form will
ask the user to choose one of the resolved IP addresses from a list.

Custom attributes on IP devices and locations
---------------------------------------------

You now have to option to add custom attributes to your IP devices and
locations. In NAV 4.1 this was only available for rooms and organizations. The
custom attributes are added in the respective SeedDB forms.

The attributes added for IP devices are displayed on the IP Device Info page.
The attributes for locations are currently not visible outside of SeedDB, as
there are no canonical Location-pages in NAV (yet). The *location* report can
be amended locally to include those attributes you want displayed, in the same
way as commented on the *organization* and *room* reports.

New command line utilities
--------------------------

NAV 4.2 introduces three new command line utilities for advanced users:

navdf
~~~~~
::

    Usage: navdf [filter]

    Lists and filters IP devices monitored by NAV

    Options:
      -h, --help show this help message and exit

    The filter expression must be a method call applicable to the Django-based
    Netbox model's manager class. Example: "filter(category__id='GSW')"

navoidverify
~~~~~~~~~~~~
::

    usage: navoidverify baseoid < sysnames.txt

    Verifies SNMP sub-tree support on a set of NAV-monitored devices

    positional arguments:
      baseoid The base OID for which a GETNEXT operation will be performed

    optional arguments:
      -h, --help show this help message and exit

    Given the root of an SNMP MIB module, a bunch of devices can be queried in
    parallel whether they have any objects below the given BASEOID - effectively
    verifying MIB support in these devices.

naventity
~~~~~~~~~
::

    usage: naventity device

    Outputs entity hierarchy graph from a device's ENTITY-MIB::entPhysicalTable
    response

    positional arguments:
      device The NAV-monitored IP device to query. Must be either a sysname
    prefix or an IP address.

    optional arguments:
      -h, --help show this help message and exit

Files to remove
---------------

Many files have been removed or moved around since NAV 4.0 and 4.1. Unless you
upgraded NAV using a package manager (such as APT), you may need/want to
remove some obsolete files and directories (here prefixed by /usr/local/nav)::

    /usr/local/nav/doc/hacking/netmap.rst
    /usr/local/nav/doc/hacking/using-vagrant.rst
    /usr/local/nav/doc/hacking/vagrant.rst
    /usr/local/nav/doc/html/hacking/netmap.html
    /usr/local/nav/doc/html/hacking/using-vagrant.html
    /usr/local/nav/doc/html/hacking/vagrant.html
    /usr/local/nav/doc/html/_sources/hacking/netmap.txt
    /usr/local/nav/doc/html/_sources/hacking/using-vagrant.txt
    /usr/local/nav/doc/html/_sources/hacking/vagrant.txt
    /usr/local/nav/lib/python/nav/web/api/auth.py
    /usr/local/nav/lib/python/nav/web/api/helpers/
    /usr/local/nav/lib/python/nav/web/api/serializers.py
    /usr/local/nav/lib/python/nav/web/api/views.py
    /usr/local/nav/lib/python/nav/web/netmap/forms.py
    /usr/local/nav/share/htdocs/static/js/src/netmap/app.js
    /usr/local/nav/share/htdocs/static/js/src/netmap/collections/
    /usr/local/nav/share/htdocs/static/js/src/netmap/main.js
    /usr/local/nav/share/htdocs/static/js/src/netmap/models/
    /usr/local/nav/share/htdocs/static/js/src/netmap/order.js
    /usr/local/nav/share/htdocs/static/js/src/netmap/resource.js
    /usr/local/nav/share/htdocs/static/js/src/netmap/router.js
    /usr/local/nav/share/htdocs/static/js/src/netmap/templates/
    /usr/local/nav/share/htdocs/static/js/src/netmap/views/
    /usr/local/nav/share/templates/netmap/admin_list_mapviews.html
    /usr/local/nav/share/templates/netmap/backbone.html
    /usr/local/nav/share/templates/netmap/graphml.html

Changelog 

View the full changelog

Version 4.2.5
(released 20 Mar 2015)

 This was released to replace the broken 4.2.4 release. The fixed regression
 is this:

  * LP#1434520 (pping is unable to post boxUp/boxDown events)

 Bugfixes:

  * LP#1403365 (offMaintenance alerts for same device every 5 minutes)
  * LP#1422298 (device history crashes when viewing weathergoose events)
  * LP#1422316 (thresholdmon AttributeError crash)
  * LP#1425536 (Status widget error when filtering on Device group)
  * LP#1425846 (alert profiles does not display without refresh)
  * LP#1427666 (watchdog is slow)
  * LP#1428071 (Portadmin crashes when searching by sysname or ip)
  * LP#1428578 (seeddb test for snmp version crashes if neither v1 or v2c is
                supported)
  * LP#1429868 (ipdevpoll jobs that are no longer supposed to run for a device
                as flagged as "overdue")
  * LP#1430795 (SeedDB room edit form asks for user's location, shows no map
                until permission is given)
  * LP#1430797 (Geomap shows no map at all when no room positions are defined)
  * LP#1430802 (SeedDB room edit insists on inserting a geoposition)
  * LP#1430803 (SeedDB room form position indicator icon is missing)
  * LP#1431780 (Trunk port status is never reset on non-Cisco equipment)
  * LP#1432056 (mod_wsgi option WSGIApplicationGroup should be %{GLOBAL} by
                default)
  * LP#1432057 ([appliance] missing python-dnspython)
  * LP#1432620 (Unable to load Netmap layer 3 map with ELINK peers)
  * LP#1432682 (Should be able to specify exact subnet prefixes to ignore)
  * LP#1433063 (netmap zoom and pan does not work for some views)
  * LP#1433120 (Shouldn't generate linkState alerts for intentionally shutdown
                interfaces)

0 blueprints and 21 bugs targeted

Bug report Importance Assignee Status
1434520 #1434520 pping is unable to post boxUp/boxDown events 2 Critical Morten Brekkevold  10 Fix Released
1403365 #1403365 offMaintenance alerts for same device every 5 minutes 3 High Morten Brekkevold  10 Fix Released
1431780 #1431780 Trunk port status is never reset on non-Cisco equipment 3 High Morten Brekkevold  10 Fix Released
1432620 #1432620 Unable to load Netmap layer 3 map with ELINK peers 3 High Morten Brekkevold  10 Fix Released
1432682 #1432682 Should be able to specify exact subnet prefixes to ignore 3 High Morten Brekkevold  10 Fix Released
1422316 #1422316 thresholdmon AttributeError crash 4 Medium Morten Brekkevold  10 Fix Released
1425846 #1425846 alert profiles does not display without refresh 4 Medium John-Magne Bredal  10 Fix Released
1429868 #1429868 ipdevpoll jobs that are no longer supposed to run for a device as flagged as "overdue" 4 Medium Morten Brekkevold  10 Fix Released
1430795 #1430795 SeedDB room edit form asks for user's location, shows no map until permission is given 4 Medium John-Magne Bredal  10 Fix Released
1430797 #1430797 Geomap shows no map at all when no room positions are defined 4 Medium John-Magne Bredal  10 Fix Released
1430802 #1430802 SeedDB room edit insists on inserting a geoposition 4 Medium John-Magne Bredal  10 Fix Released
1430803 #1430803 SeedDB room form position indicator icon is missing 4 Medium John-Magne Bredal  10 Fix Released
1433120 #1433120 Shouldn't generate linkState alerts for intentionally shutdown interfaces 4 Medium Morten Brekkevold  10 Fix Released
1432056 #1432056 mod_wsgi option WSGIApplicationGroup should be %{GLOBAL} by default 5 Low Morten Brekkevold  10 Fix Released
1422298 #1422298 device history crashes when viewing weathergoose events 1 Undecided John-Magne Bredal  10 Fix Released
1425536 #1425536 Status widget error when filtering on Device group 1 Undecided John-Magne Bredal  10 Fix Released
1427666 #1427666 watchdog is slow 1 Undecided John-Magne Bredal  10 Fix Released
1428071 #1428071 Portadmin crashes when searching by sysname or ip 1 Undecided John-Magne Bredal  10 Fix Released
1428578 #1428578 seeddb test for snmp version crashes if neither v1 or v2c is supported 1 Undecided John-Magne Bredal  10 Fix Released
1432057 #1432057 [appliance] missing python-dnspython 1 Undecided Morten Brekkevold  10 Fix Released
1433063 #1433063 netmap zoom and pan does not work for some views 1 Undecided   10 Fix Released
This milestone contains Public information
Everyone can see this information.