Versions Compared

Old Version 2

changes.mady.by.user Michael Spreen

Saved on

compared with

New Version Current

changes.mady.by.user Michael Spreen

Saved on

Key

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

...

Zusätzlich müssen noch folgende Systemvoraussetzungen auf dem Server erfüllt sein:

Systemvoraussetzungen:
Visual C++ Redistributable für Visual Studio 2017 - 32Bit / x86

Installieren Sie die 32Bit Version auch wenn Sie eine 64Bit Version von Windows haben

https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads

Universelle C RunTime

Normalerweise erfolgt die Installation per Windows Update. Dies muss nur manuell installiert werden, wenn Sie die Fehlermeldung "api-ms-win-crt-stdio-l1-1-0.dll wird nicht gefunden" erhalten.

https://support.microsoft.com/de-de/help/2999226/update-for-universal-c-runtime-in-windows



...


Installation Client

Auf der Seite des Clients muss jetzt nicht eSignatureOffice installiert werden, sondern der StepOver TCP Client, dessen aktuellste Version Sie immer hier herunterladen können: https://www.stepoverinfo.net/download.php?key=tcp-client

Folgende Systemvoraussetzungen sollten auf dem Client erfüllt sein (wie auch auf dem Server schon):

Systemvoraussetzungen:
Visual C++ Redistributable für Visual Studio 2015 - 32Bit / x86

Installieren Sie die 32Bit Version auch wenn Sie eine 64Bit Version von Windows haben

https://www.microsoft.com/en-US/download/details.aspx?id=48145

Universelle C RunTime

Normalerweise erfolgt die Installation per Windows Update. Dies muss nur manuell installiert werden, wenn Sie die Fehlermeldung "api-ms-win-crt-stdio-l1-1-0.dll wird nicht gefunden" erhalten.

https://support.microsoft.com/de-de/help/2999226/update-for-universal-c-runtime-in-windows



Installationsschritte

1. Nach dem Start der Setup-Datei, wählen Sie zuerst die gewünschte Sprache aus.

Image Modified

2. Im nächsten Bildschirm haben Sie die Möglichkeit, 2 verschiedene Zusatzoptionen auszuwählen.

Die Option "Desktop-Symbol erstellen" tut genau das, sie erstellt einen Link auf Ihrem Desktop, über welchen Sie später den TCP Client direkt starten können.

Die zweite Option mit dem Namen "Autostarteintrag erstellen" sorgt dafür, dass beim Windows Start auch die TCP Extension gestartet wird.

Image Modified

3. Überprüfen und bestätigen Sie hier die getätigten Einstellungen

Image Modified

4. Fertig!

Die Installation der TCP Extension auf dem Client ist abgeschlossen und Sie können Sich der Konfiguration widmen.

Image Modified



...


Konfiguration

Die Konfiguration Ihrer Verbindung ist der kompliziertere Bestandteil bei der Einrichtung Ihrer Server-Client Verbindung.

Wichtig ist hier die Erstellung der config.ini Datei, in welcher unter anderem die Zieladresse des Computers angegeben sein muss, an welchem das Unterschriftenpad angeschlossen ist.

EintragErklärung
[server]

Dieser Eintrag soll daran erinnern, dass diese Ini-Datei dafür gedacht ist, auf dem Server gespeichert und benutzt zu werden.


ip=0.0.0.0Dieser Eintrag wird von der Gerätesuche von eSignatureOffice ausgelesen und dann wird auf dem Computer mit der angegebenen IP nach angeschlossenen Unterschriftengeräten gesucht. Dies ist im Grunde genommen der einzige Wert, der geändert werden muss.
port=8888Dies ist der Standardport, auf welchem kommuniziert wird.
logEnabled=0Ändern Sie die 0 in diesem Eintrag auf 1, um Log-Dateien zu erzeugen. Diese Option sollte nur eingeschaltet werden, wenn es irgendwelche Probleme oder Fehlfunktionen gibt und Sie die Logs für die Problemlösung benötigen.
logLevel=0Dieser Eintrag bestimmt den Detailgrad, der für die erzeugten Log-Dateien verwendet wird. Erlaubte Werte sind 0,1, 2 und je höher der Wert desto detaillierter das Logging und desto größer gleichzeitig auch die Systemauslastung.
logLenMax=2048

