Fehlermeldung "Lost link to database" beim Login

Problem

In der Login-Maske erscheint nach Eingabe der Zugangsdaten die Fehlermeldung "Lost link to database". Der Login schlägt fehl.

Ursache

i-doit kann keine Verbindung zur Mandanten-Datenbank herstellen. Häufige Ursachen:

• Der Datenbank-Benutzer existiert nicht (z.B. nach einem Serverumzug)
• Die gespeicherten Datenbank-Credentials sind ungültig
• Der MariaDB/MySQL-Dienst ist nicht erreichbar
• Der Datenbank-Benutzer hat keine Leserechte auf die Mandanten-Datenbank

Diagnose

Datenbank-Verbindung testen

Auf der Kommandozeile des i-doit-Servers prüfen, ob der Datenbank-Benutzer sich anmelden kann:

mysql -h localhost -u idoit -p

Falls die Anmeldung fehlschlägt, sind die Credentials ungültig.

Datenbankrechte prüfen

Nach erfolgreicher Anmeldung testen, ob der Zugriff auf die Mandanten-Datenbank möglich ist:

USE idoit_data;
SHOW TABLES;

Werden Fehlermeldungen ausgegeben, fehlen die Leserechte.

Mandanten-Konfiguration prüfen

Die Datenbank-Credentials für jeden Mandanten sind in der System-Datenbank gespeichert:

USE idoit_system;
SELECT isys_mandator__title, isys_mandator__db_host,
       isys_mandator__db_user, isys_mandator__db_pass
FROM isys_mandator;

Prüfen Sie, ob die hier gespeicherten Werte korrekt sind.

Lösung

Datenbank-Benutzer anlegen oder korrigieren

Falls der Benutzer fehlt (z.B. nach einem Serverumzug), kann er neu angelegt werden:

CREATE USER 'idoit'@'localhost' IDENTIFIED BY 'sicheres_passwort';
GRANT ALL PRIVILEGES ON idoit_data.* TO 'idoit'@'localhost';
FLUSH PRIVILEGES;

Ersetzen Sie idoit, idoit_data und das Passwort durch die tatsächlichen Werte Ihrer Installation.

Mandanten-Credentials aktualisieren

Falls die Credentials in der System-Datenbank nicht mehr stimmen, können sie im Admin-Center unter Config korrigiert werden — oder direkt in der Datenbank:

USE idoit_system;
UPDATE isys_mandator
SET isys_mandator__db_user = 'idoit',
    isys_mandator__db_pass = 'sicheres_passwort'
WHERE isys_mandator__title = 'Mandant';

Ausführliche Dokumentation: Troubleshooting in der Knowledge Base