Updater aktualisieren

Mit dieser Anleitung installieren Sie den aktuellen FlinkISO-Updater und laden anschließend Anwendungsupdates direkt aus FlinkISO herunter. Das Updater-Paket ersetzt drei Anwendungsdateien. Es installiert weder den Server noch die Anwendung neu.

FlinkISO-Updater.zip herunterladen ↓

1. Updater aktualisieren

1.1 Ubuntu / Linux: den Updater mit drei Befehlen aktualisieren

Führen Sie diese Befehle in Ihrem SSH-Terminal aus. Ersetzen Sie /var/www/html/flinkiso durch Ihren Installationspfad, falls dieser abweicht. Sichern Sie vor dem Update Ihre vorhandenen Anwendungsdateien und die Datenbank.

curl -fL https://www.flinkiso.com/flinkiso-updates/FlinkISO-Updater.zip -o /tmp/FlinkISO-Updater.zip
unzip -o /tmp/FlinkISO-Updater.zip -d /tmp/flinkiso-updater
sudo cp -r /tmp/flinkiso-updater/app/. /var/www/html/flinkiso/app/

Melden Sie sich anschließend als Administrator an und klicken Sie im oberen Menü auf das Downloadsymbol .

app/. im Kopierbefehl bedeutet „den Inhalt von app kopieren“. So werden die drei Updater-Dateien in die vorhandene Anwendung eingefügt, ohne einen zusätzlichen Ordner app/app anzulegen. Die ZIP-Datei enthält weder Ihre core.php noch Datenbankeinstellungen oder hochgeladene Dateien.

Falls curl oder unzip auf Ubuntu / Debian fehlt, installieren Sie die Programme einmalig:

sudo apt install curl unzip

Das Kopieren der Dateien erfordert normalerweise keinen Apache-Neustart. Verwenden Sie die Befehle zur Fehlerbehebung in Abschnitt 4 nur, wenn ein Fehler auftritt.

1.2 Updater manuell aktualisieren

Verwenden Sie diese Alternative, wenn Sie die ZIP-Datei auf Ihren Computer herunterladen und die Dateien mit einem Dateiübertragungsprogramm kopieren möchten. Sie, Ihr Hosting-Anbieter oder Ihr Serveradministrator benötigen Zugriff auf die Installationsdateien.

1. Vorhandene Installation sichern. Sichern Sie die Anwendungsdateien und erstellen Sie eine separate Datenbanksicherung, bevor Sie Dateien ersetzen. Die datierte Sicherung des Updaters enthält Anwendungsdateien; sie ist kein Datenbankexport.
2. Paket herunterladen. Speichern Sie FlinkISO-Updater.zip und entpacken Sie die Datei auf Ihrem Computer.
3. Installationsverzeichnis ermitteln. Dies ist das Verzeichnis, das app und lib enthält. Wenn Ihre Website in einem Unterverzeichnis wie /flinkiso/ läuft, verwenden Sie das Stammverzeichnis dieser Installation.
4. Dateien in diese Installation kopieren. Führen Sie den entpackten Ordner app mit dem vorhandenen Ordner app zusammen und lassen Sie die drei enthaltenen Dateien überschreiben. Löschen oder ersetzen Sie nicht den gesamten Anwendungsordner und legen Sie keinen zusätzlichen Ordner app/app an.
5. Servervoraussetzungen prüfen. Die PHP-Umgebung, die FlinkISO ausführt, benötigt cURL und eine aktivierte Funktion exec(). Auf dem Server muss das Kommandozeilenprogramm unzip verfügbar sein. PHP ZipArchive wird für dieses Paket nicht benötigt.
6. Anwendungsupdater öffnen. Melden Sie sich mit einem berechtigten Administratorkonto an und öffnen Sie den Updater über das Downloadsymbol im oberen Menü. Aktualisieren Sie die Seite nach dem Ersetzen der Dateien und fahren Sie mit Abschnitt 2 fort.

Im Paket enthaltene Dateien

app/Controller/BillingController.php
app/Lib/FlinkisoUpdater.php
app/View/Billing/update.ctp

Kopieren Sie alle drei Dateien aus demselben Paket. app/Config/core.php, Datenbankzugangsdaten und Kundenuploads sind nicht enthalten. Behalten Sie diese installationsspezifischen Dateien unverändert bei.

2. Anwendungsupdates aus FlinkISO ausführen

