Dokumentace IP serveru © 2013 HaSaM s.r.o.
Contents
3
Table of Contents Foreword
Part I Úvod
0
5
1 Informace ................................................................................................................................... o autorských právech 5 2 Architektura ................................................................................................................................... IP serveru 6 3 Historie ................................................................................................................................... verzí 6
Part II Instalace a nastavení programu
6
1 Požadavky ................................................................................................................................... na systém 7 2 Instalace ................................................................................................................................... programu 7 3 Nastavení ................................................................................................................................... programu 10 4 Odinstalování ................................................................................................................................... programu 10 5 Aktualizace ................................................................................................................................... programu - reinstalace 11 6 Licence ................................................................................................................................... 11
Part III Spuštění programu a konfigurace 12 1 Spuštění ................................................................................................................................... aplikace IP agent 12 2 Konfigurace ................................................................................................................................... 13 Vstupní linky ......................................................................................................................................................... 14 Vysílače ......................................................................................................................................................... 15 Výstupní linky ......................................................................................................................................................... 17 Sm ěrování......................................................................................................................................................... 19 Archivace ......................................................................................................................................................... 19 Obecná nastavení ......................................................................................................................................................... 21
3 Spuštění ................................................................................................................................... a zastavení služby _IPservice 22 4 Zálohování ................................................................................................................................... konfigurace 23
Part IV Práce s aplikací
23
1 Přehled ................................................................................................................................... vysílačů 23 2 Okno ................................................................................................................................... vstupních a výstupních linek 25 3 Informace ................................................................................................................................... o licenci a verzi 27 4 Testovací ................................................................................................................................... nástroje (simulátory vysílačů) 27 5 Řešení ................................................................................................................................... problémů - troubleshooting 29 6 Kolik ................................................................................................................................... vysílačů lze připojit k IP serveru 30
Part V DeviceConfig
31
1 Popis ................................................................................................................................... programu a parametrů 31 2 Konfigurace ................................................................................................................................... přes sériový port 35 3 Konfigurace ................................................................................................................................... přes IP server 37
© 2013 HaSaM s.r.o.
4
Dokumentace IP serveru Rozšířený......................................................................................................................................................... m ód 41
4 Otázky ................................................................................................................................... a odpovědi 43
44
Part VI Phone Switcher Index
0
© 2013 HaSaM s.r.o.
Úvod
1
5
Úvod IP server verze 3.x.y je nová verze programu IP server vybudovaná na platformě .NET framework. V tomto dokumentu je popsána správa programu, jeho instalace, odinstalace, aktualizace a související témata. Dále jsou zde popsány jeho jednotlivé funkční celky a jejich obsluha. IP Server je softwarový přijímač zpráv od komunikátorů zabezpečovacích systémů. Přijímá zprávy z objektových zařízení ve formátech 4+2, CID a SIA a monitoruje spojení s jednotlivými objektovými zařízeními. Přijaté zprávy, informace o výpadku spojení, jeho obnově a další předává do systémů centralizované ochrany objektů. IP Server využívá TCP a IP protokoly transportní a síťové vrstvy a primárně podporuje komunikátory vyvinuté a dodávané firmou HaSam s.r.o. založené na přenosových technologiích GSM (SMS, GPRS) a ethernet (LAN, WAN, internet). Uživateli programu jsou technici zajišťujícím připojení a provoz objektových zařízení a operátoři pultů centralizované ochrany. Kontakt na výrobce: Web www.hasam.cz E-mail
[email protected] Telefon +420 577 101 261 Adresa HaSam s.r.o., Tečovice 45, 763 02 Zlín 4
1.1
Informace o autorských právech Copyright © HaSaM, spol. s r.o. 2007- 2009 Produkt IP server a dokumentace k tomuto produktu jsou chráněny autorským zákonem. Žádná část programového vybavení ani dokumentace nesmí být pozměňována, rozmnožována, ukládána v elektronické podobě ani jiným veřejným způsobem šířena bez předchozího výslovného svolení firmy HaSaM. spol. s r.o.. Toto omezení se také vztahuje na neautorizované překlady do jiných jazyků. Informace v této příručce jsou považovány za správné v okamžiku jejich publikace. Nicméně HaSaM, spol. s r.o. neposkytuje žádnou záruku za správnost těchto informací a vyhrazuje si právo změnit tento dokument bez upozornění. Firma HaSaM, spol. s r.o. není odpovědna za jakoukoliv ztrátu dat, poškození databází, nebo jiné ztráty, související s používáním této příručky. V případě jakýchkoliv nejasností se informujte přímo u firmy HaSaM na v úvodu uvedených adresách. K vysvětlení detailů a podpoře zákazníků při provozování IP serveru slouží skupina technické podpory firmy HaSaM. Některé informace z dokumentace Vám mohou být zřejmé až po absolvování podrobného uživatelského školení. Přejeme Vám mnoho úspěchů při využívání služeb produktu IP server.
© 2013 HaSaM s.r.o.
6
1.2
Dokumentace IP serveru
Architektura IP serveru IP Server se skládá ze dvou komponent, uvedených v tabulce
1.3
Komponenta
Funkce
_IPService
Služba, která vystavuje a řídí vstupní a výstupní kanály. Nemá GUI, běží na pozadí a plní všechny komunikační funkce přijímače PCO. Umožňuje také spuštění v ladícím režimu s výstupem informací do konzoly. Po provedení instalace programu je služba spouštěna automaticky vždy po startu PC.
IP Agent
Uživatelské rozhraní (klient) ke službě _IPService. Aplikace umožňuje konfiguraci, diagnostiku a ovládání jednotlivých objektových zařízení a to jak lokálně, tak vzdáleně. Rovněž umožňuje lokální spouštění služby _IPService.
Historie verzí Datum
Popis změn
06.09.2007 Úvodní verze dokumentace pro IP server 3.0.3.1 12.09.2007 Úprava na verzi IP serveru 3.0.4.0 30.04.2008 Úprava na verzi IP serveru 3.0.6.0 09.09.2008 Úprava na verzi IP serveru 3.1.0.0 31.10.2008 Verze 3.1.0.1 – změna v nastavení Galaxy vysílačů 6.2.2009 Aktualizace pro verzi 3.1.0.5 10.3.2009 Aktualizace pro verzi 3.1.1.0 11.4.2009 Aktualizace pro verzi 3.1.2.0, popis DeviceConfigu 16.6.2009 Verze 3.1.2.1, rozšířený mód DeviceConfigu 15.2.2010 Verze 3.2.0.0, ovladač GalaxyPlus s aktivní kontrolou vysílačů 3.1.2011 Verze 3.5.0.0, kompletně přepracované jádro 13.1.2012 Verze 3.5.0.1, přidán Phone Switcher, úpravy v podpoře Galaxy 12.11.2012 Verze 3.5.0.7, podpora K2 vysílačů, Ethernet výstup
2
Instalace a nastavení programu V této kapitole jsou popsány požadavky na instalaci IP serveru, postup při instalaci, odinstalaci a aktualizaci a informace o nastavení a licencování programu.
© 2013 HaSaM s.r.o.
Instalace a nastavení programu
2.1
7
Požadavky na systém Program IP server lze provozovat v prostředí Windows s nainstalovaným .NET frameworkem 3.5. Tím je dán výčet operačních systémů, na kterých lze program provozovat (jsou podporovány 32 i 64bitové verze operačních systémů): Windows XP SP2 a vyšší Windows Server 2003 SP1 a vyšší Windows Vista Windows Server 2008 / Windows Server 2008 R2 Windows 7 Na Windows 2000 a starších nelze .NET framework 3.5 a tedy ani IP server nainstalovat. Doporučuje se před instalací programu aplikovat všechny aktuálně dostupné hotfixy a service packy pro váš operační systém. Novější verze Windows již mají .NET framework integrovaný v sobě, není jej nutné instalovat, pouze aktivovat: Windows 7 - spusťte Control Panel -> Programs and Features -> Turn Windows features on or off, zatrhněte komponentu Microsoft .NET Framework 3.5.1 Windows Server 2008 - spusťte Server Manager -> Features a přidejte komponentu .NET Framework 3.5.1 (viz obrázek níže)
2.2
Instalace programu Instalace programu je snadná a přímočará. Instalační balíček se skládá ze souborů Setup.exe a Setup.msi. Instalaci spouštějte vždy pomocí Setup.exe – instalátor zkontroluje, zda již máte nainstalovaný .NET framework 3.5 a pokud tomu tak není, bude tato komponenta stažena z webu nainstalována. To může vyžadovat restart počítače - v takovém případě restartujte a spusťte instalátor znova. Pokud spustíte Setup.msi, kontrola se neprovádí a instalace nemusí proběhnout správně. Pokud nemáte k dispozici internetové připojení, lze .NET framework nainstalovat ručně z adresáře NETFX35. Během instalace MUSÍTE být přihlášeni pod ADMINISTRÁTORSKÝM účtem !!
© 2013 HaSaM s.r.o.
8
Dokumentace IP serveru
Po zahájení instalace postupně následují jednotlivé dialogy oddělující dílčí kroky: Uvítací dialog instalace – pokračujte tlačítkem Další
Výběr komponent – při instalaci serveru ponechte zatržen IP server, klientská aplikace (IP agent) se nainstaluje vždy. Pokud chcete administrovat IP server i z jiného počítače, spusťte na něm instalaci a položku IP server nechte nezatrženou. Pokračujte tlačítkem Další
Nastavení instalační složky (doporučeno neměnit) – pokračujte tlačítkem Další
© 2013 HaSaM s.r.o.
Instalace a nastavení programu
9
Dialog informující, že samotná instalace může být zahájena – pokračujte tlačítkem Další
Indikace průběhu instalace
Informace o úspěšném dokončení instalace – ukončení tlačítkem Zavřít
Tím je instalace dokončena a IP server se automaticky spustí.
© 2013 HaSaM s.r.o.
10
2.3
Dokumentace IP serveru
Nastavení programu Po instalaci lze změnit obecná nastavení, která nelze editovat pomocí IP agenta. Tato nastavení jsou uložena v souboru IPservice.exe.config v instalačním adresáři, v sekci
: port pro vzdálenou správu (položka AdminPort). Výchozí hodnota je 8010, lze změnit na jiný volný port podle potřeby. heslo pro připojení IP agenta (položka Security, je kódováno). Po instalaci nastaveno na IPs3rv@r , doporučuje se změnit. Změnu provedete z command promptu, kde přejdete do instalačního adresáře IP serveru a zadáte příkaz IPservice /pwd nové-heslo. Změnu hesla lze provádět i za chodu bez nutnosti restartu. délka objektového kódu Galaxy vysílačů GalaxyObjectCodeLength. Galaxy vysílače vždy posílají objektový kód o délce 6 znaků, tímto parametrem ji lze při odesílání do PCO zkrátit (tedy pokud zde nastavíte 4, kód 004311 se pošle jako 4311). Pokud máte k IP serveru připojenu SMS linku, lze vzdáleně pomocí SMS ovládat zastřežení vysílače K2. K tomu slouží parametr AllowSmsControl, hodnota "true" ovládání povoluje, "false" zakazuje. Nastavení ConfirmCmd pak určuje text potvrzení příkazu, které se posílá zpět odesílateli SMS. AllowedPhones je seznam telefonních čísel, ze kterých jsou ovládací SMS akceptovány. Čísla se oddělují středníkem AllowedInactivity - čas v sekundách, po který je povolena neaktivita ze strany vysílače (kdy neposílá žádná data) po navázání připojení AllowedCmdAge - povolené stáří ovládací SMS ze systémů třetích stran v sekundách Změny vyžadují restart IP serveru.
Pokud chcete zachovat uvedená nastavení při aktualizaci, je nutné zálohovat a po aktualizaci obnovit soubor IPservice.exe.config
2.4
Odinstalování programu Před odinstalováním programu je možné nejprve zastavit službu _IPservice pomocí aplikace IP agent. Není to však nezbytně nutné. Při odinstalování programu postupujte standardně, jako při odinstalování libovolné jiné aplikace. Ve složce Ovládací Panely (Control Panel) zvolte položku Přidat/Ubrat programy (Add or Remove Programs). Ve Windows Vista a novějších se odinstalace nachází pod položkou Programy a
© 2013 HaSaM s.r.o.
Instalace a nastavení programu
11
funkce (Programs and Features). V nabídnutém seznamu aplikací vyberte položku IPserver a stiskněte volbu Odstranit (Remove).
2.5
Aktualizace programu - reinstalace Rozdíl mezi první instalací a aktualizací stávající instalace je pouze v tom, že stávající instalaci je potřeba nejprve odstranit. Pokud dodržíte dříve uvedený postup při odinstalování programu, zůstane na vašem PC původní adresář instalace obsahující konfigurační soubor config.xml, adresáře Arch, Backup, DeviceConfig a Queue a licenční soubor lic.txt. To znamená, že po následném provedení instalace aktuální verze (zachovává-li tato zpětnou kompatibilitu) již nemusíte program znovu nastavovat a můžete jej rovnou používat. POZOR - pokud aktualizujete z verze 3.2.0.0 a nižší, dojde k automatickému upgrade konfiguračního souboru config.xml na nový formát. Pokud byste se poté z jakéhokoliv důvodu chtěli vrátit k původní verzi IP serveru, musíte konfigurační soubor obnovit ze zálohy před aktualizací. Pokud chcete upgradovat z verze IP serveru nižší než 3.x.y, jsou potřeba dodatečné kroky. Kontaktujte dodavatele pro další informace.
2.6
Licence Licence pro používání software IP Server ve své podstatě fyzicky omezuje jeho používání tak, aby bylo vždy v souladu s autorskými právy. To znamená, že zamezuje používání programu neoprávněným subjektem nebo používání v neoprávněném rozsahu.
© 2013 HaSaM s.r.o.
12
Dokumentace IP serveru Informace o licenci k programu je zakódována v souboru lic.txt, který musí být nakopírován do kmenového adresáře nainstalovaného programu. Záměnou tohoto souboru lze licenční podmínky měnit. Užívání programu je obvykle omezeno dobou používání nebo je vázáno na jméno počítače na němž je program instalován. Dále může omezovat počet připojených objektových zařízení a jejich typ – bližší informace najdete v konkrétní nabídce produktu. Pokud licenční soubor zcela chybí, IP server se chová jako by měl časově neomezenou licenci na pět vysílačů typu K1. Změna licenčního souboru se vždy projeví po restartu služby _IPService, případně po uběhnutí druhé minuty hodiny následující po změně – program licenci znovunačítá v druhé minutě každé hodiny.
3
Spuštění programu a konfigurace Tato kapitola popisuje spuštění aplikace a konfiguraci vstupních a výstupních linek a vysílačů. Všechna zde popsaná nastavení se ukládají do souboru config.xml.
3.1
Spuštění aplikace IP agent Zástupce pro spuštění aplikace IP agent (dále jen konzola) je umístěn v nabídce Start / Programy / IP server tools / IP agent. Po prvním spuštění je třeba zvolit, ke kterému IP serveru se chcete připojit. Je nutno zadat jméno nebo IP adresu serveru a port (nesmí obsahovat nečíselné znaky, jinak program připojení nepovolí, dokud chybu neodstraníte). Standardně se nabízí připojení k lokálnímu počítači na portu 8010. Dále je nutno zadat heslo pro ověření klienta. Toto heslo je po instalaci nastaveno na IPs3rv@r
Heslo se musí zadávat vždy při spuštění klienta, pokud není zatrženo Zapamatovat heslo. Pokud je tato položka zatržena, heslo se uloží zakódovaně do registry a při příštím spuštění nebude vyžadováno. Uložené heslo lze smazat v Globálním nastavení (viz dále) a poté bude při připojování opět vyžadováno. UPOZORNĚNÍ: uložení hesla snižuje úroveň bezpečnosti!! Pokud neoprávněná osoba získá přístup k vašemu počítači, může zasahovat do konfigurace IP serveru. Pro spojení mezi službou _IPService a konzolou je standardně využíván TCP port 8010 (pokud jej administrátor nezměnil). Proto je nezbytné pro vzdálené připojení konzoly, aby tento port byl uveden ve výjimkách brány firewall, případně může být na firewallu použito přesměrování jiného portu na port
© 2013 HaSaM s.r.o.
Spuštění programu a konfigurace
13
8010 IP serveru. Pak je nutno při připojování zadat číslo tohoto přesměrovaného portu. Vzdálené připojení konzoly lze využít pro diagnostiku stavu IP serveru a jednotlivých objektů a modifikaci nastavení. Nelze však ovládat běh služby (start/stop). Pokud jste připojeni k jednomu serveru a chcete se připojit jinam, stiskněte tlačítko Připojit v panelu nástrojů a zobrazí se dialog pro připojení k jinému serveru.
3.2
Konfigurace Konfigurace je rozdělena na nastavení vstupních linek, vysílačů, výstupních linek, směrování, archivace a globální nastavení. Vše se skrývá pod tlačítkem Konfigurace. Veškeré změny se provádějí on-line, tj. není nutno IP server po změně konfigurace restartovat.
Popis hlavního okna programu: Panel nástrojů s grafickými tlačítky – spouští jednotlivé funkce IP agenta, jak je popsáno dále. Okno Vstupní linky – zde je seznam vstupů IP serveru, kde je vypsán vždy typ a port vstupu, stav a počet aktivně připojených vysílačů. U SMS linky se místo aktivních připojení zobrazuje stav registrace do GSM sítě (REG +/-/?, což značí zaregistrován /nezaregistrován /nelze zjistit) a síla signálu (SIG číslo/?, což značí kvalitu signálu - vyšší číslo je lepší kvalita /nelze zjistit). Okno Výstupní linky – zobrazuje seznam výstupů, kde je vypsán vždy typ a port výstupu, zda přijímá systémové zprávy, stav a délka fronty zpráv k odeslání. Status panel – vlevo je vypsán název serveru, kam je IP agent připojen; vpravo stav připojení (Připojen /Nepřipojen /Připojuji se); uprostřed stav licence nebo případné chybové hlášení.
© 2013 HaSaM s.r.o.
14
3.2.1
Dokumentace IP serveru
Vstupní linky Zde je zobrazen seznam vstupních linek, které IP server obsluhuje. Klikem na linku se její parametry zobrazí v editačních polích. Přidání linky: vyplňte parametry linky a stiskněte tlačítko Přidat Smazání linky: klikněte na linku v seznamu a stiskněte Smazat Změna parametrů: klikněte na linku v seznamu, změňte parametry a stiskněte Změnit Výsledek zvolené operace se vypíše v okénku u spodního okraje dialogu.
Parametry linek: ID
interní identifikátor, přiděluje jej IP server (informativní charakter)
Typ
definuje komunikační protokol resp. typ připojeného zařízení K1 - pro komunikátory K1-IPT/GPT, K1-IP/GP ECO, K2-GPT Galaxy a GalaxyPlus - pro ústředny Galaxy s modulem E080 Sms - pro SMS komunikátory
Číslo SGRD linky
číslo linky pro převod zpráv do SURGARD formátu. Povolený rozsah 1-15
Port
pro K1 a Galaxy číslo TCP portu, na kterém se přijímají zprávy od komunikátorů. Pro Sms označení sériového portu, kam je připojen GSM modem přijímající SMS. Nabízí se seznam portů dostupných na daném počítači
Odesílá SMS
pouze jedna SMS linka smí mít tuto volbu aktivní; označuje linku vyhrazenou pro odesílání příkazů vysílači. Je to proto, že vysílač akceptuje zprávy jen z definovaného telefonního čísla - pokud zvolíte nesprávnou linku, vysílač bude zprávy ignorovat
© 2013 HaSaM s.r.o.
Spuštění programu a konfigurace
15
GalaxyPlus je Galaxy linka rozšířená o testování dostupnosti vysílačů. Pokud má vysílač zadán IP adresu, každou minutu se na tuto adresu pošle Ping. V případě, že vysílač na Ping neodpovídá po dobu 3 minuty, je do PCO odeslána varovná zpráva. Jakmile vysílač na Ping začne odpovídat, je opět do PCO odeslána informační zpráva. Obě zprávy se posílají v SIA formátu a jsou konfigurovatelné. Tlačítkem Zavřít dialog ukončíte.
3.2.2
Vysílače Seznamy objektů jsou svázány s jednotlivými vstupními kanály. Identifikace jednotlivých vysílačů se provádí na základě jejich objektových kódů. Jejich délka je 4 znaky (kód se interpretuje jako hexadecimální, tj. lze použít znaky 0-9 a A-F) pro linky typu K1 a 6 znaků pro linky typu GALAXY. IP server předpokládá (a vynucuje), že objektové kódy vysílačů jsou jedinečné. Pokud se přijme zpráva z neznámého objektového kódu, je zahozena a spojení se uzavře – IP server nekomunikuje s neznámými vysílači, avšak zobrazuje je pro informaci v dialogu Aktivní vysílače. V seznamu Vstupní linky zvolte linku, na které chcete vysílače administrovat a zobrazí se seznam definovaných vysílačů. Šířku sloupců lze měnit a nastavení se pamatuje. Klikem na vysílač se jeho parametry zobrazí v editačních polích. Přidání vysílače: vyplňte parametry vysílače a stiskněte tlačítko Přidat Smazání vysílače: klikněte na vysílač v seznamu a stiskněte Smazat Změna parametrů: klikněte na vysílač v seznamu, změňte parametry a stiskněte Změnit Výsledek zvolené operace se vypíše v okénku u spodního okraje dialogu.
© 2013 HaSaM s.r.o.
16
Dokumentace IP serveru
Parametry vysílačů (povinné položky jsou označeny *): ID - interní identifikátor, přidělený IP serverem (jen pro informaci) Objektový kód * - slouží pro jednoznačnou identifikaci připojených vysílačů a následné vyhodnocení kontroly spojení s jednotlivými vysílači. Jméno vysílače * - stručný název připojeného vysílače (max. 50 znaků), zobrazuje se též v dialogu Aktivní vysílače Popis - nepovinný doplňující informativní údaj (max. 120 znaků). Sem lze zapsat jakékoliv informace vztahující se k vysílači. Perioda testu [min] - definuje v minutách maximální dobu klidu mezi dvěma po sobě jdoucími zprávami z vysílače (ať užitečnými nebo testovacími). Doporučené nastavení minimální hodnoty je perioda testovací zprávy vysílače + 2 minuty. V případě výskytu častější detekce rozpadu spojení s vysílačem lze zvětšením hodnoty odfiltrovat krátkodobé výpadky spojení. Dostupný rozsah nastavení je 1 - 60 minut pro vysílače K1, 60 - 1450 minut u Galaxy. Posílání testovacích zpráv u Galaxy vysílačů je nutno ručně zapnout, viz kapitola Řešení problémů – troubleshooting. IP adresa - nepovinný doplňující informativní údaj. Pokud není vyplněn, při příjmu zpráv se nekontroluje, z které IP adresy zpráva přišla. Pokud ji vyplníte, musí zprávy přicházet z této zadané adresy, jinak je spojení odmítnuto. IP adresa by měla být zadána na GalaxyPlus lince, protože se používá pro testování dostupnosti vysílače (pokud není zadána, test se neprovádí). Kód ‘výpadek spojení’ * – pokud uplyne perioda testu bez toho, že by od vysílače přišla jakákoliv zpráva, je hlášen do nadřízeného systému poplach – odešle se zpráva ve formátu 4+2, kde objektový kód se nastaví na objektový kód vysílače a zóna se nastaví na kód výpadku spojení. Vysílač se
© 2013 HaSaM s.r.o.
Spuštění programu a konfigurace
17
převede do stavu porucha. Kód ‘obnova spojení’ * – pokud je vysílač ve stavu porucha a přijde od něj zpráva, oznámí se to do nadřízeného systému zprávou 4+2, kde objektový kód se nastaví na objektový kód vysílače a zóna se nastaví na kód obnovy spojení. Vysílač se nastaví do bezporuchového stavu. Oba kódy se interpretují jako hexadecimální, tj. lze použít znaky 0-9 a A-F. Tyto dva kódy nejsou povinné pro vysílače na lince GalaxyPlus - ta ověřuje konektivitu jiným způsobem. Telefonní číslo – nepovinný doplňkový údaj. Zavřít spojení po příjmu – pokud je zatrženo, uzavře se po potvrzení zprávy vysílači spojení (tato volba není k dispozici u GALAXY vysílačů – po dobu příjmu jednotlivých částí zprávy se spojení nesmí přerušit). Toto nastavení je doporučeno v případech, že připojené komunikátory komunikují přes proxy server, nebo lze-li předpokládat, že spojení bude často ukončováno některými síťovými prvky. Pokud není zatrženo, zůstává kanál stále otevřen a je minimalizována komunikační odezva i objem přenášených dat v důsledku nižších přenosových režií při výstavbě a ukončování spojení. Toto je doporučené nastavení pro většinu připojení vysílačů, zejména u GPRS. Pouze pro vysílače typu K1 je zobrazen ještě Typ a verze vysílače - tento údaj se zjišťuje při navázání komunikace s vysílačem. Dokud informace o verzi není známá, je pole prázdné. U vysílačů K2-GPT se zobrazuje ještě IMEI modemu, platí totéž co pro verzi. Další parametry jsou určeny pro integraci do systémů třetích stran a jsou k dispozici jen pro vysílače K1/K2: Kód ’zastřeženo’, Kód ’odstřeženo’ - pokud jsou nastaveny, posílají se do PCO vždy při změně stavu zastřežení vysílače. Konfigurační soubor - vybírá konfiguraci ze seznamu dostupných konfigurací (XML soubory v adresáři TrConfigs), využívá se ve funkci bypasování vstupů. ATM Id - textový identifikátor vysílače v systémech třetích stran Nastavení specifická pro GalaxyPlus (pro jiný typ linky se nezobrazují): Kód 'ztráta dostupnosti' - pokud vysílač neodpovídá na Ping test po dobu 3 minut, odesílá se do PCO zpráva s kódem ztráty dostupnosti (zpravidla YC). V přehledu vysílačů se vysílač zobrazí jako porucha. Kód 'obnova dostupnosti' - jakmile vysílač opět začne odpovídat na ping test, odešle se do PCO zpráva s kódem obnovy dostupnosti (zpravidla YK). Obě zprávy jsou ve formátu SIA (Ntihh:mm/code, kde hh:mm je čas ztráty / obnovy dostupnosti, code je příslušný 2písmenný kód). Nelze definovat vysílače na SMS vstupní lince – SMS nepřenášejí objektový kód vysílače a nelze jej tedy ověřit. Tato linka tedy přijímá zprávy od libovolného SMS vysílače. Můžete definovat jen tolik vysílačů, kolik dovoluje licence. Počet vysílačů na vybrané lince se zobrazuje v titulkovém pruhu dialogu. Tlačítkem Zavřít dialog ukončíte.
3.2.3
Výstupní linky Zde je zobrazen seznam výstupních linek, na které IP server může posílat zprávy od vysílačů. Klikem na linku se její parametry zobrazí v editačních polích. Přidání linky: vyplňte parametry linky a stiskněte tlačítko Přidat Smazání linky: klikněte na linku v seznamu a stiskněte Smazat Změna parametrů: klikněte na linku v seznamu, změňte parametry a stiskněte Změnit Výsledek zvolené operace se vypíše v okénku u spodního okraje dialogu.
© 2013 HaSaM s.r.o.
18
Dokumentace IP serveru
Parametry linek: ID
interní identifikátor, přiděluje jej IP server (informativní charakter)
Typ
nastavení typu výstupního kanálu Sql - výstupní data jsou zapisována do databáze SW SIMS Sgrd - výstupní data jsou přenášena ve formátu SURGARD prostřednictvím sériového rozhraní RS232 (9600,8,1,n) Dummy - speciální výstup, který simuluje úspěšný zápis, ale výstupní data nikam nezapisuje (obdoba zařízení null). Slouží pouze pro testovací účely, nepoužívejte jej v reálném provozu. Ethernet - síťové rozhraní pro NAM na portu 1025. PCO NAM se nakonfiguruje, aby se připojovalo k IP serveru
Port
lze nastavit jen pro SGRD výstup, udává sériový port, na který se data odesílají. Nabízí se seznam portů dostupných na daném počítači
Přijímat systémové zprávy
pokud je zatrženo, budou se na uvedený výstup posílat zprávy o startu a zastavení IP serveru
SQL
lze zadat jen pro SQL výstup. Definuje připojení k SQL serveru, kde je databáze SW SIMS. Tyto parametry vám musí sdělit správce SW SIMS. Server – jméno MS SQL serveru s databází Databáze – jméno databáze SW SIMS, zpravidla „SIMS“ Uživatel – login, pod kterým se IP server přihlašuje k databázi Heslo – heslo pro přihlášení k databázi
Tlačítkem Zavřít dialog ukončíte.
© 2013 HaSaM s.r.o.
Spuštění programu a konfigurace
3.2.4
19
Směrování Po nadefinování vstupních a výstupních linek je potřeba nastavit směrování zpráv, tj. z kterého vstupu budou zprávy posílány na který výstup. Oproti dřívějším verzím IP serveru je možno zprávy posílat na více výstupů.
V seznamu Vstupní linky vyberte vstup, pro který chcete nastavit směrování. Nyní zatrhněte v seznamu výstupů všechny, na které se mají posílat zprávy z vybraného vstupu. Nakonec je potřeba nastavit Master výstup (i v případě, že se zprávy posílají na jediný výstup). Tento výstup způsobí potvrzení zprávy vysílači (za předpokladu že je funkční) – tj. pokud master výstup nefunguje, vysílač potvrzení nedostane přesto, že ostatní výstupy jsou plně funkční. Nastavení směrování pro danou vstupní linku uložíte tlačítkem Nastavit a můžete přejít k nastavení pro jiný vstup. Tlačítkem Zavřít nastavovací dialog ukončíte.
3.2.5
Archivace IP server umožňuje archivaci příchozích zpráv, odpovědí na ně, výstupních zpráv a zpráv o některých významných provozních stavech. Archiv se dá použít i pro řešení problémů, neboť pro každou zprávu se ukládá i čas vzniku zprávy, objektový kód, číslo linky a IP adresa zdroje zprávy. Archiv může být uložen v souboru v podadresáři Arch v instalačním adresáři IP serveru nebo v MS SQL databázi.
© 2013 HaSaM s.r.o.
20
Dokumentace IP serveru
Pro archivaci do souboru zvolte nastavení Do souboru, pak má význam i položka Hloubka archivu [dny], která udává, kolik dní zpět se archiv udržuje. Starší soubory se automaticky mažou. Soubory mají jméno ve tvaru RR_MM_DD_ARCH.txt Tento parametr má vliv i na mazání logovacích souborů v adresáři Log - logy starší než hloubka archivu jsou automaticky mazány, aby nezabíraly diskový prostor. Struktura řádku má tvar: Typ zprávy, datum a čas, kód objektu, ID linky, obsah zprávy, doplňková informace Typ zprávy může být: INP – zpráva od vysílače SND – zpráva odeslaná vysílači OUT – zpráva odeslaná na výstup MSG – informace Pro archivaci do databáze zvolte možnost Do databáze a zadejte parametry v okénku SQL pro připojení k SQL serveru, tj. jméno serveru, jméno databáze a přihlašovací jméno a heslo. Tlačítkem Uložit se dialog zavře s uložením parametrů, tlačítko Zavřít dialog zavře beze změn. Aby bylo možno do databáze zapisovat, musí v ní existovat tabulka se správnou strukturou a stored procedura pro zápis do této tabulky. Vše potřebné si nejjednodušeji vytvoříte spuštěním skriptu archive.sql (najdete jej na instalačním médiu) proti vašemu databázovému serveru (MS SQL 2005). Skript založí databázového uživatele ipsuser s heslem IPs3rv@r, dále databázi IPserverDB a v ní všechny potřebné databázové objekty. Uvedené údaje zadejte v konfiguraci SQL.
© 2013 HaSaM s.r.o.
Spuštění programu a konfigurace
3.2.6
21
Obecná nastavení Zde jsou obecné parametry IP serveru.
Objektový kód IP serveru, Kód ‘start programu’, Kód ‘stop programu’ – z těchto parametrů se vytvářejí zprávy typu 4+2, která se posílají do nadřízeného systému pro notifikaci o spuštění a zastavení služby _IPservice. Tato zpráva se posílá do výstupů, které mají zapnutou volbu Přijímat systémové zprávy. Pokud některý z těchto parametrů není nastaven, příslušná zpráva se neposílá. Všechny kódy se zadávají jako hexadecimální, tj. lze použít znaky 0-9 a A-F. Jazyk – volí jazyk uživatelského rozhraní, lze vybrat češtinu nebo angličtinu. Při prvním spuštění se jazyk volí automaticky podle jazykového nastavení Windows (v českém a slovenském prostředí se použije čeština, jinak angličtina), po uložení nastavení se bere podle tohoto nastavení. Max. počet vláken IP serveru – počet vláken jádra IP serveru. Doporučuje se ponechat výchozí hodnotu 50 a neměnit ji. Generovat debug log – pokud je zatrženo, IP server generuje v podadresáři Log instalačního adresáře soubory Service.RRRR-MM-DD.log s informacemi o své činnosti (každý den jeden soubor, kde RRRR je rok, MM měsíc a DD den vzniku logu). Slouží pro dohledání problémů s aplikací a doporučuje se jej aktivovat jen v případě problémů vzhledem k tomu, že logování částečně zpomaluje běh aplikace a logy zabírají diskový prostor. Starší logy se odmazávají podle nastavení archivace. Hlídat výpadky od startu serveru - nová funkce od verze IP serveru 3.1.2.0. Pokud volba není zapnuta, chová se IP server stejně jako verze nižší než 3.1.2.0, tj. dokud se vysílač nepřipojí, IP server si jej nijak nevšímá a na případnou nefunkci neupozorňuje, vysílač se jeví jako neaktivní. Pokud je volba zapnuta, IP server kontroluje výpadek komunikace ihned od svého startu, tedy pokud se vysílač nepřipojí po dobu své nastavené periody testu, označí se jako nefunkční a do nadřazeného systému se odešle zpráva o výpadku vysílače. DŮLEŽITÉ: změna nastavení platí pouze pro nově přidané vysílače. Pokud tedy je volba vypnuta a zapnete ji, dosud neaktivní vysílače se stále nebudou kontrolovat. Vysílač vložený do systému po
© 2013 HaSaM s.r.o.
22
Dokumentace IP serveru změně se řídí aktuálním nastavením a bude kontrolován. Po změně nastavení je tedy vhodné restartovat IP server. POZOR - pokud je hlídání zapnuto a vložíte do systému nový vysílač dříve, než je uveden do provozu, bude hlášen jeho výpadek. To může být matoucí. Nahrazovat A nulou v objektových kódech - nastavuje, zda v příchozích zprávách nahrazovat znak “A“ nulou v objektových kódech. Pokud je nezatrženo (výchozí stav), náhrada se neprovádí, při zatržení se překódují objektové kódy ve zprávách typu ContactID, 4+2, 4+3. Zprávy typu KOM a Galaxy předávají objektový kód vždy v tak, jak byl přijat IP serverem. Toto překódování je nutné v případě, že ústředna chráněného objektu posílá nulu jako znak „A“, což působí problém při zálohování vysílače telefonní linkou (PCO totiž ve zprávách z telefonní linky vždy nahrazuje A nulou) Tlačítkem Uložit se dialog zavře s uložením parametrů, tlačítko Zavřít dialog zavře beze změn. Smazat uložené heslo – smaže heslo uložené při přihlašování a vynutí jeho zadání při příštím připojení.
3.3
Spuštění a zastavení služby _IPservice Jak již bylo uvedeno, konzola umožňuje konfiguraci, diagnostiku, spouštění a zastavení služby _IPService. Volba Služba v nástrojové liště spustí standardní MMC konzolou pro ovládání služeb na lokálním počítači. Důvodem je podpora User Account Control (UAC) v systémech Windows Vista / 7 / 2008, kdy ani uživatel Administrátor standardně nemá plná práva a službu IP serveru nebylo možno ovládat. Současná implementace se v závislosti na verzi Windows a právech uživatele chová následovně: Windows XP: administrátorovi se MMC konzola spustí přímo, neprivilegovaný uživatel musí zadat jméno a heslo administrátora pro spuštění Windows Vista se zapnutým UAC: administrátor musí potvrdit spuštění konzoly, neprivilegovaný uživatel musí zadat jméno a heslo administrátora pro spuštění Windows 7 / 2008 se zapnutým UAC: administrátor musí nebo nemusí potvrdit spuštění konzoly v závislosti na nastavené úrovni UAC, neprivilegovaný uživatel musí zadat jméno a heslo administrátora pro spuštění Pro ovládání služby IP serveru klikněte v konzoli na službu _IPservice a proveďte požadovaný úkon (zastavení / spuštění / restart).
© 2013 HaSaM s.r.o.
Spuštění programu a konfigurace
3.4
23
Zálohování konfigurace Konfigurace programu IP Server je uloženo v souboru config.xml. Tento soubor obsahuje hodnoty obecných nastavení, nastavení výstupních linek, vstupních linek i jednotlivých objektů. Tento soubor je automaticky zálohován programem do adresáře Backup při jakékoliv změně konfigurace a v názvu souboru obsahuje údaj o datu a času provedení zálohy (RR_MM_DD_HH-MM-SS-config.xml). Máte tedy vždy k dispozici kompletní historii konfigurací a podle potřeby se lze vracet ke staršímu nastavení. V případě nutnosti obnovy staršího nastavení zastavte IP server, smažte existující config.xml v základním adresáři (lépe – zálohujte jej), nakopírujte do základního adresáře příslušné starší nastavení z adresáře Backup a přejmenujte je na config.xml. Poté IP server znova spusťte.
4
Práce s aplikací V této kapitole jsou popsány funkce IP agenta nesouvisející s konfigurací, jako sledování aktivních vysílačů, tok zpráv na vstupních a výstupních linkách a řešení nejčastějších problémů. Nastavení v konfiguračním souboru aplikace: zobrazení stavu zastřežení a bypassu ovládání vysílače (aktivace toolbaru)
4.1
//povolit //povolit
Přehled vysílačů Volba Přehled vysílačů zobrazí seznam všech vysílačů definovaných v IP serveru a jejich aktuální stav. Stav je indikován barevně – modře jsou označeny vysílače, které se dosud k IP serveru nepřipojily (neaktivní), zeleně vysílače plně funkční, bez označení vysílače ve stavu porucha a černé jsou neznámé vysílače (neznámý objektový kód nebo známý objekt s chybnou IP adresou). Dostupné informace o vysílačích: kód objektu; port linky, přes který je vysílač připojen; identifikátor vysílače; čas posledního příjmu; interval mezi posledními dvěma zprávami; jméno vysílače; popis vysílače; typ; verze; volitelně stav zastřežení a bypassu Seznam je aktualizován ve výchozím nastavení cca každých 5 sekund. Pokud chcete automatické obnovování vypnout, klikněte na šipku vedle tlačítka Obnovit a zvolte možnost Obnovovat ručně. Nyní se přehled obnoví pouze po stisku tlačítka Obnovit. Pro přechod zpět na automatické obnovování přepněte na volbu Obnovovat autom. Vysílač může být v poruše ze dvou důvodů: funkční vysílač ztratí spojení s IP serverem. Takový vysílač má vyplněn čas poslední komunikace a interval zpravidla není nulový (na obrázku vysílač 2510) vysílač je neaktivní, vypršela perioda testu a je zapnuté hlídání výpadků od startu IP serveru. Čas poslední komunikace není vyplněn a interval je nula (na obrázku vysílače 2000 a 3000)
© 2013 HaSaM s.r.o.
24
Dokumentace IP serveru
Seznam lze pro snadnější orientaci uspořádat kliknutím na vybranou položku (např. objektový kód, čas poslední komunikace apod.). Klikem na určitý vysílač se povolí ovládací tlačítka v panelu nástrojů.
Pomocí tlačítka Přepni tel. linku lze ovládat komunikační linku vysílače (pouze u funkčních vysílačů K1). Možná nastavení jsou: EZS trvale na komunikátor EZS trvale na telefonní linku Zálohovat EZS telefonní linkou Po stisku tlačítka se zobrazí nastavovací dialog; nejprve je ale nutno načíst aktuální stav tlačítkem Zjistit nastavení. Jakmile vysílač vrátí aktuální stav (pokud má právě zavřené spojení s IP serverem, může tato operace trvat delší dobu), zobrazí se ve výběrovém seznamu. Poté lze nastavit novou hodnotu a odeslat ji tlačítkem Nastavit.
Tlačítkem Přepni výstup lze ovládat stav pomocných výstupů vysílače (tato funkce pracuje jen na vysílačích K1-GPT osazených přídavným modulem výstupů a firmware B071217 nebo novějším; nelze ovládat výstupy signalizující výpadek spojení !!). Pokud vás zajímá aktuální stav výstupů, stiskněte Zjistit nastavení. Jakmile vysílač odpoví (pokud má právě zavřené spojení s IP serverem, může tato operace trvat delší dobu), vypíší se stavy vedle textu Aktuální: . Nový stav výstupu lze nastavit i bez znalosti aktuálního stavu – zvolte si nový stav výstupů a odešlete jej tlačítkem Nastavit. Nový stav může být: vypnuto (LO) – výstup rozepnutý zapnuto (HI) – výstup sepnutý Special 2 - pošle v ovládacím příkaze hodnotu 2 (slouží pro speciální účely v závislosti na firmware vysílače) neměnit – zachová se aktuální stav výstup
© 2013 HaSaM s.r.o.
Práce s aplikací
25
Po nastavení nového stavu se rovněž vypíše aktuální stav obou výstupů (s určitým zpožděním).
Tlačítkem Zobrazit lze na seznam vysílačů aplikovat některý z předdefinovaných filtrů, což usnadní identifikaci neaktivních nebo nefunkčních vysílačů: Všechny - zobrazí se všechny vysílače Bez funkčních - nezobrazí se funkční vysílače Funkční - zobrazí se jen funkční vysílače (zelené) Neaktivní - zobrazí jen neaktivní vysílače (modré) V poruše - zobrazí jen vysílače v poruše (červené) V titulku okna přehledu vysílačů se vypisuje [počet zobrazených / celkový počet] vysílačů. Tlačítkem Blokování lze vybraný vysílač zablokovat/odblokovat - v blokovaném stavu IP server zprávy vysílači potvrzuje, avšak neposílá je dále do PCO. Při blokování je možné poslat do PCO zprávu 4+2 o zablokování; tato funkce se konfiguruje ručně pomocí souboru armdisarm.xml Zastřežování - zjistí aktuální stav zastřežení a umožní jej změnit Zastřežení SMS - umožní odeslat příkaz k zastřežení/odstřežení pomocí SMS (vyžaduje SMS linku na straně IP serveru) Smazat neznámé - smaže ze seznamu neznámé vysílače. Pokud by se takový vysílač znovu pokusil připojit k IP serveru, zobrazí se v seznamu znova. Bypass - umožní deaktivovat vstupy vysílače. Je nutné, aby vysílač měl definovanou tabulku parametrů v konfiguraci. Na základě výběru vstupů k deaktivaci se vysílači odešle nastavení vstupů. Neaktivní vstupy se zobrazují v seznamu vysílačů. Hledat - umožňuje vyhledávat vysílače podle ATM Id nebo objektového kódu
4.2
Okno vstupních a výstupních linek Okna se zobrazí tlačítky Vstupní linky resp. Výstupní linky. Okna zobrazují příchozí zprávy resp. zprávy posílané na výstup ve formátu SURGARD, společně s časem příchodu / odeslání a ID linky, která danou zprávu doručila. V poli Další informace se mohou zobrazit další dodatkové informace, jako IP adresa vysílače, tel. číslo GSM komunikátoru, TIMEOUT / RESTORE, pokud se jedná o zprávu o výpadku / obnovení vysílače nebo HEARTBEAT signal (zpráva informující o tom, že IP server běží). V okně výstupních linek se zpráva zobrazí až v okamžiku, kdy ji PCO potvrdí, nikoliv v okamžiku
© 2013 HaSaM s.r.o.
26
Dokumentace IP serveru odesílání. Klikem pravým tlačítkem myši kdekoliv v těchto oknech se zobrazí kontextové menu s volbou Smazat, která smaže obsah okna.
© 2013 HaSaM s.r.o.
Práce s aplikací
4.3
27
Informace o licenci a verzi Zobrazíte ji tlačítkem O programu v hlavním okně programu.
4.4
Testovací nástroje (simulátory vysílačů) Spolu s IP serverem se nainstalují nástroje pro simulaci vysílačů typu K1 a Galaxy, což umožní testovat funkci IP serveru. Nástroje lze spustit přes nabídku Start / Programy / IP server tools. SimIPcomNET je simulátor vysílače K1. Jeho okno vypadá takto:
© 2013 HaSaM s.r.o.
28
Dokumentace IP serveru
Pro připojení k IP serveru musíte znát jeho IP adresu nebo jméno a port. Defaultně se nabízí IP adresa lokálního počítače a port 4440. K IP serveru se připojíte tlačítkem Open. Pokud jste zadali IP adresu a po Open se vypíše v dolním bílém okénku zpráva: System.Net.Sock ets.Sock etException: No such host is k nown, zatrhněte zatržítko Assume IP. K této situaci dochází, pokud IP adresa serveru není správně zavedena v DNS systému. V rámečku Message vyberte typ zprávy (CID, 42, 42R, KOM, Empty = testovací zpráva) a nastavte její parametry. Nastavitelné jsou jen parametry vztahující se k vybranému typu zprávy, ostatní jsou nepřístupné. ObjCode Transmit je objektový kód vysílače (zadává se v parametrech vysílače v nastavení IP serveru). Objcode v rámečku Message je objektový kód střeženého objektu. Tlačítkem Send se zpráva odešle (kompletní obsah zprávy je zobrazen v dolním šedém okénku) a v horním bílém okénku se vypíše odpověď IP serveru. Tlačítkem Close se spojení k IP serveru uzavře. Simulátor umí provést i kontinuální test – zadejte periodu zpráv (Period) v sekundách a stiskněte Start Test. Nyní se bude s nastavenou periodou odesílat nastavená zpráva, dokud nestisknete Stop Test. Během testu lze typ zprávy libovolně měnit. Parametr Frame je číslo odesílaného rámce a s každou odeslanou zprávou se zvyšuje o jedničku. Výchozí hodnotu lze nastavit libovolně. SimGalaxyNET je simulátor Galaxy vysílače. Připojení k IP serveru je podobné jako u předchozího simulátoru – je nutno znát jméno nebo IP
© 2013 HaSaM s.r.o.
Práce s aplikací
29
adresu a port a stisknout tlačítko Open (pokud dojde k chybě System.Net.Sock ets. Sock etException: No such host is k nown po Open při zadané IP adrese, zatrhněte Assume IP). Nastavte parametry zprávy – objektový kód (ObjCode) musí začínat znakem # a mít 6 znaků. Pole Numeric part je určeno pro numerickou část zprávy (musí začínat N, lze vybrat některou z předdefinovaných zpráv a upravit ji), pole Text part pak pro textovou část (musí začínat A). Pokud v příslušné části zprávy chybí úvodní #, A nebo N, program si je před odesláním sám doplní. Tlačítkem Send Numeric se odešle zpráva pouze s numerickou částí, tlačítkem Send Complete pak kompletní zpráva (s numerickou i textovou částí).
Tlačítkem Start Test spustíte kontinuální test, kdy se odešlou kompletní zpráva, pak se počká počet sekund zadaný v poli Period a vše se opakuje, dokud nestisknete Stop Test. V šedém okénku se vypisují zprávy o odeslání, každá část by měla být IP serverem potvrzena sekvencí znaků „@8‡“.
4.5
Řešení problémů - troubleshooting Zde je uveden seznam nejčastějších závad a jejich řešení. Problém: nelze spustit služba _IPService o nedostatečné oprávnění přihlášeného uživatele na PC - zkuste službu spustit manuálně (Tento počítač – Spravovat – Služby – _IPService – Start) o blokovaný TCP port pro komunikaci (8010) o zkuste spustit IP server v debug módu. Spusťte command prompt, přejděte do instalačního adresáře IP serveru a zadejte ipservice /d. Co program vypíše?
© 2013 HaSaM s.r.o.
30
Dokumentace IP serveru Problém: služba běží, ale nepřicházejí zprávy z objektů o zkontrolujte okna vstupních a výstupních linek – přijde zpráva na vstup a na výstup již ne, nebo se neobjeví ani na vstupu? o problém s výstupním kanálem – nelze otevřít COM port nebo databázi o problém s výstupním kanálem – není definováno směrování ze vstupního kanálu o neplatná licence – např. vypršela časová platnost o blokovaný TCP port – nastavení firewallu (nejen lokálně na PC ale i v síti!) o nefunkční síťové připojení (problémy s HW síťové karty, LAN, Internetem...) o změna IP adresy PC (IP adresa musí být pevná) Problém: nepřicházejí zprávy z nově připojeného objektu o nový vysílač má chybně zadán objektový kód, případně IP adresu. Zkontrolujte dialog Aktivní vysílače Problém: nepřicházejí zprávy z nového vstupního kanálu o zkontrolujte, zda kanál není ve stavu ERROR – nezadali jste TCP port, který je již používaný? Problém: nelze založit vstupní kanál Galaxy o licence nepovoluje použití Galaxy Problém: nelze se připojit IP agentem k serveru, agent hlásí chybné heslo o k této situaci může dojít, pokud má agent zapamatované heslo a na serveru bylo heslo změněno. Pak se agent pokouší připojovat se starým heslem. Připojte se znovu a zadejte nové platné heslo (případně je nechte zapamatovat) Problém: pokud přicházejí zprávy od objektu přes IP server, jsou v objektovém kódu namísto nul znaky „A“. Pokud zpráva přijde záložní telefonní linkou, je objektový kód správně s nulami o pulty centralizované ochrany automaticky mění znaky „A“ na nulu. IP server toto ve výchozím stavu nedělá, funkci je potřeba zapnout v obecných nastaveních. Problém lze rovněž obejít nastavením ústředny tak, aby neposílala „A“, ale nuly (pokud to ústředna umožňuje) Problém: Galaxy vysílač po 24 hodinách pošle zprávu o výpadku spojení, i když je spojení funkční o Není zapnuto posílaní testovací zprávy. V ústředně jděte do menu 56.4.4=Autotest, zde lze nastavit automatické testování komunikace - buď vždy ve stanovenou dobu každý den (doporučeno), nebo pouze v případě, že za posledních 24h neodešla žádná zpráva.
4.6
Kolik vysílačů lze připojit k IP serveru Připojení vysílače vyžaduje na straně IP serveru jeden soket (port). Na jednom síťovém rozhraní lze vytvořit teoreticky 65535 soketů, avšak sokety s číslem portu 1 – 1024 jsou vyhrazeny pro různé síťové služby (80 – www, 21 – ftp, 23 – telnet atd.), některé další porty pak využívá i systém Windows. V praxi tedy lze počítat zhruba s 60 000 dostupnými sokety. Avšak soket konzumuje určité systémové zdroje (paměť), takže skutečný počet je omezen dostupnou pamětí počítače, případně i použitým operačním systémem. Obecně lze počítat zhruba s tisícovkami dostupných soketů. Prakticky byl IP server vyzkoušen na PC s Windows Vista a Windows 2003 s 4 GB RAM, kde bylo bez problémů připojeno 2000 simulovaných vysílačů. Stejného počtu bylo dosaženo i na virtuálním PC s Windows XP Profesional s 800 MB RAM.
© 2013 HaSaM s.r.o.
DeviceConfig
5
31
DeviceConfig DeviceConfig je program pro konfiguraci vysílačů firmy HaSaM s.r.o. typů K1-IPT, K1-GPT a jejich ECO variant. Vysílače lze konfigurovat lokálně po sériové lince, od verze programu 3.1.2.0 též vzdáleně přes IP server. Prvotní konfigurace se provádí vždy po sériové lince, vzdálená konfigurace je možná teprve po navázání spojení s IP serverem. Vzdálená konfigurace usnadňuje práci technikům zabezpečujícím provoz vysílačů. Současně to ale může být nebezpečný nástroj v rukou neznalé obsluhy, protože nevhodným nastavením zejména ethernetových vysílačů může dojít ke ztrátě spojení s IP serverem. V takovém případě je nutný výjezd na místo instalace a překonfigurování vysílače lokálně. Vzdálená konfigurace proto má určitá omezení, nicméně přesto je nutná opatrnost. Bližší informace získáte v dalších kapitolách. Program DeviceConfig pracuje na platformě Windows XP a novějších. Instaluje se současně s IP serverem jako jeden z pomocných nástrojů; pro samostatné použití je možno jej rovněž stáhnout na stránkách firmy HaSaM. Stažený ZIP archiv rozbalte kamkoliv na pevný disk a spusťte program DeviceConfig.exe Pro spuštění je nutné mít nainstalovaný .NET Framework 3.5 a volný sériový port. Nastavení v konfiguračním souboru aplikace: //skrýt telefonní nastavení (pro projekt Malajsie) //false = přes IP server funguje konfigurace podle této dokumentace; true = zjednodušené rozhraní
5.1
Popis programu a parametrů Program slouží k načtení a zápisu nastavení vysílače. Načtené parametry je možné uložit ve formě XML souboru pro pozdější použití nebo archivaci. V horní části hlavního okna programu se nachází menu se všemi funkcemi, které lze rovněž vyvolávat z panelu nástrojů pod menu. V menu Nástroje - O programu můžete zjistit verzi programu. Ta by obvykle měla být stejná jako verze IP serveru (pokud chcete používat dálkovou konfiguraci). Význam tlačítek v panelu nástrojů (zleva doprava): načtení parametrů z vysílače (ikona počítače se šipkou nahoru vpravo) zápis parametrů do vysílače (ikona počítače se šipkou dolů) vytvoření nového prázdného dokumentu (ikona nový dokument). Smaže aktuálního hodnoty všech zobrazených parametrů. načtení uloženého nastavení (ikona složky). Zobrazí se dialog pro výběr XML souboru s nastavením, vybraný soubor se načte a parametry se zobrazí. uložení parametrů (ikona diskety). Uloží hodnoty parametrů do naposled načteného souboru (jeho jméno je vypsáno v dolní části okna). Pokud byly parametry načteny z vysílače nebo vytvořeny ručně (jméno souboru je prázdné), program si vyžádá zadání jména souboru. uložení parametrů se zadáním souboru (ikona tři diskety). Program si vyžádá jméno souboru a do něj uloží hodnoty parametrů volba typu vysílače (výběrový seznam). Tato volba má význam při zápisu parametrů do vysílače -
© 2013 HaSaM s.r.o.
32
Dokumentace IP serveru vybraný typ musí souhlasit s typem vysílače, který nastavujete. Při načítání se volba ignoruje, program na základě načtených parametrů detekuje a nastaví typ vysílače sám. Volba se rovněž nastaví automaticky po načtení dat ze souboru. V praxi by tedy nemělo být vůbec nutné tuto volbu měnit ručně. Před zápisem parametrů do vysílače nebo souboru se provádí kontrola správnosti všech zadaných hodnot. V případě chyby se vypíše seznam chybně zadaných hodnot.
Popis parametrů pro ethernetové vysílače (K1-IPT, K1-IP ECO)
© 2013 HaSaM s.r.o.
DeviceConfig
33
Verze a typ objektového zařízení Zobrazuje údaje o verzi firmware, typu a konfiguraci vysílače. Údaje jsou aktualizovány vždy při načítání parametrů z vysílače. Kódy objektového zařízení Tato sekce obsahuje kód objektu vysílače (4 hexa znaky) a kódy událostí (2 hexa znaky) odpovídající stavu vstupů. Formát generovaných událostí je 4/2. Jejich hodnoty definuje správce PCO v souladu s tabulkami používanými pro interpretaci těchto kódů a s ohledem na dodržení jedinečnosti objektového kódu v rámci PCO. Posílání jednotlivých událostí lze zakázat prostým nevyplněním příslušného pole pro zadání kódu události. Kód objektu však musí být zadán vždy. Parametry TCP/IP
© 2013 HaSaM s.r.o.
34
Dokumentace IP serveru Parametry v této sekci jsou definovány správcem sítě. IP adresy se zadávají jako 4 číslice 0-255 oddělené tečkami, port jako číslo 0-65535. IP server (PCO) - IP adresa přijímací strany (PCO) a TCP port vyhrazený pro některý ze vstupních kanálů IP Serveru určených pro příjem zpráv od vysílačů. Obvykle se jedná o veřejnou IP adresu na straně PCO, ze které je nastaveno směrování jednoho či více TCP portů do vnitřní sítě. Zde jsou pak zprávy přijímány aplikací IP Server a předávány do PCO. Tyto parametry vám sdělí správce sítě na straně připojení PCO. Komunikátor - IP adresa a port vyhrazené pro přenos z vysílače. Adresu vám přidělí správce sítě, do které má být vysílač připojen. Maska sítě - slouží k určení adresy sítě, v které leží zařízení (PC, komunikátor apod.) se zadanou IP adrese. Masku vám přidělí správce sítě, do které má být vysílač připojen. Brána - obvykle je přijímač v jiné síti než přijímací strana, proto je třeba zadat IP adresu brány, přes kterou bude komunikace směrována. Bránu vám přidělí správce sítě, do které má být vysílač připojen. Proxy server - pokud je k přenosu zpráv využíván internet a přístup k němu je omezen proxy serverem, je třeba zadat jeho IP adresu a port. Oba údaje vám sdělí správce sítě, do které má být vysílač připojen. Pokud není proxy server použit, zadejte adresu 0.0.0.0 a port 0. Časové parametry Tato sekce definuje časové parametry vysílače - periodu testovací zprávy a interval technického poplachu. Jejich hodnoty ve výsledku určují maximální dobu, za jakou proběhne detekce a následná reakce na případnou poruchu spojení. Není však vhodné neomezeně tyto časy zkracovat, aby nedocházelo k falešným technickým poplachům. Parametry mají rozsah 0-255. Perioda testovací zprávy - definuje četnost provádění testu spojení pomocí testovacích rámců. Tyto testovací rámce nejsou na straně PCO interpretovány a nezatěžují provozně operátory PCO. Na základě absence potvrzení rámců na straně objektového vysílače je detekována porucha spojení. Na straně PCO je testovací zpráva očekávána v souladu se zadanou periodou testovací zprávy. Na straně objektového vysílače je potvrzení jakékoli odeslané zprávy očekáváno do 30 [s]. Po vypršení těchto časů je komunikace mezi objektovým vysílačem a PCO oboustranně nezávisle považována za přerušenou. Doporučená hodnota tohoto parametru je 30 [sec] až 10 [min] pro ethernetové vysílače, 10 až 40 [min] pro GPRS vysílače. Pozor, hodnota se zadává s krokem 10 vteřin (tzn., že 0.5 až 10 minut odpovídá nastavení hodnoty 3 až 60!). Nastavitelné minimum u GPRS vysílače je 2 [min] (hodnota 12); pokud se pokusíte nastavit nižší hodnotu, vysílač parametr nastaví na 10 [min]. Interval technického poplachu - definuje dobu, po které je objektovým vysílačem vyhlášen technický poplach a použita případná záložní cesta po telefonní lince. Odměřování této doby je zahájeno vždy, jakmile dojde k detekci přerušení komunikace mezi objektovým vysílačem a PCO (viz. perioda testovací zprávy). Během této doby dochází k opakovaným pokusům o obnovu spojení opakováním zpráv. Tím může dojít k obnově spojení a technický poplach tak vyhlášen není. Je-li tento parametr vhodně nastaven, jsou nahodilé jednorázové krátké výpadky komunikace odfiltrovány. Doporučená hodnota tohoto parametru je 60 až 150 [s]. Během této doby dojde ke 2 až 5 pokusům o obnovu spojení. Telefonní parametry Zde se definují parametry potřebné pro spolupráci vysílače s EZS ústřednou Telefonní linka - určuje mód spolupráce vysílače s telefonní linkou. Tento parametr lze nastavovat i pomocí IP agenta v přehledu vysílačů. o zálohovat EZS telefonní linkou - standardně je EZS ústředna připojena na vysílač, při technickém poplachu se přepne na telefonní linku o EZS trvale na telefonní linku - ústředna připojena na telefonní linku, vhodné např. při upgrade firmware ústředny o EZS trvale na komunikátor - ústředna připojena na vysílač, např. pokud telefonní linka není vůbec použita
© 2013 HaSaM s.r.o.
DeviceConfig
35
Formát - formát zpráv EZS ústředny (CID, 4/2, 4/2 s opakováním). Nastavuje se podle typu ústředny Frekvence a délka handshake Frekvence a délka KissOff - tyto 4 parametry závisí na typu ústředny. Program nastavuje tyto parametry v závislosti na formátu na zobecněné hodnoty, které byly odzkoušeny v praxi s řadou ústředen, lze je však podle potřeby měnit. Délky mají rozsah 0-255. Více informací o telefonních parametrech se dočtete v dokumentaci k jednotlivým typům vysílačů
Popis parametrů pro GPRS vysílače (K1-GPT, K1-GP ECO) Parametry GPRS vysílačů se liší od předchozího popisu v několika detailech
Parametry TCP/IP U GPRS se zadává pouze adresa a port IP serveru, ostatní parametry jsou nedostupné. GSM (GPRS - SMS) Tyto parametry jsou specifické jen pro GPRS APN (Access Point Name) - jméno přístupového bodu do sítě GPRS. Toto jméno zjistíte u svého operátora SMS - mobilní telefonní číslo určené na straně PCO pro příjem krátkých zpráv ze SMS komunikátorů. Telefonní číslo může být zadáno jak v národním, tak mezinárodním formátu. Prázdný parametr znamená, že odesílání krátkých zpráv není aktivováno. GSM signál - graficky a číselně vyjadřuje úroveň naposledy detekované intenzity signálu GSM. Zobrazovaná hodnota se aktualizuje při načítání parametrů z vysílače.
5.2
Konfigurace přes sériový port Pokud chcete načíst konfiguraci z vysílače přes sériový port, postupujte takto: V případě ethernetového vysílače jej odpojte ze sítě, u GPRS vysílače osaďte propojku JP1. Toto je nutné, aby vysílač současně nekomunikoval s IP serverem. Zvolte funkci Načíst parametry a vyberte sériový port, ke kterému je připojen vysílač (program nabízí naposled použitý port).
© 2013 HaSaM s.r.o.
36
Dokumentace IP serveru
Program začne načítat parametry, průběh operace se vypisuje v informačním okně
Úspěšně načtený parametr je potvrzen zprávou "OK", pokud vysílač parametr nezná, vypíše se "odmítnuto". Toto není příznak chyby - program se ptá na všechny parametry, avšak některé z nich jsou specifické pouze pro ethernetové vysílače, některé pouze pro GPRS vysílače. Na základě těchto specifik se detekuje typ vysílače. Pokud se vypíše text "no response", značí to, že vysílač neodpověděl na dotaz, v takovém případě
© 2013 HaSaM s.r.o.
DeviceConfig
37
máte možnost čtení ukončit. Ukončete je tedy a zkontrolujte, zda je vybrán správný port, správně připojený kabel a zopakujte načtení. Po načtení se parametry zobrazí, můžete je editovat a zapsat do souboru. Při editaci a zápisu parametrů do vysílače nejsou žádná omezení, je to dáno tím, že nastavení přes sériovou linku se provádí zpravidla při uvádění do provozu na místě instalace. Případná chyba nastavení se odhalí při testu po uvedení do provozu a lze ji na místě odstranit. Obdobně se postupuje při zápisu konfigurace do vysílače - zvolte funkci Zapsat parametry a vyberte sériový port, ke kterému je připojen vysílač (program nabízí naposled použitý port). Program začne zapisovat parametry, průběh operace se vypisuje v informačním okně jako při načítání. Nastavení parametru je potvrzeno zprávou "potvrzeno" nebo "OK". Pokud se pro některý parametr vypíše "odmítnuto", znamená to, že je špatně nastaven typ vysílače, např. se pokoušíte zapsat GPRS nastavení do ethernetového vysílače. V praxi by tento případ neměl nastat.
5.3
Konfigurace přes IP server Pokud chcete načíst konfiguraci z vysílače přes IP server, postupujte takto: Zvolte funkci Načíst parametry a vyberte port "IPserver" (program nabízí naposled použitý port). Tím se zpřístupní pole pro zadání adresy a portu IP serveru a pro zadání hesla. Bez těchto údajů se nelze k IP serveru připojit. Pokud na stejném PC je nainstalován IP agent, program automaticky předvyplní adresu a port IP serveru hodnotami, které používá IP agent. Naposled použitá adresa a port se pamatují do ukončení programu pro další připojení k IP serveru. Heslo je shodné s heslem, které se používá pro připojení IP agenta k serveru a po instalaci je nastaveno na IPs3rv@r Pokud jsou zadané připojovací údaje chybné, v dolní části dialogu se vypíše odpovídající chybová zpráva.
Po úspěšném přihlášení se zobrazí okno se třemi záložkami. Záložka Vysílače zobrazuje seznam vysílačů definovaných v IP serveru, které lze konfigurovat programem DeviceConfig. Pro každý vysílač se vypisuje: objektový kód číslo portu, přes který vysílač komunikuje jméno vysílače počet čekajících konfiguračních zpráv (Požadavky)
© 2013 HaSaM s.r.o.
38
Dokumentace IP serveru
Označte myší vysílač, jehož konfiguraci chcete načíst a stiskněte tlačítko Načíst. Tím se předá požadavek na přečtení konfigurace IP serveru a vypíše se o tom informační zpráva na záložce Informace.
© 2013 HaSaM s.r.o.
DeviceConfig
39
Nyní je potřeba počkat na odpověď vysílače - můžete dialog zavřít a otevřít jej později, nebo můžete sledovat průběh zpracování požadavku a po jeho vyřízení odpověď načíst. Sledovat lze na záložce Vysílače, kde vidíte jak se mění počet požadavků. Tlačítkem Obnovit se seznam vysílačů aktualizuje; jakmile počet požadavků klesne na nulu, je konfigurace načtena. Sledování je možné i na záložce Soubory, kde se zobrazují odpovědi na požadavky. Soubor s odpovědí má jméno ve tvaru Xcomputer-objekt-date-time.ext, kde: X je typ odpovědi, což může být R (odpověď na načtení parametrů - Response) nebo A (odpověď na zápis parametrů - Acknowledge) computer je název počítače, z nějž byl požadavek odeslán (na obrázku je to počítač sirius) objekt je objektový kód vysílače, na který byl požadavek odeslán date je datum odeslání požadavku ve tvaru RRMMDD time je čas odeslání požadavku ve tvaru HHMMSS ext je přípona, která indikuje stav zpracování: proc značí požadavek, který se ještě vyřizuje (nelze jej načíst), done značí dokončený požadavek, který již lze načíst do Deviceconfigu
© 2013 HaSaM s.r.o.
40
Dokumentace IP serveru
Tlačítkem Obnovit se výpis souborů aktualizuje. Pokud vyberete soubor s příponou done, zpřístupní se tlačítko Načíst, kterým odpověď načtete. Pokud je typ odpovědi A, vypíše se výsledek zápisu parametrů a každý parametr by měl být potvrzen textem "potvrzeno" nebo "OK". Pokud je typ odpovědi R, vypíše se výsledek načítání podobně jako u sériové linky a po zavření dialogu se parametry zobrazí. Při editaci a zápisu nastavení zpět do vysílače přes IP server existují oproti sériové lince určitá omezení. Nevhodným nastavení komunikačních parametrů totiž vysílač může ztratit spojení s IP serverem a pro nápravu je pak nutný výjezd na místo instalace. Proto DeviceConfig aplikuje při práci přes IP server dvojúrovňovou ochranu důležitých parametrů. První úroveň je pasivní a funguje po načtení parametrů přes IP server. Ochrana se projeví tím, ze nelze editovat parametry Kód objektu, IP server (PCO) a APN (hodnoty se zobrazí, ale editační pole jsou zašedlá). Důležitost nastavení IP serveru a APN je zřejmá, kód objektu nelze změnit z toho důvodu, že je současně použit pro identifikaci vysílače. Pokud by se dal změnit (ve vysílači se jeho změna projeví okamžitě), IP server by již nepovolil přístup k frontě nastavovacích příkazů pro původní objektový kód a vysílač by zůstal nedokonfigurovaný. Tuto ochranu lze ale snadno překonat uložením parametrů do souboru a jejich zpětným načtením. Proto existuje druhá úroveň ochrany, kdy se přes IP server neposílají příkazy pro nastavení objektového kódu, IP serveru a APN. Nicméně po načtení parametrů ze souboru NESMÍTE v
© 2013 HaSaM s.r.o.
DeviceConfig
41
programu přepsat kód objektu. Protože je tento kód použit pro identifikaci vysílače, DeviceConfig by předal nastavení na nesprávný vysílač, což je nežádoucí. Při změně kódu objektu na takový, který IP server nezná, DeviceConfig vypíše chybovou zprávu a požadavek na nastavení se nezpracuje. Další potenciální nebezpečí hrozí u ethernet vysílačů, kde lze měnit TCP/IP parametry. Nevhodným nastavením je však možno vysílač odstavit z provozu, protože může ztratit schopnost se připojit k IP serveru. Při změně těchto parametrů proto postupujte s maximální opatrností !! Existuje možnost změnit objektový kód vysílače, adresu a port IP serveru a APN (u GPRS vysílačů) přes IP server v rozšířeném módu. Při zápisu konfigurace do vysílače zvolte funkci Zapsat parametry a vyberte port "IPserver" (program nabízí naposled použitý port). Zadejte přihlašovací údaje k IP serveru. Po úspěšném přihlášení je odeslán požadavek na zápis konfigurace a vypíše se o tom informace. Výsledek vyřízení nastavovacího požadavku lze načíst pomocí funkce Načíst parametry a výběrem příslušného souboru s odpovědí typu A, viz popis výše.
5.3.1
Rozšířený mód Rozšířený mód umožňuje pomocí IP serveru změnit kód objektu, adresu IP serveru a u GPRS vysílačů i APN, což jsou parametry, které DeviceConfig standardně přes IP server nastavit nedovolí. Při nastavování vysílače pomocí sériové linky nemá rozšířený mód žádný význam. Při změně těchto parametrů však postupujte opatrně, neboť chybným nastavením můžete zabránit vysílači v připojení k IP serveru. Před změnou je nutno rozšířený mód nastavit v menu Nástroje - Rozšířený mód a potvrdit jeho aktivaci. Zapnutí je signalizováno zatržítkem v menu. Nyní zvolte funkci Načíst parametry a připojte se k IP serveru. V seznamu Vysílače klikněte pravým tlačítkem myši na vysílač, jehož nastavení chcete změnit. Zobrazí se menu s nabídkou změny kódu objektu, APN a IP serveru (pokud je rozšířený mód vypnut, menu se nezobrazí). Zvolte požadovanou funkci.
© 2013 HaSaM s.r.o.
42
Dokumentace IP serveru
Zobrazí se dialog pro zadání nového objektového kódu / APN / IP serveru. Pokud akci stornujete nebo zadáte chybnou hodnotu, vypíše se chybová zpráva. Stejně tak, pokud je chyba v kódu objektu - příliš dlouhé číslo, chybný znak v kódu, zadaný kód je použit jiným vysílačem (např. pokud chcete změnit objektový kód z 5000 na 7000, ale vysílač s kódem 7000 již v IP serveru je nadefinován). Po zadání hodnoty se požadavek předá serveru a zpracuje se stejně jako standardní konfigurace, včetně zobrazení výsledků operace. Při změně objektového kódu se děje toto: vysílači se odešle příkaz pro změnu kódu po odeslání příkazu se změní i kód příslušného objektu v konfiguraci IP serveru a změna se uloží do konfiguračního souboru. To je nutné pro správný příjem potvrzení o změně kódu přijme se odpověď od vysílače a zpracování se ukončí. Odpověď si převezmete na záložce Soubory, kde ji najdete podle původního objektového kódu (před změnou). Při změně APN se děje toto: vysílači se odešle příkaz pro změnu APN vysílač pošle odpověď po úspěšném potvrzení se uzavře spojení s vysílačem. Tím se vynutí nové připojení se změněným APN Pokud bylo APN nastaveno chybně, vysílač se již k IP serveru nepřipojí.
© 2013 HaSaM s.r.o.
DeviceConfig
43
Při změně IP serveru se liší chování ethernetových a GPRS vysílačů. GPRS vysílač změnu IP serveru potvrdí, teprve poté se od IP serveru odpojí a požadavek na změnu se označí jako vyřízený, tj. lze jej načíst v záložce Soubory. Ethernetový vysílač se při změně nastavení odpojí od stávajícího serveru a požadavek zůstane ve stavu rozpracovaný (je možno jej ručně smazat z adresáře DeviceConfig).
5.4
Otázky a odpovědi Zde najdete odpovědi na některé otázky týkající se používání konfiguračního programu DeviceConfig. Dotaz: Co přináší nové verze DeviceConfigu? Lze nadále používat starší verze programu? Odpověď: Nová verze přináší možnost nastavovat vysílače vzdáleně přes IP server, což umožní snížit nutnost výjezdů za účelem jejich rekonfigurace. Rovněž byly odstraněny některé nedostatky předchozích verzí a zjednodušeno použití programu: starší verze neuměly nastavit čísla TCP portů na hodnoty vyšší než 32767. Při zápisu takových hodnot došlo k pádu programu. starší verze měly problém s nastavením masky sítě s větším počtem bitů než 9 byla zavedena autodetekce typu vysílače Lze nadále používat starší verze programu, avšak vzhledem k uvedeným chybám se to nedoporučuje. Dotaz: Je rozdíl mezi nastavením po sériové lince a přes IP server? Odpověď: Ano. Po sériové lince lze nastavovat všechny parametry, přes IP server není možno měnit nejdůležitější parametry potřebné pro identifikaci vysílače a pro komunikaci s IP serverem (blíže popsáno zde). Tyto parametry však lze změnit v rozšířeném módu. Dotaz: Chrání nějakým způsobem DeviceConfig parametry, které nelze měnit přes IP server? Odpověď: Ano. Tyto parametry přes IP server nelze vůbec odeslat do vysílače (pokud není zapnut rozšířený mód). Rovněž při načtení z IP serveru tyto parametry nelze editovat. Dotaz: Lze DeviceConfigem přes IP server poškodit nastavení vysílače? Odpověď: U GPRS vysílače by tato možnost neměla nastat (s výjimkou rozšířeného módu), protože důležitá nastavení jsou chráněna. Nesprávným nastavením čísla pro SMS lze odstavit posílání SMS zpráv. U ethernetových vysílačů však lze vysílač odstavit z provozu chybným nastavení TCP parametrů - vysílač nemusí být schopen se spojit s IP serverem. Při změně těchto parametrů buďte maximálně opatrní !! Dotaz: Jak rychle se načte přes IP server konfigurace vysílače? Odpověď: záleží na použité technologii, místních podmínkách příjmu přes GPRS a na tom, zda je pro daný vysílač zapnuta volba "Zavřít spojení po příjmu". V takovém případě musí vysílač vždy vystavovat nové spojení, což celý proces zpomaluje (na GPRS se zavírání soketu nedoporučuje). Výsledky praktických měření jsou tyto: Technologie spojení se nezavírá spojení se zavírá LAN ethernet cca 40 sec 1,5 minuty GPRS cca 1 minuta 14-15 minut Pokud se spojení s vysílačem zavírá, přistupuje k tomuto času ještě prodleva při čekání na připojení vysílače - při odeslání požadavku totiž s největší pravděpodobností nebude mít vysílač otevřené spojení s IP serverem. Tato prodleva je rovna maximálně periodě testovacích zpráv.
© 2013 HaSaM s.r.o.
44
Dokumentace IP serveru Dotaz: Má restart IP serveru vliv na frontu konfiguračních zpráv? Odpověď: Ano. Požadavky na načtení a zápis konfigurace jsou uloženy pouze v paměti počítače a restartem se ztratí. Odpovědí na požadavky jsou uloženy v souborech (v podadresáři DeviceConfig nainstalovaného IP serveru) a proto jim restart neublíží. Pokud restartem přijdete o požadavky, které se právě zpracovávaly, je vhodné ručně smazat příslušné proc soubory v uvedeném adresáři.
6
Phone Switcher Phone Switcher je jednoduchá aplikace pro hromadné operace typu přepínání telefonní linky vysílačů typu K1/K2, vynucení update firmware apod. V základním stavu se vysílač zpravidla nastaví tak, aby komunikace byla zálohována telefonní linkou. Pro účely testu telefonní linky je zapotřebí vysílač přepnout na telefonní linku a po ukončení testu přepnout zpět na zálohování. Tuto operaci lze provést i pomocí IP agenta, při větším počtu vysílačů je však tato operace velmi zdlouhavá. Phone Switcher ji velmi zjednodušuje. Spustit aplikaci lze z nabídky Start / Programy / IP server tools / PhoneLineSwitcher Hlavní okno programu
Panel nástrojů s grafickými tlačítky – spouští jednotlivé funkce: Připojit - umožňuje aplikaci připojit se na IP server. připojovací dialog je shodný s dialogem z IP agenta. Phone switcher sdílí konfigurační údaje s IP agentem, tj. zpravidla není nutné tuto funkci používat - program načte nastavení z IP agenta a připojí se k serveru automaticky. Jakmile se naváže spojení s IP serverem, povolí se další funkce programu. Konfigurace - tato funkce definuje seznam vysílačů, které chcete hromadně přepínat. Zobrazí se tento dialog:
© 2013 HaSaM s.r.o.
Phone Switcher
45
V seznamu se vypíše seznam všech vysílačů typu K1/K2, zatržítky vyberte, které z nich chcete zahrnout do přepínacího procesu. Tlačítky Vybrat vše / Zrušit celý výběr označíte / zrušíte označení všech vysílačů, tlačítkem Ok výběr potvrdíte. Seznam lze filtrovat podle verze vysílače, lze hledat vysílače s verzí firmware menší než, rovnou, větší než zadaná hodnota nebo bez omezení (any). Přepnout na telefon Aktivovat zálohování Tato dvě tlačítko realizují hlavní funkci programu. První z nich přepne vysílače na telefonní linku, druhé z nich nastaví komunikaci zálohovanou přes telefonní linku. Před spuštěním operace si program vyžádá souhlas operátora.
Po odsouhlasení se zvolená operace spustí, průběh se vypisuje u jednotlivých vysílačů v seznamu. Jakmile je přepínání zahájeno, nesmíte aplikaci ukončit - je nutno vyčkat dokončení operace. To se signalizuje vypsáním textu "Operace ukončena" ve stavovém řádku Update firmware - zobrazí se dialog pro zadání URL adresy pro stažení firmware. Dále můžete zvolit, zda se požadavek odešle SMSkou. Po potvrzení se vysílačům odešle požadavek k provedení update.
© 2013 HaSaM s.r.o.
46
Dokumentace IP serveru Reset - odešle vysílačům požadavek na restart. Nápověda - zobrazí nápovědu O aplikaci - vypíše verzi programu Seznam vysílačů Pod panelem nástrojů se zobrazuje seznam vysílačů, se kterými program pracuje. Při prvním spuštění programu je seznam prázdný. Jakmile tlačítkem Konfigurace vyberete vysílače, jejich seznam se uloží do souboru (ukládá se do adresáře, kde Phone Switcher uložen, má název switch. xml) a při příštím spuštění je program automaticky načítá. O vysílači se vypisují tyto údaje: interní ID, Objektový kód, Jméno objektu, Stav (viz dále), čas poslední komunikace s vysílačem Stavy vysílače jsou následující. Initial - tento stav se nastaví vždy při spuštění aplikace a při zahájení přepínání. Indikuje, že vysílač je v počátečním stavu a čeká na vykonání operace Querying - program zjišťuje aktuální nastavení vysílače Switching - program odeslal příkaz k přepnutí telefonní linky požadovaných způsobem a čeká na potvrzení Confirmed - přepnutí bylo úspěšně provedeno a potvrzeno Error - při operaci došlo k chybě - nepodařilo se odeslat příkaz k přepnutí linky nebo přepnutí nebylo potvrzeno WaitToSendFw - čeká se na odeslání požadavku na update firmware WaitFwResponse - čeká se, až vysílač potvrdí požadavek na update firmware WaitToReset - čeká se na odeslání požadavku na reset WaitResetResponse - čeká se, až vysílač potvrdí požadavek na reset Stavový řádek Vlevo je vypsán název serveru, kam je Phone Switcher připojen; vpravo stav připojení (Připojen / Nepřipojen /Připojuji se); uprostřed se vypisují zprávy o zahájení / ukončení operací.
© 2013 HaSaM s.r.o.