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

Czech version

 

English version

 

Dohledový systém M1 (Monitor one) společnosti 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 stavu alarm spustit externí program nebo dávku. Této funkce používá tento příklad, který spouští script switch_on.cmd při výskytu jakéhokoliv alarmu. Tento script kontroluje předanou zprávu o alarmovém stavu a pokud obsahuje řetězec (zde "Contact") zavolá utilitu PosDamIO, která zajistí vzdálené sepnutí výstupu po síti.

Download

Stáhněte si zde použité spustitelné soubory:

• Batch soubor: switch_on.cmd
• AN29: PosDamIO ovládá výstupy z příkazového řádku Download: posdam_io.zip

Postup nastavení

1) Nastavení v Monitor one

V Monitor one je nutné nejdříve vytvořit "Shooter", který bude fungovat jako spoušť alarmu.

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

• Pravým tlačítkem klikneme na Ikonku Poseidon, se kterým chceme pracovat.
• Z kontextového menu vybereme "Define Shooter (manually)"
• v MIB browseru najdeme veličinu, která nás zajímá (zde pro teplotu položka sensValue ve stromu sensEntry), na ní klikneme pravým tlačítkem a vybereme "Inspect".
  
  
• V dalším kroku vytvoříme Shooter kliknutím pravého tlačítka do prostoru vpravo, označeného jako "Shooters" a vybráním volby "Add a Shooter"
  
  
• Pro Shooter nastavíme typ Threshold (hodnota v závorce vypovídá o periodě čtení v sekundách), pojmenujeme ho (např. Contact) a uložíme tlačítkem "Save".
  
  
• Označíme ikonu symbolizující nově vytvořený Shooter levým kliknutím, v pravém okně v MIB browseru klikneme pravým tlačítkem myši na "SensValue" a vybereme "Add to the selected Shooter".
  
  
• Parametr "Instance" je poslední číslo v SNMP adrese proměnné.
  Pro Poseidon definuje pořadí senzoru ".1" pro první senzor a ".3" pro třetí sensor.
• Pro sledovaný sensor je nutné zadat prahovou hodnotu (pozor pro Poseidon vrací 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) Tvorba skriptu

Nyní napíšeme jednoduchý skript, který pokud dojde k alarmu zjistí, na kterém zařízení alarm je a pokud na něm 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 Poseidonu, na kterém je alarm a dále pak obsah chybového hlášení. V chybovém hlášení je totiž obsaženo jméno "Shooteru", který alarm vyvolal a 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

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

Pokud jste v našem příkladu pojmenovali "Shooter" jinak, je třeba nahradit jím řetězec "Contact" ve skriptu. Bližší popis lze najít v 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í..

• Nastavení chování Monitoru one při alarmu je v menu Option -> Global Configuration. V dialogovém okně vybereme záložku "Alerting" a na ní zaškrtneme volbu "Execute a program or a script".
  
  
• Klikněte na odkaz "Customize" a v dalším dialogu vybereme soubor se skriptem (switch_on.cmd) a zaškrtneme 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 a na záložce "Background Shooters" vyberte vytvořený "Shooter", klikněte na něj pravým tlačítkem a vyberte možnost "Start this Shooter..."
  

Závěr:

Otestujte nastavení vytvořením situace alarm na nastaveném sensoru, Poseidon sepne po chvíli aktivity stavu Alarm výstup. Sepnutí se projeví cvaknutím a rozsvícením ledky (Poseidon 3268).

Script se volá při každé situaci alarm, ale pokud není v popisu Alarmu uveden text "Contact", nespustí se utilita PosDamIO pro ovládání výstupu.
Vhodnou úpravou skriptu lze dosáhnout větší variability řešení, případně spínat další kontakty atp. Tato Aplikační poznámka slouží 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, což lze dobře využít k tomu, abychom sepnutý kontakt opět rozepnuli.

Nejdůležitějším krokem je nastavení Monitor one, aby nás informoval o konci alarmu. Tuto volbu najdeme v menu Option -> Global Configuration, kde v dialogovém okně vybereme záložku  "Alerting" a na ní zaškrtneme volbu "Enable Reverse alerting".

Nyní je ještě nutné patřičně upravit skript. Způsobů provedení je celá řada, jeden z nich je vidět na následující ukázce. Zdrojový soubor Switch_on_adv.cmd.

@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

 Související produkty a odkazy

• Monitor one program od firmy Fineconnection
• Ostatní "Aplikační poznámky"
  • AN29: PosDamIO ovládá výstupy z příkazového řádku
  • AN32: M1 - SMS upozornění z dohledového NMS sw
    
• Poseidon family - všechny produkty z rodiny Poseidon..
  • Poseidon model XXXX - přehled modelů
• Damocles family - všechny produkty z rodiny Damocles..
  • Damocles model XXXX - přehled modelů