Planen Sie das Update für einen Zeitpunkt, an dem andere Benutzer abgemeldet sind. Bewahren Sie die Datenbanksicherung separat auf und stellen Sie ausreichend freien Speicherplatz für Anwendungssicherung, Download und Installationsarbeitsverzeichnis bereit.

1. Auf das Downloadsymbol klicken. Verwenden Sie die gewünschte Installation und ein berechtigtes Administratorkonto.
2. Sichern und aktualisieren auswählen. Der Updater prüft die konfigurierte GitHub-Quelle und bereitet eine datierte Anwendungssicherung vor. In der englischen Oberfläche heißt die Schaltfläche „Back up and update“.
3. Bei vorhandener Tagessicherung entscheiden. Sie können eine weitere Sicherung in einem Unterordner mit Uhrzeit anlegen oder eine abgeschlossene Sicherung vom selben Tag wiederverwenden. Unvollständige Sicherungen können nicht wiederverwendet werden.
4. Seite geöffnet lassen. Animierte Anzeigen und Fortschrittsbalken zeigen Verbindung, Sicherung, Download, Entpacken, Dateiprüfungen, SQL-Verarbeitung und Installation an. Starten Sie kein zweites Update in einem anderen Tab.
5. Abschlussmeldung abwarten. Der Updater lädt das konfigurierte Archiv herunter, entpackt es, verarbeitet die SQL-Anweisungen und installiert die Anwendungsdateien. Fehler einzelner SQL-Anweisungen werden protokolliert und übersprungen, damit die Verarbeitung fortgesetzt werden kann.
6. Ergebnis prüfen und Anwendung testen. Prüfen Sie die Abschlussmeldung, melden Sie sich bei Bedarf erneut an und testen Sie wichtige Seiten. Klären Sie Installations- oder Wiederherstellungsfehler vor einem erneuten Versuch. Falls Hinweise zu ApiPath oder PDFTkPath angezeigt werden, lassen Sie diese Einstellungen gesondert prüfen; der Updater verändert die core.php nicht.

Woher stammen die Updates?

Ohne kundenspezifische Repository-Einstellung verwendet der Updater Techmentis/FlinkISO-QMS-Updates. Eine Kundeninstallation kann stattdessen ein konfiguriertes privates GitHub-Repository verwenden. URL, Archivordner und persönlicher Zugriffstoken (PAT) werden in der core.php angegeben. Alle drei Werte müssen vollständig sein. Veröffentlichen Sie den PAT niemals in einer Supportnachricht oder einem Bildschirmfoto.

Speicherorte für Sicherungen und Protokolle

Der aktuelle Updater erhält vorhandene Konfigurationen, hochgeladene Dateien und installierte PO-/MO-Übersetzungskataloge. Die SQL-Verarbeitung bietet keine Datenbankrücksetzung: Eine Datenbankänderung kann bestehen bleiben, auch wenn ein späterer Dateivorgang fehlschlägt.

3. Wer darf die Anwendung aktualisieren?

Das Webserverkonto der Anwendung muss die zu sichernden Dateien lesen und in den Sicherungsordner, das Update-Arbeitsverzeichnis und die zu ersetzenden Anwendungspfade schreiben können. Für ein SSH- oder Dateiübertragungskonto können andere Berechtigungen gelten.

4. Fehler, Warnungen und Hinweise

Nutzen Sie den genauen Meldungstext und den betroffenen Pfad, um die Ursache einzugrenzen. Bewahren Sie das Ausführungsprotokoll für Supportanfragen auf. Entfernen Sie Tokens und Zugangsdaten aus allen Informationen, die Sie weitergeben. Die folgenden Meldungen sind zur Wiedererkennung im englischen Original aufgeführt.

Ubuntu / Debian: Befehle für häufige Serverprobleme

PHP cURL und exec() prüfen

Diese Befehle prüfen Kommandozeilen-PHP. Apache oder PHP-FPM kann eine andere PHP-Version oder Konfiguration verwenden. Vergleichen Sie das Ergebnis deshalb mit der Umgebung, die FlinkISO ausführt.

php -v
php --ini
php -r 'echo "cURL: ", extension_loaded("curl") ? "enabled" : "missing", PHP_EOL; echo "exec(): ", function_exists("exec") ? "enabled" : "disabled", PHP_EOL;'

Wenn die Website die PHP-Standardpakete der Distribution verwendet, installieren Sie cURL mit:

sudo apt install php-curl

Verwendet die Anwendung eine bestimmte PHP-Version, installieren Sie stattdessen das passende Paket. Beispiel für eine Website mit PHP 8.2:

