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 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