Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Remote Support Tool

Für den Installationssupport durch unsere Mitarbeiter bieten wir einen Client an, der nicht installiert werden muß und direkt nach dem Download gestartet werden kann.

TeamViewerQS_FTAPI.exe

Installation

Nach einem automatischen Java-Update auf dem Server lässt sich der FTAPI Dienst nicht mehr starten.

Statt der Login Seite erscheint nur eine leere Seite.
Sie müssen die Ungebunsgvariable neu setzen und den FTAPI-Service anpassen. Eine Anleitung finden unter: Java auf dem Server updaten

Ich bekomme in der Konsole die Meldung, dass keine JRE_HOME bzw. JAVA_HOME Variable definiert ist. Was ist zu tun

Wenn Sie beim Starten von FTAPI über die Konsole die folgende Meldung bekommen, dann ist an Ihrem Server keine Java Umgebungsvariable gesetzt.

...

 

Note

Windows Explorer bzw. Konsole erneut öffnen
Nach dem Anlegen einer neuen Umgebungsvariable müssen Sie die - eventuell noch offene - Konsole/Eingeabeaufforderung bzw. den Windows Explorer erneut öffnen, damit die neue Umgebungsvariable geladen wird.

 

Beim FTAPI Serverstart erscheint kurz die Konsole/Eingabeaufforderung und mehr nicht. Was ist hier zu tun

Wenn Sie die FTAPI Startskripten ausführen und im Anschluss die Konsole bzw. Eingabeaufforderung kurz erscheint und sich direkt wieder schließt, dann ist sehr wahrscheinlich keine JRE_HOME Umgebungsvariable gesetzt.
Die Lösung ist bei der vorherigen Frage bereits erläutert.

 

Wie finde ich heraus, welche Java Version bei meinem Server oder PC/Mac installiert ist

Die einfachste und schnellste Lösung sind die Java Testseiten beim Hersteller Oracle:

 

Wie finde ich die Version meines eingesetzten Apache Tomcat heraus

Öffnen Sie hierzu die Logdatei /ftapi-server/logs/catalina.DATUM.log. Hier sollten Sie eine Ziel ähnlich dem folgenden vorfinden:

Code Block
INFO: Starting Servlet Engine: Apache Tomcat/7.0.47

Eine andere Möglichkeit besteht darin, die Jar-Datei ftapi-server/lib/catalina.jar mit einem üblichen Zip-Programm (z.B. WinZip, 7-zip, unzip) zu entpacken und dort dann die darin befindliche Datei org/apache/catalina/util/ServerInfo.properties zu öffnen.
Hier sollten Sie eine Zeile ähnlich der folgenden vorfinden:

Code Block
 server.info=Apache Tomcat/7.0.47

 

Beim FTAPI Serverstart kommt in der Konsole die Meldung "socket bind exception" oder "socket bind failed [730013]". Wie kann ich dies beheben

Wenn beim Hochfahren des FTAPI Servers in der Konsole eine der Meldungen

...

Tip

FTAPI SecuTransfer Port umstellen

Für eine schnelle Umstellung auf einen anderen Port, müssen Sie in der Datei server.xml folgende Zeilen

aussuchen:

 

Code Block
...
<Connector port="80" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="443" server="" xpoweredBy="false" />

<Connector port="443" protocol="org.apache.coyote.http11.Http11AprProtocol"
...
/>

und folgendermaßen anpassen:

Code Block
...
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" server="" xpoweredBy="false" />

<Connector port="8443" protocol="org.apache.coyote.http11.Http11AprProtocol"
...
/>

 

Bitte erstellen Sie hierbei immer eine Sicherheitskopie der ursprünglichen Datei!

Beim nächsten FTAPI Serverstart wird der Server auf dem Port 8443 ausgeführt, welcher in der Regel nicht belegt ist. Die URL lautet dann https://localhost:8443.

 

Beim Starten des Servers auf 64-Bit Betriebssystem kommt Fehlermeldung "Ein dienstspezifischer Fehler ist aufgetreten: 0". Was ist zu tun

Wenn man den Tomcat als Dienst/Service auf einem 64-Bit OS im FTAPI Auslieferungszustand starten möchte bekommt man einen Error Code 0 oder die Meldung "Das System kann die angegebene Datei nicht finden [...] prunsrv.c".
In diesem Fall müssen dann die mit ausgelieferten 64-Bit exe-Dateien verwendet werden. Die deutsche Fehlermeldung lautet "Ein dienstspezifischer Fehler ist aufgetreten: 0". Diese kommt nach dem Versuch den Service zu starten.

