AN11 SNMP dohled a řízení napájecích výstupů 110/230V z CMD (command line) pro Windows a Linux

Podporovaná zařízení:

• NETIO PowerBOX 3Px
• NETIO PowerBOX 4Kx
• NETIO PowerCable REST 101x
• NETIO PowerDIN 4PZ
• NETIO PowerPDU 4C (zde se může implementace mírně lišit)
• NETIO PowerPDU 4PS
• NETIO PowerPDU 8QS

Pomocí SNMP protokolu lze zjišťovat stav jednotlivých zásuvek, měřit aktuální spotřebu nebo ovládat jednotlivé výstupy. SNMP je standardní protokol pro mnoho dohledových software aplikací třetích stran.

Zařízení NETIO používají pro komunikaci po SNMP výchozí port 161. Soubor MIB s popisem objektů je možné stáhnout z webové administrace v nastavení protokolu SNMP.

Linux:
Pro SNMP komunikaci z Linux lze využít např. utilitu snmpwalk, snmpget či snmpset z balíčku snmp (http://www.net-snmp.org/) - stručný návod na instalaci naleznete na konci tohoto dokumentu v kapitole “Instalace Net-SNMP utility pro Linux”.

Windows:
Pro SNMP komunikaci ve Windows lze použít např. utilit SnmpWalk, SnmpGet či SnmpSet od EZ5 Systems (https://ezfive.com/snmpsoft-tools). Utility je možné použít zdarma pro nekomerční použití.

Příklady použití

• Vzdálený dohled nad stavem zásuvek
• Ovládání zásuvek ze vzdáleného počítače

Pro ovládání (zápis)

* pokud byla zásuvky vypnutá, bude po provedení příkazu zapnutá

** pokud byla zásuvky zapnutá, bude po provedení příkazu vypnutá

Příklady

SET 1.3.6.1.4.1.47952.1.1.1.5.2.0 = 1           Output 2 = ON

SET 1.3.6.1.4.1.47952.1.1.1.5.1.0 = 4           Přepni Output 1

SET 1.3.6.1.4.1.47952.1.1.1.5.8.0 = 0           Output 8 = OFF

Příklady použití SNMP v1/v2c

iReasoning MIB Browser

Níže je uveden příklad použití SNMP v nástroji MIB Browser od společnosti iReasoning
Software je volně ke stažení pro ne komerční použit na https://ireasoning.com/mibbrowser.shtml.

Zobrazení stromové struktury SNMP protokolu pro NETIO zařízení

Načtením MIB souboru (ke stažení ve webové konfiguraci NETIO zařízení - protokol SNMP) lze zobrazit stromovou strukturu, která je rozdělena do 3 částí:

• netioOutputTable - obsahuje informace ohledně výstupů (názevy, akce, meření apod)
• netioGlobalMeasure - obsahuje měření pro celé zařízení (relevantní pouze pro zařízení s měřením, ostatní obsahují nulové hodnoty)
• netioInputTable - obsahuje informace k výstupům

Čtení a zapisování údajů pro konkrétní zařízení

Informace pro založení nového zařízení (agenta) nalezneme opět ve webové konfiguraci NETIO zařízení. Nastavujeme následující:

• Port - je vždy 161
• Read Community - řetězec (ověření) pro čtení
• Write Community - řetězec (ověření) pro zápis
• SNMP version - 1 nebo 2

Samotné provádění SNMP příkazů je realizováno přes zadání OID (předvyplní se kliknutím na strukturu MIB). V případě SNMP SET se následně zadává příslušný datový typ a posílaná hodnota).

1.   Vypsání všech stavů/hodnot (SNMP v1 / v2c - snmpwalk)

Linux - s využitím MIB

snmpwalk -m <jméno NETIO MIB> [volitelně -M <cesta k MIB>] -v <verze SNMP: 1 nebo 2c> -c <Comunity> <IP adresa NETIO> <specifikace stromu: NETIOProducts>

příklad: snmpwalk -v2c -m NETIO-PRODUCTS-NETIO-MIB -c public 192.168.101.115 NETIOProducts

Pokud jsou MIB uloženy v jiném než jednom z výchozích adresářů (viz výše v úvodu), je třeba uvést i paramatr -M s cestou. Např.:snmpwalk -m NETIO-PRODUCTS-NETIO-MIB -M /usr/share/snmp/mibs/ -v 2c -c public 192.168.101.115 NETIOProducts

Windows

SnmpWalk.exe -r:<IP adresa NETIO> -v:<verze SNMP: 1 nebo 2c> -c:<Community>

Příklad:
SnmpWalk.exe -r:192.168.101.180 -v:1 -c:"public"
nebo
SnmpWalk.exe -r:192.168.101.180 -c:"public"

Obdobně můžeme použít i pro SNMP v2c:
SnmpWalk.exe -r:192.168.101.180 -v:2c -c:"public"

Zápis hodnoty (stav výstupu) pomocí SNMP v1, 2c

Linux - s využitím MIB a jména objektu

snmpset -m <jméno NETIO MIB> [volitelně -M <cesta k MIB>] -v <verze SNMP: 1 (2c)>  -c <Community> <Objekt pro zápis dle tabulky výše> <odpovídající Typ> <Hodnota>

Příklad pro zapnutí zásuvky číslo 1:
snmpset -m NETIO-PRODUCTS-NETIO-MIB -v 1 -c private 192.168.101.159 netioOutputAction.1.0 i 1

Pokud jsou MIB uloženy v jiném než jednom z výchozích adresářů (viz výše v úvodu), je třeba uvést i parametr -M s cestou k souboru:
snmpset -m NETIO-PRODUCTS-NETIO-MIB -M /usr/share/snmp/mibs/  -v 3 -a SHA -A netiopass -l authPriv -u netio -x AES -X netiopass 192.168.101.159 netioOutputAction.1.0 i 1

Linux - s využitím OID

snmpset -v <verze SNMP: 1 (2c)>  -c <Community> <Objekt pro zápis dle tabulky výše> <odpovídající Typ> <Hodnota>

Příklad pro zapnutí zásuvky číslo 1:
snmpset -v 1 -c private 192.168.101.159 1.3.6.1.4.1.47952.1.1.1.5.1.0 i 1

Windows

SnmpSet.exe -r:<IP adresa NETIO> -v:<verze SNMP: 1 (2c)> -c:<Community> -o:<OID pro čtení dle tabulky výše> -val:<Hodnota> -tp:<odpovídající Typ>

Příklad pro zapnutí zásuvky číslo 1:
SnmpSet.exe -r:192.168.101.159 -v:1 -c:private -o:1.3.6.1.4.1.47952.1.1.1.5.1.0 -val:1 -tp:int

FAQ:

1) Proč nedoporučujeme ovládat zásuvky pomocí SNMP v1 / v2c?

SNMP v1 a v2c nepoužívají autorizaci. Zápis pomocí tohoto protokolu tak není nijak zabezpečen. Nelze tedy zajistit přístup k ovládání pouze pro oprávněné zařízení/software/systém. Pro čtení, lze použít SNMP v1 / v2c, nicméně pro zápis (ovládání výstupů) striktně doporučujeme SNMP v3.

Ovládání pomocí SNMP v3 popisujeme v následujícím článku:  >> AN59 Ovládání PDU výstupů přes SNMPv3 (Win a Linux CMD)

2) Jaký port používá SNMP a lze ho případně změnit?

Protokol SNMP v1, 2c používá pro komunikaci port 161. Tento port aktuálně měnit nelze.