DieS ist die maximale größe der Log-Datei in Kilobyte.

logFile=C:\temp\logs\soClient.logHier wird der Pfad und Dateiname der Log-Datei angegeben. Bitte stellen Sie sicher, dass der angegebene Zielordner auch wirklich bereits existiert, da eSignatureOffice keinen Ordner erzeugt.


Image Modified

Achtung!

Auf dem Client System wird von der TCP Extension ebenso eine config.ini Datei angelegt. Diese enthält in der 1. Zeile den Eintrag "[client]" und sollte auf keinen Fall geändert werden, denn diese Datei wird vom Programm selbst verwaltet!



Schritt-für-Schritt-Anleitung

Diese grundsätzlichen Schritte der Konfiguration werden hier im Folgenden erklärt.


1. Erstellung der config.ini für den Server mit folgender Vorlage

Erstellen Sie eine neue Textdatei, kopieren den folgenden Text hinein:

Code Block
[server]
ip=0.0.0.0
port=8888
logEnabled=0
logLevel=1
logLenMax=2048
logFile=C:\temp\logs\soClient.log


2. Die IP des Clients muss in die config.ini eingetragen werden

Ändern Sie also die Zeile "ip=0.0.0.0" und falls Sie sich nicht sicher sind, welche die korrekte IP des Zielcomputers ist, sollten Sie bei Ihrer IT-Abteilung oder entsprechenden Kollegen nachfragen.


3. Speichern Sie die config.ini an den richtigen Speicherort auf dem Server

Stellen Sie sicher, dass die Datei beim Speichern neben dem Dateinamen auch die korrekte Dateiendung hat!

Hierfür gibt es zwei verschiedene Möglichkeiten: entweder gleiche Einstellungen für alle Windows-Benutzer oder für jeden Benutzer separate Einstellungen.

a) Für alle Benutzer gleich: Speichern Sie die fertige config.ini in das eSignatureOffice Installationsverzeichnis, also in den gleichen Ordner wie die auszuführende Datei SOSigOffice.exe.

b) Separate Einstellungen für jeden Benutzer: Speichern Sie die config.ini in den folgenden benutzerspezifischen Ordner: "C:\Users\<USER>\AppData\Roaming\StepOver\TCPIpExtension"

Die 2. Option ist natürlich besonders dann empfehlenswert, wenn sich jeder Benutzer über eine Remote Desktop Verbindung auf einen Server einloggt und dann von dort aus das Unterschriftengerät anspricht, das wiederum am eigenen Rechner angeschlossen ist. So wird für jeden Benutzer immer die richtige IP hinterlegt.


4. Fertig!

Sie können nun Ihr Unterschriftengerät am Client anschließen und eSignatureOffice auf dem Server starten. Das Gerät wird gefunden, obwohl es nicht direkt am Server Computer angeschlossen ist.




Zusätzliche Optionen, Informationen und Problemlösungen

...

Optionale Startparameter für das RDP IPconfig Tool:

Parameter
Auswirkung

-save2config=<saveToPath>

Geben Sie hier einen alternativen Speicherpfad für die config.ini an.

-basicconfig=<path>

Geben Sie hier den Pfad zu einer bereits bestehenden config.ini Datei an, welche dann in den AppData Ordner kopiert wird.

-useExternalIPGibt die Anweisung, zu versuchen, die externe IP auszulesen, also die WAN IP anstatt der LAN IP.



Konfiguration von IP und Port per Startparameter

Ab eSignatureOffice Version 6.2 können Sie IP und den Port auch per Startparameter übergeben. 

ParameterBeschreibung
-tcp=<IP>:<Port>

