Transkript

1 Anbindung des 6000 / 900 in Die Anleitung zeigt wie sich das 6000 / 900 in einer Citrix Serverumgebung einbinden lässt. Zusammenfassung Installation / Konfiguration und Betrieb der 6000 / 900 Kartenleser unter Citrix XenApp wenn die Leser am Client über die serielle Schnittstelle oder USB virtueller COM Port (USB v.com) angeschlossen sind. Kurzablauf Installation der Kartenleser 6000 / 900 an den jeweiligen Clients. Dieses ist nur notwendig, wenn die Kartenleser über USB v. COM (virtueller COM Port) unter Windows betrieben werden sollen. Installation der CT-API Komponenten CTORG32.DLL, CTORG32.INI und Quicktest auf dem Server. Modifikation der CTORG32.INI Datei. Anbindung des COM Ports mit Hilfe des net use und change port Kommandos. Einbindung der CTORG32.DLL / CTORG32.INI Datei in das PVS/KIS System. Anmerkungen Die 6000 Terminals können alternativ auch n einer Citrix Terminalserverumgebung über angeschlossen werden. Vorteil dieser Lösung sind eine Unabhängigkeit vom Mapping der Client COM Ports sowie keine Latenzproblematik. Durch Latenzen in der Übertragung der Daten vom Server zum Terminal (Kartenleser) kann es zu Protokollabbrüchen kommen. Um dem entgegen zu wirken, sollten Sie den (T=1)-Protokoll Parameter CWT (Character Waiting Time, Timeoutzeit) von 100 ms auf z.b. 500 ms erhöhen (am Gerät und in der CTORG32.INI Datei). Sowie die BWT (Block Waiting Time) auf 5000 ms setzen (in der CTORG32.INI Datei (siehe weiter unten). Falls es zu Verbindungsabbrüchen oder anderen Problemen in der seriellen Kommunikation kommen sollte, reduzieren Sie die Baudrate auf 9600 Baud. 1/8

2 Anbindung des 6000 / 900 in Vorgehensweise Ziel: Anbindung der 6000 / 900 Kartenleser über die serielle COM Schnittstelle oder USB virtuelle COM Schnittstelle (USB v. COM) in. Die Kartenleser sind dabei physikalisch mit dem Clientsystem verbunden. Die Anwendungssoftware (z.b. PVS, Testsoftware) läuft auf einen Terminalserver in einer Terminalsession. Installation Server: + Citrix XenServer Version Citrix XenCenter (Windows administration interface for XenServer hosts) + Citrix XenApp (vormals Presentation Server, davor Metaframe). Testversion XenApp EVA beinhaltete XenApp 6 for Windows Server 2008 R2 und Windows Server 2008 R2 Enterprise 64-Bit als VHD Image. + Quicktest.exe + CTORG32.DLL V (CT-API). + CTORG32.INI (Konfigurationsfile für die CT-API DLL. ( 6000 / 900 Testtool und CT-API DLL von der Installations CD). Client(s): + Windows XP Desktop Client System mit Citrix Online Plug-in daran installiert und angeschlossen: installiert über USB v. COM (virtueller COM Port) Einstellungen im 6000 Menü: Hauptmenue > Einstellungen > Schnittstelle > Auswahl > USB v. COM Hauptmenue > Einstellungen > Schnittstelle > Parameter > Host T=1 > Timeing-CWT > (entspricht 500 ms) installiert über seriellen COM Port (-Kit DE) Einstellungen im 6000 Menü: Hauptmenue > Einstellungen > Schnittstelle > Auswahl > Parameter > Hauptmenue > Einstellungen > Schnittstelle > Parameter > > Baudrate > ,8,e,1 Hauptmenue > Einstellungen > Schnittstelle > Parameter > Host T=1 > Timeing-CWT > (entspricht 500 ms) 2/8

3 Anbindung des 6000 / 900 in installiert über USB v. COM (virtueller COM Port) Einstellungen im 900 Menü: Hauptmenue > Einstellungen > Schnittstelle > Auswahl > USB Hauptmenue > Einstellungen > Schnittstelle > Parameter > Computer > T=1CWT > installiert über seriellen COM Port (-Kit DE) Einstellungen im 900 Menü: Hauptmenue > Einstellungen > Schnittstelle > Auswahl > Hauptmenue > Einstellungen > Schnittstelle > Parameter > > ,8,e,1 Hauptmenue > Einstellungen > Schnittstelle > Parameter > Computer > T=1CWT > Wenn das 900 über USB (virtueller COM Port) an einen Windows Client angeschlossen wird, muss der entsprechende USB v. COM Treiber installiert werden (Installation Setup). Windows XP Embedded USB v.com Treiber fragen Sie bitte gesondert über technik@ingenico-hc.de an. + Linux HP ThinPro Client (HP ThinPro Operating System Demonstration Package). odtypeid=12454&prodseriesid= &prodnameid= &swenvoid=4030&swlang=13 &mode=2&taskid=135&switem=vc PRODUCT TYPE(S): Thin Clients - HARDWARE PRODUCT MODEL(S): HP Compaq t5735 Thin Client: All Models HP gt7725 Thin Client: All Models HP t5325 Thin Client: All Models HP t5545 Thin Client: All Models HP t5745 Thin Client: All Models beinhaltet u.a. folgende Client Software: - RDesktop 1.6 (RDP 6 Client) - ICA Client daran installiert und angeschlossen: installiert über seriellen COM Port (-Kit DE) Einstellungen im 6000 Menü: Hauptmenue > Einstellungen > Schnittstelle > Auswahl > Parameter > Hauptmenue > Einstellungen > Schnittstelle > Parameter > > Baudrate > ,8,e,1 3/8

4 Anbindung des 6000 / 900 in Hauptmenue > Einstellungen > Schnittstelle > Parameter > Host T=1 > Timeing-CWT > (entspricht 500 ms) installiert über seriellen COM Port (-Kit DE) Einstellungen im 900 Menü: Hauptmenue > Einstellungen > Schnittstelle > Auswahl > Hauptmenue > Einstellungen > Schnittstelle > Parameter > > ,8,e,1 Hauptmenue > Einstellungen > Schnittstelle > Parameter > Computer > T=1CWT > Konfiguration CTORG32.INI am Server Kopieren Sie die CTORG32.DLL, CTORG32.INI, Quicktest.exe Dateien auf dem Server in ein Verzeichnis. Öffnen Sie dann die CTORG32.INI Datei auf dem Server mit einem Editor (WordPad). Unter [CTORG32] tragen Sie folgendes ein bzw. ändern folgende Zeilen wie beschrieben: ========================================================================== Configuration for seriel devices ========================================================================== [CTORG32] Mode 1 Serial values be valid for the serial ommunication. 0 Serial values are ignored for the serial communication. Ctorg32.dll uses internal values and uses Baudrate finding. Default value = 0. Mode=1 [SerialDevice1] pn=1 [SerialDevice2] pn=2 [SerialDevice3] pn=3 [SerialDevice4] pn=4 4/8

5 Anbindung des 6000 / 900 in Das setzen von Mode=1 verhindert die automatisch Baudratenerkennung. Bei physikalisch seriell angeschlossenen 6000 / 900 müssen Sie daher zusätzlich die Kartenleser im Menü auf die richtige Schnittstelle () und Baudrate (in diesem Beispiel Baudrate = ) setzen. Client : Anschluss und Konfiguration der Kartenleser. Überprüfen Sie am 6000 / 900 im jeweiligen Konfigurationsmenü ob die richtigen Anschlusseinstellungen gesetzt sind. Client: Verbindung mit dem Server am Beispiel des Citrix Online Plug IN s (Windows XP Client System). Starten Sie am Client das Citrix Online Plug In und verbinden Sie sich mit dem Desktop bzw. mit der Eingabeaufforderung (Terminalsession). Geben Sie folgendes an: net use COMx: \\Client\COMy x ist die entsprechende COM Port Nummer am Server, y ist die COM Port Nummer am Client. net use COM1: \\Client\COM1 verbindet ein 6000 / 900 welches am Client Port COM1 physikalisch seriell angeschlossen ist (-Kit). Mit change port lässt sich überprüfen ob das COM Port Redirection / Mapping korrekt funktioniert hat: sollte folgendes liefern: COM1 = \DEVICE\PICASERIALREDIRECTOR\COM1:\4\CLIENTPORT:COM1: Ein am Client über USB (virtueller COM Port) angeschlossenes 6000 / 900 erhält am Client z.b. den COM Port COM3. net use COM3: \\Client\COM3 COM3 = \DEVICE\PICASERIALREDIRECTOR\COM3:\4\CLIENTPORT:COM3: Siehe Link für weitere Informationen: 5/8

6 Anbindung des 6000 / 900 in Problem: Ein Problem tritt auf wenn ein am Client angeschlossenes 6000 / 900 die Port Nummer größer COM 4 erhält. Die CT-API DLL unterstützt nur 4 serielle Geräte ([SerialDevice1]... [SerialDevice4]) da in der CTORG32.INI Datei die seriellen Ports fest zugeordnet sind (Mode=1). Beispiel: 6000 / 900 am Client COM Port COM5 angeschlossen: net use COM5: \\Client\COM5 COM5 = \DEVICE\PICASERIALREDIRECTOR\COM5:\4\CLIENTPORT:COM5: ein Zugriff auf das 6000 / 900 über COM5 ist in diesem Fall nicht möglich. Lösung: A) Über change port lässt sich die Zuordnung (Redirection) der COM Ports ändern.. change port COM4=COM5 COM4 = \DEVICE\PICASERIALREDIRECTOR\COM5:\4\CLIENTPORT:COM5: COM5 = \DEVICE\PICASERIALREDIRECTOR\COM5:\4\CLIENTPORT:COM5: Das 6000 / 900 ist jetzt am Server über COM4 erreichbar. B) In der CTORG32.INI Datei die pn Nummer modifizieren. [SerialDevice4] pn=5 Das 6000 / 900 ist jetzt am Server über COM4 [SerialDevice4] erreichbar. 6/8

