Upgrade path

[tumtumsback]

Hello all,

I inherited an Ubuntu 16.04.6 LTS server running Netbox v2.3.1

Super far behind, I know -- what are my best options to get current?

Thanks!

[domainzero]

Hey @tumtumsback

This documentation covers pretty much all of it. You'll need modern Python, PostgreSQL, and Redis installed, and you'll need to update to Netbox 2.10, then Netbox 2.11 before you get to Netbox 3.0.2 according to the 3.0 release notes.

[jeremystretch]

Since you're starting with such an old base operating system, I would strongly recommend provisioning a new system first, and installing NetBox on it. Obviously, a ton has changed since the days of v2.3, so you'll want to spend some time reading through NetBox's release notes (though it's unlikely you have much in the way of integrations).

Once you have the new system in place, you can install NetBox per the installation docs. However, you'll want to start with a v2.11 release. This will allow you to copy over the PostgreSQL database and upgrade to v2.11 automatically. Once that's done, you can proceed with upgrading from v2.11 to v3.0.

[tumtumsback]

Thank you very much! I will surely give this a try on Monday.

[tumtumsback]

Stood up a new Ubuntu 20.04.3 LTS box. Copied database from old to new box. Installed v2.11.11 successfully.

When I try to upgrade from 2.11.11 to 3.0, I get errors. I then simply just tried to do a 2.11.11 to 2.11.12 upgrade, and that keeps giving me a 503. Any help would be greatly appreciated. Thanks!

[WSU-HoneyBadger]

I had troubles with 2 things when going from 2.11.11 to 3.0

had to removing debugging for LDAP
Had to change the user for the httpd systemd startup, there is a note for this somewhere, release notes or upgrade notes.

[WSU-HoneyBadger]

It was in the "Migrating to systemd"

https://netbox.readthedocs.io/en/stable/installation/migrating-to-systemd/

"You may need to modify the user that the systemd service runs as. Please verify the user for httpd on your specific release and edit both files to match your httpd service under user and group. The username could be "nobody", "nginx", "apache", "www-data", or something else."