Page tree
Skip to end of metadata
Go to start of metadata

Client-Update

Bevor Sie Ihren Server updaten, seien Sie sich bewusst, dass Sie die entsprechenden neuen Client-Versionen verwenden müssen (Desktop App)!

Wenden Sie sich hierzu gerne auch an unseren Support.

Update Unterstützung durch FTAPI

Sollten Sie eine Updateunterstützung bei uns in Auftrag gegeben haben, kommen Sie bitte auf uns zu und führen das Update nicht selbst durch!

Installation von Linux-Diensten

Da es eine Vielzahl von Linux-Distributionen und Init-Systemen gibt, stellen wir aktuell lediglich ein init.d/rc.d-Skript namens ftapi.sh zur Verfügung, welches die Argumente "stop", "start" und "restart" akzeptiert. Dies ist unter Debian und Ubuntu getestet. Die Befehle aus der Anleitung beziehen sich auf das init.d-Init-System.

Falls Sie systemd verwenden möchten, passen Sie Ihre systemd-Unit nach dem Update entpsrechend unserer Installationanleitung an: Linux-Server Installation#ServerInstallation-Optional:systemd-Unitanlegen

Windows - Vorbedingung

Aufgrund der Umstellung von OracleJDK auf OpenJDK, wird auf Windows Servern das Visual C++ Redistributable für Visual Studio 2013 benötigt. Das Paket kann direkt über Microsoft Downloadlink abgeholt werden. Eine neuere Version (z.b. 2015 oder 2017) ersetzen diese Vorbedingung nicht.

FTAPI Update

  1. Stoppen Sie den FTAPI Server und erstellen Sie ein komplettes Backup des Systems.
  2. Datenbankanbindung prüfen.
    1. Bitte prüfen Sie ob Ihre Datenbankverbindung bereits in der properties.xml liegt oder noch über die ftapi-service-install.bat konfiguriert wird. 
    2. Sie können dies einfach nachprüfen: liegt im Verzeichnis .ftapi/config/ eine Datei properties.xml und sind dort die Datenbankdaten vorhanden - müssen Sie nichts tun. Sollte dies noch nicht der Fall sein bitte führen Sie hier genannte Schritte durch:
    3. MSSQL: Windows-Server Installation#ServerInstallation-KonfigurationFTAPISchnittstellemitMSSQL
    4. MySQL:
      1. Windows-Server Installation#ServerInstallation-KonfigurationFTAPISchnittstellemitMySQL (Windows)
      2. Linux-Server Installation#ServerInstallation-MySQL-Schnittstellenkonfiguration (Linux)
  3. Bitte prüfen und merken Sie sich, mit welchem Nutzer der FTAPI Dienst aktuell läuft.
    1. Windows: Sie können dies unter überprüfen, indem Sie services.msc aufrufen, dort den FTAPI Service auswählen -> Eigenschaften -> Anmelden
    2. 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. 
  4. Bitte de-installieren Sie den FTAPI Dienst mittels
    1. Windows: der Installationsverzeichnis/ftapi-server/ftapi-service-uninstall.bat
    2. Linux mit init.d: dem Befehl rm /etc/init.d/ftapi
  5. Sichern Sie nun bitte folgende Dateien:
    1. Installationsverzeichnis/ftapi-server/conf/server.xml
    2. Installationsverzeichnis/ftapi-server/conf/[Ihr_Zertifikat]
  6. Löschen oder verschieben Sie nun den gesamten Ordner Installationsverzeichnis/ftapi-server WICHTIG: der Ordner .ftapi/ darf nicht gelöscht oder verschoben werden.
  7. Kopieren Sie nun aus dem Downloadpaket den Ordner ftapi-server nach Installationsverzeichnis
  8. Dieser Ordner hat nun zwei Unterordner:
    1. JRE: ab sofort liegt nun hier die genutzten OpenJDK (aktuell Version 10) Instanz. Eine lokale JRE/JDK Instanz ist nicht mehr notwendig.
    2. tomcat: hier liegen alle benötigten Daten für den Tomcat Webserver (aktuelle Version 9).
  9. Kopieren Sie nun Ihr gesichertes Zertifikat in den Ordner: Installationsverzeichnis/.ftapi/certificate (ggf muss der Unterordner certificate erstellt werden)
  10. Öffnen Sie nun die "alte" server.xml und parallel die neue server.xml (zu finden unter: Installationsverzeichnis/ftapi-server/tomcat/conf)
  11. Ersetzen Sie in der neuen server.xml die Werte:
    1. keystoreFile mit "/.ftapi/certificate/[IhrZertikat]", z.B. "C:\ftapi\.ftapi\certificate\wildcard.ftapi.com"
    2. keystorePass mit dem Wert aus der alten server.xml.
  12. Sollten Sie spezielle und individuelle Einstellungen vorgenommen haben, z.B. ReverseProxys oder Ähnliches, müssen diese ebenfalls übernommen werden.
  13. 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
    1. Windows: die Datei ftapi-service-install.bat ausführen.
    2. 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)
  14. 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.
  15. Starten Sie den FTAPI Dienst.

 

 

  • No labels