7 Anbindung des 6000 / 900 in Client: Verbindung mit dem Server über einen ThinClient (HP ThinPro Linux) 6000 / 900 physikalisch seriell mit dem Client verbunden ( Kit): Starten Sie am Client eine ICA Verbindung zum Server. In der Terminalsession starten Sie die Eingabeaufforderung und geben wieder das net use Kommando ein. net use COM1: \\Client\COM1 Das Linux device (ttysx) ttys0=com1, ttys1=com2, ttys2=com3, ttys3=com4 werden auf den entsprechenden COM Port unter Windows gemappt. COM1 = \DEVICE\PICASERIALREDIRECTOR\COM1:\3\CLIENTPORT:COM1: Das 6000 / 900 ist nun über COM Port COM 3 erreichbar. Client: Verbindung mit dem Server über einen ThinClient (HP ThinPro Linux) 6000 / 900 über USB (virtueller COM Port) mit dem Client verbunden: Starten Sie am Client ein Terminal (Eingabeaufforderung) und melden sich als root an und geben folgendes Kommando ein: tail f /var/log/messages Schließen Sie nun das 6000 / 900 über USB an den Client an. Das Gerät sollte als device ttyacmx erkannt werden ( ttyacm0 wenn es das erste Device am System ist). usb 1-1: new full speed USB device using uhci_hcd and address 4 usb 1-1: configuration #1 chosen from 1 choice cdc_acm 1-1:1.0: ttyacm0: USB ACM device usb 1-1: New USB device found, idvendor=0780, idproduct=1202 usb 1-1: New USB device strings: Mfr=1, Product=2, SerialNumber=3 usb 1-1: Product: 900 Smart Card Terminal RTM (PID_DF55 V.05.00) usb 1-1: Manufacturer: Sagem Monetel GmbH usb 1-1: SerialNumber: CE Erzeugen Sie nun einen symbolischen Link auf ttyacm0 so das Sie z.b. von ttys3 auf den Leser zugreifen können: rm /dev ttys3 ln s /dev/ttyacm0 /dev/ttys3 Starten Sie am Client eine ICA Verbindung zum Server. net use COM3: \\Client\COM3 COM3 = \DEVICE\PICASERIALREDIRECTOR\COM3:\3\CLIENTPORT:COM3: Das 6000 / 900 ist nun über COM Port COM 3 erreichbar. 7/8

