NetDTL Installer - Guide utilisateur

Ce guide explique concrètement comment installer NetDTL sur un poste Windows local avec XAMPP, MariaDB, Nmap et les fichiers applicatifs NetDTL.

WindowsXAMPPMariaDBNmap

Objectif

NetDTL Installer prépare un poste Windows pour exécuter NetDTL en local. À la fin de l'installation, l'application doit être disponible dans un navigateur à l'adresse http://localhost/netdtl/.

L'installateur effectue automatiquement les opérations suivantes : installation ou vérification de Python, installation des modules Python utiles, installation ou vérification de Nmap, installation ou vérification de XAMPP, téléchargement de NetDTL, copie dans C:\xampp\htdocs\netdtl, création de la base netdtl, import du fichier SQL, génération de db.php, puis contrôle d'accès au site local.

Avant de commencer

Ce qu'il faut avoir sous la main

Un compte Windows avec droits administrateur.
Une connexion Internet pendant l'installation, car l'installateur télécharge Python, Nmap, XAMPP et NetDTL si besoin.
Le réseau à scanner au format CIDR, par exemple 192.168.1.0/24. En cas de doute, demander cette valeur à la personne qui administre le réseau.
Le nom du futur administrateur NetDTL, par défaut admin.
Un mot de passe NetDTL à conserver. Il sera utilisé pour ouvrir l'application après installation.

Important : si une autre installation XAMPP existe déjà sur le poste, fermer le panneau de contrôle XAMPP avant de lancer l'installation. L'installateur utilise le dossier standard C:\xampp.

Installer avec l'assistant Windows

Ouvrir le dossier Output du paquet NetDTL Installer.
Double-cliquer sur NetDTL_Installer_v1.0.x.exe. Le numéro exact peut changer selon la version construite.
Accepter la demande Windows de contrôle de compte utilisateur. Sans droits administrateur, l'installation ne peut pas continuer.
Dans l'assistant, garder le dossier proposé sauf besoin particulier : C:\Program Files\NetDTL.
Sur la page Configuration NetDTL, remplir les champs :
- Utilisateur administrateur NetDTL : laisser admin ou saisir le compte souhaité.
- Mot de passe administrateur NetDTL : saisir le mot de passe qui servira à ouvrir NetDTL.
- Réseau CIDR par défaut : saisir le réseau à scanner, par exemple 192.168.1.0/24.
Sur la page des tâches, laisser Créer un raccourci sur le bureau coché si l'utilisateur doit ouvrir NetDTL depuis le Bureau.
Laisser Installer le générateur de tableau de brassage coché si les outils de préparation des données de brassage sont utiles.
Cliquer sur Installer et attendre la fin. Certaines étapes peuvent durer plusieurs minutes, notamment les téléchargements et l'installation de XAMPP.
À la fin, laisser Lancer NetDTL coché pour ouvrir automatiquement l'application dans le navigateur.

Pendant l'installation, les scripts PowerShell sont lancés en arrière-plan. Il est normal de ne pas voir de console détaillée. En cas d'échec, consulter les journaux de l'assistant ou relancer les étapes indiquées plus bas.

Ouvrir NetDTL après installation

Pour ouvrir NetDTL, utiliser l'une des méthodes suivantes :

Double-cliquer sur le raccourci NetDTL créé sur le Bureau.
Ouvrir un navigateur et saisir http://localhost/netdtl/.
Depuis le menu Démarrer, ouvrir le groupe NetDTL, puis choisir NetDTL.

Quand le navigateur demande une identification, saisir l'utilisateur et le mot de passe renseignés dans l'assistant d'installation.

Vérifier l'installation

Après installation, effectuer ces contrôles simples :

Contrôle	Résultat attendu	Que faire si ce n'est pas bon
Adresse `http://localhost/netdtl/`	La page NetDTL s'affiche après authentification.	Vérifier qu'Apache est démarré dans XAMPP, puis relancer le navigateur.
Dossier applicatif	Le dossier `C:\xampp\htdocs\netdtl` existe et contient `index.php`, `db.php` et `netdtl.sql`.	Relancer l'étape de déploiement.
Base de données	MariaDB fonctionne et la base `netdtl` existe.	Démarrer MySQL/MariaDB dans XAMPP, puis relancer l'étape de configuration.
Nmap	`nmap.exe` est présent dans `C:\Program Files\Nmap` ou `C:\Program Files (x86)\Nmap`.	Relancer l'installation des dépendances.

Relancer une étape à la main

Ces commandes servent surtout au dépannage ou à une reprise après échec. Les exécuter dans Windows PowerShell en tant qu'administrateur.

Aller dans le dossier d'installation de NetDTL Installer :

cd "C:\Program Files\NetDTL"

Relancer l'installation ou la vérification des dépendances :

powershell.exe -ExecutionPolicy Bypass -File ".\scripts\install_dependencies.ps1"

Relancer le téléchargement et la copie de NetDTL vers XAMPP :

powershell.exe -ExecutionPolicy Bypass -File ".\scripts\deploy_netdtl.ps1"

Relancer la configuration de la base, du fichier db.php et de la validation web :

powershell.exe -ExecutionPolicy Bypass -File ".\scripts\configure_netdtl.ps1" -AdminUser "admin" -AdminPass "votre_mot_de_passe" -CIDR "192.168.1.0/24"

Adapter votre_mot_de_passe et 192.168.1.0/24 aux valeurs choisies pour le poste. La commande de déploiement remplace le dossier C:\xampp\htdocs\netdtl existant.

Outils de panneau de brassage

Si l'option a été installée, le menu Démarrer contient Générateur tableau de brassage. Cet outil lance le script Python fourni avec NetDTL Installer.

Le fichier d'exemple C:\Program Files\NetDTL\tools\patch_panel_config.json.example indique les colonnes attendues pour préparer les données :

Champ attendu	Colonne exemple	Signification
`prise`	`PortBrassage`	Identifiant de la prise ou du port de brassage.
`hostname`	`NomMachine`	Nom du poste ou de l'équipement.
`ip`	`AdresseIP`	Adresse IP associée.
`type`	`TypePrise`	Type de prise ou d'équipement.
`local`	`Bureau`	Local, bureau ou emplacement.
`notes`	`Commentaire`	Commentaire libre.

Pour personnaliser le mapping, copier patch_panel_config.json.example en patch_panel_config.json, puis remplacer les noms de colonnes par ceux du fichier d'inventaire réel.

Dépannage courant

Le site local ne s'ouvre pas

Ouvrir C:\xampp\xampp-control.exe.
Démarrer Apache et MySQL.
Recharger http://localhost/netdtl/ dans le navigateur.

Le mot de passe ne fonctionne pas

Relancer la configuration avec le mot de passe souhaité. La configuration régénère C:\xampp\htdocs\netdtl\db.php.

powershell.exe -ExecutionPolicy Bypass -File "C:\Program Files\NetDTL\scripts\configure_netdtl.ps1" -AdminUser "admin" -AdminPass "nouveau_mot_de_passe" -CIDR "192.168.1.0/24"

L'installation bloque pendant les téléchargements

Vérifier la connexion Internet, un proxy éventuel et les restrictions antivirus. Relancer ensuite l'installateur ou l'étape install_dependencies.ps1.

MariaDB ou Apache utilise déjà un port

Fermer les autres serveurs locaux déjà actifs. Les cas les plus fréquents sont un ancien XAMPP, WAMP, IIS, Apache ou MySQL installé comme service Windows.

Nmap est introuvable

Vérifier la présence de nmap.exe dans C:\Program Files\Nmap. Si le fichier n'existe pas, relancer l'étape des dépendances en administrateur.