diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md new file mode 100644 index 0000000..aeb11e9 --- /dev/null +++ b/docs/troubleshooting.md @@ -0,0 +1,353 @@ +# Dépannage + +## Problèmes connus et solutions + +--- + +### run-all.sh démarre mais n'exécute aucune étape + +**Symptôme :** Le script affiche le header et les infos VM puis s'arrête silencieusement. + +**Cause :** `((STEP_COUNT++))` avec `set -e` — l'expression arithmétique retourne exit code 1 quand la valeur vaut 0. + +**Solution :** Vérifier que la ligne dans `run-all.sh` est bien : +```bash +STEP_COUNT=$((STEP_COUNT + 1)) # ✔ correct +# et non : +((STEP_COUNT++)) # ✖ plante avec set -e +``` + +--- + +### Étape 01 — pfSense : valeurs vides (VLAN tag vide, IP vide) + +**Symptôme :** +``` +VLAN tag : +IP interface : 10..0.1/24 +VLAN_IF=vtnet1. +``` + +**Cause :** La version précédente utilisait `printf | script` mais `ask()` dans `provision_pfsense_vlan_interactivev2.sh` utilise `read -r -p` dans des subshells `$()` — le pipe est ignoré. + +**Solution :** Le script utilise maintenant `expect` pour simuler un vrai terminal. Vérifier que `expect` est installé : +```bash +which expect || dnf install -y expect +``` + +--- + +### Étape 01 — pfSense : règles créées mais non actives dans PF + +**Symptôme :** +```bash +ssh admin@10.11.0.1 -p 2266 "pfctl -sr | grep VLAN88" +# ← rien +``` + +**Cause :** pfSense écrit les règles dans sa config XML mais ne recharge pas le moteur PF automatiquement après création d'une nouvelle interface. + +**Solution :** Le script exécute maintenant `php /etc/rc.reload_all` après la création. C'est l'équivalent exact du bouton "Apply Changes" dans l'UI pfSense. + +Pour forcer manuellement : +```bash +ssh admin@10.11.0.1 -p 2266 "php /etc/rc.reload_all 2>/dev/null && echo OK" +``` + +Vérification : +```bash +ssh admin@10.11.0.1 -p 2266 "pfctl -sr | grep VLAN" +``` + +--- + +### Étape 01 — pfSense : erreur PHP `filter_nat_rules_generate` + +**Symptôme :** +``` +PHP ERROR: Type: 1, File: /etc/inc/filter.inc, Line: 2583 +Uncaught TypeError: Cannot access offset of type string on string +``` + +**Cause :** Une règle NAT outbound corrompue (ajoutée en mode hybrid avec un mauvais format) empêche la compilation des règles. + +**Solution :** Remettre le NAT en mode automatic et vider les règles custom : +```bash +ssh admin@10.11.0.1 -p 2266 "php -r ' +require_once(\"globals.inc\"); +require_once(\"config.inc\"); +require_once(\"functions.inc\"); +\$config[\"nat\"][\"outbound\"][\"mode\"] = \"automatic\"; +\$config[\"nat\"][\"outbound\"][\"rule\"] = array(); +write_config(\"Reset NAT to automatic\"); +echo \"OK\n\"; +'" + +ssh admin@10.11.0.1 -p 2266 "php /etc/rc.reload_all 2>/dev/null && echo OK" +``` + +--- + +### Étape 02 — DNS : hostname vide + +**Symptôme :** +``` +❌ Hostname vide +``` + +**Cause :** `dns1maj.sh` utilise `read -r -p` dans des subshells `$()` — stdin pipe ignoré. + +**Solution :** Le script utilise `expect`. Vérifier l'installation : +```bash +which expect || dnf install -y expect +``` + +--- + +### Étape 02 — DNS : enregistrement en double + +**Symptôme :** +``` +New rrset: +testvm.svc.ephaitek.com. 3600 IN A 10.88.0.10 +testvm.svc.ephaitek.com. 3600 IN A 10.88.0.10 +``` + +**Cause :** `dns1maj.sh` a été exécuté deux fois. La logique `replace_a_record` dans le script supprime l'ancien RRset avant d'ajouter, mais en cas de doublon dans la zone, deux entrées peuvent apparaître. + +**Solution :** Nettoyer manuellement sur NS1 : +```bash +ssh -p 2260 root@ns1.adm " +pdnsutil delete-rrset svc.ephaitek.com A +pdnsutil delete-rrset adm.ephaitek.com A +pdnsutil increase-serial svc.ephaitek.com +pdnsutil increase-serial adm.ephaitek.com +pdns_control notify svc.ephaitek.com +pdns_control notify adm.ephaitek.com +" +``` +Puis relancer l'étape 02 : +```bash +./run-all.sh --vmid --name --vlan --only 02 +``` + +--- + +### Étape 03 — PKI : CA cert absent + +**Symptôme :** +``` +✖ CA cert Vault absent: /root/admin_tools/pki/root.crt +``` + +**Solution :** +```bash +mkdir -p /root/admin_tools/pki +ssh root@10.100.0.42 -p 2242 \ + "vault read -field=certificate pki/cert/ca" \ + > /root/admin_tools/pki/root.crt +chmod 644 /root/admin_tools/pki/root.crt +``` + +--- + +### Étape 03 — PKI : VM injoignable après 300s + +**Symptôme :** +``` +✖ VM client1 (10.100.0.11:2211) injoignable après 300s +``` + +**Causes possibles :** +1. La VM n'a pas encore fini de booter (Cloud-Init lent) +2. Le VLAN pfSense n'est pas encore actif (étape 01 en erreur) +3. Le port SSH incorrect + +**Vérifications :** +```bash +# La VM répond au ping ? +ping -c 3 10.100.0.11 + +# Le port SSH est ouvert ? +nc -z -w 3 10.100.0.11 2211 + +# Vérifier dans Proxmox +qm status +``` + +**Solution :** Attendre que la VM soit prête puis rejouer depuis l'étape 03 : +```bash +./run-all.sh --vmid --name --vlan --from 03 +``` + +--- + +### Étape 04 — Split DNS : `the input device is not a TTY` + +**Symptôme :** +``` +the input device is not a TTY +``` + +**Cause :** `deploy-dns-keyv3.sh` fait un `read -s` qui requiert un TTY. Impossible depuis un pipe. + +**Solution :** Le script crée une copie patchée qui lit `DEFAULT_PASSWORD` depuis l'environnement. Vérifier que `VM_ROOT_PASSWORD` est exporté : +```bash +export VM_ROOT_PASSWORD="Tyujkl46" +./run-all.sh --vmid --name --vlan --only 04 +``` + +--- + +### Étape 04 — Split DNS : Internet KO depuis la VM + +**Symptôme :** +``` +❌ Prérequis Internet KO : DNS IPv4 ou HTTPS IPv4 indisponible +``` + +**Cause :** Les règles pfSense WEB (80/443) ne sont pas encore actives. + +**Solution :** +```bash +# Vérifier les règles actives +ssh admin@10.11.0.1 -p 2266 "pfctl -sr | grep VLAN" + +# Si vide : forcer le reload +ssh admin@10.11.0.1 -p 2266 "php /etc/rc.reload_all 2>/dev/null && echo OK" + +# Vérifier ensuite +ssh root@10.100.0. -p 22 \ + "curl -s --max-time 10 -o /dev/null -w '%{http_code}' https://mirrors.rockylinux.org" +# Attendu : 200, 301 ou 302 +``` + +Puis rejouer : +```bash +./run-all.sh --vmid --name --vlan --only 04 +``` + +--- + +### Étape 04 — Split DNS : mauvaises IPs source dans split-dns.conf + +**Symptôme :** dnsmasq tourne mais Internet ne résout pas : +``` +server=10.60.0.10@10.80.0.10 ← IP source incorrecte +``` + +**Cause :** `deploy-dns-keyv3.sh` détecte les IPs source via `ip route get` au moment de l'exécution, et si le routage n'est pas encore stable, il peut prendre une mauvaise interface. + +**Solution :** Corriger manuellement sur la VM : +```bash +ssh root@10.100.0. -p 22 + +cat > /etc/dnsmasq.d/split-dns.conf << EOF +# Internet + svc +server=10.60.0.10@10..0.10 +server=10.60.0.11@10..0.10 + +# Zone ADM +server=/adm.ephaitek.com/10.100.0.60@10.100.0. +server=/adm.ephaitek.com/10.100.0.61@10.100.0. +EOF + +systemctl restart dnsmasq +dig +short google.com @127.0.0.1 +``` + +--- + +### Étape 05 — SSSD : Internet KO, dnf échoue + +**Symptôme :** +``` +✖ Internet inaccessible depuis la VM +``` + +**Cause :** Règles pfSense WEB non actives (même cause qu'étape 04). + +**Solution :** Voir section "Étape 04 — Internet KO" ci-dessus, puis : +```bash +./run-all.sh --vmid --name --vlan --only 05 +``` + +--- + +### Étape 05 — SSSD : utilisateurs LDAP non résolus + +**Symptôme :** +``` +id: 'youness-adm': no such user +``` + +**Causes possibles et vérifications :** + +```bash +# 1. sssd est-il actif ? +systemctl status sssd + +# 2. Peut-il joindre le LDAP ? +journalctl -u sssd -n 30 --no-pager + +# 3. Le LDAP est-il accessible depuis la VM ? +nc -z -w 3 10.100.0.40 389 && echo "LDAP OK" || echo "LDAP KO" + +# 4. Vérifier sssd.conf +cat /etc/sssd/sssd.conf +# Permissions : doit être 600 root:root +ls -la /etc/sssd/sssd.conf + +# 5. Forcer un refresh +sss_cache -E +systemctl restart sssd +sleep 3 +id youness-adm +``` + +--- + +## Suppression propre d'une VM + +Pour supprimer complètement une VM de toute l'infrastructure : + +```bash +# Variables +VMID=1189 +NAME="test-test" +VLAN=35 +OPT_IF="opt15" # vérifier avec : ssh admin@10.11.0.1 -p 2266 "pfctl -sr | grep ${VLAN}" + +# 1. Proxmox +qm stop ${VMID} --skiplock 1 2>/dev/null || true +qm destroy ${VMID} --purge 1 + +# 2. pfSense — supprimer VLAN + interface + règles +ssh admin@10.11.0.1 -p 2266 "php -r ' +require_once(\"globals.inc\"); +require_once(\"config.inc\"); +require_once(\"functions.inc\"); +unset(\$config[\"interfaces\"][\"${OPT_IF}\"]); +foreach (\$config[\"vlans\"][\"vlan\"] as \$k => \$v) { + if ((string)(\$v[\"tag\"] ?? \"\") === \"${VLAN}\") unset(\$config[\"vlans\"][\"vlan\"][\$k]); +} +\$config[\"filter\"][\"rule\"] = array_values(array_filter( + \$config[\"filter\"][\"rule\"] ?? [], + function(\$r) { return strpos(\$r[\"descr\"] ?? \"\", \"VLAN${VLAN}\") === false; } +)); +write_config(\"Cleanup VLAN${VLAN}\"); +echo \"pfSense cleanup OK\n\"; +'" +ssh admin@10.11.0.1 -p 2266 "php /etc/rc.reload_all 2>/dev/null && echo OK" + +# 3. DNS — supprimer les enregistrements +ssh -p 2260 root@ns1.adm " +pdnsutil delete-rrset svc.ephaitek.com ${NAME} A +pdnsutil delete-rrset adm.ephaitek.com ${NAME} A +pdnsutil increase-serial svc.ephaitek.com +pdnsutil increase-serial adm.ephaitek.com +pdns_control notify svc.ephaitek.com +pdns_control notify adm.ephaitek.com +echo 'DNS cleanup OK' +" +``` \ No newline at end of file