Merge branch '5.13.x'

Uninett · Mar 7, 2025 · 237e1b6 · 237e1b6
2 parents 7af1dbb + fcce0bc
commit 237e1b6
Show file tree

Hide file tree

Showing 25 changed files with 98 additions and 22 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -11,6 +11,58 @@ This project uses [*towncrier*](https://towncrier.readthedocs.io/) and the chang
 
 <!-- towncrier release notes start -->
 
+## [5.13.0] - 2025-03-07
+
+### Security
+
+- Omit Palo Alto API keys from ARP plugin log output
+  ([#3251](https://github.com/Uninett/nav/issues/3251))
+
+### Added
+
+- Add option for showing OUI vendor name in Machine Tracker searches
+  ([#3292](https://github.com/Uninett/nav/issues/3292))
+- Add cronjob for populating database with OUI data nightly
+  ([#3320](https://github.com/Uninett/nav/issues/3320))
+- Run test suite by default on Python 3.11 and Django 4.2
+  ([#2850](https://github.com/Uninett/nav/issues/2850))
+- Added tests for device history search
+  ([#3261](https://github.com/Uninett/nav/issues/3261))
+
+### Changed
+
+- Upgraded Django requirement to 4.2
+  ([#2789](https://github.com/Uninett/nav/issues/2789))
+- Upgraded and cleaned up various Docker environments used for development and
+  testing to Debian Bookworm / Python 3.11
+  ([#3284](https://github.com/Uninett/nav/issues/3284))
+
+### Fixed
+
+- Fix minor incompatibilities with Django 4.2
+  ([#2850](https://github.com/Uninett/nav/issues/2850))
+- Fixed non-responsive search function in room map widget
+  ([#3207](https://github.com/Uninett/nav/issues/3207))
+- Validate interval inputs in several search forms to avoid unhandled overflow
+  errors (switch port activity, radius top talkers report, radius error log
+  search, radius account log search)
+  ([#3242](https://github.com/Uninett/nav/issues/3242),
+  [#3245](https://github.com/Uninett/nav/issues/3245),
+  [#3246](https://github.com/Uninett/nav/issues/3246),
+  [#3247](https://github.com/Uninett/nav/issues/3247))
+- Verify that multiple quarantine rules cannot be added with identical VLANs in
+  Arnold ([#3244](https://github.com/Uninett/nav/issues/3244))
+- Fixed broken module history view in device history
+  ([#3258](https://github.com/Uninett/nav/issues/3258))
+- Stop sending error mails to site admins from graphite-web proxy endpoint when
+  graphite response code is in the 5XX range
+  ([#3259](https://github.com/Uninett/nav/issues/3259))
+- Ignore case of sysname in IP device info
+  ([#3262](https://github.com/Uninett/nav/issues/3262))
+- Add user-agent header when downloading OUI text file
+  ([#3291](https://github.com/Uninett/nav/issues/3291))
+
+
 ## [5.12.0] - 2024-12-16
 
 ### Removed

diff --git a/NOTES.rst b/NOTES.rst
@@ -8,6 +8,40 @@ existing bug reports, go to https://github.com/uninett/nav/issues .
 To see an overview of upcoming release milestones and the issues they resolve,
 please go to https://github.com/uninett/nav/milestones .
 
+NAV 5.13
+========
+
+Dependency changes
+------------------
+
+NAV 5.13 will run properly on Python 3.11.
+
+Dependencies to these Python modules have been added:
+
+:mod:`pytz`
+
+Python modules with changed version requirements:
+
+* :mod:`Django` (``>=4.2,<4.3``)
+* :mod:`djangorestframework` (``>=3.12`` - in practice, 3.15 at the time of release)
+
+OUI lookup in Machine Tracker searches
+--------------------------------------
+
+The first three octets of a MAC hardware address is considered its OUI
+(Organizationally Unique Identifier), and identifies a vendor, manufacturer or
+other organization (as assigned by the IEEE).
+
+NAV 5.11 added the :program:`navoui` program to fetch OUI assignments from IEEE
+and populate the NAV database with them.  NAV 5.13 finally utilizes this
+information by adding optional vendor lookups to Machine Tracker searches.
+
+A new cron job, ``navoui``, is also added, to update the list of assignments
+nightly.  You will not benefit from vendor lookups in Machine Tracker until
+:program:`navoui` has been run at least once. If you don't want to wait for the
+first nightly run, you can simply run the program manually.
+
+
 NAV 5.12
 ========
 

diff --git a/README.rst b/README.rst
@@ -29,7 +29,7 @@ NAV is licensed under the *GNU GPL version 3*.  NAV includes software from third
 parties, which are either licensed under the GPL or compatible licenses.
 
 * Copyright 2002-2021 Uninett AS
-* Copyright 2022-2024 Sikt
+* Copyright 2022-2025 Sikt
 
 See individual source files for more detailed copyright notices.
 

diff --git a/changelog.d/+auxiliary-docker-bookworm.changed.md b/changelog.d/+auxiliary-docker-bookworm.changed.md
diff --git a/changelog.d/+cleanup-test-docker-image.changed.md b/changelog.d/+cleanup-test-docker-image.changed.md
diff --git a/changelog.d/2789.changed.md b/changelog.d/2789.changed.md
diff --git a/changelog.d/2850.added.md b/changelog.d/2850.added.md
diff --git a/changelog.d/2850.fixed.md b/changelog.d/2850.fixed.md
diff --git a/changelog.d/3207.fixed.md b/changelog.d/3207.fixed.md
diff --git a/changelog.d/3242.fixed.md b/changelog.d/3242.fixed.md
diff --git a/changelog.d/3244.fixed.md b/changelog.d/3244.fixed.md
diff --git a/changelog.d/3245.fixed.md b/changelog.d/3245.fixed.md
diff --git a/changelog.d/3246.fixed.md b/changelog.d/3246.fixed.md
diff --git a/changelog.d/3247.fixed.md b/changelog.d/3247.fixed.md
diff --git a/changelog.d/3251.security.md b/changelog.d/3251.security.md
diff --git a/changelog.d/3258.fixed.md b/changelog.d/3258.fixed.md
diff --git a/changelog.d/3259.fixed.md b/changelog.d/3259.fixed.md
diff --git a/changelog.d/3261.added.md b/changelog.d/3261.added.md
diff --git a/changelog.d/3262.fixed.md b/changelog.d/3262.fixed.md
diff --git a/changelog.d/3284.changed.md b/changelog.d/3284.changed.md
diff --git a/changelog.d/3291.fixed.md b/changelog.d/3291.fixed.md
diff --git a/changelog.d/3292.added.md b/changelog.d/3292.added.md
diff --git a/changelog.d/3320.added.md b/changelog.d/3320.added.md
diff --git a/doc/conf.py b/doc/conf.py
@@ -52,7 +52,7 @@
 
 # General information about the project.
 project = u'NAV'
-copyright = u'2012-2021 Uninett AS, 2022-2024 Sikt'
+copyright = u'2012-2021 Uninett AS, 2022-2025 Sikt'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the

diff --git a/doc/intro/getting-organized.rst b/doc/intro/getting-organized.rst
@@ -99,6 +99,16 @@ register a new device type and attach it to the ``unknown`` vendor id. You may
 wish to later edit these auto-created device types using the SeedDB *Type*
 tab to set the correct vendor id and a more proper type name and description.
 
+Vendor OUIs and MAC addresses
+-----------------------------
+
+NAV's Machine Tracker search tool allows searching logs of ARP and CAM data
+collected from your routers and switches.  It provides an optional OUI vendor
+lookup for MAC address results.  The OUI mapping database is populated by the
+:program:`navoui` cronjob on a nightly basis.  If you're on day 1 with your NAV
+install and do not want to wait for the cronjob to run for the first time, you
+can run the :program:`navoui` command manually to populate the OUI table
+immediately.
 
 Cabling and patching
 --------------------