Version vom 9. August 2019, 12:24 Uhr

Allgemeines

Der QR/NFC Contoller ist ein System zur Kommunikation zwischen der jeweiligen Hardware Komponente und der James Middelware.
Der Controller kann bis zu vier USB Leseeinheiten aufnehmen.

Beim Aufruf wird die nummerische ID des Readers an die Middelware übergeben.

Standardwerte

Der Kontroller hat die IP 192.168.44.72/24 im Standard. Diese sollte entsprechend der lokalen Situation angepasst werden. Der Benutzername ist root und das Passwort metasec

Konfiguration

Zur Einrichtung des Controllers sind folgende Schritte notwendig:

• Konfiguration der IP Adresse
• Konfiguration der Kommunikation mit der James Middelware

Netzwerk

Folgende Schritte sind zu notwendig:

• Login via SSH auf den Kontroller mit o.g. Daten
• Folgende Dateien müssen dem lokalen Umfeld angepasst werden für eine korrekte Funktion des Netzwerks
  • /etc/network/interfaces.d/eth0 für die IP Adresse und eventuell notwendiges Default Gateway
  • /etc/resolv.conf für den DNS Server ( ist optional. wenn kein DNS Server zu Einsatz kommt, dann kann die Datei auch leer bleiben)
  • /etc/hostname für den Hostnamen der Box. Auch wenn kein DNS zum Einsatz kommt, so soll der Hostname ein eindeutiger Bezeichener sein.

Nachdem die Anpassungen im Netzwerk gemacht worden sind, kann das System per "reboot" neu gestartet werden.

Reader

Der nächste Schritt kann nur durchgeführt werden, wenn die Readereinheiten am Kontroller angeschlossen sind.
Mit dem Kommando sehen Sie alle angeschlossen Leser

 ls -1 /dev/input/event*

Ausgabe:

/dev/input/event0
/dev/input/event1

Diese Werte werden für die Konfiguration der Middelware später benötigt.
Im oben genannten Beispiel sind zwei Leser vom Kontroller erkannt worden.

Middelware

Die Datei /etc/metasec/qrcode_scanner.ini beinhaltet die Konfiguration der Kommunikationsschnittselle zur James Middelware

[default]
james_host=james-srv.kunde.local
hw_device=/dev/input/event0 /dev/input/event1
boxid=AABBCCDD
url_base_target=/portals/wf_middelware_portal.php
url_opt_param=wf_id=17&value_rel_id=1

Die Parameter sind wie folgt zu konfigurieren: james_host = DNS Name oder IP Adresse des James Servers hw_device = Leser welche entsprechend am Kontroller angeschlossen sind. Wichtig: Wenn ein Leser fehlerhaft notiert ist, oder nach einem Reboot des Systems nicht erkannt wird, kann der gesamte Prozesse nicht starten!!! boxid = Optionales ID des Kontrollers. Empfehlung ist die MAC Adresse hier zu verwenden url_base_target = Ziel für den Aufruf. Dieser kann wie im Beispiel oben so belassen werden url_opt_param = i.d.R. wird ein Workflow verarbeitet. Die ID des Workflows muss als Parameter übergeben werden. Generell kann hier jeder Art von Parameterfolgen angehängt werden.

Nach erfolgreicher Bearbeitung der Datei können Sie den Kontroller neu starten.

Betreib

Jeder Positiver Scan am Leser wird an die konfigurierte Adresse übermittelt. Sie können die Aufrufe im Syslog als auch im NGINX Log des James Webservers sehen