Verwenden Sie diesen Parameter zusammen mit der IP des Client-PCs in Ihrem Netzwerk, gefolgt von einem Doppelpunkt, gefolgt von der Portnummer, über welche kommuniziert werden soll. Standardmäßig ist dies der Port 8888. Achtung, auch wenn Sie den Standardport benutzen möchten, müssen Sie ihn in diesem Parameter trotzdem eintragen.

z.B. "-tcp=129.168.0.1:8888"

Es ist bei dieser Methode nicht notwendig, die config.ini Datei manuell zu erstellen, denn eSignatureOffice prüft beim Programmstart, ob die Datei vorhanden ist und erstellt sie gegebenenfalls selbst. Bitte beachten Sie jedoch, dass dafür dann aber ggf. Administratorrechte notwendig sind weil die config.ini in das Installationsverzeichnis von eSignatureOffice kopiert werden muss!

...

Falls Sie beim Versuch, sich zu registrieren den Hinweis erhalten, Ihren Produktschlüssel zu überprüfen, kann es auch sein, dass Sie versucht haben, einen Lizenzschlüssel für eine Standardversion von eSignatureOffice zu benutzen, anstatt eines Lizenzschlüssels für eine TCP-spezifische Version. 

...

Probleme / Fehlermeldungen

ProblembeschreibungMögliche Ursachen / Lösungen

Falls der Server entweder die Konfigurationsdatei (config.ini) nicht finden oder keine Verbindung zum Client aufbauen kann, wird er die folgende Fehlermeldung anzeigen.
Image Modified

a) Fehlende config.ini Datei. Bitte überprüfen Sie, ob die Datei wirklich existiert und die korrekten Client-Daten enthält.

b) Eine Firewall blockiert die Verbindung, die falsche Client-IP ist eingetragen oder es liegen andere Netzwerkprobleme vor. Um herauszufinden, wo das Problem liegt, könnten Sie den Telnet Service auf der Server-Seite benutzen um zu testen, ob Sie auf den TCP-Client zugreifen können.

Falls die Lizenz des Clients noch nicht aktiviert wurde, erscheint die folgende Meldung zu Beginn jedes Signaturvorgangs.

Image Modified

Sobald die TCP Extension auf dem Client gestartet wird, erscheint die Aufforderung zur Lizenzierung. Geben Sie hier den passenden Lizenzschlüssel ein, den Sie erhalten haben. StepOver Lizenzschlüssel für TCP kompatible Programme enthalten im letzten Ziffernblock immer die Kombination "017". Bitte stellen Sie also sicher, dass Sie auch einen zu Ihrer Version passenden Lizenzschlüssel benutzen.
Es tritt eine Zugriffsverletzung von BEX oder ein Programmabsturz bei der Nutzung von Windows Server 2008 R2 mit Terminal Service auf.
  • Rechtsklicken Sie im Windows Explorer auf "Dieser PC"
  • Klicken Sie auf "Eigenschaften"
  • Klicken Sie im linken Bereich auf "Erweiterte Systemeinstellungen"
  • Im Abschnitt "Leistung" klicken Sie auf "Einstellungen"
  • Wählen Sie den Reiter "Datenausführungsverhinderung" und klicken dort auf die Option "Datenausführungsverhinderung für alle Programme und Dienste mit Ausnahme der ausgewählten einschalten:"
  • Klicken Sie auf "Hinzufügen...", um ein Dateiauswahlfenster zu öffnen, in welchem Sie dann die SOSigOffice.exe im eSignatureOffice Installationsverzeichnis auswählen.

    Image Modified
Fehlermeldung, dass die Datei "api-ms-win-crt-stdio-l1-1-0.dll" nicht gefunden werden konnte.

Diese Datei gehört zur universellen C RunTime, welche normalerweise per Windows Update installiert wird. Falls Ihr System die relevanten Updates bisher nicht installiert hat, müssen Sie die C RunTime Bibliothek selbst installieren: https://support.microsoft.com/de-de/help/2999226/update-for-universal-c-runtime-in-windows