This repository has been archived on 2026-11-09. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
Ephaitek-provisioning/docs/troubleshooting.md
T

8.8 KiB

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 :

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é :

which expect || dnf install -y expect

Étape 01 — pfSense : règles créées mais non actives dans PF

Symptôme :

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 :

ssh admin@10.11.0.1 -p 2266 "php /etc/rc.reload_all 2>/dev/null && echo OK"

Vérification :

ssh admin@10.11.0.1 -p 2266 "pfctl -sr | grep VLAN<N>"

É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 :

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 :

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 :

ssh -p 2260 root@ns1.adm "
pdnsutil delete-rrset svc.ephaitek.com <nom> A
pdnsutil delete-rrset adm.ephaitek.com <nom> 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 :

./run-all.sh --vmid <ID> --name <nom> --vlan <N> --only 02

Étape 03 — PKI : CA cert absent

Symptôme :

✖ CA cert Vault absent: /root/admin_tools/pki/root.crt

Solution :

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 :

# 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 <VMID>

Solution : Attendre que la VM soit prête puis rejouer depuis l'étape 03 :

./run-all.sh --vmid <ID> --name <nom> --vlan <N> --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é :

export VM_ROOT_PASSWORD="Tyujkl46"
./run-all.sh --vmid <ID> --name <nom> --vlan <N> --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 :

# Vérifier les règles actives
ssh admin@10.11.0.1 -p 2266 "pfctl -sr | grep VLAN<N>"

# 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.<VLAN> -p 22<VLAN> \
    "curl -s --max-time 10 -o /dev/null -w '%{http_code}' https://mirrors.rockylinux.org"
# Attendu : 200, 301 ou 302

Puis rejouer :

./run-all.sh --vmid <ID> --name <nom> --vlan <N> --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 :

ssh root@10.100.0.<VLAN> -p 22<VLAN>

cat > /etc/dnsmasq.d/split-dns.conf << EOF
# Internet + svc
server=10.60.0.10@10.<VLAN>.0.10
server=10.60.0.11@10.<VLAN>.0.10

# Zone ADM
server=/adm.ephaitek.com/10.100.0.60@10.100.0.<VLAN>
server=/adm.ephaitek.com/10.100.0.61@10.100.0.<VLAN>
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 :

./run-all.sh --vmid <ID> --name <nom> --vlan <N> --only 05

Étape 05 — SSSD : utilisateurs LDAP non résolus

Symptôme :

id: 'youness-adm': no such user

Causes possibles et vérifications :

# 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 :

# 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'
"