Weitere Details zum Vorgehen sind HIER zu finden.

 

Beim Aufrufen der Webstart-Seite erhalte ich die Fehlermeldung "No Webstart resources found". Was ist zu tun

1. Stoppen sie den FTAPI Service
2. Erstellen Sie eine Sicherheitskopie der Datei .ftapi/config/user-config.properties
3. Löschen Sie die folgenden beiden Zeilen aus der Datei user-config.properties: 

 ftapi.webstart.codebase=rO0ABXQAFS93ZWJ1aS9zdGF0aWMvYXBwbGV0cw\=\=
ftapi.webstart.home=rO0ABXQAFi4vd2VidWkvc3RhdGljL2FwcGxldHM\= 

 4. Starten Sie den Service neu


Ein Port wie z.B. 443 ist bei mir bereits belegt. Wie kann ich FTAPI auf einem anderen betreiben

Falls für den Betrieb von FTAPI ein Port bereits belegt/anderweitig verwendet wird, kann dieser auf einen beliebigen freien Port umgestellt werden,

  1. In der FTAPI WebUI-Konfiguration den Eintrag ftapi.base.url=http://localhost:443 suchen und entsprechend dem neuen Port anpassen (z.B. statt 443 den Port 8443 eintragen)
  2. Damit auch der Tomcat-Server den gleichen Port nutzt, muss noch die Datei /ftapi-server/conf/server.xml angepasst werden.
    Darin den folgenden Eintrag mit port="80" suchen und auf den neuen Port (z.B. 8443) anpassen.

  3. Den FTAPI-Server neu starten

  4. (Optional: Diesen neuen Port in Ihrer Firewall für Zugriffe von extern freischalten, was in der Regel bei 443 bereits der Fall sein sollte.)

Wie muss man einen Mailserver (z.B. MS Exchange 2010) für das Relaying einstellen, damit E-Mails vom FTAPI Server darüber verschickt werden

Die genauen Einstellungen hängen von dem jeweils eingesetzten Mailserver und dessen Relay-Möglichkeiten ab.
Grundsätzlich muss der Mailserver mittels einer Regel/Ausnahme so eingestellt sein, dass diesem als Relay-Server erlaubt ist, E-Mails vom Server auf dem das FTAPI-System betrieben wird (als Remoteserver mit IP-Adresse eintragen) verschicken zu dürfen.

...

Alle Angaben dort sind ohne Gewähr. FTAPI Software übernimmt für deren Richtigkeit keine Haftung.

Konfiguration

Ich möchte den Ort, an dem die Binärdaten abgelegt werden ändern. Wo stellt man dies ein

Bei Verwendung des LocalDiskStorage (Standard) werden die Binärdaten im Verzeichnis ~/.ftapi/storage abgelegt. Um diesen Speicherort zu ändern, sind folgende Schritte notwendig:

...

 

Note

Binärdaten verschieben
Beachten Sie hierzu auch die Informationen unter Storage!

 

Ich möchte den Ort für das .ftapi Verzeichnis ändern. Was ist zu tun

Standardmäßig wird der .ftapi-Ordner direkt unterhalb Ihres ftapi-server Verzeichnisses angelegt und genutzt. Man kann diesen Pfad auch fix an einem anderen Ort angeben.
In Windows-Umgebungen ist hierfür die folgende Zeile in der Datei /ftapi-server/ftapi-start.bat anzupassen:

...

 

Note

Bereits installierter Dienst/Daemon
Falls Sie den FTAPI Tomcat Server bereits als Dienst/Daemon installiert haben, müssen Sie diesen zuerst deinstallieren und dann aus dem neuen Pfad heraus erneut installieren.

Meine Base-URL soll mit einer Erweiterung wie z.B. /ftapi-server aufhören. Wie kann ich das einstellen

Wenn Sie möchten, dass Ihre Base-URL mit einer speziellen Erweiterung wie z.B. /ftapi-server endet, können Sie die FTAPI war-Datei entsprechend umbenennen.

...