sudo apt install php8.2-curl

Verwenden Sie das Paket für die bereits eingesetzte PHP-Version. Installieren Sie nicht eigens eine andere PHP-Version für den Updater. Weitere Informationen enthält die offizielle PHP-Anleitung zur Paketinstallation. Falls exec() deaktiviert ist, lassen Sie disable_functions in der PHP-Konfiguration der Website sowie mögliche Hosting-Beschränkungen prüfen.

Bei Bedarf nur den verwendeten PHP-Dienst neu starten

Für Apache mit PHP-Modul:

sudo systemctl restart apache2

Für PHP-FPM starten Sie stattdessen den tatsächlich verwendeten FPM-Dienst neu. Dieses Beispiel gilt für PHP 8.2; passen Sie die Version an Ihre Website an:

sudo systemctl restart php8.2-fpm

Sie müssen nicht beide Befehle ausführen. Ein Dienstneustart unterbricht Anfragen kurzzeitig. Führen Sie ihn deshalb im Wartungsfenster des Updates aus.

Schreibzugriff für das Webserverkonto ermöglichen

Verwenden Sie diese Befehle bei Schreib- oder Verzeichniszugriffsfehlern, wenn die Installation ihre Anwendungsdateien selbst aktualisieren soll. Die ACL-Befehle behalten vorhandene Eigentümer bei und geben dem angegebenen Webserverkonto Zugriff auf app und backup. Passen Sie beide Einstellungen an Ihre Installation an. Die Rechte werden nicht allen Benutzern gewährt.

(
    set -eu
    FLINKISO_ROOT="/var/www/html/flinkiso"
    FLINKISO_WEB_USER="www-data"

    sudo apt install acl
    sudo mkdir -p "$FLINKISO_ROOT/backup" "$FLINKISO_ROOT/app/webroot/updates"
    sudo setfacl -R -m "u:$FLINKISO_WEB_USER:rwX" \
        "$FLINKISO_ROOT/app" "$FLINKISO_ROOT/backup"
    sudo setfacl -m "u:$FLINKISO_WEB_USER:rx" "$FLINKISO_ROOT"

    sudo -u "$FLINKISO_WEB_USER" test -w "$FLINKISO_ROOT/backup"
    sudo -u "$FLINKISO_WEB_USER" test -w "$FLINKISO_ROOT/app/webroot/updates"
    sudo -u "$FLINKISO_WEB_USER" test -w "$FLINKISO_ROOT/app/Lib"
    echo "Backup, updates and library directories are writable."
)

Falls ein übergeordneter Ordner den Zugriff weiterhin verhindert, prüfen Sie den vollständigen Pfad mit namei -l /var/www/html/flinkiso/app/Lib/FlinkisoUpdater.php und lassen Sie die Zugriffsrechte dieses Ordners korrigieren. Unterstützt Ihr Hosting keine ACLs, verwenden Sie die dort vorgesehene Eigentümer- oder Gruppenberechtigung. Wenden Sie chmod -R 0777 nicht auf die Installation an.

Updater-Protokolle finden und private Sicherungen öffnen

Ersetzen Sie den Beispielpfad der Installation. Diese Diagnosebefehle lesen nur Informationen aus; sie entfernen keine Sicherungen, Sperren oder Wiederherstellungsdateien.

sudo ls -la /var/www/html/flinkiso/backup
sudo find /var/www/html/flinkiso/backup/.updater -maxdepth 2 -type f -name 'run.jsonl' -print

Öffnen Sie das passende Ausführungsprotokoll mit sudo less /vollstaendiger/pfad/zum/protokoll. Bewahren Sie es für den Support auf und entfernen Sie vor einer Weitergabe Zugangsdaten. Wenn Sie Updater-Dateien wiederherstellen müssen, verwenden Sie die vor dem Ersetzen angelegte Sicherung. Das Wiederherstellen dieser Dateien macht Datenbankänderungen eines späteren Anwendungsupdates nicht rückgängig.

Vor einer Supportanfrage

• Notieren Sie Installations-URL, ungefähre Ausführungszeit und den genauen Fehlertext.
• Bewahren Sie die datierte Sicherung und den zugehörigen Ausführungsordner unter backup/.updater/ auf.
• Geben Sie an, ob der Fehler bei Sicherung, Download, SQL-Verarbeitung oder Dateiinstallation aufgetreten ist.
• Teilen Sie relevante Protokolleinträge nur mit dem berechtigten Supportteam und entfernen Sie PATs und Zugangsdaten.