M1 - sepnutí vzdáleného relé při alarmu z NMS programu

Monitorovací systém M1 (Monitor one) od FineConnection je určen k monitorování stavu sítě a síťové infrastruktury. Produkty z rodiny Poseidon jsou do programu Monitor one plně integrovány.

Při monitorování prostředí se může objevit požadavek na sepnutí kontaktu (zapnutí sirény, majáku apod.), pokud některá z měřených veličin překročí stanovenou hodnotu.

Monitor one umožňuje při vzniku alarmového stavu spustit externí program nebo dávku. Této funkce používá tento příklad, který spouští skript switch_on.cmd při výskytu jakéhokoliv upozornění (alarmu). Tento skript kontroluje předanou zprávu o alarmovém stavu, a pokud obsahuje daný řetězec (zde „Contact“), zavolá utilitu PosDamIO, která zajistí vzdálené sepnutí výstupu po síti.

Postup nastavení

1) Konfigurace Monitor one

V Monitor one je nutné nejdříve vytvořit „Shooter“, který bude spouštět alarm.

Postup vytvoření „Shooter“ je následující:

• Pravým tlačítkem myši klikněte na ikonu zařízení Poseidon, s kterým chcete pracovat.
• Z kontextové nabídky vyberte volbu „Define Shooter (manually)“.
• V MIB browseru najděte veličinu, která vás zajímá (v tomto příkladu uvažujme teplotu, kterou reprezentuje položka sensValue ve stromu sensEntry), klikněte na ni pravým tlačítkem myši a vyberte „Inspect“.
  
  
  
  
  
  
   
• V dalším kroku vytvořte „Shooter“, a to kliknutím pravým tlačítkem myši na oblast „Shooters“ na pravé straně a výběrem volby „Add a Shooter“.
  
  
  
  
  
  
  
  
  
  
   
• Nastavte typ na „Threshold“ (hodnota v závorkách odpovídá periodě čtení v sekundách), pojmenujte jej (např. Contact) a kliknutím na tlačítko „Save“ jej uložte.
  
  
  
  
  
  
  
  
  
  
   
• Kliknutím vyberte ikonu označující nově vytvořený „Shooter“, v pravém okně MIB browseru klikněte pravým tlačítkem myši na „SensValue“ a vyberte „Add to the selected Shooter“.
  
  
  
  
  
  
  
  
  
  
   
• Parametr „Instance“ je poslední číslo v SNMP adrese proměnné.
  Produkty Poseidon používají pořadí senzoru – ".1" pro první senzor, ".3" pro třetí senzor.
• Pro sledovaný senzor je třeba zadat prahovou hodnotu (pozor, Poseidon vrací v proměnné sensValue teplotu ve °C vynásobenou 10) a operátor.
• Po uložení Shooteru tlačítkem „Add/Modify“ je možné okno MIB browseru zavřít.

2) Vytvoření skriptu

Nyní napíšeme jednoduchý skript, který v případě alarmu zjistí, na kterém zařízení alarm je, a pokud chceme sepnout kontakt, tak jej sepne.

Monitor one umí skriptu předat několik parametrů. Nás v tomto případě zajímá IP adresa zařízení Poseidon, na kterém se alarm vyskytl, a obsah chybového hlášení. V chybovém hlášení je totiž obsažen název „Shooteru“, který alarm vyvolal. Pomocí něj pak filtrujeme požadavky na sepnutí kontaktu.

Skript může mít následující podobu:

@echo off
set IP=%1
set MESSAGE=%2
echo %MESSAGE% | find /C "Contact"
echo %ERRORLEVEL%
if %ERRORLEVEL% EQU 0 posdamio.exe -o 1=ON %IP%
goto eof
:eof

Uložte skript s příponou .cmd. Pro fungování skriptu je nutné, aby program PosDamIO.exe byl ve stejném adresáři jako skript.

Pokud jste pojmenovali „Shooter“ jinak, je třeba tento název použít místo řetězce „Contact“ ve skriptu. Více informací viz AN29: PosDamIO ovládá výstupy z příkazového řádku. Úpravou skriptu lze dosáhnout i filtrování podle jména zařízení nebo spínání jiných kontaktů při alarmu z jiného „Shooteru“.

3) Aktivace „Shooteru“ v Monitor one

Nyní zbývá nastavit spouštění skriptu a spustit "Shooter" pro dané zařízení.

• Chování programu Monitor one se nastavuje v nabídce Option -> Global Configuration. V dialogovém okně vyberte kartu „Alerting“ a na ní zaškrtněte volbu „Execute a program or a script“.
  
  
  
  
  
  
  
  
  
  
   
• Klikněte na odkaz „Customize“. V následujícím dialogovém okně vyberte soubor se skriptem (switch_on.cmd) a zaškrtněte políčka „4 IP address“ a „5 Event Message“.
• Zavřete dialogová okna a vraťte se zpět na mapu sítě.
  
  
  
  
  
  
  
  
  
   
• Klikněte levým tlačítkem na ikonu Poseidon, na kartě „Background Shooters“ vyberte vytvořený „Shooter“, klikněte na něj pravým tlačítkem myši a vyberte volbu „Start this Shooter...“.

Závěr:

Zkontrolujte nastavení tak, že na nastaveném senzoru přivodíte nějakou alarmovou situaci. Po krátké době Poseidon aktivuje příslušný výstup. Sepnutí kontaktu se projeví cvaknutím a rozsvícením LED (Poseidon 3268).

Skript se volá při každé alarmové situaci. Pokud však v popisu alarmu není uveden text „Contact“, utilita PosDamIO pro ovládání výstupu se nespustí.
Vhodnou úpravou skriptu lze dosáhnout větší variability řešení, případně spínat další kontakty atp. To je však nad rámec této aplikační poznámky, která má sloužit spíše k naznačení možného postupu při řešení podobných úkolů.

Poznámka:

Monitor one umí reagovat kromě počátku alarmu i na jeho konec. To lze dobře využít k tomu, abychom sepnutý kontakt opět rozepnuli.

Nejdůležitějším krokem je nastavení Monitor one, aby informoval o konci alarmu. Tato volba je v nabídce Option -> Global Configuration. V dialogovém okně vyberte kartu „Alerting“ a na ní zaškrtněte volbu „Enable Reverse alerting“. Nyní je ještě nutné patřičně upravit skript. To lze udělat mnoha způsoby, jeden z nich následuje. @echo off set IP=%1 set MESSAGE=%2 echo %MESSAGE% | find /C "normal" if %ERRORLEVEL% EQU 0 (call :SetOFF) else (call :SetON) goto eof :SetON echo %MESSAGE% | find /C "Contact" if %ERRORLEVEL% EQU 0 posdamio.exe -o 1=ON %IP% goto eof :SetOFF echo %MESSAGE% | find /C "Contact" if %ERRORLEVEL% EQU 0 posdamio.exe -o 1=OFF %IP% goto eof :eof