PD Trigger

English version

Česká verze

Jednotky Poseidon či Damocles odesílají upozornění na stav Alarm (např. překročení hodnot teploty) přes Email nebo SNMP Trap. PD Trigger přijímá a reaguje na SNMP Trapy (rychle doručený UDP paket). Systém pravidel umožňuje nastavit reakci na jednoznačně definovaný podmět nebo Alarm. Spolupracuje s Poseidon a Damocles (přes SNMP). Pracuje jako služba (NT service), podporuje Windows 2000/XP/Vista a 2000/2003 Server. Různé reakce na stav Alarm: Varovné okno, přehrání Audio souboru, odeslání SMS, sepnutí vzdáleného výstupu, spuštění zadané aplikace NT službou / s GUI aplikace. Zabezpečení konfiguračního rozhraní heslem.

PD Trigger Flyer

Download PD Trigger

Základní parametry programu

• Kompatibilita: Podporuje všechny produkty Poseidon a Damocles (vyžaduje SNMP)
• Pravidla: Jednoduchá obsluha a tvorba pravidel prostřednictvím grafických průvodců.
  • Možnost kombinování operací zadáním více pravidel.
  • Nezávislá pravidla vykonaná při spuštění vzdáleného zařízení.
  • Nezávislá pravidla vykonaná při spuštění PD Triggeru.
  • Podpora více zařízení najednou– rozlišení vstupů alarmů na úrovni názvů senzorů/vstupů.
• Akce: Možné reakce, které lze vyvolat na základě podmínky:
  • Zobrazení varovného okna (volitelně i jako součást dalších akcí).
  • Přehrání WAV souboru systémovým přehrávačem.
  • Spuštění externí aplikace při přihlášeném uživateli.
  • Spuštění externí aplikace bez přihlášení uživatele.
  • Odeslání SMS prostřednictvím připojeného externího modemu s možností logování.
  • Sepnutí výstupů jednotek Poseidon či Damocles po ethernetu.
• Operační systémy: Windows 2000/XP/Vista/2000 a Server/2003 Server.
  • Aplikace typu klient/server pro zajištění samostatného provozu na Windows serverech.
  • Provoz jako služba (NT services) umožňuje autonomní provoz.
  • Nezávislý log systému.
• Jednoduchá instalace: Automatické nastavení Firewallu Windows XP SP2/2003 Server/Vista.
• Bezpečnost: Zabezpečení konfiguračního rozhraní heslem.

Systém pravidel

PD Trigger je aplikace vykonávající uživatelem požadované operace na základě sady pravidel definujících, za jakých okolností se má operace provést, jednotlivá pravidla lze vzájemně kombinovat.

Vlastnosti pravidel:

• Název – slouží jen pro usnadnění uživatelské správy pravidel.
• Podmínku spuštění – vlastní definice podmínky: zapnutí zařízení (definice IP adresy), alarm na vstupu či senzoru (název vstupu/senzoru). Součástí je určení provádění pravidla při zahájení či ukončení Alarmu, případně při obou stavech.
• Požadovanou akci – definice toho, co se má stát, je-li splněn filtr (zobrazení varovného okna, odeslání SMS apod.).

Pro každou akci je vyžadováno samostatné pravidlo, kromě zobrazení varovného okna, které lze zobrazit u kterékoliv akce a ovládání výstupů.

Pravidla po spušťení

PD Trigger obsahuje speciální pravidla prováděná jednorázově při:

• Pravidlo aktivováno při spuštění zařízení
• Pravidlo aktivováno při spuštění aplikace PD Trigger

Obě pravidla lze použít pro nastavení výchozích hodnot vzdálených výstupů. Pravidla vázaná na spuštění zařízení lze užít jako varování o potřebě kontroly provozního stavu monitorovaného prostředí a podobně.

Aplikace klient / server

