NetBox-Updater/README.md

NetBox Updater

Automatisiertes Upgrade-Skript für selbst gehostete NetBox-Installationen unter /opt/netbox.

Erledigt automatisch:

• Download & Entpacken der neuen NetBox-Version
• Übernahme von configuration.py, ldap_config.py, media/, scripts/, reports/, gunicorn.py
• Übernahme/Erstellung der local_requirements.txt (Plugins), inkl. automatischem django-auth-ldap-Eintrag bei erkannter LDAP-Konfig
• Verzeichnistausch (netbox → netbox_old, neue Version → netbox)
• Ausführung von upgrade.sh

Ausführung per Oneliner

Direkt von Gitea herunterladen und ausführen (Version als Parameter, ohne führendes v):

curl -fsSL https://git.mrblake.cc/MrBlake/NetBox-Updater/raw/branch/main/upgrade.sh | sudo bash -s -- 4.1.5

Alternativ mit wget:

wget -qO- https://git.mrblake.cc/MrBlake/NetBox-Updater/raw/branch/main/upgrade.sh | sudo bash -s -- 4.1.5

4.1.5 durch die gewünschte Zielversion ersetzen (siehe NetBox Releases).

Voraussetzungen

• Root-Rechte (sudo)
• Bestehende Installation unter /opt/netbox
• wget, tar, curl installiert
• Kein /opt/netbox_old und kein /opt/netbox-<Version> vorhanden (Skript bricht sonst ab, um nichts zu überschreiben)

Ablauf im Detail

1. Download: Lädt vX.Y.Z.tar.gz von GitHub und entpackt es nach /opt/netbox-X.Y.Z.
2. Kopieren: Überträgt Konfiguration, Medien, Skripte, Reports und ggf. gunicorn.py aus der bestehenden Installation.
3. Plugins: Kopiert local_requirements.txt aus /opt/netbox. Existiert keine, wird eine Standardliste angelegt (in der Skriptdatei editierbar). Bei vorhandener ldap_config.py wird django-auth-ldap automatisch ergänzt.
4. Pause zur Prüfung: Das Skript hält an und bittet dich, CSRF_TRUSTED_ORIGINS in der neuen configuration.py zu kontrollieren, bevor es weitermacht (Enter zum Fortfahren, Strg+C zum Abbrechen).
5. Verzeichnistausch: /opt/netbox → /opt/netbox_old, /opt/netbox-X.Y.Z → /opt/netbox.
6. Upgrade: Führt /opt/netbox/upgrade.sh aus.
7. Aufräumen: Löscht den heruntergeladenen Tarball.

Nach dem Upgrade

• NetBox testen (Login, Plugins, LDAP falls genutzt).
• Bei Problemen: Rollback möglich, da die alte Installation unter /opt/netbox_old erhalten bleibt.
• Nach erfolgreicher Prüfung kann /opt/netbox_old gelöscht werden:

  sudo rm -rf /opt/netbox_old
  

Lokale Ausführung (ohne Oneliner)

wget https://git.mrblake.cc/MrBlake/NetBox-Updater/raw/branch/main/upgrade.sh
chmod +x upgrade.sh
sudo ./upgrade.sh 4.1.5