NetBox: installation et configuration sur Debian - Linux

Tom SALA - ITConnect - 05/09
Tutoriel NetBox : installez et configurez cette solution open source pour gérer l’inventaire et la documentation de votre infrastructure réseau.

Sommaire

  • I. Présentation
  • II. Fonctionnement de NetBox
  • III. Installation de NetBox
    • A. Prérequis
    • B. Mise à jour du serveur
    • C. Installation de la base de données PostgreSQL
    • D. Installation de Redis
    • E. Installation de NetBox
    • F. Exécution script d’installation
    • G. Gunicorn
    • H. Installation du serveur HTTP
  • IV. Premiers pas avec NetBox
    • A. Création d’objets
    • B. Ajouter un site
    • C. Ajouter un switch
  • V. Mise à jour NetBox
  • VI. Conclusion

I. Présentation

NetBox est un outil open source combinant à la fois deux rôles importants : un IP Address Management (IPAM) et un Data Center Infrastructure Management (DCIM). Il permet de documenter l’infrastructure réseau, depuis les baies jusqu’aux adresses IP.

NetBox sert de référentiel central et vous laisse décrire, presque sans limite, tous les composants de votre infrastructure :

  • Organisation : Sites, utilisateurs, contacts
  • Baies (DCIM) : Rôles de baie, types (42U, 48U…)
  • Équipements : Rôles et types d’appareils, fabricants, modules matériels, interfaces (Ethernet, SFP, etc.), ports console, ports d’alimentation, adresses MAC
  • Connexions : Câbles physiques, liaisons radio point-à-point, alimentations électriques
  • Sans-fil : SSID et réseaux Wi-Fi
  • IPAM : Adresses IP, plages, VLAN
  • VPN : Tunnels site-à-site ou accès distant
  • Virtualisation : Machines virtuelles, interfaces, disques virtuels, clusters d’hyperviseurs
  • Mais aussi : commentaires, étiquettes (tags), marques, licences, etc.
Page d’accueil NetBox

NetBox a une version community qui permet d’être hébergée sur son infrastructure et propose aussi des services payants destinés aux entreprises. La version open source de NetBox n’impose pas de restrictions d’usage. Les différences avec les offres payantes portent sur les fonctionnalités additionnelles, l’hébergement cloud et le support.

Aussi, NetBox, a une très grande communauté qui a permis la création de plugins. Ils permettent d’ajouter ou d’améliorer certaines fonctionnalités.

Dans ce tutoriel, vous allez procéder à l’installation de NetBox Community sur Linux. Pour ma part, je vais réaliser l’installation sur un serveur Debian 12. Il est tout à fait possible d’installer NetBox sur d’autres distributions. Cependant, à noter que l’installation officielle de NetBox présentée dans la documentation a été réalisée sur Ubuntu 22.04.

II. Fonctionnement de NetBox

Pour commencer, voici un schéma représentatif de la structure de NetBox.

Schéma simplifié du fonctionnement de NetBox

Nous pouvons visualiser les composants suivants :

  • PostgreSQL : Base de données utilisée pour stocker toutes les données
  • Redis : Mémoire tampon utilisée pour les différentes tâches
  • Django : Base de développement de l’application NetBox
  • NetBox : Application contenant toutes les fonctionnalités
  • Rqworker : Processus python permettant d’exécuter des tâches en arrière-plan
  • Gunicorn : Serveur WSGI permettant la communication entre Django et Nginx
  • Nginx/Apache : Serveur web permettant de recevoir les requêtes et accéder à l’application

III. Installation de NetBox

A. Prérequis

Si vous souhaitez installer NetBox sur votre serveur Linux, il faudra vérifier que ces exigences soient acquises pour effectuer une bonne installation. Les exigences pour l’installation sont :

DépendancesVersions supportées

Python

3.10, 3.11, 3.12

PostgreSQL

14+

Redis

4.0+

B. Mise à jour du serveur

Sur votre serveur Linux, fraîchement installée ou non, appliquez les mises à jour de paquets avec la commande suivante :

sudo apt update && sudo apt upgrade -y

C. Installation de la base de données PostgreSQL

Vous allez procéder à l’installation et configuration d’une base de données PostgreSQL. NetBox nécessite PostgreSQL 14 ou une version ultérieure.

Note : veuillez noter que MySQL et d’autres bases de données relationnelles ne sont pas pris en charge.

  • Installation

Pour installer PostgreSQL, vous allez utiliser cette commande :

sudo apt install -y postgresql

Avant de continuer, vérifiez la version que vous venez d’installer de PostgreSQL :

psql -V Affichage version PostgreSQL

Sur Debian 12, c’est la version 15 de PostgreSQL qui est installée. Sur Debian 13, par exemple, ce sera la version 17 de PostgreSQL qui sera installée.

  • Création de la base de données

Vous allez maintenant procéder à la création de la base de données pour NetBox, lui attribuer un nom utilisateur ainsi qu’un mot de passe pour l’authentification.

Avant cela, il faut se connecter à PostgreSQL en tant qu’utilisateur postgres :

sudo -u postgres psql

Vous risquez d’apercevoir comme message : could not change directory to "/root": Permission non accordée, ceci est normal.

Avec cette commande, nous essayons d’exécuter la commande en tant que root, avec l’utilisateur postgres, qui par défaut n’a pas les droits d’accès au d...
[Courte citation de 8% de l'article original]

Loading...