Bekannte Probleme beim Update von i-doit

Dieser Artikel dokumentiert bekannte Probleme, die beim Update auf oder von bestimmten i-doit-Versionen auftreten können, sowie deren Lösungen.

Vor dem Update

Vor jedem Update sollten die folgenden Punkte geprüft werden:

• Backup erstellen — Datenbank und Dateisystem vollständig sichern
• Systemvoraussetzungen prüfen — PHP-, MariaDB- und Apache-Version gegen die Kompatibilitätsmatrix der Zielversion abgleichen
• Add-on-Kompatibilität prüfen — Viele Add-ons haben Mindestversionen pro i-doit-Release
• Schreibrechte sicherstellen — Der Webserver-Benutzer (z.B. www-data) benötigt Schreibrechte auf das i-doit-Verzeichnis

Update auf Version 38

Add-on-Mindestversionen

Beim Update auf v38 müssen zahlreiche Add-ons vorher auf Mindestversionen aktualisiert werden:

Die Add-on-ZIPs stehen im Kundenportal zum Download bereit. Die Installation erfolgt über das Admin-Center unter Add-ons > Install/update module.

Gateway Timeout bei der Migration

Fehlerbild: Das Update bricht mit einem "Gateway Timeout" ab, besonders bei großen Installationen.

Ursache: Große Logbuch-Tabellen verlangsamen die Datenbank-Migration erheblich.

Lösung: Die Timeout-Fehler bei Logbuch-Migrationen können in der Regel ignoriert werden — sie sind nicht kritisch für den Betrieb. Führen Sie das Update erneut durch. Falls das Problem bestehen bleibt:

• Apache/Nginx Timeout-Werte erhöhen
• Das Update per Console durchführen (umgeht Browser-Timeouts):

sudo -u www-data php console.php update \
    -u admin -p admin \
    -z /pfad/zur/idoit-38-update.zip \
    --v 38

Add-on & Subscription Center lädt nicht

Lösung: Der Server muss folgende Adressen erreichen können:

• crm-gateway.i-doit.com
• lizenzen.i-doit.com
• center.i-doit.com

Firewall-Regeln entsprechend anpassen.

Update auf Version 37

HTTP 500 / leere Seite nach dem File-Update

Symptom: Beim Update von Version 36 auf Version 37 oder 38 bricht das Update beim Schritt „4. File-Update" mit einem HTTP-500-Fehler ab, oder i-doit zeigt anschließend bei jedem Aufruf nur eine leere Seite. Das Update von Version 35 auf 36 läuft problemlos.

Fehlermeldung im Webserver-Log:

PHP Fatal error: Uncaught TypeError: Cannot assign null to property isys_tenant::$description of type string in .../src/classes/core/isys_tenant.class.php

Ursache: Auf Installationen, die ursprünglich mit älteren Versionen erstellt wurden, kann die Mandantenbeschreibung in der Datenbank NULL sein. Ab Version 37 ist die zugehörige Property streng als string typisiert, sodass PHP 8 den NULL-Wert ablehnt und jeder Aufruf (einschließlich des Update-Assistenten) mit einem Fatal Error endet.

Lösung: Die leere Mandantenbeschreibung auf einen leeren Wert setzen. Bitte erstellen Sie vorab ein Backup. Die betroffene Tabelle liegt in der System-Datenbank (Standard idoit_system); passen Sie Benutzer und Datenbanknamen im folgenden Befehl entsprechend an.

mysql -u idoit -p idoit_system -e "UPDATE isys_mandator SET isys_mandator__description = '' WHERE isys_mandator__description IS NULL;"

Nach dem Ausführen funktionieren Login und Update wieder. Sollte anschließend eine ähnliche Meldung zu einem anderen Feld erscheinen, wenden Sie sich an den Support.

Update auf Version 35 (von Version 34)

Crypto-Hash-Migration schlägt fehl

Fehlermeldung:

