Update einspielen#

i-doit sollte immer in der aktuellsten Version betrieben werden. In Minor-Releases befinden sich immer zahlreiche Bugfixes, in Major-Releases dazu dann noch neue Funktionen und Verbesserungen von bestehenden Funktionen. Minor-Releases erscheinen ungefähr alle vier Wochen, Major-Releases alle sechs Monate. Das Update kann über die Web-Oberfläche von i-doit durchgeführt werden, setzt jedoch einen Internetzugang (gegebenenfalls über einen HTTP-Proxy) voraus. Alternativ kann das Update über die Konsole vorbereitet und anschließend über die Web-Oberfläche fortgeführt werden.

Update über die Web-Oberfläche#

Das Update erreichst du entweder unter Verwaltung → [Mandanten-Name] Verwaltung → i-doit Update, über das Quicklaunch-Widget auf dem Dashboard oder über die URL http://i-doit-host/i-doit/?load=update

Nach dem Aufruf öffnet sich eine eigene Oberfläche, in der geprüft wird, wie der aktuelle Zustand des Systems ist. In unserem Screenshot sehen wir, dass unter anderem die PHP-Extension mcrypt nicht gefunden wurde. Sollte solch eine Meldung ausgegeben werden, ist es sehr wichtig, das System dementsprechend anzupassen. Schaue hier am besten in unsere Systemvoraussetzungen bzw. in unsere Systemeinstellungen. Nach der Anpassung der Umgebung sollte alles grün abgehakt bzw. auf "OK" stehen.

Schritt 1: i-doit update und compatibility check#

Schritt 2: Available updates#

In diesem Schritt werden alle verfügbaren Update-Pakete angezeigt. In unserem Beispiel ist i-doit Version 25 installiert und kann daher nur auf die gleiche Version aktualisiert werden.

Nach einem Klick auf Check for a new version wird nach der höchsten Version geprüft, die installiert werden kann.
Nach einem Klick auf Download wird das Update-Paket heruntergeladen und entpackt.
Wenn du eine URL für das Update-Paket hast, kannst du den Link einfügen und auf Download and extract klicken.

Nun steht die neue Version für das Update bereit. Es kann ausgewählt und mit einem Klick auf Next gestartet werden. Wer sich für die Änderungen interessiert, die das Paket mit sich bringt, findet dazu unter see changelog eine Auflistung.

Schritt 3: Database(s)#

In der Regel sind die Haken bereits, wie im Bild erkennbar, gesetzt, sodass die Systemdatenbank und die dazugehörigen Mandanten schon für das Update ausgewählt sind. Sollte es keinen Grund geben, einzelne Mandanten nicht zu aktualisieren, sollten die Haken gesetzt bleiben.

Schritt 4: File-Update#

Allerspätestens jetzt solltest du ein Backup anfertigen. Wenn du ein Backup hast, kannst du über den Button Yes, I did a backup! - Start the update das Update einspielen.

Schritt 5: Overview (Log)#

Jede Änderung kann Auswirkungen auf Dateien und Datenbanken haben. Wenn etwas schief geht (typischerweise wegen fehlender Schreibrechte), erscheint eine rote "ERROR" Meldung. Wenn für jede Änderung ein grünes "DONE" angezeigt wird, kannst du mit dem nächsten Schritt fortfahren, indem du auf Next klickst.

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.

Schritt 7: Attribute migration#

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

Schritt 8: Completion#

Nun ist das Update abgeschlossen. Wer detaillierte Informationen zum Update nachlesen möchte, kann dies in der verlinkten Log-Datei tun. Über Run i-doit v.[VERSION] kann zu i-doit zurückgekehrt werden. Es ist sehr zu empfehlen, den Browser und den i-doit-Cache unter Verwaltung → [Mandanten-Name] Verwaltung → Systemreparatur und Bereinigung zu löschen.

Update über die Konsole vorbereiten#

Das Update kann über die Konsole vorbereitet werden. Für die Vorbereitung muss aus dem Kundenportal das neuste Update-Paket heruntergeladen werden.

Das Update-Paket kann (beispielsweise per WinSCP) auf dem Server abgelegt werden. Verschiebe danach das Paket in das Hauptverzeichnis von i-doit, wenn du es nicht schon direkt dort abgelegt hast. Das geht mit diesem Befehl:

1

mv idoit-26-update.zip /var/www/html/i-doit/

Dann muss das Paket entpackt und alle bestehenden Dateien überschrieben werden.

1
2

cd /var/www/html/i-doit
unzip idoit-26-update.zip

Jetzt werden die Dateirechte angepasst, sodass der Webserver lesend wie schreibend Zugriff auf i-doit hat.

1
2
3
4

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

Nun kannst du in unserer Anleitung für das Update über die Web-Oberfläche weiterschauen und dabei die Schritte für den Download des neuesten Pakets überspringen.

Update über die Konsole via console.php#

Möchte man das Update über die Konsole ausführen wird die console.php verwendet. Dazu verwenden wir den den update Befehl der console.php.

Zuerst wechseln wir in das i-doit root Verzeichnis:

1

cd /var/www/html/i-doit/

Dann führen wir den Update Befehl aus und müssen noch Interaktiv einige Fragen beantworten davor das Update durchgeführt werden kann:

1

sudo -u www-data php console.php update

Wir können dem Befehl auch direkt alle notwendigen Parameter mitgeben. Für ein Update von i-doit Version 1.17 oder 1.17.2 auf Version 1.18 sieht der Befehl wie folgt aus:

1

sudo -u www-data php console.php update -u BENUTZERNAME -p PASSWORT -z /var/www/html/i-doit/idoit-1.18-update.zip --v 1.18

Die Ausgabe kann dann z.B. so aussehen:

Anschließend kann i-doit verwendet werden. Nach dem Update sollte der Cache geleert und der Suche-index erneuert werden.