Bitte bedenken Sie, dass Sie bei Updates diese Umbenennung ebenfalls immer durchführen müssen!

Proxyserver: Ich habe im LAN einen Proxy-Server in Betrieb über den die Clients ins Internet gehen. Wie kann ich mich mit FTAPI verbinden

Selbstverständlich kann FTAPI mit einem Proxy-Server betrieben werden.
Falls Sie einen Proxy-Server bertreiben, empfehlen wir Ihnen, sich für Ihre FTAPI URL eine Ausnahme in Form von ftapi.ihre-domain.com* in Ihren Proxy-Gruppenrichtlinien einzutragen.

...

Grundsätzlich ist FTAPI auch mit dazwischengeschaltetem Proxy voll einsatzfähig, jedoch ist die Performance teilweise beeinträchtigt.
Dies hängt primär auch vom Zugriffsort (Server direkt, Intranet oder Internet) auf den FTAPI Server ab.

WebUI

Kann ich der digitalen Signatur bei der ersten Zustellung vertrauen bzw. soll ich die Anwendung ausführen

Die digitale Signatur für das geladene Java Applet ist vom Hersteller FTAPI Software GmbH erstellt und offiziell signiert worden und für die Nutzung von FTAPI Voraussetzung.
Bitte setzen Sie bei der nachfolgenden Meldung den Haken bei "Inhalten dieses Urhebers immer vertrauen", damit Sie zukünftig diesen Hinweis nicht mehr angezeigt bekommen, solange keine Änderungen vorliegen.

...

Die Angabe bei Von: zeigt Ihre URL für Ihren FTAPI Server an.
Weitere Informationen und Details zu dieser digitalen Signatur erhalten Sie, in dem Sie in diesem Fenster rechts unten auch "Weitere Informationen..." klicken.

Ich wurde gebeten eine "Browser Traffic Aufzeichnung" zu machen. Was mache ich jetzt

Info
titleWozu wird eine "Browser Traffic Aufzeichnung" benötigt?

Mit diesen Loginformationen ist es Entwicklern möglich einzusehen, welche Daten ein Client vom Server geladen hat und welche nicht.
Hiermit kann dann beispielsweise festgestellt werden, ob ein Problem im Browser auftritt, weil der Server nicht ausreichende Daten gesandt hat, oder ob die Lösung an anderer Stelle gesucht werden kann.

In einer solchen Aufzeichnung werden natürlich keine verschlüsselte Daten gesammelt.

Google Chrome

  • Öffnen Sie einen neuen Browser Tab und drücken Sie dann die F12 Taste, um die "Entwickler Konsole" zu öffnen
  • In der Leiste ganz oben wählen Sie dann Network
  • Aktivieren Sie hier die Option Preserve Log
  • Nun gehen Sie in dem zuvor geöffneten Browser Tab den FTAPI Prozess durch, der zu dem Fehler führt, um den es in Ihrem aktuellen Ticket geht.
  • Als nächsten führen Sie einen Rechtsklick in die Auflistung an geladenen Daten aus und wählen dann Save as HAR with content:
     
  • Diese Datei speichern Sie ab und senden sie uns über Ihr Ticket zu. Sollte die Datei dafür zu groß sein, packen Sie sie gerne in ein Archivdatei um sie zu verkleinern: Microsoft Hilfe zum Komprimieren von Dateien

Mozilla Firefox

  • Öffnen Sie einen neuen Browser Tab und drücken Sie dann F12 Taste, um die "Entwickler Konsole" zu öffnen
  • In der Leiste ganz oben wählen Sie dann Netzweranalyse
  • Nun gehen Sie in dem zuvor geöffneten Browser Tab den FTAPI Prozess durch, der zu dem Fehler führt, um den es in Ihrem aktuellen Ticket geht.
  • Als nächsten führen Sie einen Rechtsklick in die Auflistung an geladenen Daten aus und wählen dann Alles als HAR speichern:
  • Diese Datei speichern Sie ab und senden sie uns über Ihr Ticket zu. Sollte die Datei dafür zu groß sein, packen Sie sie gerne in ein Archivdatei um sie zu verkleinern: Microsoft Hilfe zum Komprimieren von Dateien

