XXXL Troubleshooting
- Andy Erd
Analytics
Informationen/Aufbau
Damit die Webanwendung zugriff auf das Unterschriftenpad bekommt sind 3 Komponenten notwendig:
StepOver Citrix Extension welche auf dem IGEL oder Windows PCs installiert ist
StepOver PadConnector (Citrix Server)
StepOver PadConnectorManager (Citrix Server)
StepOver Citrix Extension
Damit innerhalb einer Citrix Session auf das Unterschriftenpad zugegriffen werden kann, muss das Unterschriftenpad welchen am Igel oder Windows PC angeschlossen werden weitergeleitet werden. Die Kommunikation wird über einen virtuellen Citrix Channel zwischen Client und Server getunnelt. Notwendig ist dafür das die StepOver Citrix Extension auf dem Client installiert und aktiviert ist. Bei IGEL OS11 ist diese bereits in der Firmware enthalten und muss lediglich aktiviert werden:
Für Windows Clients kann das Setup unter folgenden Link heruntergeladen werden:
https://www.stepoverinfo.net/download.php?file=Citrix_Client_Europa_20250127.exe
Weitere Einstellungen sind nicht mehr notwendig.
StepOver PadConnector
Moderne Webbrowser können nicht so einfach auf USB Geräte zugreifen, daher wurde der PadConnector entwickelt. Es handelt sich hierbei um einen kleinen webSocket-Webserver welcher vom Browser angesprochen wird und auf der anderen Seite mit dem Pad direkt oder indirekt (virtueller Citrix Channel) verbunden ist. Der PadConnector muss daher auf dem System laufen auf dem auch der Browser läuft, zum Beispiel in der Citrix Umgebung.
Standardmäßig läuft der PadConnector auf dem Port 57357 und es gibt verschiedene Seiten mit welchen man die Verbindung zum Pad prüfen kann oder eine Testunterschrift machen kann.
Wichtig auf Terminal bzw. Multi User ist der Zugriff über den Standard Port nicht möglich weil dieser vom PadConnectorManager verwendet wird. Man muss in dem Fall erst über den /dump Aufruf den richtigen Port ermitteln wenn man den PadConnector ansprechen möchte.
https://signsocket.stepover.com:57357/
https://signsocket.stepover.com:57357/deviceInfo
https://signsocket.stepover.com:57357/version
Man kann den PadConnector über folgende Adresse herunterfahren
https://signsocket.stepover.com:57357/shutdown
Anschließend kann man ihn mit folgender Adresse neustarten lassen. Im Browser muss man den Start zusätzlich bestätigen und ca. 10 sekunden später sollte der PadConnector wieder gestartet sein.
padcon://
StepOver PadConnectorManager
Bei Multiuser Umgebungen gibt es das Problem das man mehrere PadConnector Instanzen starten muss, denn das Unterschriften Pad ist zum Beispiel bei Citrix nur in der User-Session verfügbar. Das bedeutet wiederum das jede PadConnector Instanz mit einem anderen Port laufen muss, was bedeutet das die Webseite den richtigen Port wissen muss. Hierfür gibt es den PadConnector Manager, im Grunde ist das ein Vermittlerservice welcher die PadConnector Instanzen kennt und bei dem die Webseite für den aktuellen User den Port abfragen kann.
Der PadConnectorManager läuft auf dem Port 57357 und ist über https://signsocket.stepover.com:57357/ erreichbar.
Über die Seite https://signsocket.stepover.com:57357/dump kann man sich eine Liste anzeigen lassen von den bekannten PadConnector Instanzen.
In der /dump Ausgabe steht an erster Stelle der Username, der zweite Wert ist der entsprechende Port und der letzte Wert ist ein Token welchen die Webseite setz für die Abfrage des Ports. Bei Problemen kann die Ausgabe aber auch anders aussehen.
Username | Port | Token | Info |
|---|---|---|---|
vorhanden | vorhanden | vorhanden | Normaler Zustand |
vorhanden | 0 | vorhanden | PadConnector Instanz des Users wurde bisher nicht gestartet, von der Webseite hab es den Versuch der Portabfrage |
vorhanden | vorhanden |
| PadConnector wurde gestartet aber bisher hat die Webseite den Port noch nicht nachgefragt |
Wichtig: der PadConnectorManager bekommt nicht selbst mit das eine PadConnector Instanz sich beendet hat, wenn zum Beispiel der User sich längst abgemeldet hat. Im Zweifel versuchen die PadConnector Instanz über den entsprechenden Port versuchen.
Der dump wird erst mit dem Neustart des PadConnectorManagers ausgelöst, was eigentlich nur bei einem Neustart des Servers passiert.
Troubleshooting
Webseite zeigt an das kein Pad gefunden wurde.
Prüfen ob das Pad mit dem Aufruf https://signsocket.stepover.com:XXXXX/deviceInfo gefunden wird (XXXX mit dem entsprechenden Port ersetzen!). Die Ausgabe sollte in etwas so aussehen:
In dem Fall sollte auch die Webseite das Pad finden, wenn das nicht der Fall ist sind weitere Logs für die Analyse notwendig.
Wenn das Pads hier nicht gefunden wird, gibt es entweder ein Problem mit dem virtuellen Channel zum Client oder ein Problem direkt auf dem Client. Probleme mit dem virtuellen Channel können wir nur mit Logs weiter analysieren. Um ein Problem direkt auf dem Igel auszuschließen, kann man auf diesen mit Terminal prüfen ob die StepOver Komponente das Pad findet.
Wichtig ist das diese Rückmeldung ohne eine Fehlermeldung passieren muss! Wenn das Pad hier nicht gefunden ist bitte nochmal prüfen ob das Pad wirklich angeschlossen ist und auch hochgefahren ist (Logo Sichtbar und Orange LED).
Wie kann ich das Pad auf VCOM stellen
Wir haben festgestellt das die Übertragung der Dokumentenbilder zwischen IGEL und Pad sehr langsam ist bei den eingesetzten IGEL Clients. Als Workaround werden daher die Pads zukünftig auf VCOM umgestellt. Diese Umstellung erfolgt beim Start des PadConnectors.
Aktuell muss das Pad manuell an einen lokalen Windows PC umgestellt werden. Dazu bitte folgenden Schritten folgen:
Download des SODC Tools
https://www.stepoverinfo.net/download.php?file=SODC-Test.zip
Anschließend irgendwohin entpacken und die SODC.exe starten
Im Testtool auf “Pad auswählen” klicken und anschließend das gefundene Pad bestätigen.
Danach auf Optionen klicken und in dem neuen Fenster den Buchstaben “a” tippen. Damit sollten die versteckten Funktionen aktiv werden
Klicken Sie auf den Tab “CommType”. Wählen die in der oberen Dropdown liste die Option “so.pad.communication.connection.type” aus. Mit “Get Variable” können Sie den aktuellen Status auslesen und mit “Set variable” diesen verändern.
HID-USB | 0 |
VCOM - CDCACM | 2 |
Damit die Einstellung übernommen wird muss das Pad neugestartet werden, trennen Sie dafür entweder das Stromkabel für 5 Sekunden oder lösen Sie den Neustart über den Tab “Reset” aus.
Wichtig für VCOM muss auf dem Igel der entsprechende Treiber mit geladen werden. Dies kann man mit dem Befehl modprobe cdc-acm machen
