BELPIC RA PC The BELPIC cookbook
INDEX The BELPIC cookbook... 1 Inleiding... 3 Voorafgaande tips:... 3 Doel:... 4 Gids voor het invullen van de RA PC checklist:... 5 BELPIC HARDWARE CHECKLIST... 6 BELPIC HARDWARE CHECKLIST VOORBEELD... 7 1) Kaartlezers driver versie en datum:... 8 2) kaartlezers positie:... 13 3) Routing ISA server :... 14 4) Windows hardware error logfile:... 14 5) PIN code wijziging test:... 17 6) kaartlezertest BELPIC:... 17 7) communicatie test BELPIC:... 18 8) Versies : op datum 01/8/2006... 19 9) BELPIC PCSC service:... 20 9.a. nieuwe versie sinds 4/7/2006: V 2.5.9... 20 10) installeren van een vreemde kaartlezer:... 21 11) conflict met andere toepassingen:... 22 12) geen verbinding meer mogelijk met server/ nieuwe PC:... 24 13) JAVA foutboodschap:... 25 14) USB klavier:... 25 15) Compaq PC:... 25 Versie-tracking:... 26 2 van 26 Versie 1.1-1/8/2006 3/08/2006
Inleiding Deze handleiding heeft tot doel een gids te zijn voor de configuratie en het nazicht van BELPIC RA pc s. Een stabiele configuratie is een samenspel van op de juiste manier opstarten, juiste versie van BELPIC software, kaartlezer firmware, kaartlezer driver, instellingen BELPIC, voldoende communicatie bandbreedte en optimale routering. Om het overzichtelijk te houden en geen items te vergeten is er een checklist toegevoegd, die het process eenvoudger maakt. Het is een vrij technische materie, waar mogelijk worden dan ook schermafdrukken gebruikt om de uitvoering te vergemakkelijken. Indien u nog vragen heeft of er ook door middel van de handleidng niet aan uit kan, kan u de provinciale coördinatie cel EID contacteren voor verdere hulp. Het is de bedoeling dit document zo up to date mogelijk te houden, indien u nog items wenst toegevoegd te zien of opmerkingen heeft over de bestaande kan u mij steeds contacteren (luc.mertens@rrn.fgov.be) Voorafgaande tips: Sommige instructies behelsen het wijzigen van configuratie files van windows of BELPIC., dit is niet zonder risico, neem in elke geval ALTIJD een backup alvorens iets te wijzigen, zodat u de toestand steeds kan terugdraaien. Dit is geen uitnodiging tot experimenteren, weet waar je mee bezig bent als je verkeerde parameters wijzigt zit je met een geblokkeerd systeem. Het is van essentieel belang om de PC correct op te starten t.t.z. te wachten tot de kaartlezers klaar staan alvorens de PC op te starten. Na het wijzigen van drivers en dergelijke is het steeds nodig een volledige herstart (met spannings onderbreking) te doen van de PC. 3 van 26 Versie 1.1-1/8/2006 3/08/2006
Doel: Reeds van in het begin werden de RA PC s voornamelijk geplaagd door problemen met de kaartlezers. Als oorzaak hiervan werd door ervaring vastgesteld: PC wordt niet correct opgestart verkeerde versie van kaartlezer firmware verkeerde versie van kaartlezer driver verkeerde versie BELPIC software onvoldoende bandbreedte op het netwerk hoge responstijden op het netwerk wegens slechte routering en uiteraard effektief defekte kaartlezers Hierna volgt een checklist welke u zal toelaten om snel en grondig deze parameters te kontroleren. Indien de RA PC geconfigureerd wordt zoals in deze handleiding voorgesteld wordt, dan kan er nadien in het systeemlogboek van het Windows besturingssyteem vastgesteld worden of de kaartlezer hardware fouten blijft genereren. In dat geval is èèn of alle twee de kaarttlezers defect. In twijfelgevallen kunt u de verdachte kaartlezers best vervangen door toestellen die zeker goed zijn. Indien geen reserve kaartlezers voorhanden zijn kan de kaartlezer van de ambtenaar door een alternatieve vervangen worden (klavier of kleine kaartlezer) om alzo een kaartlezer te recupereren. Bevat het systeemlogboek geen hardware fouten dan moet de oorzaak in de richting van het communicatie kanaal gezocht worden (bandbreedte, routering). 4 van 26 Versie 1.1-1/8/2006 3/08/2006
Gids voor het invullen van de RA PC checklist: 1) Vul de datum, niscode en naam van de gemeente in 2) Voer een communicatie test uit vanuit het BELPIC programma, de pc naam staat bovenaan het document, print de test af, vul de naam in. 3) Kruis aan of het een RA PC betreft of een eigen PC 4) Noteer van elke kaartlezer: a. Type. b. Serienr (onderaan op sticker). c. Firmware versie (zie display). d. Driver versie en datum ( drivers ). e. Doe eventueel een kaartlezertest vanuit BELPIC. f. Doe eventueel een PIN code wijziging test. 5) Kijk de kaarltezer positie na in de BELPIC software (0 en 1), en pas zonodig aan. ( positie ) 6) Vraag aan de systeem beheerder of er een ISA server is, zo ja kijk de routing table na en noteer. ( routing ) 7) Noteer de BELPIC versie. 8) Kijk de timings van de communicatie test na (ping). 9) Kijk of er errors staan in de windows log file ( logfile ). 10) start de PC op de correcte wijze op en noteer. 11) kijk na of de BELPIC PCSC service af staat als hij aanwezig is. 12) is er contact met de Belgacom BILAN helpdesk. 5 van 26 Versie 1.1-1/8/2006 3/08/2006
BELPIC HARDWARE CHECKLIST 6 van 26 Versie 1.1-1/8/2006 3/08/2006
BELPIC HARDWARE CHECKLIST VOORBEELD 7 van 26 Versie 1.1-1/8/2006 3/08/2006
1) Kaartlezers driver versie en datum: a) klik op het icoontje met de groene pijl rechts onderaan de windows desktop (hardware veilig verwijderen) b) selecteer de eerste kaartlezer c) klik op de knop eigenschappen 8 van 26 Versie 1.1-1/8/2006 3/08/2006
d) selecteer de TAB stuurprogramma Daar vindt je de versie nummer en de datum van de driver van de kaartlezer en of hij al dan niet digitaal ondertekend is. Indien de datum (16/5 i.p.v. 17/5) niet up to date is, dient de kaartlezer opnieuw geïnstalleerd worden door de driver bij te werken. Volgens procedure A) hieronder Indien de datum en de versie (vaak versie van 2003) niet up to date is, dient de kaartlezer opnieuw geïnstalleerd worden door de driver bestanden volledig te installeren volgens procedure B) hieronder 9 van 26 Versie 1.1-1/8/2006 3/08/2006
A) stuurprogramma bijwerken Zelf kiezen aanklikken 10 van 26 Versie 1.1-1/8/2006 3/08/2006
niet zoeken aanklikken STR391 reader selecteren en volgende klikken 11 van 26 Versie 1.1-1/8/2006 3/08/2006
indien nodig toch doorgaan klikken Voltooien klikken B) Indien de driver de verkeerde versie is (versie, datum, digitale ondertekening) moeten de bestanden: STR391.sys versie van 17/5/2005!!! STR391.inf STR391.cat ter beschikking zijn (op floppy, USB stick of CD) en dient u de net doorlopen procedure opnieuw uit te voeren, daarbij verwijzend naar de correcte bestanden (bijvoorbeeld a:\) 12 van 26 Versie 1.1-1/8/2006 3/08/2006
2) kaartlezers positie: Zorg er voor dat de ambtenaar kaartlezer op 0 staat en de burger op 1. Indien omgekeerd, kies in de drop down list de goede settings en verwissel de kaartlezers fysisch van plaats ZONDER de USB kabels uit te trekken!!! 13 van 26 Versie 1.1-1/8/2006 3/08/2006
3) Routing ISA server : Indien de gebruiker over een ISA server beschikt, controleer of de onderstaande lijn 193.191.221.133 belpic.rrn.fgov.be in de routingtable (%windir%\system32\drivers\etc) aanwezig is, zoniet voeg ze toe, de server moet NIET opnieuw opgestart worden, het effekt is onmiddelijk voelbaar als een zeer grote snelheids winst in de responstijden van de BELPIC software. 4) Windows hardware error logfile: open de logfile op onderstaande wijze: Open het control panel via start configuratie scherm Selecteer sub groep systeembeheer Selecteer logboeken 14 van 26 Versie 1.1-1/8/2006 3/08/2006
Selecteer systeem logboeken 15 van 26 Versie 1.1-1/8/2006 3/08/2006
Indien grote blokken fouten optreden, binnen dezlefde tijdspanne (seconden) is er een kaartlezer probleem aanwezig. Wanneer de PC correct is opgestart en de drivers en firmware up to date zijn, duidt dit op èèn of twee slechte kaartlezers. Indien de fouten slechts sporadisch aanwezig zijn, zijn deproblemen niet te wijten aan kaartlezer problemen maar aan bijvoorbeeld communicatie of routing problemen. De lijst kan desgewenst geëxporteerd worden of via printscreen en paint afgedrukt worden: 16 van 26 Versie 1.1-1/8/2006 3/08/2006
5) PIN code wijziging test: Indien de RA pc correct opgestart is en juist geconfigureerd, kan u enkele keren na elkaar een PIN code wijziging uitvoeren. Indien het om een defecte kaartlezer gaat zal u er niet in slagen dit uit te voeren, de in BELPIC voorziene kaartlezertest zal wel ok zijn. 6) kaartlezertest BELPIC: u dient uitgelogd te zijn om deze test uit te voeren! Test de kaart vervolgens met en zonder een IEK, èèn lezer moet een fout geven (lege kaartlezer), de andere moet de chip inhoud kunnen lezen. Om zeker te zijn dat de kaartlezer in orde is kan u ook nog een PIN code wijzigings test doorlopen. 17 van 26 Versie 1.1-1/8/2006 3/08/2006
7) communicatie test BELPIC: u dient uitgelogd te zijn om deze test uit te voeren! u kan zien of er verbinding is met de server in Brussel, indien niet kijk het lokaal netwerk na. 18 van 26 Versie 1.1-1/8/2006 3/08/2006
Ideaal is dat er zo weinig mogelijk tussenstappen (hops) in het communicatie kanaal zitten en dat de timings zo laag mogelijk blijven. Sommige routers staan echter zo ingesteld dat ze op deze commando s niet antwoorden. Aan bijvoorbeeld de snelheid van een 25/27 opvraging kan u inschatten hoe snel de systemen reageren. Buiten snelheid is vooral stabiliteit een belangrijke parameter. Trage maar stabiele data lijnen hoeven nog niet noodzakelijk tot problemen te leiden. Echter wanneer de lijn reactietijden sprongen maakt van bijvoorbeeld 20 naar 290 ms moet dit verder onderzocht worden. Dit kan via uw systeem beheerder/contractor of door een lijnanalyse aan te vragen bij Belgacom (contractnummers noodzakelijk) Hieronder een voorbeeld van een 2M/b lijn welke op 1,2 M/b afgeknepen wordt en vooral in de voormiddag veelvuldig op zijn max debiet zit. 8) Versies : op datum 01/8/2006 Belpic 1.7.0 build 353 RRV020 Cashmouse 1.04 Driver STR 391 1.9.0.1 17/5/2005 BELPIC hardware checklist 0.99 10/7/2006 Cookbook 1.1 01/8/2006 Middleware 2.5.9 04/7/2006 19 van 26 Versie 1.1-1/8/2006 3/08/2006
9) BELPIC PCSC service: Voor het registreren van certificaten wordt de middleware software gebruikt. Deze start echter een service op die de kaartlezers voor andere toepasssingen blokkeert, op deze wijze kan u deze afzetten: start het windows services beheer op: deze service moet buiten dienst gezet worden (disable) om conflicten met BELPIC en eventuele andere toepassingen te vermijden 9.a. nieuwe versie sinds 4/7/2006: V 2.5.9 (Belgian_Identity_Card_Run-time_2.5.9.zip) er wordt een nieuwe naam gebruikt voor de service: eid Privacy Service 20 van 26 Versie 1.1-1/8/2006 3/08/2006
Afhankelijk van wat de user selecteerde bij de installatie zal deze service al dan niet geactiveerd worden. Indien hij op automatisch staat moet hij afgezet worden. 10) installeren van een vreemde kaartlezer: Uit de praktijk blijkt dat een BELPC RA pc s waar de kant van de ambtenaar een alternatieve kaartlezer geplaatst wordt stabieler werken, dit omdat het Windows operating systeem twee identieke kaartlezers moeilijk kan onderscheiden op systeem niveau. De kaarlezer aan de kant van de burger MOET steeds van het type cashmouse zijn. Het installatie process behelst 2 stappen: A) installatie van de kaartlezer onder windows: installeer de kaartlezer zodanig dat hij onder windows herkend wordt, dit is o.a. te zien aan het feit dat je hem in het BELPIC programma kan selecteren. Herstart de PC. B) aanpassingen BELPIC: a. zet de alternatieve kaartlezer als ambtenaar lezer b selecteer de burger cashmouse kaartlezer op positie 0 c schrijf de settings weg door op toepassen te klikken d neem een backup copie van de file c:\belpic\opensc.conf e editeer de c:\belpic\opensc.conf met een ASCII editor zoals wordpad (NIET MSWORD!) kopiëer een blok over van een vergelijkbare kaartlezer (meestal met pinpad emulator): bijvoorbeeld: # Place here the names and libs (DLL) for the Belpic pin pad readers # Start with reader0 and lib0, then reader1 and lib1,... until # reader9 and lib9. # The lib (DLL) should be placed in your execution path. reader0 = "SCM Microsystems STR391"; lib0 = EID_Cashmouse; reader1 = "ACS ACR38U"; lib1 = pinpad_emulator; reader2 = "Texas Instruments GTICARD"; lib2 = pinpad_emulator; reader3 = "Xiring X Pass Serial"; lib3 = xireid; reader4 = "SCM Microsystems STR100"; lib4 = EID_Cashmouse; blok 1 kopiëren/plakken reader1 = "ACS ACR38U"; 21 van 26 Versie 1.1-1/8/2006 3/08/2006
lib1 = pinpad_emulator; volgnummer aanpassen reader5 = "ACS ACR38U"; lib5 = pinpad_emulator; kopieer de naam die in het BELPIC programma voor de kaartlezer staat en zet deze in de plaats van de bestaande naam, opgelet : 0 en spatie op het einde van de naam verwijderen!!! voorbeeld naamgeving : reader5 = ""; lib5 = pinpad_emulator; reader5 = "Texas Instruments GTICARD 0"; lib5 = pinpad_emulator; reader5 = " Texas Instruments GTICARD"; lib5 = pinpad_emulator; schrijf de file weg. Herstart BELPIC en kijk of de settings correct zijn, vooral dat de burger kaartlezer op positie 0 staat!. Mocht deze werkwijze verkeerd aflopen, zelfs een verborgen spatie in het bestand doet het BELPIC programma vastlopen, zet dan desnoods de backup file terug. Er zijn maximaal 10 kaartlezers categorieën (0 9) toegelaten. 11) conflict met andere toepassingen: 22 van 26 Versie 1.1-1/8/2006 3/08/2006
Zoals de toepassing voor de sociale zekerheid : schakel volgens punt 9 de BELPIC PCSC service uit. Binnenkort komt een nieuwe middleware ter beschikking (versie 2.5) welke bij het installeren vraagt of de service moet geïnstalleerd worden, daarop uiteraard nee antwoorden.om conflicten te vermijden. 23 van 26 Versie 1.1-1/8/2006 3/08/2006
12) geen verbinding meer mogelijk met server/ nieuwe PC: Voor een nieuwe PC heeft u een R-code nodig, of indien de PC hersteld werd en er werd een nieuwe netwerkkaart, soms geïntegreerd in het moederbord, geïnstalleerd, dan is de P- code voor de PC niet meer geldig en kan u geen verbinding meer maken met de server in Brussel. De P-code is immers een samensmelting van het MAC adres (netwerkkaart), de computernaam en de NIS code van de gemeente. Door middel van het programma PCODE.EXE (CD-Rom BELPIC) kan u de P-code genereren en vervolgens aan de helpdesk (02 518 21 17) een R-code vragen, de naam van de PC mag maar èèn keer in de lijst met de codes voorkomen!. Plaats de cursor in het BELPIC programma in het NIS code veld en druk CTRL SHIFT gelijktijdig in en tik RCODE op het toetsenbord in, naast de NIS code verschijnt een nieuw veld waar u de op de helpdesk verkregen R-code moet intypen. 24 van 26 Versie 1.1-1/8/2006 3/08/2006
Soms krijgt u nadien een fout verkeerde NIS code, dan verschijnt de verkeerde NIS code wanneer u het PCODE programma uitvoert, dan moet u de NIS code in de Windows Registry manueel gaan aanpassen (regedit opgelet! niet zonder gevaar!). 13) JAVA foutboodschap: Wanneer u deze foutboodschap krijgt, meestal bij het installeren van een nieuwe configuratie dient u de JAVA versie j2re-1_3_1_07-windows-i586-i.exe op de PC te installeren. Vraag dit eventueel aan uw systeembeheerder indien u niet over voldoende schrijfrechten en/of over het bestand beschikt. 14) USB klavier: Bij het gebruik van een USB klavier moet in het BIOS van het systeem LEGACY SUPPORT aangezet worden om het klavier bij het opstarten te herkennen. Indien dit niet gebeurt zal het klavier wel werken in windows, maar niet gebruikt kunnen worden om bijvoorbeeld in te loggen. 15) Compaq PC: Bij bepaalde types Compaq PC worden de kaartlezers uitgeschakeld wanneer de PC afstaat. In het BIOS staat bovendien een quick boot optie aan. Daardoor is de PC reeds opgestart, vooraleer de cashmouses werkingsklaar zijn. Zet in het BIOS (F10 toets) de quickboot optie op fullboot, indien nodig kan een power on delay in stappen van 5 seconden opgegeven worden in het BIOS. 25 van 26 Versie 1.1-1/8/2006 3/08/2006
Versie-tracking: 1/8/2006 Punt 14 USB klavier bijgevoegd Punt 15 Compaq PC bijgevoegd Punt 8 aangepast Punt 9 a nieuwe middleware bijgevoegd Versie tracking bijgevoegd 26 van 26 Versie 1.1-1/8/2006 3/08/2006