APLIKAČNÍ PŘÍRUČKA
Použité symboly Danger Důležité upozornění, které může mít vliv na bezpečí osoby nebo funkčnost přístroje. Attention Upozornění na možné problémy, ke kterým může dojít ve specifických případech. Information, notice Informace, které obsahují užitečné rady, nebo zajímavé poznámky. Example Příklad funkce, příkazu nebo skriptu. Open Source softwarové licence Software v tomto zařízení používá části open source software pod různými licencemi: GPL verze 2 a 3, LGPL verze 2, licence ve stylu BSD, licence ve stylu MIT. Seznam komponent spolu s plnými texty licencí je přístupný v samotném zařízení: Viz odkaz Licenses dole na hlavní stránce webového rozhraní routeru (General Status) nebo navštívením adresy IP_adresa_zařízení/licenses.cgi. V případě zájmu o zdrojové kódy nás kontaktujte na adrese: techsupport@advantech-bb.com Modifikace a debugování spustitelných programů využívajících knihovny LGPL: Výrobce zařízení tímto deklaruje právo použít pro vlastní potřebu debugovací techniky (např. dekompilaci) a provést uživatelské úpravy pouze těch spustitelných programů, které využívají knihovny pod licencí LGPL. Toto může být provedeno pouze pro osobní použití zákazníka. Není povolena žádná distribuce takto upravených programů, ani žádné předávání informací získaných během modifikace programů. Advantech B+B SmartWorx s.r.o., Sokolská 71, 562 04 Ústi nad Orlicí, Česká Republika Dokument č. APP-0010-CZ, revidován 27. února 2018. Vydáno v České republice. i
Obsah 1 Základní vlastnosti a MIB soubory 1 1.1 Stromová struktura.................................. 1 1.2 System........................................ 2 1.3 Interfaces....................................... 3 1.4 IP........................................... 3 1.5 ICMP......................................... 5 1.6 TCP.......................................... 7 1.7 UDP.......................................... 8 2 Privátní strom routery Advantech 9 2.1 Products........................................ 9 2.2 Protocols....................................... 10 2.2.1 XC-CNT.................................... 10 2.2.2 M-BUS.................................... 11 2.2.3 I/O vstupy a výstupy............................. 12 2.3 Status......................................... 12 2.4 Mobile......................................... 13 2.5 Mobile-2........................................ 14 2.5.1 MobileToday................................. 14 2.5.2 MobileYesterday............................... 15 2.5.3 MobileThisWeek............................... 15 2.5.4 MobileLastWeek............................... 15 2.5.5 MobileThisPeriod............................... 15 2.5.6 MobileLastPeriod............................... 15 2.6 Info........................................... 16 2.7 GPS.......................................... 16 3 OID posílané v SNMP trapu 18 4 Příklad nastavení a vyčtení SNMP 20 5 Doporučená literatura 22 ii
Seznam obrázků 1 Základní struktura.................................. 1 2 Privátní OID strom pro routery Advantech strom conel............. 9 3 Příklad SNMP konfigurace.............................. 20 4 Příklad MIB prohlížeče................................ 21 Seznam tabulek 1 Základní skupiny mgmt............................... 2 2 System........................................ 2 3 Interfaces....................................... 3 4 IP........................................... 5 5 ICMP......................................... 6 6 TCP.......................................... 7 7 UDP.......................................... 8 8 Products OID..................................... 10 9 OID pro XC-CNT................................... 11 10 OID pro M-BUS.................................... 11 11 OID pro I/O vstupy a výstupy............................ 12 12 Status OID...................................... 12 13 Mobile OID...................................... 13 14 Mobile Technology hodnoty............................ 14 15 MobileToday OID................................... 15 16 Info OID........................................ 16 17 GPS OID....................................... 17 iii
1. Základní vlastnosti a MIB soubory OID (Object Identifier) je označení pro číselný identifikátor, díky kterému je každá hodnota v SNMP jednoznačně identifikována. OID je tvořeno posloupností čísel oddělených tečkou. Tvar každého OID je dán hodnotou identifikátoru nadřazeného prvku, jež je doplněna o tečku a aktuální číslo. Je tedy patrné, že vzniká stromová struktura. Ta je ukládána do MIB databází (Management Information Base), které obsahují také jména a popisy jednotlivých číselných identifikátorů. Informace o routeru jsou dostupné v částech mgmt a private OID stromu. Strom private pro routery Advantech je definovám MIB soubory, které jsou veřejně dostupné v repozitáři zde: https://bitbucket.org/bbsmartworx/snmp-mib/ (vyžaduje moduly RFC1155-SMI a RFC-1212). Soubory v repozitáři jsou aktuální a směrodatné, jsou čitelné jakýmkoli SNMP MIB browserem a mohou být analyzovány pro přesné informace např. o datových typech jednotlivých OID apod. SNMP v1/v2 nebo v3 je podporováno. Všechny SNMP hodnoty lze pouze vyčítat (read-only), až na binární výstupy: ioout0 (.1.3.6.1.4.1.30140.2.3.2.0) a xccntout1 (.1.3.6.1.4.1.30140.2.1.9.0). Tyto dvě OID lze pomocí SNMP nastavovat (read-write) dle nastavení skupiny write (viz konfigurační stránka SNMP v routeru). 1.1 Stromová struktura Na následujícím obrázku je znázorněna základní stromová struktura, na jejímž základě jednotlivá OID vznikají: Obrázek 1: Základní struktura 1
Položka mgmt se ve standardní MIB tabulce dále dělí na tyto skupiny: OID Jméno skupiny Poznámka.1.3.6.1.2.1.1 system Více lze nalézt v sekci 1.2.1.3.6.1.2.1.2 interfaces Více lze nalézt v sekci 1.3.1.3.6.1.2.1.3 at Není podporováno routery Advantech.1.3.6.1.2.1.4 ip Více lze nalézt v sekci 1.4.1.3.6.1.2.1.5 icmp Více lze nalézt v sekci 1.5.1.3.6.1.2.1.6 tcp Více lze nalézt v sekci 1.6.1.3.6.1.2.1.7 udp Více lze nalézt v sekci 1.7.1.3.6.1.2.1.8 egp Není podporováno routery Advantech.1.3.6.1.2.1.9 transmission Není podporováno routery Advantech.1.3.6.1.2.1.10 snmp Není podporováno routery Advantech Tabulka 1: Základní skupiny mgmt 1.2 System OID Objekt Popis.1.3.6.1.2.1.1.1 sysdescr Textový popis zařízení jméno a verze firmware v případě Advantech routeru..1.3.6.1.2.1.1.2 sysobjectid Identifikace subsystému pro správu sítě. Obsahuje OID typu produktu dle tabulky 8..1.3.6.1.2.1.1.3 sysuptime Čas (v setinách sekund) od okamžiku, kdy byla v systému provedena poslední inicializace (tzn. doba spuštění)..1.3.6.1.2.1.1.4 syscontact Uchovává kontaktní informace dle konfigurace v routeru (Stránka Services, SNMP). Nejsou-li známy, hodnota je řetězec nulové délky..1.3.6.1.2.1.1.5 sysname Jméno systému dle nastavení SNMP. Není-li známo, řetězec nulové délky..1.3.6.1.2.1.1.6 syslocation Fyzické umístění dle nastavení SNMP. Není-li umístění známo, řetězec nulové délky..1.3.6.1.2.1.1.7 sysservices Hodnota označující soubor služeb, které jsou k dispozici. Hodnota 4 pro routery Advantech. Tabulka 2: System 2
1.3 Interfaces OID Tabulka Popis.1.3.6.1.2.1.2.1 ifnumber Počet sít ových rozhraní (bez ohledu na jejich aktuální stav).1.3.6.1.2.1.2.2 iftable Jednotlivé položky. Tabulka s podorbnými informacemi pro každé rozhraní. Počet tabulek je dán hodnotou ifnumber. Tabulka 3: Interfaces iftable je nadřazený prvek pro skupinu ifentry (OID.1.3.6.1.2.1.2.2.1), do níž spadají skalární objekty, které uchovávají informace vztahující se ke konkrétnímu rozhraní. Pozor: Ne všechna rozhraní routeru jsou dostupná zde přes SNMP! Dostupné je pouze první Ethernetové rozhraní a rozhraní mobilního připojení. 1.4 IP OID Objekt Popis.1.3.6.1.2.1.4.1 ipforwarding Údaj o tom, zda se router tváří jako brána (IP gateway) v souvislosti s přeposíláním přijatých paketů (nejsou adresované tomuto routeru)..1.3.6.1.2.1.4.2 ipdefaultttl Defaultní hodnota položky TTL (Time-To-Live) v hlavičce IP paketu. Platí vždy, když hodnota není poskytována transportní vrstvou..1.3.6.1.2.1.4.3 ipinreceives Celkový počet přijatých paketů včetně těch, jež byly přijaty omylem..1.3.6.1.2.1.4.4 ipinhdrerrors Celkový počet příchozích paketů zahozených kvůli chybám v jejich IP hlavičkách, což zahrnuje špatné kontrolní součty, neshodu v číselném značení verze,....1.3.6.1.2.1.4.5 ipinaddrerrors Počet příchozích paketů zahozených z důvodu neplatné adresy v příslušné položce IP hlavičky..1.3.6.1.2.1.4.6 ipforwdatagrams Počet příchozích paketů, pro které tento router nebyl cílovou adresou. V důsledku toho byl proveden pokus najít cestu pro přeposlání paketů na cílovou adresu..1.3.6.1.2.1.4.7 ipinunknownprotos Počet úspěšně přijatých paketů, které však byly zahozeny z důvodu neznámého nebo nepodporovaného protokolu. Pokračování na následující straně 3
Pokračování z předchozí strany OID Objekt Popis.1.3.6.1.2.1.4.8 ipindiscards Počet příchozích paketů, u nichž se nevyskytly žádné problémy, které by zamezily zpracování, ale přesto byly tyto pakety zahozeny (např. kvůli nedostatku vyrovnávací paměti)..1.3.6.1.2.1.4.9 ipindelivers Celkový počet příchozích paketů úspěšně doručených do IP uživatelských protokolů (včetně ICMP)..1.3.6.1.2.1.4.10 ipoutrequests Celkový počet paketů, které lokalní IP uživ. protokoly (včetně ICMP) dodaly do IP s žádostí o přenos. Tento čítač nezahrnuje pakety obsažené v ipforwdatagrams..1.3.6.1.2.1.4.11 ipoutdiscards Počet odchozích paketů, u kterých nebyl zjištěn žádný problém s odesláním na cílovou adresu a přesto byly zahozeny (např. kvůli nedostatku vyrovnávací paměti). Tento čítač může zahrnovat také pakety započítané v ipforwdatagrams, pokud splní dané kritérium..1.3.6.1.2.1.4.12 ipoutnoroutes Počet zahozených paketů, u kterých nemohla být nalezena cesta k cílové adrese. Tento čítač zahrnuje také pakety započítané v ipforwdatagrams (splňují kritérium žádné cesty )..1.3.6.1.2.1.4.13 ipreasmtimeout Maximální počet sekund, po které jsou pozdrženy fragmenty čekající nové přeskupení..1.3.6.1.2.1.4.14 ipreasmreqds Počet IP fragmentů potřebných pro nové přeskupení..1.3.6.1.2.1.4.15 ipreasmoks Počet úspěšně přeskupených paketů..1.3.6.1.2.1.4.16 ipreasmfails Počet chyb detekovaný algoritmem využívaným pro přeskupení (důdem může být časový limit apod.)..1.3.6.1.2.1.4.17 ipfragoks Počet paketů, které byly úspěšně fragmentovány..1.3.6.1.2.1.4.18 ipfragfails Počet paketů, které byly zahozeny, protože je bylo nutné fragmentovat, ale nemohly být (fragmentovány)..1.3.6.1.2.1.4.19 ipfragcreates Počet fragmentů paketu, které vznikly při fragmentaci. Pokračování na následující straně 4
Pokračování z předchozí strany OID Objekt Popis.1.3.6.1.2.1.4.20 ipaddrtable Není podporováno routery Advantech..1.3.6.1.2.1.4.21 iproutetable Není podporováno routery Advantech..1.3.6.1.2.1.4.22 ipnettomediatable Není podporováno routery Advantech..1.3.6.1.2.1.4.23 iproutingdiscards Není podporováno routery Advantech. Tabulka 4: IP 1.5 ICMP OID Objekt Popis.1.3.6.1.2.1.5.1 icmpinmsgs Celkový počet přijatých ICMP zpráv. Zahrnuty jsou také zprávy z icmpinerrors..1.3.6.1.2.1.5.2 icmpinerrors Počet přijatých ICMP zpráv, které jsou označeny za chybné špatný ICMP kontrolní součet, špatná délka apod..1.3.6.1.2.1.5.3 icmpindestunreachs Počet přijatých zpráv typu ICMP Destination Unreachable (nedosažitelnost cíle)..1.3.6.1.2.1.5.4 icmpintimeexcds Počet přijatých ICMP Time Exceeded zpráv (překročení času)..1.3.6.1.2.1.5.5 icmpinparmprobs Počet přijatých ICMP Parameter Problem zpráv (problémy s parametrem)..1.3.6.1.2.1.5.6 icmpinsrcquenchs Počet přijatých ICMP Source Quench zpráv (tj. zpráv s požadavky na snížení frekvence odesílání)..1.3.6.1.2.1.5.7 icmpinredirects Počet přijatých ICMP Redirect zpráv (přesměrování paketů na alternativní trasu)..1.3.6.1.2.1.5.8 icmpinechos Počet přijatých ICMP Echo zpráv (požadavky na odeslání Echo Reply zpráv)..1.3.6.1.2.1.5.9 icmpinechoreps Počet přijatých ICMP Echo Reply zpráv (odpovědi na Echo zprávy)..1.3.6.1.2.1.5.10 icmpintimestamps Počet přijatých ICMP Timestamp zpráv (tj. požadavky na synchronizaci času)..1.3.6.1.2.1.5.11 icmpintimestampreps Počet přijatých ICMP Timestamp Reply zpráv (odpovědi na Timestamp zprávy).1.3.6.1.2.1.5.12 icmpinaddrmasks Počet přijatých ICMP Address Mask Request zpráv (požadavky na získání masky podsítě)..1.3.6.1.2.1.5.13 icmpinaddrmaskreps Počet přijatých ICMP Address Mask Reply zpráv (odpovědi na Address Mask Request s příslušnou maskou podsítě). Pokračování na následující straně 5
Pokračování z předchozí strany OID Objekt Popis.1.3.6.1.2.1.5.14 icmpoutmsgs Celkový počet ICMP zpráv, které se pokusil router odeslat. Zahrnuty jsou také zprávy z icmpouterrors..1.3.6.1.2.1.5.15 icmpouterrors Počet zpráv, které nemohly být odeslány z důvodů zjištěných v rámci ICMP, což je např. nedostatek vyrovnávací paměti..1.3.6.1.2.1.5.16 icmpoutdestunreachs Počet odeslaných ICMP Destination Unreachable zpráv (nedosažitelnost cíle)..1.3.6.1.2.1.5.17 icmpouttimeexcds Počet odeslaných ICMP Time Exceeded zpráv (překročení času)..1.3.6.1.2.1.5.18 icmpoutparmprobs Počet odeslaných ICMP Parameter Problem zpráv (problémy s parametrem)..1.3.6.1.2.1.5.19 icmpoutsrcquenchs Počet odeslaných ICMP Source Quench zpráv (tj. zpráv s požadavky na snížení frekvence odesílání)..1.3.6.1.2.1.5.20 icmpoutredirects Počet odeslaných ICMP Redirect zpráv (přesměrování paketů na alternativní trasu)..1.3.6.1.2.1.5.21 icmpoutechos Počet odeslaných ICMP Echo zpráv (požadavky na odeslání Echo Reply zpráv)..1.3.6.1.2.1.5.22 icmpoutechoreps Počet odeslaných ICMP Echo Reply zpráv (odpovědi na Echo zprávy)..1.3.6.1.2.1.5.23 icmpouttimestamps Počet odeslaných ICMP Timestamp zpráv (požadavky na synchronizaci času)..1.3.6.1.2.1.5.24 icmpouttimestampreps Počet odeslaných ICMP Timestamp Reply zpráv (odpovědi na Timestamp zprávy).1.3.6.1.2.1.5.25 icmpoutaddrmasks Počet odeslaných ICMP Address Mask Request zpráv (požadavky na získání masky podsítě)..1.3.6.1.2.1.5.26 icmpoutaddrmaskreps Počet odeslaných zpráv typu ICMP Address Mask Reply (odpovědi na Address Mask Request s příslušnou maskou podsítě). Tabulka 5: ICMP 6
1.6 TCP OID Objekt Popis.1.3.6.1.2.1.6.1 tcprtoalgorithm Použitý algoritmus pro stanovení hodnoty timeoutu využívaného pro opakovaný přenos nepotvrzených oktetů..1.3.6.1.2.1.6.2 tcprtomin Minimální povolená hodnota pro timeout (v milisekundách).1.3.6.1.2.1.6.3 tcprtomax Maximální povolená hodnota pro timeout (hodnota v milisekundách).1.3.6.1.2.1.6.4 tcpmaxconn Maximální počet TCP spojení, které je router schopen podporovat. Je-li maximální počet připojení dynamický, může zde být hodnota -1..1.3.6.1.2.1.6.5 tcpactiveopens Počet přímých přechodů TCP spojení ze stavu CLOSED do stavu SYN-SENT..1.3.6.1.2.1.6.6 tcppassiveopens Počet přímých přechodů TCP spojení ze stavu LIS- TEN do stavu SYN-RECEIVED..1.3.6.1.2.1.6.7 tcpattemptfails Počet přímých přechodů TCP spojení ze stavu SYN- SENT nebo SYN-RECEIVED do stavu CLOSED. Přičítán je také počet přímých přechodů TCP spojení ze stavu SYNRECEIVED do stavu LISTEN..1.3.6.1.2.1.6.8 tcpestabresets Počet přímých přechodů TCP spojení ze stavu CLOSEWAIT nebo ESTABLISHED do stavu CLOSED..1.3.6.1.2.1.6.9 tcpcurrestab Počet TCP spojení, jejichž aktuální stav je ESTAB- LISHED nebo CLOSE-WAIT..1.3.6.1.2.1.6.10 tcpinsegs Celkový počet přijatých segmentů včetně těch přijatých omylem. Zahrnuje také segmenty přijaté na aktuálně navázaných spojeních..1.3.6.1.2.1.6.11 tcpoutsegs Celkový počet odeslaných segmentů včetně těch na aktuálních připojeních, ale s výjimkou těch, které obsahují pouze přenesené oktety..1.3.6.1.2.1.6.12 tcpretranssegs Celkový počet TCP segmentů, které přenáší jeden nebo více již dříve přenášených oktetů..1.3.6.1.2.1.6.13 tcpconntable Není podporováno routery Advantech..1.3.6.1.2.1.6.14 tcpinerrs Není podporováno routery Advantech..1.3.6.1.2.1.6.15 tcpoutrsts Není podporováno routery Advantech. Tabulka 6: TCP 7
1.7 UDP OID Objekt Popis.1.3.6.1.2.1.7.1 udpindatagram Celkový počet doručených UDP paketů.1.3.6.1.2.1.7.2 udpnoports Celkový počet přijatých UDP paketů, které nebyly doručeny kvůli chybějícímu cílovému portu.1.3.6.1.2.1.7.3 udpinerrors Celkový počet přijatých UDP paketů, které nebyly doručeny z jiného důvodu.1.3.6.1.2.1.7.4 udpoutdatagrams Celkový počet odeslaných UDP paketů.1.3.6.1.2.1.7.5 udptable Není podporováno routery Advantech. Tabulka 7: UDP 8
2. Privátní strom routery Advantech V této kapitole jsou popsány hodnoty SNMP, které jsou specifické pro firmu Advantech B+B SmartWorx (dříve Conel). Strom začíná na OID =.1.3.6.1.4.1.30140, což lze slovně interpretovat jako: iso.org.dod.internet.private.enterprises.conel Na následujícím obrázku je znázorněn strom conel, z něhož se odvozují OID pro routery společnosti Advantech B+B Smartworx. Obrázek 2: Privátní OID strom pro routery Advantech strom conel Podstromy mobile a mobile-2 nejsou dostupné pro routery, které nemají bezdrátový modul pro mobilní připojení (XR5i, XR5i v2, XR5i v2e, SR300, atd.) 2.1 Products Pro jednotlivé produkty, které jsou vyráběny ve firmě Advantech B+B SmartWorx (dříve Conel), se používá následující rozsah OID (vnitřních proměnných): OID Označení Výrobek.1.3.6.1.4.1.30140.1.1 routerer75 EDGE router ER75.1.3.6.1.4.1.30140.1.2 routerer75i EDGE router ER75i.1.3.6.1.4.1.30140.1.3 routerur5 UMTS router UR5.1.3.6.1.4.1.30140.1.4 routerur5i UMTS router UR5i.1.3.6.1.4.1.30140.1.5 routerxr5i Průmyslový router XR5i.1.3.6.1.4.1.30140.1.6 routerer75iv2 EDGE router ER75i v2.1.3.6.1.4.1.30140.1.7 routerur5v2 UMTS router UR5 v2.1.3.6.1.4.1.30140.1.8 routerur5iv2 UMTS router UR5i v2.1.3.6.1.4.1.30140.1.9 routerxr5iv2 Průmyslový router XR5i v2.1.3.6.1.4.1.30140.1.10 routerlr77v2 LTE router LR77 v2.1.3.6.1.4.1.30140.1.11 routercr10v2 CDMA router CR10 v2 Pokračování na následující straně 9
Pokračování z předchozí strany OID Označení Výrobek.1.3.6.1.4.1.30140.1.12 routerucr11v2 CDMA/UMTS router UCR11 v2.1.3.6.1.4.1.30140.1.13 routerur5iv2l HSPA+ router UR5i v2 Libratum.1.3.6.1.4.1.30140.1.14 routerspectre3g HSPA+ router UR5i v2 SL pro USA.1.3.6.1.4.1.30140.1.15 routerspectrert Průmyslový router XR5i v2 SL pro USA.1.3.6.1.4.1.30140.1.16 routerrr75i GSM-R router RR75i v2.1.3.6.1.4.1.30140.1.17 routerspectrelteat LTE router LR77 v2 SL pro USA AT&T.1.3.6.1.4.1.30140.1.18 routerxr5iv2e Průmyslový router XR5i v2 Libratum.1.3.6.1.4.1.30140.1.19 routerbiviasv2hc Dvoumodulový router Bivias v2 HC.1.3.6.1.4.1.30140.1.20 routerbiviasv2lc Dvoumodulový router Bivias v2 LC.1.3.6.1.4.1.30140.1.21 routerspectreltevz LTE router LR77 v2 SL pro USA Verizon.1.3.6.1.4.1.30140.1.22 routerbiviasv2ll Dvoumodulový router Bivias v2 LL.1.3.6.1.4.1.30140.1.23 routerbiviasv2lh Dvoumodulový router Bivias v2 LH.1.3.6.1.4.1.30140.1.24 routerbiviasv2hh Dvoumodulový router Bivias v2 HH.1.3.6.1.4.1.30140.1.25 routerlr77v2l LTE router LR77 v2 Libratum.1.3.6.1.4.1.30140.1.27 routerspectrev3lte LTE router SmartFlex.1.3.6.1.4.1.30140.1.29 routerspectrev3ert Průmyslový router SmartFlex SR300.1.3.6.1.4.1.30140.1.32 routerspectrev3tlte Dvoumodulový LTE router SmartMotion.1.3.6.1.4.1.30140.1.35 routerspectrev3lteus LTE router SmartFlex pro USA.1.3.6.1.4.1.30140.1.36 routerspectrev3llte LTE router SmartStart.1.3.6.1.4.1.30140.1.37 routerspectrev3llteus LTE router SmartStart pro USA Tabulka 8: Products OID 2.2 Protocols 2.2.1 XC-CNT Pro použití xccnt části stromu je nutné mít k dispozici v2 router s rozšiřujícím rozhraním XC- CNT. To je třeba v routeru aktivovat na konfigurační stránce SNMP, viz Konfigurační manuál pro v2 routery, [1]. Binární výstup lze nastavovat přes SNMP hodnota xccntout1 (.1.3.6.1.4.1.30140.2.1.9.0). Ostatní hodnoty jsou pouze pro čtení. Pro volitelný port CNT je použit následující rozsah OID (vnitřních proměnných): OID Označení Význam.1.3.6.1.4.1.30140.2.1.1.0 xccntan1 Analogový vstup AN1 (rozsah 0-4095).1.3.6.1.4.1.30140.2.1.2.0 xccntan2 Analogový vstup AN2 (rozsah 0-4095).1.3.6.1.4.1.30140.2.1.3.0 xccntcnt1 Čítačový vstup CNT1 (rozsah 0-4294967295) Pokračování na následující straně 10
Pokračování z předchozí strany OID Označení Význam.1.3.6.1.4.1.30140.2.1.4.0 xccntcnt2 Čítačový vstup CNT2 (rozsah 0-4294967295).1.3.6.1.4.1.30140.2.1.5.0 xccntbin1 Binární vstup BIN1 (hodnoty 0,1).1.3.6.1.4.1.30140.2.1.6.0 xccntbin2 Binární vstup BIN2 (hodnoty 0,1).1.3.6.1.4.1.30140.2.1.7.0 xccntbin3 Binární vstup BIN3 (hodnoty 0,1).1.3.6.1.4.1.30140.2.1.8.0 xccntbin4 Binární vstup BIN4 (hodnoty 0,1).1.3.6.1.4.1.30140.2.1.9.0 xccntout1 Binární výstup OUT1 (hodnoty 0,1) Tabulka 9: OID pro XC-CNT 2.2.2 M-BUS Následující rozsah OID je použit pro rozšiřující volitelný port M-BUS. Ten může být použit pouze ve v2 routerech je třeba odesílání SNMP aktivovat na stránce SNMP v konfiguraci routeru zaškrtnutím položky Enable M-BUS extension. Strom mbus obsahuje 255 větví (adres), jejichž textové názvy jsou mbus00 až mbusff. To odpovádá adresám MBUS zařízení (0 až 255) v hexadecimálním formátu. Každá adresa/větev zařízení má pod sebou následující rozsah OID: OID Označení Význam.1.3.6.1.4.1.30140.2.2.<adresa>.1.0 IdNumber Číslo měřiče.1.3.6.1.4.1.30140.2.2.<adresa>.2.0 Manufacturer Výrobce.1.3.6.1.4.1.30140.2.2.<adresa>.3.0 Version Specifikuje verzi měřiče.1.3.6.1.4.1.30140.2.2.<adresa>.4.0 Medium Typ měřeného média.1.3.6.1.4.1.30140.2.2.<adresa>.5.0 Status Hlášení chybových stavů.1.3.6.1.4.1.30140.2.2.<adresa>.6.0 VIF00 Informační pole hodnoty.1.3.6.1.4.1.30140.2.2.<adresa>.7.0 Value00 Out.1.3.6.1.4.1.30140.2.2.<adresa>.8.0 VIF01 1. VIF informační pole hodnoty.1.3.6.1.4.1.30140.2.2.<adresa>.9.0 Value01 1. měřená hodnota....1.3.6.1.4.1.30140.2.2.<adresa>.100.0 VIF2F 47. VIF informační pole hodnoty.1.3.6.1.4.1.30140.2.2.<adresa>.101.0 Value2F 47. měřená hodnota Tabulka 10: OID pro M-BUS Kde <adresa> je adresa MBUS měřiče/zařízení z rozsahu 0 až 255, přičemž reálně využitelné jsou adresy 0 až 250, další adresy jsou rezervovány a některé určeny k broadcastu. 11
2.2.3 I/O vstupy a výstupy Poznámka: Vyčítání I/O je nutné aktivovat v routeru v konfiguraci na stránce SNMP. Jeden binární výstup lze nastavovat přes SNMP hodnota ioout0 (.1.3.6.1.4.1.30140.2.3.2.0). Ostatní hodnoty jsou pouze pro čtení. Pro I/O vstupy a výstupy je použit následující rozsah OID (vnitřních proměnných): OID Označení Význam.1.3.6.1.4.1.30140.2.3.1.0 iobin0 Binární vstup BIN0 (hodnoty 0,1).1.3.6.1.4.1.30140.2.3.2.0 ioout0 Binární výstup OUT0 (hodnoty 0,1).1.3.6.1.4.1.30140.2.3.3.0 iobin1 Binární vstup BIN1 (hodnoty 0,1), pouze u v3 routerů Tabulka 11: OID pro I/O vstupy a výstupy 2.3 Status OID Označení Význam.1.3.6.1.4.1.30140.3.1.0 statusmbusoverload1 M-BUS pojistka 1 (hodnoty 0,1).1.3.6.1.4.1.30140.3.2.0 statusmbusoverload2 M-BUS pojistka 2 (hodnoty 0,1).1.3.6.1.4.1.30140.3.3.0 statustemperature Vnitřní teplota.1.3.6.1.4.1.30140.3.4.0 statusvoltage Vstupní napájecí napětí Tabulka 12: Status OID Informace o vnitřní teplotě a napájecím napětí je možné získávat počínaje firmwarem 3.0.4. Je však nutné mít router se základní deskou RB-v2-6 a novější. 12
2.4 Mobile OID Označení Význam.1.3.6.1.4.1.30140.4.1 mobiletechnology Hodnoty 0 24, viz tabulka níže.1.3.6.1.4.1.30140.4.2 mobileplmn Kód operátora.1.3.6.1.4.1.30140.4.3 mobilecell Buňka.1.3.6.1.4.1.30140.4.4 mobilechannel Kanál.1.3.6.1.4.1.30140.4.5 mobilesignalstrength Síla signálu (dbm).1.3.6.1.4.1.30140.4.6 mobilechanneln1 Sousední kanál č. 1.1.3.6.1.4.1.30140.4.7 mobilesignalstrengthn1 Síla signálu, buňka sousedního kanálu č. 1.1.3.6.1.4.1.30140.4.8 mobilechanneln2 Sousední kanál č. 2.1.3.6.1.4.1.30140.4.9 mobilesignalstrengthn2 Síla signálu, buňka sousedního kanálu č. 2.1.3.6.1.4.1.30140.4.10 mobilechanneln3 Sousední kanál č. 3.1.3.6.1.4.1.30140.4.11 mobilesignalstrengthn3 Síla signálu, buňka sousedního kanálu č. 3.1.3.6.1.4.1.30140.4.12 mobilechanneln4 Sousední kanál č. 4.1.3.6.1.4.1.30140.4.13 mobilesignalstrengthn4 Síla signálu, buňka sousedního kanálu č. 4.1.3.6.1.4.1.30140.4.14 mobilechanneln5 Sousední kanál č. 5.1.3.6.1.4.1.30140.4.15 mobilesignalstrengthn5 Síla signálu, buňka sousedního kanálu č. 5.1.3.6.1.4.1.30140.4.16 mobileuptime Doba, jak dlouho je sestavené spojení.1.3.6.1.4.1.30140.4.17 mobileconnect Časové razítko posledního spojení (jinak 0).1.3.6.1.4.1.30140.4.18 mobiledisconnect Časové razítko okamžiku, ve kterém se naposled rozpadlo spojení.1.3.6.1.4.1.30140.4.19 mobilecard Číslo SIM karty.1.3.6.1.4.1.30140.4.20 mobileipaddress Přidělená IP adresa (není-li, samé nuly).1.3.6.1.4.1.30140.4.21 mobilelatency Doba odezvy uchovává platnou hodnotu jen při odesílání trapu (jinak je hodnota 0).1.3.6.1.4.1.30140.4.22 mobilereportperiod Perioda posílání statistik do R-SeeNetu.1.3.6.1.4.1.30140.4.23 mobileregistration Stav registrace sítě.1.3.6.1.4.1.30140.4.24 mobileoperator Operátor, v jehož síti je router provozován.1.3.6.1.4.1.30140.4.25 mobilelac Location Area Code.1.3.6.1.4.1.30140.4.26 mobilesignalquality Kvalita signálu.1.3.6.1.4.1.30140.4.27 mobilecsq Hodnota síly signálu (0 až 31) Tabulka 13: Mobile OID OID Označení.1.3.6.1.4.1.30140.4.1.0 none.1.3.6.1.4.1.30140.4.1.2 gprs.1.3.6.1.4.1.30140.4.1.4 edge Pokračování na následující straně 13
Pokračování z předchozí strany OID Označení.1.3.6.1.4.1.30140.4.1.6 umts.1.3.6.1.4.1.30140.4.1.8 hsdpa.1.3.6.1.4.1.30140.4.1.10 hsupa.1.3.6.1.4.1.30140.4.1.12 hspa.1.3.6.1.4.1.30140.4.1.14 lte.1.3.6.1.4.1.30140.4.1.16 cdma.1.3.6.1.4.1.30140.4.1.18 evdo.1.3.6.1.4.1.30140.4.1.20 evdo0.1.3.6.1.4.1.30140.4.1.22 evdoa.1.3.6.1.4.1.30140.4.1.24 evdob Tabulka 14: Mobile Technology hodnoty 2.5 Mobile-2 2.5.1 MobileToday Tyto OID obsahují statistické hodnoty ohledně mobilního připojení. Analytická data jsou k dispozici pro různá časová období: dnes, včera, tento týden, minulý týden, atd. Typy SNMP hodnot (OID) jsou stejné pro každé časové období. V tabulce níže popsány pro mobiletoday (statistiky za dnešek). OID Označení Význam.1.3.6.1.4.1.30140.5.1.1 mobiletodayrxpri Přijatá data na primární SIM kartě.1.3.6.1.4.1.30140.5.1.2 mobiletodayrxsec Přijatá data na sekundární SIM kartě.1.3.6.1.4.1.30140.5.1.3 mobiletodaytxpri Odeslaná data na primární SIM kartě.1.3.6.1.4.1.30140.5.1.4 mobiletodaytxsec Odeslaná data na sekundární SIM kartě.1.3.6.1.4.1.30140.5.1.5 mobiletodayconnectionspri Počet spojení na primární SIM kartě.1.3.6.1.4.1.30140.5.1.6 mobiletodayconnectionssec Počet spojení na sekundární SIM kartě.1.3.6.1.4.1.30140.5.1.7 mobiletodayonlinepri Doba na primární SIM kartě.1.3.6.1.4.1.30140.5.1.8 mobiletodayonlinesec Doba na sekundární SIM kartě.1.3.6.1.4.1.30140.5.1.9 mobiletodayoffline Doba v režimu offline.1.3.6.1.4.1.30140.5.1.10 mobiletodaycells Počet buněk (během daného období).1.3.6.1.4.1.30140.5.1.11 mobiletodaysignalavg Průměrná síla signálu.1.3.6.1.4.1.30140.5.1.12 mobiletodaysignalmin Minimální síla signálu 14 Pokračování na následující straně
Pokračování z předchozí strany OID Označení Význam.1.3.6.1.4.1.30140.5.1.13 mobiletodaysignalmax Maximální síla signálu.1.3.6.1.4.1.30140.5.1.14 mobiletodaydatemin Časové razítko pro LevelMin (poslední okamžik, kdy byla síla signálu minimální).1.3.6.1.4.1.30140.5.1.15 TodayDateMax Časové razítko pro LevelMax (poslední okamžik, kdy byla síla signálu maximální) Tabulka 15: MobileToday OID 2.5.2 MobileYesterday Význam jednotlivých položek odpovídá položkám, které jsou uvedené v tabulce 15. Netýkají se však aktuálního dne, ale dne který mu předcházel. Jejich označení tak obsahuje slovo "Yesterday" (nikoliv Today). Rozsah OID začíná na.1.3.6.1.4.1.30140.5.2.1. 2.5.3 MobileThisWeek Význam jednotlivých položek odpovídá položkám, které jsou uvedené v tabulce 15. Netýkají se však aktuálního dne, ale aktuálního týdne. Jejich označení tak začíná slovním spojením "ThisWeek" (nikoliv Today). Rozsah OID začíná na.1.3.6.1.4.1.30140.5.3.1. 2.5.4 MobileLastWeek Význam jednotlivých položek odpovídá položkám, které jsou uvedené v tabulce 15. Netýkají se však aktuálního dne, ale uplynulého týdne. Jejich označení tak začíná slovním spojením "LastWeek" (nikoliv Today). Rozsah OID začíná na.1.3.6.1.4.1.30140.5.4.1. 2.5.5 MobileThisPeriod Význam jednotlivých položek odpovídá položkám, které jsou uvedené v tabulce 15. Netýkají se však aktuálního dne, ale daného aktuálního období. Jejich označení tak začíná slovním spojením "ThisPeriod" (ne Today). Rozsah OID začíná na.1.3.6.1.4.1.30140.5.5.1. 2.5.6 MobileLastPeriod Význam jednotlivých položek odpovídá položkám, které jsou uvedené v tabulce 15. Netýkají se však aktuálního dne, ale daného uplynulého období. Jejich označení tak začíná slovním spojením "LastPeriod" (ne Today). Rozsah OID začíná na.1.3.6.1.4.1.30140.5.6.1. 15
2.6 Info Tato skupina je určena pro uchovávání základních informací o daném produktu. OID Označení Význam.1.3.6.1.4.1.30140.6.1 Product Označení daného produktu.1.3.6.1.4.1.30140.6.2 Firmware Informace o nahraném firmware.1.3.6.1.4.1.30140.6.3 SN Sériové číslo daného produkt.1.3.6.1.4.1.30140.6.4 IMEI IMEI kód daného produktu.1.3.6.1.4.1.30140.6.5 ESN ESN kód daného produktu.1.3.6.1.4.1.30140.6.6 MEID MEID kód daného produktu.1.3.6.1.4.1.30140.6.7 ICCID ICCID kód používané SIM karty Tabulka 16: Info OID 2.7 GPS Pozor: Pro vyčítání z gps části stromu je nutné mít v routeru nainstalovaný uživatelský modul GPS. Ten je k dispozici ke stažení na Engineering Portal, viz odkaz [6] v doporučené literatuře a Konfigurační manuál pro informace, jak jej nahrát do routeru. Pro odesílané GPS zprávy je použit rozsah OID (tj. vnitřních proměnných) uvedený v následující tabulce. OID Označení Význam.1.3.6.1.4.1.30140.7.1 gpstimeutc Aktuální čas formát hhmmss (vychází z UTC koordinovaný světový čas).1.3.6.1.4.1.30140.7.2 gpslatitude Zeměpisná šířka (ve stupních).1.3.6.1.4.1.30140.7.3 gpslongitude Zeměpisná délka (ve stupních).1.3.6.1.4.1.30140.7.4 gpsaltitude Nadmořská výška (v metrech).1.3.6.1.4.1.30140.7.5 gpssatellites Počet satelitů, které jsou v přímém dohledu (jsou přímo viditelné pro dané zařízení).1.3.6.1.4.1.30140.7.6 gpsfixstatus Udává, zda jsou k dispozici data a pokud ano, jaká je jejich kvalita. Nejsou-li data k dispozici, hodnota je rovna nule. Nenulová hodnota značí přítomnost dat..1.3.6.1.4.1.30140.7.7 gpsspeedover Ground Aktuální rychlost zařízení vůči Zemskému povrchu (v uzlech) Pokračování na následující straně 16
Pokračování z předchozí strany OID Označení Význam.1.3.6.1.4.1.30140.7.8 gpscourseover Ground Směr pohybu zařízení vůči Zemskému povrchu (ve stupních).1.3.6.1.4.1.30140.7.9 gpsdate Aktuální datum fromát ddmmrr Tabulka 17: GPS OID 17
3. OID posílané v SNMP trapu V routeru je možné aktivovat pravidelné odesílání SNMP trapů do dozorového systému. To je aktivováno na stránce SNMP v routeru, zaškrtnutím volby Enable reporting to supervisory system. Je třeba ještě vylnit IP adresu dozorového systému, časový interval posílání SNMP trapů a vše potvrdit tlačítkem Apply. Nyní jsou SNMP trapy posílány pravidelně v nastaveném intervalu. První SNMP trap je větší, obsahuje více informací. Tento větší SNMP trap je pak odesílán každých 24 hodin od aktivace. Každý SNMP trap obsahuje tyto OID:.1.3.6.1.2.1.2.2.1.6.1 (ifphysaddress).1.3.6.1.2.1.2.2.1.10.2 (ifinoctets).1.3.6.1.2.1.2.2.1.16.2 (ifoutoctets).1.3.6.1.4.1.30140.4.1.0 (mobiletechnology).1.3.6.1.4.1.30140.4.2.0 (mobileplmn).1.3.6.1.4.1.30140.4.3.0 (mobilecell).1.3.6.1.4.1.30140.4.4.0 (mobilechannel).1.3.6.1.4.1.30140.4.5.0 (mobilesignalstrength).1.3.6.1.4.1.30140.4.6.0 (mobilechanneln1).1.3.6.1.4.1.30140.4.7.0 (mobilesignalstrengthn1).1.3.6.1.4.1.30140.4.8.0 (mobilechanneln2).1.3.6.1.4.1.30140.4.9.0 (mobilesignalstrengthn2).1.3.6.1.4.1.30140.4.10.0 (mobilechanneln3).1.3.6.1.4.1.30140.4.11.0 (mobilesignalstrengthn3).1.3.6.1.4.1.30140.4.12.0 (mobilechanneln4).1.3.6.1.4.1.30140.4.13.0 (mobilesignalstrengthn4).1.3.6.1.4.1.30140.4.14.0 (mobilechanneln5).1.3.6.1.4.1.30140.4.15.0 (mobilesignalstrengthn5).1.3.6.1.4.1.30140.4.16.0 (mobileuptime).1.3.6.1.4.1.30140.4.17.0 (mobileconnect).1.3.6.1.4.1.30140.4.18.0 (mobiledisconnect).1.3.6.1.4.1.30140.4.19.0 (mobilecard).1.3.6.1.4.1.30140.4.21.0 (mobilelatency).1.3.6.1.4.1.30140.4.22.0 (mobilereportperiod).1.3.6.1.4.1.30140.4.26.0 (mobilesignalquality).1.3.6.1.4.1.30140.4.27.0 (mobilecsq).1.3.6.1.4.1.30140.5.1.10.0 (mobiletodaycells).1.3.6.1.4.1.30140.3.3.0 (statustemperature).1.3.6.1.4.1.30140.3.4.0 (statusvoltage) 18
Každých 24 hodin jsou pak posílány také tyto OID:.1.3.6.1.4.1.30140.6.3.0 (infosn).1.3.6.1.4.1.30140.6.4.0 (infoimei).1.3.6.1.4.1.30140.6.5.0 (infoesn).1.3.6.1.4.1.30140.6.6.0 (infomeid).1.3.6.1.2.1.1.1.0 (sysdescr).1.3.6.1.2.1.1.5.0 (sysname).1.3.6.1.2.1.1.6.0 (syslocation) 19
4. Příklad nastavení a vyčtení SNMP Na obrázku níže je příklad nastavení SNMP v routeru. Stránka SNMP Configuration je dostupná ve webovém rozhraní routeru v sekci Configuration pod položkou Services. Pro aktivaci vyčítání SNMP je nutné zaškrtnout položku Enable SNMP agent a volbu potvrdit kliknutím na tlačítko Apply. Volitelně lze vyplnit údaje jako jméno, umístění zařízení, kontakt, případně upřesnit další nastavení. Obrázek 3: Příklad SNMP konfigurace 20
Nyní je možné přistupovat na SNMP strom routeru s pomocé jakéhokoli dostupného SNMP browseru (prohlížeče) jako např. MG-SOFT (na obrázku níže) či SnmpB. Důležité je nastavit IP adresu routeru pro spojení s routerem. Je doporučené načíst si také MIB soubory z repozitáře (viz doporučená literatura níže). Nyní se lze stromem jednotlivých OID proklikávat, vyčítat jejich hodnoty, prověřovat formát a typ vracených dat apod. Obrázek 4: Příklad MIB prohlížeče Cesta k privátním proměnným routerů Advantech je: iso org dod internet private enterprises conel Cesta k základním informacím o routeru je: iso org dod internet mgmt mib-2 system 21
5. Doporučená literatura [1] Advantech B+B SmartWorx: v2 Routery konfigurační manuál (MAN-0021-CZ) [2] Advantech B+B SmartWorx: SmartFlex konfigurační manuál (MAN-0023-CZ) [3] Advantech B+B SmartWorx: SmartMotion konfigurační manuál (MAN-0024-CZ) [4] Advantech B+B SmartWorx: SmartStart konfigurační manuál (MAN-0022-CZ) [5] Advantech B+B SmartWorx: SNMP MIB repozitář, dostupný z: https://bitbucket.org/bbsmartworx/snmp-mib/ [6] Engineering Portal: User Modules https://ep.advantech-bb.cz/user-modules 22