pro uživatele programu pro pořizování fotodokumentace na STK CIS-Technik Server verze 1.9 pro Windows

NÁVOD K OBSLUZE pro uživatele programu pro pořizování fotodokumentace na STK CIS-Technik Server verze 1.9 pro Windows http://cis-technik.wz.cz E-mail: info@cis-technik.wz.cz

HISTORIE DOKUMENTU... 3 1 POPIS A INSTALACE APLIKACE CIS-TECHNIK... 4 1.1 POPIS PRODUKTU... 4 1.1.1 CIS-Technik Server... 4 1.1.2 CIS-Technik... 4 1.2 HARDWAROVÉ POŽADAVKY... 4 1.3 INSTALACE PRODUKTU... 4 1.3.1 Přístupová oprávnění... 4 1.3.2 Odinstalování uživatelské aplikace... 5 1.3.3 Instalace systémové služby... 5 1.3.4 Instalace za provozu... 6 2 NASTAVENÍ SERVERU... 7 2.1 OBSAH SLOŽKY... 7 2.2 NASTAVENÍ FIREWALL... 8 2.2.1 Průvodce nastavením brány Firewall... 8 2.3 NASTAVENÍ PŘES WEBOVÝ PROHLÍŽEČ... 11 2.4 LOGOVACÍ SOUBOR... 12 3 WEBOVÝ SERVER... 13 3.1 ROZPRACOVANÉ PROHLÍDKY... 13 3.1.1 Náhled rozpracované prohlídky... 13 3.2 DOKONČENÉ PROHLÍDKY... 14 4 KOMUNIKAČNÍ PROTOKOLY... 15 4.1 FUNKCE SERVERU... 15 5 SERVEROVÁ SLUŽBA... 16 5.1 AKTUALIZACE... 16 5.2 STAV PROVOZU... 16 5.3 OVLÁDÁNÍ SLUŽBY DÁVKOVÝM SOUBOREM... 17 5.4 NÁVRAT K PŘEDCHOZÍ VERZI... 17 2

HISTORIE DOKUMENTU Datum Verze Popis Autor 27.8.2016 1.0 Vytvoření dokumentu Ing. Luděk Florian 28.8.2016 1.1 Aktualizace bodu 5.1, přidány body 5.2, 5.3, 5.4 Ing. Luděk Florian 3

