i-doit Update installieren

i-doit sollte immer in der aktuellsten Version betrieben werden. Major-Releases erscheinen alle sechs Monate, Minor-Releases ungefähr alle vier Wochen. Es gibt zwei Update-Wege: über die Web-Oberfläche oder per Console (CLI).

Vor dem Update

1. Backup erstellen — Datenbank und Dateisystem vollständig sichern
2. Systemvoraussetzungen prüfen — PHP-, MariaDB- und Apache-Version gegen die Zielversion abgleichen
3. Add-on-Kompatibilität prüfen — Mindestversionen der Add-ons für die Zielversion beachten
4. Schreibrechte sicherstellen — Der Webserver-Benutzer benötigt Schreibrechte auf das i-doit-Verzeichnis

Versionen überspringen

• Ab Version 20 können Major-Versionen übersprungen werden
• Update auf v38 erfordert mindestens v35 als Ausgangspunkt
• Versionen unter v30 müssen zuerst auf v29 aktualisiert werden

Update über die Web-Oberfläche

1. Navigieren Sie zu Verwaltung > [Mandant] Verwaltung > i-doit Update (oder über das Quicklaunch-Widget auf dem Dashboard)
2. Der Systemcheck prüft die Umgebung — alle Punkte sollten grün/OK sein
3. Klicken Sie auf "Check for a new version" — erfordert Internetverbindung
4. Das Update-Paket wird heruntergeladen und entpackt
5. Datenbanken auswählen — System-Datenbank und Mandanten sind in der Regel bereits vorausgewählt
6. Backup bestätigen und Update mit "Yes, I did a backup! - Start the update" starten
7. File-Update — Dateien werden aktualisiert (bei Fehlern: Schreibrechte prüfen, siehe unten)
8. Migration — Datenbank-Änderungen werden durchgeführt
9. Property Migration — Attribut-Migrationen werden ausgeführt
10. Abschluss — über "Run i-doit" zurück zur Anwendung

Update per Console (CLI)

Für Server ohne Internetzugang oder für automatisierte Updates.

Vorbereitung

Update-ZIP aus dem Kundenportal herunterladen und auf den Server übertragen:

mv /pfad/zur/idoit-38-update.zip /var/www/html/i-doit/
cd /var/www/html/i-doit/
unzip idoit-38-update.zip

Bei der Frage nach dem Überschreiben mit A (All) bestätigen.

Rechte setzen

Debian/Ubuntu:

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

Update ausführen

sudo -u www-data php console.php update \
    -u admin -p admin \
    -z /var/www/html/i-doit/idoit-38-update.zip \
    --v 38

Alternativ ohne Parameter starten — die Console fragt dann interaktiv nach den fehlenden Angaben:

sudo -u www-data php console.php update

Nach dem Update

1. Browser-Cache leeren (Strg+Shift+R)
2. i-doit-Cache leeren unter Verwaltung > Systemtools > Cache
3. Suchindex erneuern:

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

1. Reports aktualisieren unter Verwaltung > Systemtools > Cache / Datenbank

Häufige Probleme beim Update

Bekannte Fehler und deren Lösungen sind in einem eigenen Artikel dokumentiert:

Bekannte Probleme beim Update von i-doit

Ausführliche Dokumentation: Update einspielen in der Knowledge Base