PD Trigger funguje jako aplikace typu klient/server, kde jádrem je nainstalovaná služba (NT services) běžící na pozadí a zajišťující plynulý provoz.

Grafické rozhraní funguje jako klient připojující se ke službě a kromě konfigurace zajišťuje činnosti určené k informování uživatele o aktuálním stavu (PD Trigger Events, přehrávání zvuku).

Není-li spuštěna klientská část, neprovádí se zobrazování varovných oken. Činnost klientské části (PD Trigger Control panel) je signalizována ikonou PD Triggeru ve stavové liště vedle hodin (systray), která se v případě ztráty spojení (zastavení služby apod.) změní na přeškrtnutou.
Klientská část je spouštěna automaticky při přihlášení uživatele, případně po první instalaci ji lze spustit ručně pomocí volby START/Programy/HW group/PD Trigger/ PD Trigger Control panel.

Instalace

PD Trigger je vybaven přehledným konfigurátorem, který umožňuje rychlou a snadnou instalaci.

Vzhledem k tomu, že je třeba, aby PD Trigger komunikoval s vnějším světem, je třeba v konfiguraci Vašeho firewallu povolit spouštění služby a otevřít příslušné porty pro SNMP Trapy (typicky 162, ale může být uživatelem změněn).

V případě, že je při instalaci detekován standardní firewall ve Windows XP SP2, Windows Vista nebo Windows 2003 Server, jste dotázáni na povolení automatické změny konfigurace firewallu. Pokud souhlas udělíte, instalátor přidá službu do výjimek firewallu – jinak tak budete muset učinit sami (Program Files\HW group\PD Trigger\PD_Trigger_srv.exe).
Totéž platí v případě jiných než originálních firewallů systémů Windows (Sunbelt, ISA, Norton apod.).

PD Trigger Events

Samostatná aplikace, která se stará o zobrazování alarmových stavů na obrazovce počítače a současně slouží jako varovné okno, je-li v některém z pravidel požadováno jeho zobrazení.

Výpis obsahuje výrazné zobrazení s detailními informacemi o alarmu a současně seznam předešlých, v nichž lze snadno listovat. Vybraný řádek (alarm) je pak v detailu zobrazen ve zvýrazněné části okna.

Z aplikace lze zobrazit Logfile či vyvolat PD Trigger Configurator. Obě volby jsou praktické při ladění pravidel. Tlačítko Clear All maže všechny zaznamenané alarmy (maže pouze záznamy z PD Trigger Events, ne v Logfile).

About – o programu

Okno About je dostupné z PD Trigger Configurator, umožňuje aktivaci licenčních klíčů zvyšujících počet povolených pravidel. K aktivaci klíče je třeba být v administrátorském režimu.

Poznámka: Po aktivaci musí dojít k restartu služby i klientských aplikací – bude provedeno automaticky.

PD Trigger Configurator

PD Trigger Configurator je hlavním konfiguračním prostředím pro PD Trigger. Umožňuje definovat jednotlivá pravidla, akce a nastavení.

S výjimkou možnosti zobrazení Logfile jsou všechny ostatní volby chráněny heslem (výchozí heslo je „admin“).

General

• SNMP port – nastavuje port, na kterém bude PD Trigger naslouchat příchozím SNMP Trapům. Standardně je nastaven na 162 (port vyhrazený pro SNMP Trap), nicméně na systémech využívajících SNMP může být obsazen.
• Show This Computer Ethernet Address – vypisuje všechny IP adresy síťových rozhraní v PC/serveru, na kterém je PD Trigger spuštěn. Tato informace je důležitá pro nastavení cílových adres pro SNMP Trapy v jednotkách Poseidon a Damocles (viz Jak nastavit zařízení pro práci s PD Trigger).
• Logfile Enable – umožňuje deaktivovat záznam provozu PD Triggeru do Logfile. Standardně je volba zaškrtnuta, ale po nastavení a odladění pravidel může být v rámci úspor místa na disku deaktivována (nicméně toto důrazně nedoporučujeme).
• Help – Jednoduchá nápověda – tento text
• About – Informace o aplikaci s možností zadání licenčního klíče.
• Ztráta připojení se službou – ikona PD Triggeru. V případě ztráty spojení se službou se změní na přeškrtnutou.