Fatal error: Uncaught ArgumentCountError: 4 arguments are required, 2 given
in migrate-system-crypto-hash-to-tenant.php:28

Lösung: Den Hotfix i-doit_34_ID-11978_migration-of-crypto-hashes.zip auf der Version 34 installieren, bevor das Update auf Version 35 durchgeführt wird. Der Hotfix ist im Hotfix-Archiv der Knowledge Base verfügbar.

Update auf Version 34

HTTP 500 nach Update (SM-View Add-on)

Fehlermeldung im Webserver-Log:

PHP Fatal error: Declaration of
Symfony\Component\HttpFoundation\ResponseHeaderBag::all(?string $key = null)
must be compatible with
Symfony\Component\HttpFoundation\HeaderBag::all(?string $key = null): array

Ursache: SM-View 2024.3.0.2708 ist nicht kompatibel mit i-doit 34.

Lösung: Das SM-View Add-on im Admin-Center deaktivieren, bis eine kompatible Version verfügbar ist.

Update auf Version 33

Funktionen verschwinden nach dem Update

Symptom: Nach dem Update fehlen Funktionen wie die Update-Funktion selbst oder die LDAP-Konfiguration.

Ursache: Platzhalter-Variablen in der Konfigurationsdatei wurden beim Update nicht korrekt durch Werte ersetzt.

Lösung: In der Datei .../i-doit/src/config.inc.php folgende Werte prüfen und korrigieren:

Korrekt:

$g_enable_gui_update = '1';
$g_is_cloud = '0';
$g_active_features = [''];

Falsch (Platzhalter nicht aufgelöst):

$g_enable_gui_update = '%config.admin.enable_gui_update%';
$g_is_cloud = '%config.cloud.active%';
$g_active_features = ['%config.active_features.list%'];

Update von Version 28

"Next"-Button funktioniert nicht nach Hotfix

Symptom: Nach Installation des Hotfix i-doit_28_hotfix_ID-10745.zip wird die neue Version angezeigt, aber ein Klick auf "Next" bewirkt nichts.

Fehlermeldung in der Browserkonsole (F12):

Uncaught ReferenceError: open29NoticeHandler is not defined

Lösung:

1. Das Update auf Version 28 erneut mit dem Updater ausführen
2. Die Update-ZIP der Version 29 aus dem Kundenportal herunterladen
3. Die ZIP im i-doit-Ordner entpacken
4. Das Update auf Version 29 mit dem Updater ausführen

Update von Version 25–28

Updater zeigt falsche Zielversion an

Symptom: Der Updater zeigt v30 als nächste Version an, obwohl v29 korrekt wäre.

Lösung: Das v29-Updatepaket manuell aus dem Kundenportal herunterladen und im i-doit-Ordner entpacken.

Allgemeines Problem: "A problem occurred during update" beim File-Update

Ursache: Fehlende Schreibberechtigungen auf dem Dateisystem.

Lösung je nach Betriebssystem:

Debian/Ubuntu:

cd /var/www/html/
sudo chown www-data:www-data -R .
sudo find . -type d -exec chmod 775 {} \;
sudo find . -type f -exec chmod 664 {} \;

Red Hat Enterprise Linux:

cd /var/www/html/
sudo chown apache:apache -R .
sudo find . -type d -exec chmod 775 {} \;
sudo find . -type f -exec chmod 664 {} \;

SUSE Linux Enterprise Server:

cd /var/www/html/
sudo chown wwwrun:www -R .
sudo find . -type d -exec chmod 775 {} \;
sudo find . -type f -exec chmod 664 {} \;

Nach dem Update

• Cache leeren: Browser-Cache (Strg+Shift+R) und i-doit-Cache (Verwaltung > Systemtools > Cache)
• Reports aktualisieren: Verwaltung > Systemtools > Cache / Datenbank > Reports aktualisieren
• Suchindex erneuern:

sudo -u www-data php console.php search-index -u admin -p admin

Ausführliche Dokumentation: Update einspielen | Bekannte Update-Probleme