Zum Inhalt

Update i-doit#

Halte i-doit immer auf dem neuesten Stand. Minor-Releases (ca. alle vier Wochen) enthalten Bugfixes, Major-Releases (ca. alle sechs Monate) bringen zusätzlich neue Funktionen.

Du hast zwei Wege für das Update:

Release überspringen ab Version 20

Wenn du direkt auf eine neuere Version, z.B. 26, springen möchtest, kannst du das neueste Update-Paket aus dem Kundenportal herunterladen und im i-doit Ordner entpacken. Die notwendigen Schritte findest du unter updates über die Konsole vorbereiten. Ab Version 25 mit Hotfix, wird auch die Version 27 beim Update-Check für den Download angeboten.

Releases überspringen vor Version 20

Wenn aktuell die Version 1.13.1 installiert und schon die Version 1.13.3 verfügbar ist, wird trotzdem nur die nächsthöhere Version - also 1.13.2 - angezeigt. Allerdings können Minor-Releases grundsätzlich übersprungen werden. Dennoch werden über diesen Weg trotzdem alle Minor-Releases einzeln installiert, bis die aktuellste Version erreicht ist. Wenn du direkt auf die Version 1.13.3 springen möchtest, kannst du das neueste Paket im Kundenportal herunterladen und auf dem i-doit-Host entpacken. Die notwendigen Schritte dafür kannst du hier finden.

Backup

Vor dem Update sollte unbedingt ein Backup angefertigt werden.

Fehlende Schreibrechte

Wenn beim Herunterladen und Extrahieren eine Fehlermeldung erscheint, ist es oft der Fall, dass der Apache-Webserver keine Schreibrechte für den Pfad hat, in dem i-doit installiert ist. Mehr dazu hier

Update über die Web-Oberfläche#

Öffne das Update über einen der folgenden Wege:

  • Verwaltung → [Mandanten-Name] Verwaltung → i-doit Update
  • Quicklaunch-Widget auf dem Dashboard
  • Direkt-URL: http://i-doit-host/i-doit/?load=update

Update via Dashboard

i-doit prüft den aktuellen Systemzustand. Falls etwas nicht stimmt, gleiche die Systemvoraussetzungen und Systemeinstellungen ab. Nach Anpassung sollte alles gruen bzw. "OK" sein.

Schritt 1: i-doit update und Kompatibilität check#

i-doit update

Schritt 2: Available updates#

Hier siehst du alle verfügbaren Update-Pakete.

Update-Available-Check

  • Check for a new version -- prüft, welche hoechste Version verfügbar ist.
  • Download -- lädt das Update-Paket herunter und entpackt es.
  • Hast du eine URL, fuege sie ein und klicke auf Download and extract.

Update-Available-Download

Wähle die neue Version aus und klicke auf Next. Unter see changelog findest du eine Auflistung der Änderungen.

Update-Available-Donwload

Schritt 3: Database(s)#

Die Systemdatenbank und alle Mandanten sind in der Regel bereits ausgewählt. Lass die Haken gesetzt, sofern du keinen Grund hast, einzelne Mandanten auszuschließen.

Update-DB

Schritt 4: File-Update#

Spätestens jetzt solltest du ein Backup haben. Klicke auf Yes, I did a backup! - Start the update, um das Update zu starten.

Update-Files

Schritt 5: Overview (Log)#

Prüfe das Protokoll: Gruenes "DONE" bedeutet Erfolg, rotes "ERROR" deutet auf ein Problem hin (häufig fehlende Schreibrechte). Bei durchgehend gruenen Einträgen klicke auf Next.

Update-Overview

Schritt 6: Migration#

Je nach Update werden Änderungen an bestehenden Daten vorgenommen. Der Schritt "Migration" führt diese aus und meldet, ob die Änderungen erfolgreich waren.

Update-Migration

Schritt 7: Attribute migration#

Nach der sogenannten "Property Migration" sollte hier ebenfalls alles grün angezeigt werden.

Update-Attributes

Schritt 8: Completion#

Das Update ist abgeschlossen. Details findest du in der verlinkten Log-Datei. Klicke auf Run i-doit v.[VERSION], um zurückzukehren. Lösche anschließend den Browser- und i-doit-Cache unter Verwaltung → [Mandanten-Name] Verwaltung → Systemreparatur und Bereinigung.

Update-Complete

Update über die Konsole vorbereiten#

Lade das neueste Update-Paket aus dem Kundenportal oder von der Seite Download Links herunter und übertrage es auf den Server (z. B. per WinSCP). Verschiebe das Paket ins i-doit-Hauptverzeichnis:

1
mv idoit-38-update.zip /var/www/html/

Entpacke das Paket und überschreibe bestehende Dateien:

1
2
cd /var/www/html/
unzip idoit-38-update.zip

Passe die Dateirechte an, damit der Webserver Lese- und Schreibzugriff hat:

Die hier genutzte Benutzer:Gruppen Kombination www-data:www-data bezieht sich auf Debian GNU/Linux oder Ubuntu Linux. Sollte ein anderes Betriebssystem genutzt werden, muss die genutzte Benutzer:Gruppen Kombination angepasst werden.

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

Fahre nun mit dem Update über die Web-Oberfläche fort und überspringe die Download-Schritte.

Update über die Konsole via console.php#

Backup

Erstelle vor dem Update unbedingt ein Backup.

Du kannst das Update auch vollständig über die console.php ausführen. Wechsle dazu ins i-doit-Verzeichnis:

1
cd /var/www/html/

Führe den Update-Befehl aus und beantworte die interaktiven Fragen:

1
sudo -u www-data php console.php update

Alternativ gibst du alle Parameter direkt mit. Beispiel für ein Update auf Version 38:

1
sudo -u www-data php console.php update -u {benutzername} -p {passwort} -z /var/www/html/idoit-38-update.zip --v 38

Nach dem Update#

Führe nach jedem Update folgende Schritte aus:

  1. Cache leeren
  2. Suchindex erneuern
  3. Reporte aktualisieren