Update Reihenfolge
Das Einspielen der Versionen 4.3.0, 4.7.6 und 4.11.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 WebUI einloggen, bevor Sie die nächste Version einspielen.
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:
- Überprüfen Sie zunächst mit
nslookup cdn.ftapi.com
oder dig cdn.ftapi.com
die korrekte DNS-Auflösung der Adresse. - Stellen Sie dann sicher, dass Ihre Firewall ausgehende Verbindungen auf den Port 443 (HTTPS) zulässt.
- Überprüfen Sie gegebenenfalls die Konfiguration eines eventuell verwendeten Proxy-Servers.
- 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.
Aktion erforderlich für Kunden mit FTAPI Datenräumen
- Die Datenraum-Funktion wird in den nächsten Versionen komplett aus FTAPI entfernt. Als Konsequenz haben Sie und Ihre Benutzer:innen keinen Zugriff mehr auf die in den FTAPI Datenräumen gespeicherten Daten. Um Datenverlust zu verhindern, empfiehlt Ihnen FTAPI dringend einen Export zur Datensicherung durchzuführen und die Daten zu migrieren. Mehr Informationen und Anleitungen finden Sie hier.
- Bereits seit dem 31.10.2023 befindet sich das Produkt im End-of-Life, weshalb der Betrieb des Produktes von FTAPI nicht mehr unterstützt wird. Mehr erfahren.
Update Schritte 4.37 -> 4.38.1
- Stoppen Sie den FTAPI Server und erstellen Sie ein komplettes Backup des Systems.
- Sichern Sie nun bitte die Datei Installationsverzeichnis
/ftapi-server/tomcat/conf/server.xml
- Bitte prüfen und merken Sie sich, mit welchem Nutzer der FTAPI Dienst aktuell läuft.
- Windows: Sie können dies überprüfen, indem Sie
services.msc
aufrufen und dort den FTAPI Service auswählen -> Eigenschaften -> Anmelden - Linux: Ist von der Distribution und dem gewählten init-System abhängig. Wenn Sie keinen vom Standard abweichenden Nutzer angegeben haben, können Sie diesen Schritt überspringen.
- Bitte de-installieren Sie den FTAPI Dienst mittels
- Windows: der Installationsverzeichnis
/ftapi-server/tomcat/ftapi-service-uninstall.bat
- Linux mit init.d: dem Befehl
rm /etc/init.d/ftapi
- Löschen oder verschieben Sie nun den gesamten Ordner Installationsverzeichnis/ftapi-server. WICHTIG: der Ordner
.ftapi/
darf nicht gelöscht oder verschoben werden. - Kopieren Sie nun aus dem Downloadpaket den Ordner
ftapi-server
nach Installationsverzeichnis - Öffnen Sie nun die "alte"
server.xml
und parallel die neue server.xml
(zu finden unter: Installationsverzeichnis/ftapi-server/tomcat/conf
) - Ersetzen Sie in der neuen
server.xml
die Werte:keystoreFile
mit "[...]/.ftapi/certificate/[IhrZertikat]", z.B. "C:\ftapi\.ftapi\certificate\wildcard.ftapi.com.pfx"keystorePass
mit dem Wert aus der alten server.xml
.
- Sollten Sie spezielle und individuelle Einstellungen vorgenommen haben, z.B. ReverseProxys oder Ähnliches, müssen diese ebenfalls übernommen werden.
- Sollten Sie LDAPS konfiguriert haben, muss das SSL-Zertifikat des LDAP/AD Servers erneut in den CACerts-Keystore aufgenommen werden
- Nur für Linux: Setzen Sie die "executable"-Rechte für alle ausführbaren Dateien:
chmod +x ftapi-server/tomcat/*.sh
chmod +x ftapi-server/tomcat/bin/*.sh
chmod +x ftapi-server/jre/linux/bin/*
- Installieren Sie den FTAPI Service neu indem Sie:
- Windows: CMD als Administrator öffnen, zum FTAPI Installationverzeichnis navigieren und von dort die Datei
Installationsverzeichnis/ftapi-server/tomcat/ftapi-service-install.bat
ausführen. - Linux mit init.d: den Befehl
ln -s Installationsverzeichnis/ftapi-server/tomcat/ftapi.sh /etc/init.d/ftapi
(ersetzen Sie Installationsverzeichnis mit dem absoluten Pfad des Installationverzeichnisses)
- Nur für Windows:
- Sollten Sie einen eigenen Service-Nutzer unter Punkt 3 identifiziert haben, rufen Sie bitte die
services.msc
auf und setzen diesen erneut. Ggf. kann der Dienst nun Apache Tomcat...FTAPI heißen. Stellen Sie sicher, dass der Nutzer Lese- und Schreibrechte auf den .ftapi
Ordner hat - Ändern Sie ansonsten den Service-Nutzer auf "Lokales Systemkonto"
- Nur für Linux: Falls der FTAPI-Dienst nicht als root-Nutzer ausgeführt wird, weisen Sie per
chown -R
den Besitz des ftapi-server-Ordners dem ausführenden Nutzer zu. - Löschen Sie, falls vorhanden, alle Dateien mit der Endung
.yml
aus dem Verzeichnis /ftapi/.ftapi/config
. - falls Sie das Produkt SecuRooms nicht gebucht haben: Kopieren Sie die neue Datei
secutransfer-OnPremise.yml
in das Verzeichnis /ftapi/.ftapi/config
. Datei herunterladen. - falls Sie das Produkt SecuRooms gebucht haben: Kopieren Sie die Datei
secutransfer-OnPremiseWithSecuRooms.yml
in das Verzeichnis /ftapi/.ftapi/config
.
Datei herunterladen.
- Benennen Sie die eben kopierte .yml-Datei in
secutransfer.yml
um. - Um das MySQL Datenbanksystem zu nutzen, müssen Sie einen kompatiblen JDBC-Treiber zur Apache Tomcat-Installation hinzufügen. Beachten Sie die Lizenzvereinbarungen des Herstellers für die Verwendung des JDBC-Treibers. Laden Sie den Konnektor/J JDBC Treiber in der Version 8.0.28 bis Version 8.033 hier herunter: http://dev.mysql.com/downloads/connector/j/
Wählen Sie 'Platform Independent' aus. Kopieren Sie die JAR-Bibliothek des JDBC-Treibers in das Apache Tomcat-Installationsverzeichnis in den Ordner /ftapi/mysql/
.
TomCat/J-Connector Einrichtung:
![](https://cdn-assets.productfruits.com/41600bee-0a35-4532-a53c-cda4939b9541)
![](https://cdn-assets.productfruits.com/7c284889-4abd-4d9d-8310-dfb2e36fa073)
- Stellen Sie außerdem sicher, dass eine aktuelle MySQL Version vorliegt:
![](https://cdn-assets.productfruits.com/fe063f20-7476-45ef-9821-a67b9f2a8e0a)
- Starten Sie den FTAPI Dienst neu. Alle Änderungen und Neuerungen werden jetzt automatisch eingespielt und aktiviert.
Troubleshooting
Falls die WebUI im Browser nach dem erstmaligen Start nach der Durchführung des Updates einen Fehler ausgibt, durchsuchen sie das aktuelle ftapi-stderr.log (zu finden unter ftapi/ftapi-server/tomcat/logs) nach folgendem Fehler:
META-INF/config/db/db-changelog-pre-all-versions.xml::1.0.0-pre-all-mysql-primary-key-dbchangelog::jdietrich was: 8:aac6a5dc3e82735ef2fecbeaff535dfc but is now: 8:222b93d12a3606a2f8e40bfa69ef063f
Falls dieser Fehler im Log auftauchen sollte, führen Sie in der FTAPI MySQL Datenbank die folgende Query aus und starten sie anschließend den FTAPI Dienst neu:
UPDATE DATABASECHANGELOG SET MD5SUM='8:222b93d12a3606a2f8e40bfa69ef063f' WHERE ID='1.0.0-pre-all-mysql-primary-key-dbchangelog';
Eröffnen Sie alternativ ein Ticket bei unserem Support, dieser wird Sie bei der Durchführung unterstützen.