Rules list

Obsahuje seznam všech definovaných pravidel s informací o jejich nastavení. K přidávání, odebírání  a editaci pravidel slouží kontextové menu, které lze vyvolat pravým tlačítkem myši nad hlavním oknem pole Rules list a příslušné volby Add rule, Remove rule a Edit rule.

Tip: Editaci již vytvořených pravidel lze aktivovat též poklepáním na příslušný řádek.

Edit Rule - vytváření a editace pravidel

Hlavní okno pro tvorbu pravidel je rozděleno na sekce:

• Condition definuje podmínky, za jakých se má pravidlo vykonat
• Action definuje akci a její parametry.
• Tips obsahuje jednoduchou nápovědu pro konkrétní editovaná pole.

Condition

Přepínač režimu – definuje, jaký charakter činnosti je sledován:

• Input/Sensor Change  - pravidlo závislé na alarmové akci.
• Run with Device Startup  - pravidlo závislé na spuštění vzdáleného zařízení.
• Run with System Startup  - pravidlo závislé na spuštění samotného PD Triggeru).

Filter – filtr podmínky pro příchozí SNMP Trapy. Trapy, které budou ve svém těle obsahovat tento výraz, budou pravidlem zpracovány.

Standardně se do pole Filter uvádí název vstupu/senzoru či jeho část, na který má pravidlo reagovat, přičemž platí klasická hvězdičková konvence, tj. symbol „*“ (smí být v řetězci obsažen pouze jednou) nahrazuje libovolný počet jakýchkoliv znaků a symbol „?“ nahrazuje jeden libovolný znak.

Příklad: 
* 12      = Binary 12, Sensor 12, Output 12,... 
Sen??r*1  = Sensor 1, Sensor_1, Sensor1, SenSOry#+1,...
Out*      = Output 12, Out1, Output_1

Podmínka Run with Device Startup reaguje na SNMP Trap, který posílá zařízení po startu napájení. Filtr identifikuje zařízení pomocí jeho IP adresy, ve filtru lze opět lze použít hvězdičkovou konvenci (smí být v řetězci obsažena pouze jednou) jako „masku“ :
192.168.1.99  = only 192.168.1.99 
192.168.1.*   = 192.168.1.1, 192.168.1.99, 192.168.1.100, ... 
192.168.1.??  = 192.168.1.10, 192.168.1.98, 192.168.1.99,... 

Alarm Edge – Definuje, zda má být pravidlo spouštěno pouze při zahájení alarmu (Alarm start), pouze při ukončení alarmu (Alarm stop) nebo při obou stavech (Alarm start&stop).

 

Action

Sekce nastavuje akce a jejich parametry s možností jejich otestování.

Action Type – je klíčovou volbou prováděného typu akce. V závislosti na této volbě se mění nadpis proměnného pole, který akci definuje.

• None – volba je určena k deaktivaci sekce v případě, kdy má být pouze zobrazeno varovné okno. Výběrem této akce se automaticky zaškrtne pole Show Message Box.
• Output – volba umožňuje ovládat výstupy jednotek Poseidon (modely vybavené výstupy) a Damocles.
  Výběr cílového zařízení včetně výstupu je rovněž možný pomocí grafického průvodce – viz popis Output Action Wizard.
  Proměnné pole Command slouží k zadání řádkového příkazu pro ovládání výstupů ve formátu:
  [username:password@]ip_address:port;output_id=command
  kde output_id je ID výstupu v rozsahu 151 až 214 a command je jedna z hodnot:
  • 1 - sepnout výstup.
  • 0 – vypnout výstup.
  • X -  sepnout výstup po dobu, kdy je alarm aktivní.
  • !  - vypnout výstup po skončení alarmu.
    
    Příklad:
    192.168.1.99:80;151=0
    john:johnpass@192.168.1.67:80;151=!
    
    
