Network Administration Visualized 3.12.1

=================================================
 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 3.12
========

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

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

- Python >= 2.6 is now required. NAV will not work under Python 3.
- Django >= 1.2 is now required. NAV will likely not work under Django 1.4.

Cricket configuration
---------------------

Your subtree-sets configuration for Cricket must be updated. This file is most
likely placed in /etc/cricket/. Compare manually with or copy from
`doc/cricket/cricket/subtree-sets`.

Take note of `$(NAV)/etc/mcc.conf`. Module `interfaces` should be there instead
of `routerinterfaces` and `switchports`.

IPv6 statistics for router interfaces will now be collected. For this to work
you need to copy some configuration templates to your `cricket-config`
directory. NB: Make sure the `dataDir` is the same as the original after
copying the `Defaults` file. If your NAV is installed in `/usr/local/nav`, run
these commands::

  sudo cp doc/cricket/cricket-config/Defaults \
             /usr/local/nav/etc/cricket-config/

  sudo cp -r doc/cricket/cricket-config/ipv6-interfaces \
             /usr/local/nav/etc/cricket-config/

Room map
--------

If you have registered coordinates (latitude, longitude) on your rooms you may
include a geographical map of the rooms on the front page by editing
`etc/webfront/welcome-registered.txt` and/or `welcome-anonymous.txt` and
adding the following HTML::

  <div id="mapwrapper">
      <div id="room_map" class="smallmap"></div>
  </div>

If you feel like having a bigger map, replace `smallmap` with `bigmap`. The
markers are clickable and will take you to the new "Room view" for the clicked
room.

Toolbar search
--------------

The toolbar search now searches for more than IP devices. Try it!

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

If any of the following files and directories are still in your installation
after upgrading to NAV 3.12, they should be removed (installation prefix has
been stripped from these file names). If you installed and upgraded NAV using
a packaging system, you should be able to safely ignore this section::

  doc/getting-started.txt
  doc/mailin/README
  doc/radius/
  etc/apache/subsystems/maintenance.conf
  etc/apache/subsystems/messages.conf
  etc/apache/subsystems/netmap.conf
  lib/python/nav/ipdevpoll/plugins/lastupdated.py
  lib/python/nav/web/maintenance/handler.py
  lib/python/nav/web/messages/handler.py
  lib/python/nav/web/netmap/datacollector.py
  share/htdocs/js/DeviceBrowserTemplate.js
  share/htdocs/js/devicehistory.js
  share/htdocs/js/EditTemplate.js
  share/htdocs/js/ipdevinfo.js
  share/htdocs/js/jquery-1.4.4.min.js
  share/htdocs/js/jquery-json-2.2.min.js
  share/htdocs/js/quickselect.js
  share/htdocs/js/seeddb.js
  share/htdocs/js/seeddbTemplate.js
  share/htdocs/netmap/