Knowledge Article
REQUEST NO. 00156
Nederlandse versie: Gerard Baegen
Afdeling: Engineering
Vertrouwelijk: Nee
Datum 23/10/2014
Product: CITO
Onderdeelnummer::
Versie: 6.4 NL
KEL Number: N/A
Titel: CITO 6.4 NL - Patch Installer Instructies en Troubleshooting Documentversie: a10 Laatst gewijzigd: 01/12/2014 Gerelateerde documenten: KA0139 - “CITO 6.2.0.4 : Windows 7 & 8 64bit Installatiehandleiding” Benodigd installatiepakket: CITO6_4_PatchInstallerPack_1.0.0.12.exe
Ondersteunde besturingssystemen:
Besturingssysteem Windows XP1 Windows 7 Windows 8 Windows 8.1
32-Bit JA JA JA JA
64-Bit NEE Zie KA0139 Zie KA0139 Zie KA0139
Minimum Service Pack 3 1
Korte beschrijving: Dit document bevat instructies om CITO 6.4 NL d.m.v. het patch installatiepakket en eventuele probleemoplossing als onverhoopt toch problemen optreden. In de meeste gevallen zal de upgrade naar CITO 6.4 probleemloos verlopen. Wel is het belangrijk dat aan de voorwaarden gesteld in Voorbereidingen en Eisen voldaan is vóór aanvang van de upgrade zodat deze moeiteloos verloopt en dat in geval van problemen een back-up van uw data beschikbaar is en herstel naar een werkende versie van CITO 6.2.0.4 inclusief uw data mogelijk is.
1
8 april 2014 is de ondersteuning van Windows XP door Microsoft beëindigd. CITO kan en mag nog steeds gebruikt worden op Windows XP computers. Dit is echter geheel op eigen risico. Ondersteuning bij problemen zal alleen mogelijk zijn bij Windows 7 of nieuwere versies.
Inhoudsopgave Knowledge Article ........................................................... 1 Inhoudsopgave ........................................................... 2 Afbeeldingen............................................................. 2 Voorbereidingen en eisen ..................................................... 3 CITO Eisen ............................................................ 3 Uitpakken van het CITO 6.4 installatiepakket .................................... 3 Uitvoeren van de CITO 6.4 NL Patch Installer ...................................... 4 Stap 1 : Detectie van de huidige CITO versie .................................... 4 Stap 2 : Plaatsen van de geüpdate bestanden ................................... 5 Stap 3 : Update van de CITO Database ....................................... 5 Troubleshooting ............................................................ 6 CITO verkeerde versie ....................................................... 6 1 : CITO Versie niet aangetroffen: ............................................. 6 2 : CITO verkeerde versie aangetroffen. ......................................... 6 3 : CITO 6.4.0.1 is al geïnstalleerd. ............................................ 7 Fout tijdens uitpakken van bestanden ............................................ 7 GUI Patch Installer ........................................................ 7 CITO 6.4 Upgrade mislukt ..................................................... 8 Terug naar CITO 6.2.0.4 ...................................................... 9 Console “Force” Mode Installatie ............................................... 10 Troubleshooting console “Force” Installatie ...................................... 11
Afbeeldingen Afb. 1 : Stap 1 Succes, CITO 6.2.0.4 aangetroffen ................................... 4 Afb. 2 : Stap 2 : Updatebestanden, Succes ........................................ 5 Afb. 3 : Stap 3 : Database Update, Succes ......................................... 5 Afb. 5 : Stap 1 Fout : CITO verkeerde versie aangetroffen .............................. 6 Afb. 6 : Stap 1 Fout : CITO 6.4 is al geïnstalleerd .................................... 7 Afb 7 : Stap 2 Fout : Controle op juiste bestandsversies ............................... 8 Afb. 8 : Console "Force" Mode Installatie ......................................... 10 Afb. 9 : Stap 2 Console "Force" Installatiefout: Ontbreken van bestanden ................. 11
Voorbereidingen en eisen CITO Eisen 1) CITO 6.2.0.4 Moet al geïnstalleerd zijn of moet éérst geïnstalleerd worden: a. Nieuwe installatie i. Installeer CITO 6.2.0.4 met behulp van het CITO setup.exe bestand. Let op: Na de installatie van versie 6.2.0.4 kunt u direct doorgaan met de upgrade naar versie 6.4. U hoeft versie 6.2.0.4 niet eerst op te starten in admin modus, dit kan na de upgrade naar CITO 6.4. Let op: De installatieplaatjes printer Toshiba TEC EV4-G hoeft ook pas na de upgrade naar CITO 6.4 uitgevoerd te worden.. ii. Als u CITO 6.2.0.4 installeert op een Windows 7 of 8 64bit machine volg dan Knowledge Article KA0139 “CITO 6.2.0.4 : Windows 7 & 8 64bit Installatiehandleiding”. b. Upgrade Installatie i. Als CITO 6.2.0.4 al geïnstalleerd is kunt u direct met de upgrade beginnen. Belangrijk: Als u een oudere versie van CITO gebruikt moet u deze eerste upgraden naar versie 6.2.0.4. 2) CITO mag niet actief zijn: Belangrijk: Geef Windows de tijd om alle CITO processen te stoppen en alle bestanden vrij te geven. 3) Back-up beide dynamische en statische CITO 6.2.0.4 databasen naar een veilige locatie: BELANGRIJK: Beide CITO databases moeten naar een veilige locatie als back-up gekopieerd worden. Let op: De database bestanden acelies.dll en wrkstatic.dll bevinden zich in C:\Program Files (x86)\SECommon bij Windows 64bit of in C:\Program Files\SECommon bij 32bit Windows. 4) Pak de CITO 6.4 bestanden uit. Zie: Uitpakken van het CITO 6.4 installatiepakket beneden.
Uitpakken van het CITO 6.4 installatiepakket Plaats het CITO 6.4 Patch self-extracting bestand naar een geschikte locatie: Aanbevolen is het bureaublad van uw pc. In de beschrijving hieronder gaan we er vanuit dat dit bestand zich inderdaad op het bureaublad bevind. Dubbelklik op CITO6_4_PatchInstallerPack.exe om de CITO 6.4 Patch Installer en ondersteunende bestanden op het bureaublad uit te pakken. CITOPatchInstallerV6_4.exe (9MB) : De patch waarmee CITO van 6.2.0.4 naar 6.4.0.1 te upgraden. CITOV6_4_InstallationFiles (1MB) : Ondersteunende bestanden hulpprogramma’s die de CITO 6.4 patch installer gebruikt en een aantal die vereist zijn voor manuele processen zoals beschreven in deze KA.
Uitvoeren van de CITO 6.4 NL Patch Installer De patch installer voorziet in een Wizard waarmee 3 belangrijke stappen doorlopen worden.: 1) Controle van de huidige versie: CITO 6.2.0.4 2) Plaatsen van de geüpdatete bestanden 3) Update van de CITO database Nadat de CITO 6.4 Patch Installer voltooid is moet men alle CITO functies testen voordat men de CITO software weer gaat gebruiken bij officiële kalibraties van voertuigen. Bij fouten verwijzen we naar het hoofdstuk CITO 6.4 Upgrade mislukt en hoofdstuk Troubleshooting verderop in dit document.
Hieronder een stap voor stap beschrijving van een succesvolle installatie van de CITO 6.4 patch. Mochten er fouten optreden tijdens het gebruik van de Patch Installer dan worden deze kenbaar gemaakt d.m.v. een rode banner waarin beschreven wordt wat de fout is. Bij fouten neemt u eerst hoofdstuk troubleshooting door voor mogelijke oplossingen voordat u met C.A.S.U. – Utrecht contact opneemt. Na elke voltooide stap klikt u op “Volgende” om de volgende stap te starten.
Stap 1 : Detectie van de huidige CITO versie De CITO 6.4 Patch installer vereist dat CITO 6.2.0.4 geïnstalleerd is voor u verder kunt gaan. U krijgt een foutmelding als er een versie anders dan 6.2.0.4 geïnstalleerd is.
Afb. 1 : Stap 1 Succes, CITO 6.2.0.4 aangetroffen
Stap 2 : Plaatsen van de geüpdate bestanden De CITO 6.4 NL Update omvat 5 geüpdate bestanden die op de juiste plaats in de bestaande CITO 6.2.0.4 installatie geplaats moeten worden.. De patch installer vervangt automatisch de betreffende CITO 6.2.0.4 bestanden door de CITO 6.4 versies. Na de vervanging worden automatisch de bestandversies gecontroleerd om er zeker van te zijn dat de juiste versies geïnstalleerd zijn. Als deze controle mislukt zal deze stap een foutmelding geven met de bijbehorende beschrijving. Afb. 2 : Stap 2 : Updatebestanden, Succes
Stap 3 : Update van de CITO Database De statische CITO database moet geüpdate worden voordat de applicatie kan functioneren. Ook de dynamische database moet een update hebben zodat de back-up en terugzetten back-up functie blijven functioneren. Deze stap herkend of de huidige CITO installatie een standalone installatie is en update de database. Let op ( Mogelijk verborgen fout ) : Een probleem met de update van de database wordt niet door de Patch Installer gemeld. In dit geval zult u niet kunnen inloggen. Als dit probleem zich optreed kijkt u in het hoofdstuk Troubleshooting voor een mogelijke oplossing.
Na voltooien van stap 3 klikt u op “Afsluiten” om de update te beëindigen.
Start CITO 6.4 en controleer de applicatie volledig voordat u voertuigen gaat kalibreren. Afb. 3 : Stap 3 : Database Update, Succes
Troubleshooting Er kunnen een aantal fouten optreden tijdens het gebruik van de CITO 6.4 Patch Installer. Hieronder de beschrijvingen en mogelijke oplossingen.
CITO verkeerde versie Er zijn 3 fouten mogelijk tijdens de detectie van de huidige versie. In alle gevallen breekt de installer de installatie af. Zoek de bijbehorende weergegeven foutmelding hieronder op en volg de aangegeven stappen.
1 : CITO Versie niet aangetroffen: Foutmelding : “De CITO installer heeft de huidige softwareversie niet vast kunnen stellen. Controleer of u administrator rechten heeft en probeer het nogmaals. Neem contact op met de klantenservice als dit probleem zich blijft voordoen.” Aanbevolen actie(s): 1) Probeer de upgrade nogmaals door op de rechtermuis knop te klikken en “Uitvoeren als Administrator” te kiezen. 2) Bent u er 100% van dat CITO 6.2.0.4 geïnstalleerd is voer dan de installatie in Console “force” Mode uit. De versiecheck wordt dan niet uitgevoerd. 3) Bij twijfel neemt u contact op met C.A.S.U. – Utrecht.
2 : CITO verkeerde versie aangetroffen. Foutmelding : “De CITO software op deze computer is versie: {VERSION}. Deze installatie vereist minimaal CITO versie 6.2.0.4. Voer a.u.b. de upgrade naar 6.2.0.4 en probeer het opnieuw. Neem contact op met de klantenservice als dit probleem zich blijft voordoen..”
Afb. 4 : Stap 1 Fout : CITO verkeerde versie aangetroffen
Aanbevolen actie(s): 1) Als CITO 5 geïnstalleerd is upgrade u naar CITO 6.2.0.4 d.m.v. de CITO 6.2.0.4 installer.. 2) Zodra CITO 6.2.0.4 geïnstalleerd is installeert u de CITO 6.4 Patch opnieuw.
3 : CITO 6.4.0.1 is al geïnstalleerd. Foutmelding : “CITO 6.4 is al geïnstalleerd.” Afb. 5 : Stap 1 Fout : CITO 6.4 is al geïnstalleerd
Aanbevolen actie(s): 1) Nadat de CITO 6.4 patch installer uitgevoerd wordt na een mislukte poging om de update te installeren kan deze foutmelding weergegeven worden. Oplossing is door de Patch Installer in console “force” mode,te installeren. Zie: “CITO 6.4 Upgrade mislukt” verderop in dit document. 2) Als de CITO 6.4 al eerder geïnstalleerd is klikt u op “Afsluiten” de update was al uitgevoerd.
Fout tijdens uitpakken van bestanden GUI Patch Installer Foutmelding: B.v. “>>>>>>> ~\SECommon\CitoWSLang0x13.dll : CITO v6.4 version = 1.1.0.17 [INVALID]... detected version = 1.1.0.15” Consequentie: Als het uipakken van bestanden mislukt zal de installer de upgrade niet kunnen voltooien. Aanbevolen actie(s): In dit geval verwijdert u de Patch installer en ondersteunende bestanden van het bureaublad, Pak de bestanden opnieuw uit door dubbel te klikken op CITO6_4_PatchInstallerPack_1.0.0.8.exe 7Zip. Voer de Patch installer opnieuw uit in Console “Force” Mode.
Afb 6 : Stap 2 Fout : Controle op juiste bestandsversies
Er zijn een aantal redenen waardoor bestanden niet correct vervangen zijn. Mogelijkheden: 1) CITO is nog actief waardoor bestanden die geupdate moesten worden nog in gebruik waren. 2) De computer is erg traag of heeft technische storingen waardoor de controle uitgevoerd word voordat de bestanden geupgrade zijn. 3) Verwijzingen in de Patch Installer naar de CITOV6_4_Installatie map bevat niet alle CITO 6.4 bestanden – vaak veroorzaakt door een eerder uitgevoerde en mislukte installatie van CITO 6.4.
CITO 6.4 Upgrade mislukt Als na een CITO 6.4 upgrade installatie met behulp van de patch installer of console “force” mode CITO niet correct functioneert start u de pc opnieuw op en probeer nogmaals de upgrade in console “force” mode uit te voeren, zie: Console “Force” Mode Installatie Als na deze 2de poging de upgrade mislukt neemt u contact op met klantondersteuning voor assistentie. Mocht het wenselijk zijn om terug te keren naar de oorspronkelijke versie CITO 6.2.0.4 kan dit door de stappen in volgend hoofdstuk te volgen.
Terug naar CITO versie 6.2.0.4 Als de installatie van de CITO 6.4 upgrade mislukt is en in afwachting van ondersteuning door klantondersteuning wilt u doorwerken met voorgaande versie CITO 6.2.0.4 volg dan onderstaande stappen. 1) Controleer of CITO 6.4 niet actief is. 2) Open de C:\Users\{Username}\Desktop\CITOV6_4_InstallationFiles\CITO 6.2.0.4 Files map in Windows Explorer en open een 2de Windows Explorer venster en plaats deze naast elkaar op het scherm. 3) In het 2de Windows Explorer venster opent u C:\{Program Files}*\CITO en kopieer CitoWS.exe van de CITO 6.2.0.4 Files folder naar C:\{Program Files}*\CITO en overschrijft u de aanwezige CitoWS.exe in die map. 4) In het 2de Windows Explorer venster opent u C:\{Program Files}*\SECommon en kopieerd u de resterende CITO 6.2.0.4 bestanden naar C:\{Program Files}*\SECommon waar u de volgende bestanden overschrijft: CitoWSLang0x13.dll SEDBAM.dll Wizard.dll WizardLang0x13.dll 5) Open een Administrator command prompt en navigeer naar C:\{Program Files}*\SECommon waarna u het volgende commando uitvoert: “>RegisterLangFiles”. 6) Handmatig terugplaatsen van de eerder veilig gestelde CITO 6.2.0.4 databases. a. Terugplaatsen van de databases: i. Kopieer de eerder veilig gestelde kopieën van de CITO 6.2.0.4 acelies.dll en wrkstatic.dll databasen naar map C:\{Program Files}*\SECommon en overschrijf de aanwezige .dll bestanden. ii. Als u om een of andere reden een schone installatie van CITO 6.2.0.4 nodig heeft zijn 2 lege database bestanden beschikbaar in de map CITO 6.2.0.4 Files\Empty Database Files. Als u deze kopieert naar C:\{Program Files}*\SECommon en de daar aanwezige bestanden overschrijft heeft u een schone CITO 6.2 installatie. Let op. U bent wel de historie van de uitgevoerde kalibraties kwijt, dit leid tot sancties bij een controle door de RDW.
7) Start CITO 6.2.0.4, log in met de altijd gebruikte gebruikersna(a)m(en) en bijbehorende wachtwoord(en) en controleer of alles juist functioneerd voordat het systeem gebruikt gaatt worden voor wettelijke kalibraties.
Console “Force” Mode Installatie In gevallen waarbij de standaard installatie via de patch installer niet naar behoren werken of een snellere geautomatiseerde upgrade naar CITO 6.4 wenselijk is dan kan de patch installer uitgevoerd worden vanaf de opdrachtprompt in console “force” mode. De te maken stappen om de installer in console “force “ mode uit te voeren zijn: 1) Open een administrator opdrachtprompt2. 2) Gebruik het cd {dir} commando om naar de directory te gaan waar de CITOPatchInstallerV6_4.exe uitgepakt is, b.v. “cd C:\Users\Test\Desktop”. Hint: Dubbelklik op de CITOV6_4_InstallationFiles map op het bureaublad zodat deze in Windows explorer geopend wordt. U kunt dan het path van de adresbalk kopiëren. 3) Voer de patch installer in console “force” mode uit met de volgende opdracht: C:\Users\Test\Desktop>CITOPatchInstallerV6_4 –f De patch installer zal in een eigen venster geopend worden.. De patch installer slaat de versiecheck over en zal direct naar stap 2 aanvangen, het vervangen van de bestanden voor de CITO 6.4 versies. Vervolgens zal stap 3, het updaten van de database, aansluitend uitgevoerd worden. Als de CITO 6.4 bestanden succesvol vervangen zijn zal 5 maal de melding “1 file(s) verplaatst.” Verschijnen. 1 voor elk correct geplaatst bestand. Verschijnt dit niet lees dan verder in het hoofdstuk troubleshooting voor verdere ondersteuning. De regsvr32 opdracht om de CITO 6.2.0.4 dlls uit het register te verwijderen waarna de nieuwe CITO 6.4 dlls geregistreerd worden geven geen melding over een geslaagde of mislukte upgrade. De enige manier om te controleren of de upgrade succesvol was is door CITO op te starten, lukt dit niet dan is de upgrade niet geslaagd. Lees dan verder in het hoofdstuk troubleshooting voor verdere ondersteuning..
Afb. 7 : Console "Force" Mode Installatie
2
Hoe open ik een opdrachtprompt (CMD): https://technet.microsoft.com/nl-nl/library/cc778084(v=WS.10).aspx
Troubleshooting console “Force” Installatie Foutmelding : De melding “Het systeem kan de bestanden niet vinden” verschijnt na de Windows shell “move” command. Ook kunt u meldingen krijgen dat bestanden die vervangen moeten worden niet overschreven kunnen worden omdat deze in gebruik zijn. Oorzaak is vaak dat CITO actief is. Consequentie: Als een bepaald bestand niet vervangen kan worden in Console “Force” mode zal de installer verder gaan zonder dit bestand te vervangen zonder dat alle benodigde bestanden vervangen zijn. Aanbevolen aktie(s): 1) Controleer handmatig of de juiste bestandsversies in {Program Files}\CITO en {Program Files}\SECommon geplaatst zijn 2) Als een of meerdere bestanden niet de juiste versie hebben vervang deze dan door de versie 6.2.0.4 dll bestanden die voor aanvang veilig gesteld zijn. (backup) In dit geval verwijdert u de Patch installer en ondersteunende bestanden van het bureaublad, Pak de bestanden opnieuw uit door dubbel te klikken op CITO6_4_PatchInstallerPack_1.0.0.8.exe 7Zip. Voer de Patch installer opnieuw uit in Console “Force” Mode.
Afb. 8 : Stap 2 Console "Force" Installatiefout: Ontbreken van bestanden