• Sound – volba umožňující přehrání vybraného zvuku ve formátu WAV. Kliknutím na tlačítko procházení lze nalistovat požadovaný soubor (standardně je výchozí složkou %SystemRoot%\Media).
  
• Run by Service – spuštění externí aplikace službou – používá se při spouštění aplikací především na Windows Serverech resp. v případě, kdy je třeba start i bez přihlášeného uživatele či bez požadavku na spuštění grafického rozhraní. Cestu k programu lze zadat buď ručně, nebo nalistovat v systému. Řádek Parameters umožňuje definovat parametry spouštění aplikace – více viz Parametry spouštěných aplikací.
  
  Pozor, bezpečnostní riziko: Aplikace je spuštěna se stejnými právy, jako má NT service.
   
• Run Application – Spouštění externí aplikace s požadavkem na zobrazení jejího grafického rozhraní. Vyžaduje přihlášení uživatele. Cestu k programu lze zadat buď ručně, nebo nalistovat v systému. Řádek Parameters umožňuje definovat parametry spouštění aplikace – více viz Parametry spouštěných aplikací.
  
• Send SMS – Možnost odeslání SMS přes externí modem ModemCom/G10. V podstatě se jedná o spouštění externí aplikace sms_send.exe, přičemž do textu SMS lze vkládat pomocí maker hodnoty získané ze SNMP Trapů (viz Makra). Příklad parametrů:
  -d COM1 -n 777456789 -m "PDT: %NAME% = %VALUE%"
  Význam jednotlivých parametrů (lze uplatnit grafický konfigurátor – viz Send SMS Action Wizard):
  • -d         COM port, ke kterému je modem připojen.
  • -n         Telefonní číslo, na které se SMS posílá.
  • -m        Text zprávy, v němž lze uplatnit proměnné z přijatého trapu (viz Makra).

Poznámka: Volby Run Application a Sound lze aplikovat pouze při spuštěném PD Trigger Control panel (při přihlášeném uživateli).

Ostatní možnosti a nastavení

Makra

Makra jsou proměnné, jejichž použitím lze do parametrů spouštění aplikací či do SMS zpráv vkládat hodnoty získané z alarmových SNMP Trapů.

• %COND%, - vybraná podmínka,
• %IP%, - IP adresa zařízení,
• %NAME%, - název senzoru/vstupu,
• %VALUE% - hodnota senzoru/vstupu,
• %STATE% - aktuální stav (Alarm).

Output Action Wizard

Grafické rozhraní usnadňující nastavení reakce výstupů. Výstupem je zápis umožňující ovládat konkrétní výstup (např. 192.168.1.99:80;151=0).
Průvodce umožňuje vyhledat požadované zařízení a jeho výstup a nastavit požadavky na stav tohoto výstupu.

Klikňete na tlačítko procházení vedle řádku Commands v případě, že je jako Type Action vybrán Output. Po spuštění průvodce vyhledají zařízení HW group, výsledek je zobrazen v okně Device List. U všech zařízení se stáhne konfigurační soubor (setup.xml) se seznamem vstupů a senzorů, ale především výstupů.

Vybráním požadovaného výstupu se sekce Device Details změní na Output Details s uvedením názvu výstupu a jeho ID.

Vyberte v sekci Output Action akci:

• Set to Off – nastaví výstup do klidového stavu (parametr Command=0).
• Set to On – Sepne výstup (parametr Command=1).
• Set to On when alarm is active – Sepne výstup po dobu, kdy je příslušný alarm aktivní (parametr Command=X).
• Set to OFF when alarm is active - Rozepne výstup po dobu, kdy je příslušný alarm aktivní (parametr Command=!).