8 Anbindung des 6000 / 900 in Zum Abschluss der Installation / Konfiguration lässt sich die Verbindung zum Kartenleser mit dem Testprogramm Quicktest überprüfen. Kopieren Sie nun die CT-API Komponenten CTORG32.DLL / CTORG32.INI in das Anwendungsverzeichnis Ihres PVS / KIS Systems und binden die CT-API DLL in das System ein. Abkürzungen: ICA (Independent Computing Architecture) Terminal Server Protokoll von Citrix. RDP (Remote Desktop Protocol) Terminal Server Protokoll von Microsoft. PVS Praxis Verwaltungssystem. KIS Krankenhaus Informationssystem. 8/8

9 Technical Note Anbindung des 6000 / 900 in Client / Server Umgebung (Windows Server - Linux Client). Health PVS / KIS Kundenanwendung KVK egk Server System (Windows) SOFTWARE LAYER Application Ware CT-API 1 2 Dateiaustausch Programmaufruf KVK_Daten.xml egk_allge meinevers icherungs datenxml. xml Ingenico Healthcare "WinCrd2XML.exe" (32- Bit) 1 2 egk_gesch uetztever sicherten datenxml. xml egk_mfdf_h CA_EF_Stat usvd.xml egk_mfef_ GDO.xml Option 1: Direkter Zugriff auf die CT-API Schnittstelle. egk_perso enlicheve rsicherte ndatenxml.xml Option 2: Programmaufruf von "WinCrd2XML" und Dateiaustausc h. Middle Ware CT-API DLL CTORG32.DLL / CTORG64.DLL [CTORG32] Mode=1 [SerialDevice3] pn=3 CT-API DLL CTORG32.DLL / CTORG64.DLL [TCPDevice1] pn=port_tcp1 ip_addr= tcp_port=9700 encrypted=0 username=orga password=bcslan [portmapping] pn_1=port_tcp1 Konfiguartionsdatei CTORG32.INI / CTORG64.INI - CITRIX ICA - RDesktop RDP / ICA TCP/IP UDP TCP / IP IP Adresse eintragen! SOFTWARE LAYER Middle Ware COM Port Redirection er / USB (virtueller COM Port) Windows RDP Remote Desktop (RDesktop) Client oder Citrix Online Plug IN Konfiguration Symbolischen Link auf ttyacm0 erzeugen,so das Sie z.b. von ttys3 auf den Leser zugreifen können: rm /dev ttys3 ln s /dev/ttyacm0 /dev/ ttys3 Client System (LINUX) Unterstützte Karten KVK egk USB (virtueller COM Port) USB (virtueller COM Port) HARDWARE LAYER 9xx Mobil / Stationär Mode PC-Protokoll > T=1 Parameter > ,8,e,1 T=1CWT > 9xx Mobil / Stationär Mode USB PC-Protokoll > T=1 T=1CWT > Timeing-CWT > USB v. COM Timeing-CWT > Parameter > > IP Adresse >

