Network Administration Visualized 4.4.0

=================================================
 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.4
=======

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

- The Python library :mod:`django` must now be version *1.7*.
- The Python library :mod:`djangorestframework` must now be version *2.4*.
- The Python Imaging Library (PIL) seems dead and appears to no longer be
  available in the Python Package Index. We have replaced the dependency with
  :mod:`Pillow`, which is a fork of PIL. NAV should still work with the old
  library, though.

Interactive trend graphs
------------------------

Whereas NAV 4.3 and earlier would call on graphite-web to produce graphs as
static PNG images, NAV 4.4 uses the Rickshaw Javascript library to render
graphs from the same Graphite data.

These graphs allow for more user interaction, such as zooming and value
inspection. The are, however, not as readily re-usable by passing around URLs.

Slack dispatcher
----------------

NAV 4.4 adds a Slack dispatcher to the Alert Engine.

To dispatch messages to a Slack channel, you need to create a Slack channel and
add an Incoming Webhooks integration. More information about that can be found
at https://api.slack.com/incoming-webhooks . You will get an URL to use for
posting messages.

Then you need to add a Slack alert address to your alert profile and use this
address in an alert subscription. The address is the URL you got when setting up
the webhooks integration.

The username, emoji user-icon and channel for the messages are defined when
setting up the integration, but if you for some reason want to override this you
can do it in alertengine.conf.

Subnet matrix improvements
--------------------------

Various mysterious layout bugs in the subnet matrix have been fixed, by way of
a partial rewrite. Utilization data is now retrieve asynchronously, which
means that the matrix itself should load a lot faster. More details of each
subnet is now available in pop-up menus when clicking on them.

checkService.py has been renamed
--------------------------------

If you were using `checkService.py` to test your servicemon plugins, this
command has now been renamed to `navcheckservice`, and its command line
options have slightly changed. Run it with `--help` for more information.