Je-li nastavení chráněno uživatelským jménem a heslem, vyzve průvodce k jeho zadání a následně je doplní do příkazu.

Send SMS Action Wizard

Umožňuje ručně nastavit parametry pro odesílání SMS.

• Serial Port  - Číslo portu COM, na kterém se modem nachází.
• Target Number – cílové telefonní číslo, na které má být SMS zaslána.
• Text – Text SMS zprávy s možností aplikace maker (viz výše). Makra lze snadno vložit do zprávy z kontextového menu, které se vyvolá pravým tlačítkem nad textem zprávy nebo klávesovou zkratkou :
  • CTRL+C - Insert Condition Name (%COND%).
  • CTRL+N - Insert Sensor Name (%NAME%).
  • CTRL+I - Insert IP Adress (%IP%).
  • CRTL+V  - Insert Sensor Value (%VALUE%).
  • CTRL+S Insert Sensor State (%STATE%).
• Log File Enable – zapíná/vypíná logování obsluhy modemu. Modem využívá nezávislý soubor pro záznam své činnosti, který je standardně uložen na „C:\Program Files\HW group\PD Trigger\sms_sender.log“ .
• FileName – umožňuje změnit umístění LOG souboru či jeho zobrazení.

Parametry spouštěných aplikací

PD Trigger umožňuje spouštět externí aplikace s pomocí jejich parametrů, případně do parametrů vkládat pomocí maker hodnoty získané z trapů, jako jsou IP adresa zařízení či hodnota senzoru. Podmínkou je, aby aplikace umožňovala spouštění z příkazové řádky. Popis parametrů se liší podle konkrétní aplikace, ale obvykle jej lze vypsat pomocí spuštění aplikace s parametrem /H nebo /?.

PD Trigger + Poseidon a Damocles

Aby mohly jednotky Poseidon a Damocles spolupracovat s aplikací PD Trigger, je třeba v jejich konfiguraci správně nastavit parametry pro SNMP Trapy. Vzhledem k tomu, že konfigurace je podrobně popsána v manuálech od těchto zařízení, popíšeme pouze nastavení klíčových parametrů.

Poznámka: Následující řádky platí pouze v případě, že se jednotky Poseidon a Damocles nacházejí ve stejné síti jako počítač s PD Triggerem, případně je-li tento počítač na veřejné IP adrese!

Poseidon

Otevřete konfigurační FLASH rozhraní jednotky Poseidon na záložce SNMP Setup. Zde máte možnost definovat až dvě cílové destinace pro SNMP Trapy:

• Do pole IP Adress vepíšete IP adresu vyčtenou ze sekce General v PD Trigger Configurator.
• Položka Port musí obsahovat stejnou hodnotu jako stejné pole v PD Trigger Configurator.
• Zapněte volbu Enable, která aktivuje odesílání základních SNMP Trapů (zapnutí či reset zařízení).
• Na záložce Sensors zaškrtněte u příslušných senzorů, u kterých chcete sledovat alarmové stavy pomocí PD Trigger, políčko Out of Safe Range SNMP Trap. Chcete-li sledovat též binární vstupy, nastavte Dry Contact Inputs state reaction na Send SNMP Trap, případně Send SNMP Trap + SMS& Email a nastavte, kdy na příslušném vstupu je alarmový stav.

Damocles

V jednotkách Damocles se opět vše nastavuje pomocí rozhraní FLASH, nicméně tentokrát vše na jednom místě – na záložce Alarms.

Způsob nastavení v případě, že cílový server/počítač není na veřejné adrese, je stejný, jen jako IP adresa musí být nastavena vnější adresa internetové brány, která je z pohledu každé sítě jedinečná. Navíc je třeba nastavit směrování packetů na správný počítač, proto se obraťte na Vašeho správce sítě, který Vám s konfigurací poradí.

Objednací čísla

Download

• Download PD Trigger.zip
• PD Trigger Flyer