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

353 lines
8.8 KiB
Markdown

# 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<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 :
```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 <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 :
```bash
./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 :**
```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 <VMID>
```
**Solution :** Attendre que la VM soit prête puis rejouer depuis l'étape 03 :
```bash
./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é :
```bash
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 :**
```bash
# 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 :
```bash
./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 :
```bash
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 :
```bash
./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 :**
```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'
"
```