Updateanleitung Version 4.57.1 auf Version 4.58.1

Update-Reihenfolge

Das Einspielen der Versionen 4.44.1, 4.49.0 und 4.56.1 ist zwingend erforderlich und darf nicht übersprungen werden, bevor Sie das Update auf die aktuelle Version vornehmen. Jede Version muss einmal komplett erfolgreich starten und Sie müssen sich einmal an der FTAPI Weboberfläche einloggen, bevor Sie die nächste Version einspielen.

Wenn Ihr FTAPI System derzeit noch auf einer Version < 4.49.0 ist, dann führen Sie bitte zunächst ein Update auf Version 4.49.0 ("Spring Boot Update") durch.
-> Zur Installationsdatei & Update-Anleitung (für Windows).
-> Zur Installationsdatei & Update-Anleitung (für Linux).

Sollten Sie die FTAPI-Server-Komponenten oder eine Updateanleitung für vorherige Versionen zum Download benötigen, nutzen Sie hierfür bitte das Support-Formular: https://www.ftapi.com/supportanfrage/

Vorbereitung zur Einspielung des Updates

Um sicherzustellen, dass Ihr lokal installierter Dienst Zugriff auf den externen Dienst cdn.ftapi.com hat, führen Sie bitte folgende Schritte durch:

1. Überprüfen Sie zunächst mit nslookup cdn.ftapi.com die korrekte DNS-Auflösung der Adresse.
2. Stellen Sie dann sicher, dass Ihre Firewall ausgehende Verbindungen auf den Port 443 (HTTPS) zulässt.
3. Überprüfen Sie gegebenenfalls die Konfiguration eines eventuell verwendeten Proxy-Servers.
4. Führen Sie abschließend einen Test durch, um die erfolgreiche Verbindung zu bestätigen.

Der Zugriff auf cdn.ftapi.com wird unter anderem benötigt, um die sicherheitsrelevante Benachrichtigung zu veralteten Outlook Add-In-Versionen bereitzustellen.

Die Update-Schritte

1. Backup erstellen
Stoppen Sie den FTAPI Server und erstellen Sie ein komplettes Backup des Systems.

2. Dienst stoppen und deinstallieren

Für Windows:
Bitte prüfen und merken Sie sich, mit welchem Nutzer der FTAPI Dienst aktuell läuft. (Überprüfung via services.msc -> FTAPI Service -> Eigenschaften -> Anmelden).
Öffnen Sie eine Kommandozeile und führen Sie folgende Befehle aus:
\ftapi-server\ftapi-server.exe stop (stoppt den Dienst)
\ftapi-server\ftapi-server.exe uninstall (deinstalliert den Dienst)

Für Linux:
Der Dienst muss nicht deinstalliert werden, da über einen SymLink lediglich auf /ftapi-server/ftapi.service referenziert wird. Daher genügt es, den Dienst lediglich zu stoppen.
Führen Sie folgenden Befehl aus: systemctl stop ftapi

3. Konfiguration bereinigen
Löschen Sie, falls vorhanden, die Datei properties.xml aus dem Verzeichnis /ftapi/.ftapi/config.

4. Alten Server-Ordner verschieben
Verschieben oder benennen Sie nun den gesamten Ordner /ftapi/ftapi-server um (z. B. in /ftapi/ftapi-server-old).
WICHTIG: Der Ordner .ftapi/ darf NICHT gelöscht oder verschoben werden.

Nur für Linux (Optional):
Sollten Sie Anpassungen an der vorhandenen /ftapi-server/ftapi.service vorgenommen haben, müssen diese zunächst in die neue /ftapi-server/ftapi.service übertragen werden.

5. Neue Dateien kopieren
Kopieren Sie nun aus dem Downloadpaket den Ordner ftapi-server ins Installationsverzeichnis.

Für Linux:
Machen Sie die Binärdatei java ausführbar:
sudo chmod +x <BASE_DIR>/ftapi-server/jre/linux/bin/java

6. Neuen Dienst (Version 4.58.1) installieren und starten

Für Windows:
Navigieren Sie über eine Kommandozeile zu \<BASE_DIR>\ftapi-server
Führen Sie ftapi-server.exe install aus, um den Dienst zu installieren.
Führen Sie ftapi-server.exe start aus, um den Dienst zu starten.

Für Linux:
Laden Sie den SystemD-Daemon neu und starten Sie den FTAPI-Dienst:
sudo systemctl daemon-reload
sudo systemctl start ftapi.service

Troubleshooting

1. Erreichbarkeit prüfen
Versuchen Sie zunächst immer, die Server-URL aufzurufen. Es sollte die Anmeldeseite angezeigt werden.

2. Logdateien prüfen
Wenn dies nicht funktioniert, überprüfen Sie bitte die Logdateien auf Fehler.
SecuTransfer speichert alle Logs in: <BASE_DIR>/.ftapi/logs
Die Dienstprotokolle werden gespeichert in: <BASE_DIR>/ftapi-server/service-logs

Linux-Tools zur Prüfung:
Status prüfen: systemctl status ftapi.service
Logs drucken: journalctl -u ftapi.service
Live-Logs: journalctl -f -u ftapi.service
Bestimmter Zeitraum: journalctl --since "2025-04-11 15:00:00" --until "2025-04-11 16:00:00" -u ftapi.service

3. "Control process exited with error code"
Sollte beim Start des FTAPI-Dienstes diese Fehlermeldung ausgegeben werden, so wird dieser ggf. unter einem falschen Kontext ausgeführt.
Beachten Sie hierzu die Hinweise unter Punkt 12 der Linux-Updateanleitung.

Outlook Add-in

Sollten Sie das Outlook Add-in nutzen, so empfiehlt FTAPI die aktuellste Version 4.8.8 des Add-ins zu verwenden: Zum Download-Bereich.