# Fehleranalyse und Debugging

Im Folgenden wird das Vorgehen zur Identifizierung von Systemproblemen beschrieben.

1. Laufen Arbeiten an anderen erforderlichen Systemen oder Infrastruktur parallel? Z.B. Netz, Storage, VM oder IDM
2. Server-Überwachung checken: 
    1. System überlastet? Storage voll gelaufen? CPU-Last?
3. Webserver + DB überprüfen 
    1. Läuft der Webserver?
    2. Ist genügend Speicherplatz frei? `<span class="ms-rteFontFace-2">df -h</span>`
    3. <span class="ms-rteFontFace-2"><span class="ms-rteThemeFontFace-1">Läuft die Datenbank und hat genügend Speicherplatz?</span>  
        </span>
4. Was wurde zuletzt geändert; mögliche Auslöser für Probleme? Changelog sichten.
5. Cronjobs überprüfen 
    1. Läuft der Linux-cron korrekt?
    2. Werden die "Geplanten Vorgänge" sauber abgearbeitet? `/admin/tool/task/scheduledtasks.php`
    3. Cron oder einzelne Tasks ggf. manuell ausführen?
6. Log-Dateien analysieren + Moodle-Konfiguration  
    
    1. Siehe auch Moodle Webserver
    2. Alle Systemklicks nachvollziehbar unter: `/report/log`
    3. Konfigurationsänderungen: `/report/configlog/index.php`
    4. Login via Debug-user ([$CFG-&gt;debugusers = '2';](https://docs.moodle.org/en/Debugging#In_config.php "Moodle Docs: Debug-user einrichten")), der für alle Aktionen im "Developer-Modus" agiert und Fehlermeldungen direkt im Browser anzeigt
7. Moodle-Dateien  
    
    1. Wurden Plugins aktualisiert?
    2. Haben die Moodle-Dateien die erforderlichen Rechte?
8. Viren-Scanner 
    1. Blockiert der Viren-Scanner etwas?
    2. Gibt es massive Performance-Beeinträchtigungen durch Viren-Scanner?
9. Netzwerk + Firewall 
    1. Sind alle benötigten Freigaben erteilt auf Webservern und ggf. Loadbalancer?
    2. IPv6/v4; funktioniert beides? Z.B. testen mit <span class="ms-rteFontFace-2">curl -4 https://moodle-an-hochschulen.de/</span>
    3. Netzwerkverkehr analysieren, z.B. via   
        `tcpdump -i any -nn host [Moodle-Server]`  
        tcpdump-Erklärungen: [https://xinux.net/index.php/Tcpdump\_grundlagen](https://xinux.net/index.php/Tcpdump_grundlagen "tcpdump-Grundlagen") + [https://geekflare.com/tcpdump-examples/](https://geekflare.com/tcpdump-examples/ "tcpdump-Beispiele")  
        in eine Datei schreiben: `-w [Dateiname]`

<div id="bkmrk-">  
</div><div id="bkmrk--1"></div>## Debug-Modus aktivieren mittels config.php 

```bash
//=========================================================================
// 7. SETTINGS FOR DEVELOPMENT SERVERS - not intended for production use!!!
//=========================================================================
//
// Force a debugging mode regardless the settings in the site administration
@error_reporting(E_ALL | E_STRICT);   // NOT FOR PRODUCTION SERVERS!
@ini_set('display_errors', '1');      // NOT FOR PRODUCTION SERVERS!
$CFG->debug = (E_ALL | E_STRICT);     // === DEBUG_DEVELOPER - NOT FOR PRODUCTION SERVERS!
$CFG->debugdisplay = 1;               // NOT FOR PRODUCTION SERVERS!
```

siehe auch: [https://docs.moodle.org/en/Debugging#In\_config.php](https://docs.moodle.org/en/Debugging#In_config.php)

## Bekannte Errors

### Ungültige Kursmodul-ID (core\_error invalidcoursemodule)

Wenn ein Kurs nicht mehr regulär aufgerufen werden kann und stattdessen die Fehlermeldung *"Ungültige Kursmodul-ID"* (lang-string *invalidcoursemodule* in *core\_error*) angezeigt wird, liegt dies oft an Fehlern in der Reihenfolge von Kursabschnitten oder Kursmodulen. Dann hilft meist die Ausführung des CLI-Skripts fix\_course\_sequence.php (ohne *--fix* nur Prüfung auf Fehler):

```
php admin/cli/fix_course_sequence.php -c=* --fix
```

Siehe auch [Moodle-Docs Reihenfolge der Kursmodule reparieren](https://docs.moodle.org/de/Administration_%C3%BCber_Kommandozeile#Reihenfolge_der_Kursmodule_reparieren "Reihenfolge der Kursmodule reparieren (Moodle Docs)")

## Weiterführendes

Debugging allgemein: [https://docs.moodle.org/en/Debugging](https://docs.moodle.org/en/Debugging "Moodle Docs: Debugging")

Debug-Informationen konfigurieren: [https://docs.moodle.org/en/Debugging#Debug\_messages](https://docs.moodle.org/en/Debugging#Debug_messages "Moodle Docs: Debug messages Einstellungen")

---

Autor: [Klaus Steitz](https://forum.moodle-an-hochschulen.de/user/view.php?id=44 "Profil von Klaus Steitz"), Technische Universität Darmstadt