Migrationsleitfaden RackTables zu NetBox
RackTables war großartig. Seit 2007 hat es genau das getan, was es sollte: Racks und IPs verwalten. PHP, MySQL, läuft. Aber die Wahrheit ist: Technik entwickelt sich weiter. Das letzte Update kam im Februar 2022. Keine moderne API. Die alten Migrationsskripte? Völlig nutzlos für moderne Systeme. RackTables ist heute ein Klotz am Bein, der deine IT blockiert.
Woran du merkst, dass RackTables nicht mehr reicht.
Wenn sich aber mehrere dieser sechs Punkte vertraut anfühlen, kostet dich das Bleiben mehr als der Wechsel. Einen neutralen Marktüberblick findest du in unserem Vergleich zur Open-Source-Netzwerkdokumentation.
Keine REST-API als Fundament
RackTables stammt aus der Zeit vor NetDevOps. Wer Ansible, Terraform oder eigene Skripte an die Doku anbinden will, kämpft gegen das Tool statt mit ihm.
Kein Release seit 2022
Das letzte Release 0.22.0 stammt vom 15.02.2022. Neuere Stände erscheinen nur als Git-Tags, die GitHub-Releases-Seite bleibt leer.
PHP-Wartungslast
Ein PHP-Stack mit MySQL/MariaDB will gepatcht, gehostet und abgesichert werden. Das bindet genau die Zeit, die deinem Netzbetrieb fehlt.
Freie Attribute statt Datenmodell
RackTables lässt fast jede Eingabe zu. NetBox validiert: Pflichtfelder, Typen, Eindeutigkeit. Erst dadurch wird Dokumentation automatisierbar.
Verkabelung und Power rudimentär
Patchwege, Panels und Stromversorgung auf dem Niveau des NetBox-Modells (Cables, Power Feeds) bildet RackTables nicht ab.
Keine Source of Truth für NetDevOps
Monitoring, CMDB und Automatisierung brauchen eine maschinenlesbare, validierte Quelle. Genau dafür wurde NetBox gebaut.
So übersetzt sich dein Datenmodell.
Die gute Nachricht: Für fast alles in RackTables gibt es ein sauberes Ziel in NetBox. Die Zuordnung entscheidet darüber, wie viel Handarbeit nach dem Import übrig bleibt.
-
RackTables · Objects
› NetBox: Devices mit Device Types
Jedes Device braucht in NetBox einen Manufacturer und einen Device Type. Generische RackTables-Objects musst du vorher typisieren, sonst scheitert der Import.
-
RackTables · Racks
› NetBox: Racks, Sites und Locations
NetBox hängt jedes Rack an eine Site, optional an eine Location. Den Standort-Schnitt legst du vor dem Import fest, nicht danach.
-
RackTables · IPv4/IPv6-Spaces
› NetBox: Prefixes und IP Addresses
Netze werden Prefixes, Adressen werden IP Addresses inklusive Interface-Zuordnung. Kollisionen fallen dank Validierung sofort auf.
-
RackTables · Attributes
› NetBox: Custom Fields
Frei definierte Attribute übernimmst du als Custom Fields, jetzt aber mit Datentyp, Pflichtstatus und Validierungsregeln.
-
RackTables · Tag-Baum
› NetBox: flache Tags
NetBox kennt keine Tag-Hierarchie. Verschachtelte Tags bildest du über Namenskonventionen ab, etwa standort-berlin statt Baumstruktur.
-
RackTables · Ports & Links
› NetBox: Interfaces und Cables
Verbindungen werden echte Cable-Objekte zwischen Interfaces. Sie kommen als letzter Importschritt, wenn beide Endpunkte existieren.
Die Migrationsskripte im Check.
Zwei Community-Tools tauchen in jeder Suche auf. Beide haben Verdienste, beide haben dasselbe Problem: Sie stammen aus der NetBox-2.x-Ära. Aktuell ist NetBox 4.6, dazwischen liegen zwei Major-Versionen.
goebelmeier/racktables2netbox
Das meistverlinkte Migrationstool. Die Projektdoku referenziert das Datenmodell von NetBox 2.3.4, eine Kompatibilitätszusage für aktuelle Versionen gibt es nicht. Am 21.05.2024 hat der Autor das Repository archiviert, seitdem ist es read-only (18 Stars, 18 Forks).
Bekanntester Ansatz · nachvollziehbare Mapping-Logik als Code-Referenz
Archiviert seit Mai 2024 · Ziel NetBox 2.x · keine Pflege mehr
bandwidth-intern/racktables-to-netbox
Das Skript mit dem größten Funktionsumfang: Es liest per SQL direkt aus der RackTables-Datenbank und schreibt über die NetBox-API. Laut README migriert es Racks samt Sites, Geräteplatzierungen, VMs und Cluster, Parent-Child-Beziehungen (Server im Chassis, Patchpanel im Patchpanel), IPs, Netze, VLANs, Interfaces mit IPs, Verbindungen sowie Tags, Labels und Asset-Nummern.
Umfangreichster Scope · SQL-Zugriff statt fragiler Exporte
One-Shot auf leere Instanz · letzter Push 28.08.2022 · VMs mit doppelten Namen fallen raus
SQL-Export plus CSV- und API-Import in die aktuelle NetBox
Statt eine sechs Jahre alte NetBox zu installieren, damit ein Skript von 2022 läuft, exportierst du gezielt aus der RackTables-Datenbank und importierst direkt in die aktuelle Version. NetBox hilft dabei kräftig: Der CSV-Bulk-Import legt neue Objekte an und aktualisiert bestehende, sobald die CSV ein id-Feld enthält. Die REST-API wendet beim Import dieselben Validierungsregeln an wie die UI-Formulare und erstellt viele Objekte in einem einzigen Request. Für Massendaten und Verkabelung ist pynetbox das Werkzeug der Wahl.
Die Reihenfolge ist kein Stilmittel: Devices brauchen Device Types, Interfaces brauchen Devices, und Kabel brauchen beide Endpunkte. Deshalb kommen Sites zuerst und die Verkabelung fast zuletzt. Es ist dieselbe Sequenz, die auch die Migrationsskripte intern abarbeiten.
Migration in vier Phasen.
Der gleiche Ablauf, mit dem wir jede NetBox-Migration führen, hier auf RackTables zugeschnitten. Wenn du die Phasen lieber mit uns gehst: Genau dafür gibt es die Migrationsberatung.
Audit & Datenhygiene
Bestandsaufnahme direkt in RackTables: Was ist aktuell, was ist Leiche, was ist doppelt? Aufräumen vor dem Export spart jede Stunde dreifach.
- Objekt- und Attribut-Inventur
- Duplikate und Altlasten markieren
- Read-only-DB-Zugang einrichten
- Aufwandsschätzung je Objekttyp
Mapping & Zielmodell
Zuordnung je Objekttyp plus NetBox-Zielmodell: Sites, Tenants, Custom Fields und Namenskonventionen einmal sauber definieren.
- Mapping-Tabelle je Objekttyp
- Device-Type-Bibliothek aufbauen
- Custom Fields & Tags definieren
- RBAC-Grundkonzept
Testmigration & Abgleich
Import auf eine Staging-Instanz, Stichproben gegen RackTables, Fehlerliste abarbeiten, wiederholen, bis der Lauf sauber durchgeht.
- CSV- und API-Import auf Staging
- Zählstände je Objekttyp abgleichen
- Kollisions- und Validierungsreport
- Import-Playbook einfrieren
Cutover mit read-only
Finaler Delta-Import, kurze Doppelpflege, dann RackTables auf read-only. Klarer Stichtag, klarer Rollback, kein Feuerwehrmodus.
- Finaler Delta-Import
- RackTables read-only schalten
- Team-Onboarding in NetBox
- Eigenbetrieb oder Managed Service
Sechs Fehler, die dich Wochen kosten.
- Skripte zielen auf NetBox 2.x, produktiv ist 4.6 Das aktuelle Release ist v4.6.4 vom 30.06.2026. Zwischen der Zielversion der alten Skripte und heute liegen zwei Major-Versionen samt Modellbrüchen.
- Umweg über eine Alt-NetBox plus Upgrade-Kette Der 2021 in der netbox-discuss-Liste empfohlene Workaround ist fragil: Das Verkabelungsmodell änderte sich in 2.5, die Choice-Fields-API in 2.8, und seit 2.9 ist VMInterface ein eigenes Modell.
- Datenmüll wandert mit Wer nicht vorher aufräumt, dokumentiert seine Altlasten künftig nur schöner. Datenhygiene gehört in Phase 1, nicht nach den Cutover.
- Generische Objects ohne Device Type NetBox verlangt Manufacturer und Device Type. „Irgendein Server" importiert sich nicht, typisiere vor dem Export.
- Nicht eindeutige VM-Namen racktables-to-netbox ignoriert VMs mit doppelten Namen beim Update-Lauf, weil die Zuordnung zu Clustern sonst kippt. Vorher umbenennen.
- CSV-Export ist nicht CSV-Import Der RackTables-Export passt nicht auf das NetBox-Importformat. Spalten mappen, Pflichtfelder ergänzen, Format je Objekttyp prüfen.
Alle Prüfpunkte, von Datenhygiene bis Cutover, stecken in unserer kostenfreien 28-Punkte-Checkliste für NetBox-Migrationen.
28-Punkte-Checkliste sichern ›Wie Wikimedia von RackTables zu NetBox wechselte.
Export, kurze Doppelpflege, read-only.
Wikimedia hat seine Hardware-Inventur 2018 öffentlich nachvollziehbar migriert: Export und Import starteten am 21. und 24.09.2018, eine Woche lang wurden beide Tools parallel gepflegt, ab dem 01.10.2018 war RackTables read-only. Am 11.10.2018 wurde der Task als Resolved geschlossen.
Die Mechanik ist dieselbe, die sich auch in unseren Projekten bewährt: kurzer Parallelbetrieb mit klarem Stichtag statt monatelanger Doppelpflege.
Deine Fragen, kurz beantwortet.
Migrationspfad klären, bevor du Wochen versenkst.
Im kostenfreien Erstgespräch schauen wir auf deine RackTables-Instanz und sagen dir ehrlich, welcher Importpfad passt. Lieber erst selbst prüfen? Dann hol dir die Checkliste oder sieh NetBox live.