1 POPIS A INSTALACE APLIKACE CIS-TECHNIK 1.1 POPIS PRODUKTU Softwarový produkt CIS-Technik je určen pro pořizování fotodokumentace, prokazující přítomnost vozidla na stanici technické kontroly. Povinnost pořizování fotodokumentace dokumentující přítomnosti vozidla při technické prohlídce na lince je popsáno ve VD 1/2015 (ke stažení zde: http://www.mdcr.cz/nr/rdonlyres/326e2300-08b3-485a-bc21- E31E5FC5FD9E/0/Instrukcec11_2015.pdf). Od 1. října 2016 dochází k částečným úpravám při pořizování fotodokumentace přítomnosti vozidla na lince STK. Popis změn je uveden v Instrukci pro STK č.4/2016 (ke stažení zde: http://www.mdcr.cz/nr/rdonlyres/f135292f-c400-4be4-ad6a-84d11aaf45ff/0/prilohac1.doc). Popisovaná aplikace se skládá ze dvou samostatných spolupracujících částí. Aktuální informace o produktu můžete získat na adrese http://www.cis-technik.wz.cz. 1.1.1 CIS-Technik Server je služba systému Windows, která zajišťuje komunikaci a příjem pořízených fotografií z mobilního zařízení, jejich umístění do datové složky pro dlouhodobou archivaci, zmenšení fotografií na požadovanou velikost a umístění do složky pro pozdější odeslání do CIS-STK. Dále zprostředkovává komunikaci s APL Terminálem při zahájení a ukončení technické prohlídky. Služba CIS-Technik Server zároveň slouží jako webový server pro náhled pořízených fotografií během provádění technické prohlídky a náhled na archivovaná data. Návod k obsluze pro instalaci a provoz serverové části je samostatný dokument a je vždy v aktuální verzi ke stažení na webových stránkách http://cis-technik.wz.cz/download/navod_server.pdf. 1.1.2 CIS-Technik je aplikace určená pro mobilní zařízení s operačním systémem Android, zajišťující čtení čárových kódů technika a Záznamníků vozidel, zahájení a ukončení technické prohlídky a pořízení fotografií kontrolovaného vozidla nebo vozidel jízdní soupravy. V případě provádění technické prohlídky mobilním způsobem (traktory) zajišťuje pořízení fotografií a jejich uložení v mobilním zařízení do doby jejich odeslání na server při tvorbě ručního protokolu. Návod k obsluze pro instalaci a provoz aplikace je samostatný dokument a je vždy v aktuální verzi ke stažení na webových stránkách http://cis-technik.wz.cz/download/navod_android.pdf. 1.2 HARDWAROVÉ POŽADAVKY Aplikace CIS-Technik Server je aplikace typu systémová služba, určená pro počítače a servery s operačními systémy MS Windows 7, MS Windows 8, MS Windows 8.1, MS Windows 10, MS Windows Server 2012. Na ostatních systémem MS Windows nebyla aplikace odzkoušena. Hardwarové požadavky nejsou specifikovány. Systémová služba CIS- Technik Server musí být spuštěna na stejném fyzickém stroji, jako APL Terminál pro komunikaci s CIS-STK. Vyhovuje-li tedy počítač pro aplikaci APL Terminál, vyhovuje i pro běh systémové služby CIS-Technik Server. 1.3 INSTALACE PRODUKTU Výměna systémové služby za aplikační server trvá zhruba 10 sekund a je ji možné provést při splnění drobné podmínky za plného provozu na lince STK (bod 1.3.4). 1.3.1 Přístupová oprávnění Pro instalaci systémové služby musíte být přihlášeni s administrátorskými právy. Instalační soubor stahujte z webových stránek následujícím odkazem: http://cis-technik.wz.cz/download/cistechnikservicesetup.zip. Rozbalte ZIP soubor a spusťte instalační soubor CISTechnikServiceSetup.exe. 4

1.3.2 Odinstalování uživatelské aplikace Stiskněte symbol pro zastavení v okně aplikace. Po zastavení serverové aplikace klikněte na tlačítko zavření aplikace v pravém horním rohu. Po dotazu na zavření aplikace souhlaste a aplikaci zavřete. 1.3.3 Instalace systémové služby Instalace systémové služby je velice jednoduchá. Instalujte službu do stejné složky, kde byla instalována serverová aplikace. Složka je přednastavena, tak pouze v případě, že server byl instalován do jiné složky, upravte cílové umístění. Po dokončení instalace je nabízena instalace a spuštění systémové služby. V této chvíli serverová aplikace musí být vypnuta (bod 1.3.2). Stiskem tlačítka dokončit se provede instalace a spuštění služby. Po zobrazení zprávy o spuštění služby je instalace dokončena. 5

1.3.4 Instalace za provozu S výměnou serverové aplikace za systémovou službu není třeba čekat na konec pracovní doby. Stačí k tomu dodržet následující postup: - Spusťte instalaci (bod 1.3.3) a pokračujte do okamžiku, kdy je nabízena instalace a spuštění služby. - Zajistěte, aby technici v případě rozpracované prohlídky přestali pořizovat fotografie. - Vypněte serverovou aplikaci (bod 1.3.2). - Pokračujte v instalaci a spuštění služby tlačítkem Dokončit. - Po spuštění systémové služby mohou technici pokračovat v pořizování fotografií. 6

2 NASTAVENÍ SERVERU Je-li služba (dále jen server) instalována do složky, kde byla původní serverová aplikace, není třeba nic nastavovat. Služba si načte původní nastavení. 2.1 OBSAH SLOŽKY Ve složce, kam byla systémová služba nainstalována, se nacházejí následující soubory: - Log složka, kde jsou uchovány logovací soubory průběhu komunikace s CIS-STK a průběh přenosu fotografií z mobilního zařízení - App.Config původní textový soubor s uložením konfigurace serverové aplikace. Systémová služba jej nepoužívá, ale po prvním spuštění z něj načítá původní nastavení - CIS-Technik Service.log logovací soubor, zaznamenávající spuštění a zastavení systémové služby, nastavení konfigurace, spuštění webového serveru, komunikace s mobilními zařízeními při hledání serveru a kontrola nové verze systémové služby včetně její případné aktualizace - CIS-Technik Setup.xml konfigurační soubor, využívaný systémovou službou pro uložení konfigurace - CISTechnikServer.exe původní serverová aplikace. Nyní nevyužita, po ověření funkčnosti služby ji lze odstranit - CISTechnikServerLib.dll knihovna systémové služby pro komunikaci a provoz webového serveru - CISTechnikServerService.exe spouštěcí soubor systémové služby, která následně spouští knihovnu pro komunikaci a webový server - Install.bat dávkový soubor pro instalaci a spuštění systémové služby - Service.bat dávkový soubor pro instalaci, spuštění, zastavení a odinstalování systémové služby. - Unins000.dat instalační informace pro případné odinstalování produktu - Unins000.exe aplikace pro odinstalování produktu 7

2.2 NASTAVENÍ FIREWALL Následující popis nastavení je určen pro případ nové instalace. Pokud provádíte pouze aktualizaci ze serverové aplikace na systémovou službu, tato část se vás netýká. Průchod branou Firewall již máte nastaven. Pro zajištění komunikace mezi serverem a mobilním zařízením je nutné povolit porty pro průchod bránou Firewall, aby nebyla blokována komunikace mezi mobilním zařízením a serverem. Jedná se o následující porty: - 7777 - port slouží k hledání serveru ze strany mobilního zařízení (viz návod k obsluze CIS-Technik pro Android, bod 2.3.3.2) - 8080 - port, na kterém komunikuje mobilní zařízení se serverem pro zahájení/ukončení prohlídky a kde dochází k odesílání fotografií z mobilních zařízení. Port zároveň slouží i pro funkci webového serveru - 9000 - port, na kterém komunikuje APL Terminál pro zahájení/ukončení prohlídky se systémem CIS-STK Port, který lze uživatelsky měnit je komunikační port 8080, kdy může být nastavena jiná hodnota. V tom případě je nutné také nastavit průchod branou Firewall právě pro tento port. Pro komunikaci se používají komunikační protokoly TCP a UDP. 2.2.1 Průvodce nastavením brány Firewall Následující obrázky jsou ze systému MS Windows 7. Jiné verze operačního systému mohou být mírně odlišné. 1. Vyberte Start->Ovládací panely. Vyberte Brána Windows Firewall. 2. Vyberte Upřesnit nastavení. Pro tuto volbu potřebujete administrátorská práva přístupu. 8

3. Vyberte Příchozí pravidla a poté klikněte na Nové pravidlo. 4. Vyberte Port, poté klikněte na tlačítko Další. 5. Vyberte protokol TCP, zadejte čísla portů 7777, 8080, 9000 a pokračujte stiskem tlačítka Další. 9

6. Vyberte Povolit připojení a poté stiskněte Další. 7. Vyberte vhodný profil, nebo nechte všechny volby zaškrtnuty a pokračujte stiskem tlačítka Další. 8. Zadejte název pravidla a dokončete stiskem tlačítka Další. 9. Nyní opakujte postup od kroku 3, jen v kroku 5 vyberte protokol UDP. Zbytek zadejte stejně. 10

2.3 NASTAVENÍ PŘES WEBOVÝ PROHLÍŽEČ Otevřete webový prohlížeč a zadejte adresu serveru, doplněnou o komunikační port. Otevíráte-li prohlížeč na serveru, můžete zadat místo adresy localhost, což je odkázání serveru na svoji adresu, např. http://localhost:8080 Vyberte volbu Nastavení v pravém rohu obrazovky. Zadávací pole obsahují následující hodnoty pro nastavení: - Archiv foto - hlavní složka pro ukládání archivních fotografií. V průběhu činnosti se v této složce vytváří dynamicky další podsložky, reprezentující rok a měsíc. V každém měsíci jsou uloženy složky s číslem protokolu. V těchto složkách jsou uloženy archivní fotografie. 11

- Offline foto - složka, kam se ukládají složky s číslem protokolu a fotografiemi pro použití při tvorbě ručního protokolu. Do složky se ukládají miniatury fotografií v případě používání aplikace v režimu technických prohlídek, prováděných mobilním způsobem (traktory) nebo v případě, kdy není funkční systém CIS-STK a je nutno dokončit technickou prohlídku na lince v off-line režimu. - WebServer port - komunikační port pro vzájemnou komunikaci mezi mobilním zařízením a serverem pro odesílání pořízených fotografií a pro zahájení/ukončení prohlídky na lince. Pokud je potřeba použít jiný komunikační port, je nutné také jiný port nastavit v bráně Firewall (bod 2.2.1). - Broadcast port - port, na kterém odesílá mobilní zařízení zprávu při hledání serveru v síti. - Heslo pro uložení - protože by mohl kdokoli měnit nastavení pomocí webového rozhraní, je v současné době nastavení chráněno heslem. Heslo obdrží každý správce IT na vyžádání (není součástí dokumentace). V případě změny nastavení ať už složek pro ukládání fotografií nebo komunikačních portů, stiskem tlačítka OK dojde k uložení nového nastavení a je okamžitě resetován server pro spuštění s novými hodnotami. Změnu nastavení provádějte vždy v době, kdy jsou ukončeny technické prohlídky! 2.4 LOGOVACÍ SOUBOR V záložce Nastavení je v pravé části volba zobrazení logu serveru. Po kliknutí na tuto volbu je zobrazen průběh činnosti služby Server. V logu lze zjistit stav instalace, načtené hodnoty a spuštění komunikačních služeb. 12

3 WEBOVÝ SERVER Systémová služba CIS-Technik Server slouží zároveň jako webový server pro prohlížení rozpracovaných a dokončených prohlídek. 3.1 ROZPRACOVANÉ PROHLÍDKY Pod hlavičkou webového serveru je nabídka Rozpracované prohlídky. Vyberte kliknutím uvedenou nabídku. Zobrazí se seznam právě rozpracovaných prohlídek. Vybere prohlídku, kterou chce sledovat kliknutím na číslo protokolu. 3.1.1 Náhled rozpracované prohlídky Po výběru kliknutím na číslo protokolu se zobrazí náhled rozpracované prohlídky. Stránka se pravidelně aktualizuje, takže lze sledovat průběh přenosu fotografií z mobilního zařízení na server. 13

Webová stránka obsahuje v záhlaví informaci o kontrolovaném vozidle, jméno technika, který prohlídku provádí, a čas zahájení technické prohlídky. Log přenosu fotografií zobrazuje průběh (v příkladu jsou fiktivní údaje) přijetí fotografie z mobilního zařízení, jeho originální velikost, místo uložení miniatury pro odeslání do systému CIS-STK a cílovou velikost souboru a kvalitu. Spodní část webové stránky zobrazuje jednotlivé fotografie a to jak v originálním provedení, tak vytvořené miniatury pro odeslání do CIS-STK. Kliknutím na příslušnou fotografii lze zobrazit plnou velikost. 3.2 DOKONČENÉ PROHLÍDKY Pod hlavičkou webového serveru je nabídka Dokončené prohlídky. Vyberte kliknutím uvedenou nabídku. Zadejte měsíc a rok, za který se má zobrazit seznam dokončených prohlídek. Stiskem tlačítka Hledej se zobrazí seznam dokončených prohlídek. Po výběru měsíce a roku se zobrazí seznam dokončených prohlídek. Zobrazení technické prohlídky provedete kliknutím na číslo vybraného protokolu. Náhled dokončené prohlídky je obdobný jako u rozpracované prohlídky (bod 3.1.1), jen nejsou zobrazeny miniatury fotografií, které již po odeslání do CIS-STK nejsou k dispozici. 14

4 KOMUNIKAČNÍ PROTOKOLY Server pro komunikaci používá metody POST a GET v závislosti na požadovaném výsledku. Volání serveru se provádí pomocí adresy, portu a funkce, oddělené lomítkem s příslušnými parametry. Například funkce pro zjištění verze serveru je /getversion. Pro zobrazení výsledku zadejte do webového prohlížeče na serveru: http://localhost:8080/getversion Odpovědí je zobrazení verze serverové služby. 4.1 FUNKCE SERVERU Funkce serveru Metoda Popis funkce /photo POST Odesílání foto z mobilního zařízení na server /delphoto POST Příkaz ke smazání fotografie v datovém úložišti /statusphoto GET Dotaz na stav doručení fotografií z mobilního zařízení na server /setoffline GET Přesun sady fotografií do offline složky (při výpadku CIS-STK v průběhu prohlídky) /serverstatus GET Dotaz na dostupnost serveru a připravenosti ke komunikaci /restart GET Příkaz k restartu systémové služby serveru /log Příkaz k zobrazení logu činnosti serveru /nastaveni GET Zobrazení nastavení serveru s možností konfigurace /uloznastaveni POST Příkaz k uložení nastavení serveru /aktivniprohlidky GET Zobrazení seznamu rozpracovaných prohlídek /prohlídka GET Zobrazení vybrané rozpracované prohlídky /ukazfoto GET Zobrazí seznam fotografií vybraného protokolu /detailfoto GET Zobrazí v plné velikosti miniaturu nebo originální fotografii vybraného protokolu /dokonceneprohlidky GET Zobrazí seznam dokončených prohlídek za vybrané období /getversion GET Zobrazí verzi systémové služby serveru /getversionandroid GET Zobrazí číslo verze, které odesílá jako odpověď do mobilního zařízení /StartJob POST Zahájení technické prohlídky /CloseJob POST Ukončení technické prohlídky /stornoprohlidky POST Stornování prohlídky = výmaz fotografií v datovém úložišti včetně miniatur pro CIS /cisdostupny GET Vrací stav dostupnosti systému CIS-STK /protokoltraktor GET Vrací vhodné číslo protokolu prohlídky traktoru (číslo ručního protokolu) /protokolvolny POST Vrací zpět odpověď, zda je zadané číslo ručního protokolu volné pro použití foto 15

5 SERVEROVÁ SLUŽBA 5.1 AKTUALIZACE Kontrola dostupnosti aktualizace serverové služby je prováděna denně v rozmezí od 00 hod do 01 hod. V případě dostupnosti nové verze je tato verze stažena a nainstalována. Jedná se tedy o bezobslužný režim provozu systémové služby. Číslo aktuální verze je viditelné přes webový prohlížeč na úvodní obrazovce v levém horním rohu. 5.2 STAV PROVOZU Nejde-li zobrazit webová stránka služby a nejde-li se přihlásit nebo odhlásit z technické prohlídky, mohlo dojít ze strany operačního systému Windows k příkazu zastavení služby. Pak je nutné pátrat po příčinách zastavení služby. Službu lze také spustit/zastavit ručně. K tomu slouží dávkový soubor Service.bat, zmíněný v bodě 2.1. Dávkový soubor je nutné spustit s administrátorskými právy. Klikněte pravým tlačítkem na soubor a vyberte položku Spustit jako správce. Zobrazí se stav služby. V místě orámovaného okna musí být informace o běžící službě (4 RUNNING). Pokud je v uvedeném místě uvedena hodnota STOPPED, je služba z nějakého důvodu zastavena. Opětovné spuštění služby provedete stiskem klávesy 3 a Enter. 16

5.3 OVLÁDÁNÍ SLUŽBY DÁVKOVÝM SOUBOREM Službu CIS-Technik Server lze ovládat dávkovým souborem Service.bat (bod 2.1), je-li tento soubor spuštěn s administrátorskými právy (bod 5.2). Nabízené možnosti dávkového souboru jsou tyto: - 1) Install + start - provede nainstalování služby a její následné spuštění - 2) Install - provede instalaci služby. Spuštění serverové služby se provede volbou 3) - 3) Start - spuštění serverové služby - 4) Stop - zastavení běhu serverové služby - 5) UnInstall - provede odinstalování serverové služby. Před odinstalováním musí být zastavena 4) - 6) Stop + UnInstall - zastavení služby a její následné odinstalování ze systému - 7) Exit - ukončení práce s dávkovým souborem 5.4 NÁVRAT K PŘEDCHOZÍ VERZI Nepředpokládá se, že by bylo nutné se vracet zpět k předchozí verzi serverové služby. Nicméně pokud jsou k tomu závažné důvody, může i tato situace nastat. Při aktualizaci na novou verzi se předchozí verze systémové knihovny ukládá právě pro tuto nepředvídatelnou potřebu. Jak se vrátit k předchozí verzi serverové služby: - Spusťte dávkový soubor Service.bat s administrátorským přístupem (bod 5.2) - Zastavte běh služby (bod 5.3, volba 4-Stop) - Ve složce, kde je instalována služba, smažte soubor CISTechnikServerLib.dll 17

- Klikněte pravým tlačítkem na soubor CISTechnikServerLib.bak a přejmenujte jej na CISTechnikServerLib.dll - Spusťte běh služby (bod 5.3, volba 3-Start) - Po otevření webového prohlížeče je v záhlaví uvedena předchozí verze serverové služby. 18

P o z n á m k y 19