10 Technical Note Anbindung des 6000 / 900 in Client / Server Umgebung (Windows Server - Windows Client). Health PVS / KIS Kundenanwendung KVK egk Server System (Windows) SOFTWARE LAYER Application Ware CT-API 1 2 Dateiaustausch Programmaufruf KVK_Daten.xml egk_allge meinevers icherungs datenxml. xml Ingenico Healthcare "WinCrd2XML.exe" (32- Bit) 1 2 egk_gesch uetztever sicherten datenxml. xml egk_mfdf_h CA_EF_Stat usvd.xml egk_mfef_ GDO.xml Option 1: Direkter Zugriff auf die CT-API Schnittstelle. egk_perso enlicheve rsicherte ndatenxml.xml Option 2: Programmaufruf von "WinCrd2XML" und Dateiaustausc h. Middle Ware CT-API DLL CTORG32.DLL / CTORG64.DLL [CTORG32] Mode=1 [SerialDevice3] pn=3 CT-API DLL CTORG32.DLL / CTORG64.DLL [TCPDevice1] pn=port_tcp1 ip_addr= tcp_port=9700 encrypted=0 username=orga password=bcslan [portmapping] pn_1=port_tcp1 Konfiguartionsdatei CTORG32.INI / CTORG64.INI CITRIX ICA Windows Terminal Services RDP Remote Desktop RDP RDP / ICA TCP/IP UDP TCP / IP IP Adresse eintragen! SOFTWARE LAYER Middle Ware COM Port Redirection er / USB (virtueller COM Port) Windows RDP Remote Desktop Connection oder Citrix Online Plug IN Konfiguration Smart Card Redirection USB (PC/SC) Smartcards und e Schnittstellen auswählen! Client System (Windows) Unterstützte Karten KVK egk USB (virtueller COM Port) USB (PC/SC) USB (virtueller COM Port) HARDWARE LAYER 9xx Mobil / Stationär Mode PC-Protokoll > T=1 Parameter > ,8,e,1 T=1CWT > 9xx Mobil / Stationär Mode USB PC-Protokoll > T=1 T=1CWT > 9xx Mobil / Stationär Mode USB PC-Protokoll > CCID-Escape T=1CWT > Timeing-CWT > USB v. COM Timeing-CWT > Parameter > > IP Adresse >