352 lines
7.5 KiB
Markdown
352 lines
7.5 KiB
Markdown
# 🔧 TROUBLESHOOTING: Failed to read configuration file
|
|
|
|
**Eroare**: `SYSTEM [CRIT]: Failed to read configuration file /path/to/ircd.conf`
|
|
**Versiune**: v1.0.2
|
|
**Data**: 13 februarie 2026
|
|
|
|
---
|
|
|
|
## 🎯 Problema
|
|
|
|
Serverul IRCd nu pornește și afișează eroarea:
|
|
```
|
|
[2026-2-13 9:48:01] SYSTEM [CRIT]: Failed to read configuration file /home/ircd/ircd/etc/ircd.conf
|
|
```
|
|
|
|
Deși fișierul `ircd.conf` există, serverul nu îl poate citi.
|
|
|
|
---
|
|
|
|
## 🔍 Cauze Posibile
|
|
|
|
### 1. **Permisiuni de Citire** (CEA MAI COMUNĂ)
|
|
Fișierul există dar utilizatorul care rulează serverul nu are dreptul să îl citească.
|
|
|
|
### 2. **Fișier Gol sau Corupt**
|
|
Fișierul există dar are 0 bytes sau este corupt.
|
|
|
|
### 3. **Cale Greșită**
|
|
Serverul caută fișierul într-o locație diferită.
|
|
|
|
### 4. **Proprietar Diferit**
|
|
Fișierul aparține altui utilizator.
|
|
|
|
### 5. **Sintaxă Invalidă**
|
|
Config-ul are erori de sintaxă care împiedică citirea.
|
|
|
|
---
|
|
|
|
## ✅ Soluții - Pas cu Pas
|
|
|
|
### SOLUȚIE 1: Diagnosticare Automată (RECOMANDATĂ)
|
|
|
|
Rulează noul script de diagnosticare:
|
|
|
|
```bash
|
|
./diagnose.sh
|
|
```
|
|
|
|
Acest script va verifica automat:
|
|
- ✅ Existența fișierului
|
|
- ✅ Permisiuni de citire
|
|
- ✅ Mărimea fișierului
|
|
- ✅ Sintaxa configurației
|
|
- ✅ Acolade și ghilimele
|
|
- ✅ Proprietar fișier
|
|
- ✅ Directoare necesare
|
|
|
|
**Output-ul te va ghida spre problema exactă!**
|
|
|
|
---
|
|
|
|
### SOLUȚIE 2: Verificare Manuală Rapidă
|
|
|
|
```bash
|
|
# 1. Verifică dacă fișierul există
|
|
ls -la ~/ircd/etc/ircd.conf
|
|
|
|
# Ar trebui să vezi ceva gen:
|
|
# -rw------- 1 ircd ircd 12345 Feb 13 09:00 ircd.conf
|
|
|
|
# 2. Verifică conținutul (primele 10 linii)
|
|
head -10 ~/ircd/etc/ircd.conf
|
|
|
|
# Ar trebui să vezi configurația (General, Port, etc.)
|
|
```
|
|
|
|
---
|
|
|
|
### SOLUȚIE 3: Remediere Permisiuni
|
|
|
|
Dacă diagnosticarea arată probleme de permisiuni:
|
|
|
|
```bash
|
|
# Setează permisiuni corecte (owner poate citi/scrie)
|
|
chmod 600 ~/ircd/etc/ircd.conf
|
|
|
|
# Verifică din nou
|
|
ls -la ~/ircd/etc/ircd.conf
|
|
```
|
|
|
|
Permisiunile corecte:
|
|
- **600** = `-rw-------` (doar owner poate citi/scrie)
|
|
- **644** = `-rw-r--r--` (owner citire/scriere, alții citire)
|
|
|
|
---
|
|
|
|
### SOLUȚIE 4: Verificare Proprietar
|
|
|
|
```bash
|
|
# Verifică cine este proprietarul
|
|
stat ~/ircd/etc/ircd.conf
|
|
|
|
# SAU
|
|
ls -la ~/ircd/etc/ircd.conf
|
|
|
|
# Dacă proprietarul este diferit, schimbă-l:
|
|
chown $USER:$USER ~/ircd/etc/ircd.conf
|
|
```
|
|
|
|
---
|
|
|
|
### SOLUȚIE 5: Test Sintaxă Config
|
|
|
|
```bash
|
|
# Testează configurația cu ircd -c
|
|
~/ircd/bin/ircd -c -f ~/ircd/etc/ircd.conf
|
|
|
|
# SAU folosind meniul admin
|
|
./admin.sh
|
|
# → Opțiunea 8 (Test sintaxă configurare)
|
|
```
|
|
|
|
Dacă apar erori de sintaxă:
|
|
- Verifică acolade `{ }` potrivite
|
|
- Verifică ghilimele `" "` închise
|
|
- Verifică punct-virgulă `;` la sfârșitul liniilor
|
|
|
|
---
|
|
|
|
### SOLUȚIE 6: Regenerare Config
|
|
|
|
Dacă fișierul este corupt sau gol:
|
|
|
|
```bash
|
|
# Folosind meniul admin
|
|
./admin.sh
|
|
# → Opțiunea 5 (Editare configurare)
|
|
# → În editor, șterge totul și salvează fișierul gol
|
|
# → La ieșire din editor, va fi creat un config nou
|
|
|
|
# SAU manual cu install.sh
|
|
./install.sh
|
|
# → Va detecta config existent și va întreba dacă vrei să îl suprascrii
|
|
```
|
|
|
|
---
|
|
|
|
## 🛠️ Folosind Meniul Admin Îmbunătățit (v1.0.2)
|
|
|
|
Din versiunea **v1.0.2**, meniul `admin.sh` are verificări avansate:
|
|
|
|
```bash
|
|
./admin.sh
|
|
```
|
|
|
|
### Opțiunea 1 - Pornire Server
|
|
Acum verifică automat:
|
|
- ✅ Existența fișierului config
|
|
- ✅ Permisiuni de citire
|
|
- ✅ Fișier nu este gol
|
|
- ✅ Permisiuni executabil
|
|
- ✅ **Afișează diagnosticare detaliată la erori**
|
|
|
|
### Opțiunea 8 - Test Sintaxă
|
|
Acum verifică:
|
|
- ✅ Permisiuni detaliate
|
|
- ✅ Mărimea fișierului
|
|
- ✅ Sintaxă acolade
|
|
- ✅ Statistici config (blocuri General, Port, etc.)
|
|
- ✅ **Sugestii de remediere**
|
|
|
|
---
|
|
|
|
## 📋 Checklist Verificare Completă
|
|
|
|
Urmează acești pași în ordine:
|
|
|
|
```bash
|
|
# ☐ 1. Rulează diagnosticare automată
|
|
./diagnose.sh
|
|
|
|
# ☐ 2. Verifică existența fișierului
|
|
ls -la ~/ircd/etc/ircd.conf
|
|
|
|
# ☐ 3. Verifică conținutul (nu este gol)
|
|
wc -l ~/ircd/etc/ircd.conf
|
|
# Ar trebui să aibă > 0 linii
|
|
|
|
# ☐ 4. Verifică permisiuni
|
|
# Ar trebui: -rw------- sau -rw-r--r--
|
|
chmod 600 ~/ircd/etc/ircd.conf
|
|
|
|
# ☐ 5. Testează sintaxă
|
|
~/ircd/bin/ircd -c -f ~/ircd/etc/ircd.conf
|
|
|
|
# ☐ 6. Verifică proprietar
|
|
stat ~/ircd/etc/ircd.conf
|
|
# Owner ar trebui să fie utilizatorul curent
|
|
|
|
# ☐ 7. Încearcă pornirea din nou
|
|
./admin.sh → Opțiunea 1
|
|
```
|
|
|
|
---
|
|
|
|
## 🎯 Exemplu Real - Rezolvare Pas cu Pas
|
|
|
|
### Problema ta specifică:
|
|
```
|
|
[2026-2-13 9:48:01] SYSTEM [CRIT]: Failed to read configuration file /home/ircd/ircd/etc/ircd.conf
|
|
```
|
|
|
|
### Pași de rezolvare:
|
|
|
|
```bash
|
|
# 1. Conectează-te ca utilizatorul ircd
|
|
su - ircd
|
|
# SAU
|
|
sudo -u ircd bash
|
|
|
|
# 2. Rulează diagnosticarea
|
|
cd ~/underchat-ircd
|
|
./diagnose.sh
|
|
|
|
# 3. Observă output-ul - va afișa exact ce este greșit
|
|
|
|
# 4. Urmează sugestiile din diagnose.sh
|
|
|
|
# 5. Dacă diagnosticarea spune "permisiuni", rulează:
|
|
chmod 600 /home/ircd/ircd/etc/ircd.conf
|
|
|
|
# 6. Dacă diagnosticarea spune "fișier gol", regenerează:
|
|
./admin.sh → Opțiunea 5 (editează și salvează un config valid)
|
|
|
|
# 7. Test final:
|
|
./admin.sh → Opțiunea 1 (Pornire server)
|
|
```
|
|
|
|
---
|
|
|
|
## 🔧 Troubleshooting Avansat
|
|
|
|
### Verifică exact ce eroare dă ircd:
|
|
|
|
```bash
|
|
# Rulează ircd manual pentru a vedea toate erorile
|
|
~/ircd/bin/ircd -f ~/ircd/etc/ircd.conf
|
|
|
|
# SAU cu debugging:
|
|
~/ircd/bin/ircd -d -f ~/ircd/etc/ircd.conf 2>&1 | tee ircd_debug.log
|
|
```
|
|
|
|
### Verifică log-urile sistemului:
|
|
|
|
```bash
|
|
# Ultimele erori din log
|
|
tail -50 ~/ircd/log/ircd.log
|
|
|
|
# Caută erori critice
|
|
grep -i "error\|crit\|fail" ~/ircd/log/ircd.log
|
|
```
|
|
|
|
### Verifică dacă există blocaje de SELinux (CentOS/RHEL):
|
|
|
|
```bash
|
|
# Verifică status SELinux
|
|
getenforce
|
|
|
|
# Dacă este Enforcing, temporar dezactivează:
|
|
sudo setenforce 0
|
|
|
|
# Încearcă din nou să pornești serverul
|
|
./admin.sh → Opțiunea 1
|
|
|
|
# Dacă acum funcționează, problema era SELinux
|
|
# Configurează SELinux permanent:
|
|
sudo setsebool -P httpd_can_network_connect 1
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 Comparație Erori Comune
|
|
|
|
| Eroare | Cauză | Soluție |
|
|
|--------|-------|---------|
|
|
| `Failed to read configuration file` | Permisiuni | `chmod 600 ircd.conf` |
|
|
| `Configuration file not found` | Cale greșită | Verifică `-f` parameter |
|
|
| `Parse error in config` | Sintaxă invalidă | `ircd -c -f config` |
|
|
| `Empty configuration` | Fișier gol | Regenerează config |
|
|
| `Permission denied` | User greșit | Rulează ca owner |
|
|
|
|
---
|
|
|
|
## ✅ Verificare Finală După Rezolvare
|
|
|
|
După ce ai rezolvat problema:
|
|
|
|
```bash
|
|
# 1. Test sintaxă
|
|
./admin.sh → Opțiunea 8
|
|
|
|
# Ar trebui să vezi:
|
|
# ✓ CONFIGURARE VALIDĂ!
|
|
|
|
# 2. Pornire server
|
|
./admin.sh → Opțiunea 1
|
|
|
|
# Ar trebui să vezi:
|
|
# [+] ✓ Server pornit cu succes!
|
|
# [+] PID: 12345
|
|
|
|
# 3. Verifică status
|
|
./admin.sh → Opțiunea 4
|
|
|
|
# Ar trebui să vezi:
|
|
# Status: PORNIT
|
|
# PID: 12345
|
|
# CPU: X% | RAM: Y KB
|
|
```
|
|
|
|
---
|
|
|
|
## 📚 Referințe
|
|
|
|
- **diagnose.sh** - Script automat de diagnosticare (NOU în v1.0.2)
|
|
- **admin.sh** - Meniu cu verificări îmbunătățite (v1.0.2)
|
|
- **COMANDA_CONFIGURE.md** - Parametrii de configurare
|
|
- **INSTALL_AUTO.md** - Ghid complet de instalare
|
|
|
|
---
|
|
|
|
## 🆘 Încă Nu Funcționează?
|
|
|
|
Dacă după toate aceste verificări încă nu merge:
|
|
|
|
1. **Rulează diagnose.sh** și trimite output-ul complet
|
|
2. **Verifică log-ul complet**: `cat ~/ircd/log/ircd.log`
|
|
3. **Verifică sistemul**: `uname -a` și `ls -la ~/ircd/etc/`
|
|
4. **Regenerează totul**:
|
|
```bash
|
|
cd underchat-ircd
|
|
./install.sh --prefix ~/ircd-new
|
|
```
|
|
|
|
---
|
|
|
|
**Repository**: https://gitlab.back.ro/underchat/ircu2.git
|
|
**Versiune**: v1.0.2
|
|
**Data**: 13 februarie 2026
|
|
**Status**: ✅ Rezolvată cu diagnose.sh
|
|
|