git: 357edb13382b - main - UPDATING: Add upgrade instructions for NetBox 3.x

From: Kai Knoblich <kai_at_FreeBSD.org>
Date: Mon, 04 Oct 2021 17:29:36 UTC
The branch main has been updated by kai:

URL: https://cgit.FreeBSD.org/ports/commit/?id=357edb13382bbb36ea61937736ed3d28584553b1

commit 357edb13382bbb36ea61937736ed3d28584553b1
Author:     Kai Knoblich <kai@FreeBSD.org>
AuthorDate: 2021-10-04 17:04:23 +0000
Commit:     Kai Knoblich <kai@FreeBSD.org>
CommitDate: 2021-10-04 17:26:08 +0000

    UPDATING: Add upgrade instructions for NetBox 3.x
    
    Give users a few pointers on what to keep in mind when updating
    to NetBox 3.x.
---
 UPDATING | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/UPDATING b/UPDATING
index 1308ac3ce20c..5fea5496a883 100644
--- a/UPDATING
+++ b/UPDATING
@@ -5,6 +5,36 @@ they are unavoidable.
 You should get into the habit of checking this file for changes each time
 you update your ports collection, before attempting any port upgrades.
 
+20211004:
+  AFFECTS: users of net-mgmt/netbox
+  AUTHOR: kai@FreeBSD.org
+
+  /!\ WARNING /!\
+
+  The NetBox 3.0 release contains major changes, so at least items 1.), 2.)
+  and 3.) must be checked before proceeding with the upgrade!
+
+  /!\ WARNING /!\
+
+  1. Please ensure that your local installation of net-mgmt/netbox is at
+     the 2.11 release before attemping to upgrade to NetBox 3.0 or later.
+
+  2. Please also note that the previously deprecated secrets functionality
+     has been removed with NetBox 3.0.  This means, all of the secrets still
+     remain in the database once upgraded, only the secrets functionality on
+     the part of NetBox is no longer given.
+
+     In order to continue to be able to access the stored secrets as usual
+     (and then possibly migrate them to another solution, e.g.
+     security/vault), please install the security/py-netbox-secretstore port
+     once NetBox has been upgraded to 3.x and follow its installation
+     instructions how to enable the plugin.
+
+  3. If plugins are used, they should be temporarily deactivated to avoid
+     disruptions during the upgrade process.
+
+  4. Please also check the pkg-message and the changelogs for further info.
+
 20211004:
   AFFECTS: users of www/py-pyjwt
   AUTHOR: rhurlin@FreeBSD.org