Internet Explorer 11

  • Öffnen Sie einen neuen Browser Tab und drücken Sie dann F12 Taste, um die "Entwickler Konsole" zu öffnen
  • in der Leiste ganz oben wählen Sie Netzwerk und klicken dann auf das grüne "Play Icon" um die Netzwerkaufnahme zu starten:
  • Nun gehen Sie in dem zuvor geöffneten Browser Tab den FTAPI Prozess durch, der zu dem Fehler führt, um den es in Ihrem aktuellen Ticket geht.
  • Als nächstes klicken Sie auf das "Speichern-Icon":
  • Diese Datei speichern Sie ab und senden sie uns über Ihr Ticket zu. Sollte die Datei dafür zu groß sein, packen Sie sie gerne in ein Archivdatei um sie zu verkleinern: Microsoft Hilfe zum Komprimieren von Dateien

Wie finde ich Fehler, die im Browser auftreten

Diese können über die Server Konsole gefunden, werden, die Sie wiefolgt öffnen können:

Google Chrome

  • Drücken Sie in Ihrem aktuellen Browser Fenster auf F12 und klicken in dem sich öffnenden Fenster dann auf Konsole
  • Nun führen Sie den Prozess, der zu dem Fehler führt in diesem Browser Tab erneut aus
  • Danach klicken Sie in dem "Debug Fenster" mit der rechen Maustaste und wählen Speichern als
  • Diese Datei speichern Sie nun ab und lassen sie uns zukommen

Internet Explorer

  • Drücken Sie in Ihrem aktuellen Browser Fenster auf F12 und klicken in dem sich öffnenden Fenster dann auf Konsole
  • Nun führen Sie den Prozess, der zu dem Fehler führt in diesem Browser Tab erneut aus
  • Danach klicken sie Sie in dem "Debug Fenster" mit der rechten Maustaste und wählen Alle kopieren
  • Nun öffnen Sie einen Texteditor und kopieren die Daten aus Ihrer Zwischenablage dort hinen
  • Nachdem Sie dieses Textdokument abgespeichert haben senden Sie es uns zu

Mozilla Firefox

  • Drücken Sie in Ihrem aktuellen Browser Fenster auf F12 und klicken in dem sich öffnenden Fenster dann auf Konsole
  • Nun führen Sie den Prozess, der zu dem Fehler führt in diesem Browser Tab erneut aus
  • Danach klicken Sie in dem "Debug Fenster" mit der rechen Maustaste und wählen Alle kopieren
  • Nun öffnen Sie einen Texteditor und kopieren die Daten aus Ihrer Zwischenablage dort hinein
  • Nachdem Sie dieses Textdokument abgespeichert haben senden Sie es uns zu

Datenbank

Wie erstelle ich einen Datenbank dump (MySQL)?

Sollten Sie von unserem Support gebeten werden, einen Datenbank dump zu erstellen, dann können Sie nach der folgenden Anleitung vorgehen, um diesen für eine MySQL Datenbank zu erstellen.

...

Dieses Archiv lassen Sie uns dann entweder über Ihr Ticket oder gerne auch per FTAPI zukommen.

Wie kann ich das Passwort des Datenbank Users für FTAPI ändern (Windows Server)?

Es gibt mehrere Fälle, in denen es notwendig ist, dass Passwort für den Datenbank User im FTAPI zu ändern.

...

  1. Stellen Sie sicher, dass Sie das korrekte Passwort für den Daetnbank User vorliegen haben. Im Zweifelsfall setzen Sie es neu
  2. Öffnen Sie in Ihrem FTAPI Installationsverzeichnis die Datei .../ftapi-server/ftapi-service-install.bat
  3. Finden Sie die Stelle mit -Dftapi.jdbc.password= und schreiben Sie das Passwort dahinter ((tick)Tipp: Das Passwort wird zwischen das und das ; geschrieben). Speichern Sie die Datei danach.
  4. Führen Sie nun diese Datei mit Administrator Rechten aus: .../ftapi-server/ftapi-server-uninstall.bat
  5. Nun führen Sie diese Datei mit Administrator Rechten aus: .../ftapi-server/ftapi-server-install.bat
  6. Sie finden Ihren Server nun wie gewohnt bei den Diensten Ihres Windows Server und können ihn von dort starten

Outlook Add-In

Wie kann ich das Debugging aktivieren?

Das Debug-Logging aktivieren Sie, indem Sie eine Umgebungsvariable erstellen, welche folgenden Namen und Wert hat:

...