Wie führe ich ein Update/Upgrade durch?

userdata/
userdata/*
web/images/

vom Webserver gelesen, geschrieben und ausgeführt werden dürfen.

Dieses HowTo beschreibt, wie Sie Ihre bestehende VIMP-Installation auf eine aktuelle Version updaten oder auch upgraden (z.B. von VIMP Ultimate zu VIMP Corporate), inklusive bereits installierter Module.

Vor einem Update erstellen Sie bitte IMMER ein Backup der Dateien und der Datenbank!
In diesem Artikel haben wir den Backup-Vorgang beschrieben.

Ein VIMP-Updatepaket hat die folgende Benennung:
vimp.framework-<version>-<edition>-updater.bin

Ein VIMP-Modul-Updatepaket hat folgende Benennung:
vimp.module.<modulname>-<version>-updater.bin

VIMP In-Place Updater

Seit Version 5.0 kann VIMP komfortabel über die "VIMP Update"-Seite im Backend auf eine neue Version aktualisiert werden.

Bitte beachten Sie, dass nur Administratoren, die die Berechtigung "access backend update" zugewiesen haben, Zugriff auf den In-Place Updater erhalten.

Laden Sie über das Dateiauswahlfeld einfach die neue Updater-Datei hoch (vimp.framework-<version>-<edition>-updater.bin) und starten Sie anschließend das Update. Sie können dabei noch auswählen, ob Sie die Erstellung eines Backups überspringen möchten (nicht empfohlen!) und ob Sie die Update-Datei nach der Durchführung des Updates wieder löschen möchten.

Den Update-Fortschritt sehen Sie im Log-Fenster. Das Log können Sie anschließend abspeichern

Sollte es einmal zu einem Fehler bei einem Update kommen, so können Sie problemlos zur letzten Version zurückkehren, indem Sie das zuvor erstellte Backup wieder einspielen.

Manuelles Update

Sofern Sie VIMP in einer Version kleiner als 5.0.0 einsetzen, muss das Update manuell durchgeführt werden.

Im Beispiel werden wir VIMP Ultimate [Standard] 4.2.12 auf VIMP 4.3.0 updaten.

Laden Sie die Update-Pakete dafür in das VIMP-Installationsverzeichnis Ihres Servers hoch, z.B. per SFTP oder FTP.

Als root wechseln Sie in der Shell (z.B. mit Putty) in das VIMP Installationsverzeichnis und geben den Paketen die Berechtigung zum Ausführen (wir gehen im Folgenden von einer Installation unter /var/www/html aus):

cd /var/www/html
chmod +x vimp.*-updater.bin

Leeren Sie den VIMP Cache:

./vimp cc

Wichtiger Hinweis:

In VIMP-Versionen kleiner 6.x benutzen Sie bitte statt ./vimp den Befehl ./symfony in obigem Code.

Führen Sie dann das Update-Skript (=Paket) aus:

./vimp.framework-4.3.0-r27301-ultimate-standard-updater.bin

Zuerst werden Sie nach dem Pfad des Installationsverzeichnisses gefragt. Der Default-Wert ist das aktuelle Verzeichnis und steht in eckigen Klammern [...].

Install path [/var/www/html]:

Klicken Sie zur Übernahme des Pfades einfach auf Return.

Der Updater prüft nun die Systemvoraussetzungen:

Starting Installer ...
>> OK        PHP version is at least 7.0.0 (7.4.6)
>> OK        PHP version is equal or less than 7.4.x (7.4.6)
>> OK        DOM extension is installed
>> OK        XML extension is installed
>> OK        XSL extension is installed
>> OK        Tokenizer extension is installed
>> OK        Multibyte String extension is installed
>> OK        iconv extension is installed
>> OK        Posix extension is installed
>> OK        GD extension is installed
>> OK        Imagick extension is installed
>> OK        cUrl extension is installed
>> OK        mysql extension is installed
>> OK        mcrypt extension is installed
>> OK        PDO is installed
>> OK        PDO mysql driver is installed
>> INFO      PDO has some drivers installed: mysql, sqlite
>> OK        MySQL version is at least 5.0.6 (5.5.5-10.4.17-MariaDB)
>> OK        SourceGuardian extension is installed
>> OK        php.ini has short_open_tag set to off
>> OK        php.ini has magic_quotes_gpc set to off
>> OK        php.ini has register_globals set to off
>> OK        php.ini has safe_mode set to off
>> OK        php.ini has session.auto_start set to off
>> OK        php.ini has file_uploads set to on
>> OK        php.ini has allow_url_fopen set to on
>> OK        php.ini has register_argc_argv set to on
>> OK        php.ini has set memory_limit not equal to -1
>> OK        php.ini has set memory_limit greater or equal than 512M
>> OK        php.ini has set memory_limit lesser than 2G
>> OK        php.ini has set post_max_size greater or equal than 100M
>> OK        php.ini has set post_max_size lesser than 2G
>> OK        php.ini has set upload_max_filesize greater or equal than 100M
>> OK        php.ini has set upload_max_filesize lesser than 2G
>> OK        ffmpeg is installed
>> OK        ffprobe is installed
>> OK        exiftool is installed
>> INFO      Version: 4.3.0 (r27301)
>> INFO      Edition: ULTIMATE
>> INFO      OS: Linux 5.4.0-42-generic #46-Ubuntu SMP Fri Jul 10 00:24:02 UTC 2020
>> INFO      Memory: 63GB
 Continue? [Y/n]:

Da wir eine funktionierende VIMP-Installation updaten, sollten keine ERROR Meldungen gezeigt werden. Bestätigen Sie zum Fortfahren mit Return.

Die neuen Dateien werden jetzt aus dem Paket kopiert. Der Updater prüft, was er zu tun hat und fragt zur Sicherheit jeweils nach, ob er fortfahren soll.

...
>> update    Table channel_user changed
>> update    Table config changed
>> update    Table menu changed
>> update    Table role_permission changed
 Changes for Database found. Apply? [Y/n]:

Bestätigen Sie, ob Änderungen an der Datenbank jetzt ausgeführt werden sollen. Wenn Sie noch keinen mysqldump (Backup der DB) erstellt haben, könnten Sie hier noch abbrechen.

...
>> update    Changing table category...
>> update    Check filesystem for changes
>> update    File /data/sql/updates.sql changed
>> update    File /data/sql/upgrade.sql changed
 Changes for filesystem found. Apply? [Y/n]:

Bestätigen Sie wieder per Return und das Update des Frameworks wird ausgeführt.

VIMP ist jetzt upgedated/upgegraded und Sie können es im Browser unter Ihrer Domain aufrufen.

Das war es schon.