...
- Kategória komunikačnej linky: TCP/IP-UDP.
- UDP Parametre:
- Host: Existujú 3 možnosti:
- IP adresa konkrétneho sieťového rozhrania počítača, na ktorom je proces D2000 KOM – UDP pakety budú odosielané a prijímané len prostredníctvom tohto rozhrania. Príklad: 192.168.1.10
- Symbolické meno konkrétneho sieťového rozhrania počítača. Príklad: D2SRV_PRIMARY
- Textové konštanty ANY alebo Textová konštanta ALL - otvorí sa nakonfigurovaný UDP port na všetkých dostupných sieťových rozhrania počítača. Na posielanie správ bude použité najvhodnejšie sieťové rozhranie na základe smerovacích tabuliek, príjem správ bude uskutočňovaný na všetkých sieťových rozhraniach.
- Port: Číslo UDP portu (0 až 65535), z ktorého proces D2000 KOM posiela výzvy a na ktorý prichádzajú odpovede. Ak je hodnota 0, číslo portu je automaticky určené operačným systémom.
Poznámka: Štandardné UDP porty používané pre SNMP sú 161 a 162, ale tie bývajú často obsadené SNMP agentom, preto je vhodné zvoliť iný port. S hodnotou 0 môžu byť problémy, ak sú v sieti firewally a iné ochrany - vtedy treba nakonfigurovať konkrétny port a zabezpečiť, že firewally neodfiltrujú pakety z tohto portu.
- Host: Existujú 3 možnosti:
Poznámka:
V prípade, že je potrebné prevádzkovať protokol SNMP v redundantnom systéme, kedy súčasne bežia dve inštancie procesu KOM na dvoch rôznych počítačoch a nie je možné jednoznačne určiť IP adresu sieťového rozhrania v nastavení linky, vtedy je vhodné zvoliť konfiguráciu v štýle „ANY“, resp. „ALL“. Ďalšia možnosť je zhodne pomenovať sieťové IP adresy rozhrania, napr. SNMP_LAN a v súbore hosts (cC:\windows\system32\drivers\etc\hosts) každého počítača prideliť správnu IP adresu. Čiže napr.:
...
| Kotva | ||||
|---|---|---|---|---|
|
...
- Komunikačný protokol: SNMP Manager.
- Adresa stanice: definuje sa vo formáte IP_adresa1[:port1], IP_adresa2[:port2].
...
| Kľúčové slovo | Plný názov | Popis | Jednotka | Náhradná hodnota | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Wait Timeout | Doba čakania na odpoveď pri čítaní hodnôt. | ms | 100 | ||||||
| Retry Count | Počet opakovaní žiadostí o hodnotu pri neúspešnom čakaní, potom sa pokračuje žiadosťou o inú hodnotu. | - | 3 | ||||||
| Max Error Count | Maximálny počet neúspešných dotazov, kým stanica prejde do stavu StCOMERR. Úspešne doručená hodnota nuluje počítadlo neúspechov a nastavuje stanicu opäť do stavu StON. | - | 1 | ||||||
| Trace Level | Ten istý význam ako parameter Trace level na linke, ale s platnosťou pre konkrétnu stanicu. Ak je na linke hodnota parametra Trace level vyššia, má prednosť. Poznámka: Vypisovanie informácií o prichádzajúcich hodnotách je ovplyvňované hodnotou parametra Trace level na linke, keďže po príchode hodnoty ešte nie je zrejmé, pre akú stanicu hodnota prišla. | - | 0 |
| Kotva | ||||
|---|---|---|---|---|
|
...
Adresa: Udáva OID (object identifier) bodu, s ktorým chceme pracovať. OID adresa je uvádzaná v číselnom tvare, pričom jednotlivé čísla sú oddelené bodkou, napr. 1.3.6.1.2.1.1.1.0.
Meraný bod s takto zadanou adresou sa bude vyčítať vždy po linke, ktorá je práve funkčná (linka primary, backup je určovaná na základe úspešnosti odpovede pri predošlom obvolaní a v prípade potreby je automaticky prepínaná).
Ak by bolo potrebné mať informáciu o tom, či je primárna alebo záložná IP adresa zariadenia dostupná, je možné využiť tzv. vynútenú adresáciu a to tým, že zvolíme voľbu Len primárna, resp. Len záložná. Tým zaistíme, že získanie hodnoty meraného bodu sa bude zisťovať len z primárnej, resp. záložnej adresy stanice. Voľba všetky je štandardná voľba, kedy sa hodnoty meraných bodov získavajú priebežne z obidvoch adries stanice (pokiaľ sú nakonfigurované). Voľba pasívny znamená, že hodnota meraného bodu sa priamo nevyčítava, ale sa získa nepriamo ako kópia hodnoty iného meraného bodu s rovnakou adresou, ale v režime napr. Len primárna.
Ak na zariadení neexistuje bod s nami zadanou OID adresou, SNMP agent vráti odpoveď s chybovým kódom s inou OID adresou (pretože objekt s požadovanou OID neexistuje) a preto bude komunikácia označená ako neúspešná. Meraný bod prejde do stavu „Neznáma hodnota“. Ak je potrebné stav linky signalizovať zmenou hodnoty a nie platnosťou hodnoty objektu, je možné vytvoriť napr. objekt typu DI, žiadať hodnotu celočíselného typu (napr. UpTime) a využiť automatickú konverziu čísla na boolean, kedy hodnota 0 je false a ostatné True. Vo vlastnostiach objektu potom nastaviť používanie náhradnej hodnoty a ako default hodnotu nastaviť False. Potom bude objekt nadobúdať hodnôt len True alebo False v závislosti na dostupnosti objektu v SNMP agentovi.
Meraný bod s adresou, ktorá sa začína %IGNORE, bude ignorovaný.
| Kotva | ||||
|---|---|---|---|---|
|
Niektoré zariadenia majú problém s poskytovaním hodnôt pomocou Get požiadavky, pokiaľ sa jedná o položku poľa. V takom prípade je potrebné nakonfigurovať typ požiadavky GetNext, pričom ako adresu je treba nakonfigurovať OID predchádzajúceho objektu (na jej zistenie odporúčame použiť java aplikáciu MIB Browser (http://tl1.ireasoning.com/mibbrowser.shtml) na načítanie celého stromu hodnôt a zistenie adresy OID predchádzajúceho objektu).
...
Nasledujúca tabuľka zobrazuje podporované konverzie typov hodnôt.
- povolená konverzia
...
Protokol SNMP umožňuje okrem periodického vyčítavania hodnôt aj posielanie oznámení o výskyte dôležitých udalostí. Tieto oznámenia sa nazývajú Trapy (anglicky Traps). Trapy posiela SNMP agent na IP adresu a port (štandardne 162), ktorú má nakonfigurovanú (jednoduchšie zariadenia podporujú posielanie Trapov na jedinú IP adresu a port, dokonalejšie aj viacero adries).
Nakonfigurovaním linkového parametra Trap IP address sa spustí task, ktorý na porte Trap port prijíma tieto Trapy.
V aktuálnej verzii je podporený príjem SNMP Trapov vo verzii V1 a V2C protokolu SNMP. Štandardne jedno zariadenie posiela Trapy jednej konkrétnej verzie protokolu.
Na príjem Trapov z konkrétneho zariadenia je nutné nakonfigurovať na príslušnej stanici merané body s nasledovnými textovými adresami (stačí vybraté, nie je nutné všetky):
Textové adresy meraných bodov pre Trapy v SNMP protokole vo verzii V1:
| Adresa bodu | Dátový typ | Popis | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| OID | Položka "Enterprise" trap správy: OID objektu generujúceho trap (pre konkrétne zariadenie konštanta). Poznámka: Z tohto OID sa dá často určiť výrobca zariadenia. | ||||||||||||
| Integer | Položka "Generic-trap" trap správy: identifikátor triedy trapu. Pre SNMP verziu 1 sú v RFC 1157 definované tieto hodnoty:
| ||||||||||||
| Integer | Položka "Specific-trap" trap správy: špecifický kód správy. | ||||||||||||
| TimeTicks | Položka "Time-stamp" trap správy: časová pečiatka (podľa RFC 1157 počet uplynutých stotín sekundy medzi poslednou sieťovou reinicializáciou zariadenia a vygenerovaním trapu.
Pokiaľ je meraný bod typu Ci - Celočíselný vstup, jeho hodnota bude v stotinách sekundy, tj. TimeTicks. Avšak pokiaľ dosiahne maximálnu hodnotu pre celočíselnú hodnotu v D2000 (t.j. 2^31-1, keďže celočíselný typ je implementovaný ako 32-bitový Integer so znamienkom), väčšie hodnoty nadobudnúť nemôže. Podľa RFC 1157 je Time-stamp typu TimeTicks, čo je podľa RFC 1155 nezáporný integer. T.j. môže nadobúdať aj väčšie hodnoty ako 2^31-1, ktoré sa nedajú zapísať do meraného bodu typu Ci - Celočíselný vstup. Preto odporúčame nakonfigurovať meraný bod typu Ai - Analóg vstup. | ||||||||||||
| OID | Položka "Object-name" trap správy: OID objektu, ktorý je príčinou vzniku trapu, alebo ktorého sa trap týka. | ||||||||||||
| ľubovoľný | Položka "Object-value" trap správy: hodnota objektu, ktorý je príčinou vzniku trapu alebo ktorého sa trap týka. Poznámka 1: Keďže typ hodnoty je ľubovoľný, je vhodné nakonfigurovať meraný bod typu TxtI - Textový vstup. V opačnom prípade budú niektoré hodnoty neskonvertovateľné (napr. na Celočíselný vstup) a hodnota TRAP_VALUE sa nezmení. Poznámka 2: Trap môže obsahovať aj niekoľko dvojíc (OID, hodnota). V tom prípade sa postupne nastavujú hodnoty meraných bodov s adresami TRAP_OID a TRAP_VALUE pre všetky tieto dvojice. Možné je napr. nakonfigurovať event spúšťaný na zmenu hodnoty meraného bodu s adresou TRAP_VALUE a dvojice (OID, hodnota) ukladať do databázy. | ||||||||||||
| Boolean | Meraný bod určený na potvrdzovanie spracovania hodnôt. Keďže v jednej správe Trap sa môže nachádzať niekoľko dvojíc (TRAP_OID, TRAP_VALUE), korektné spracovanie napr. ESL skriptom vyžaduje, aby KOM proces nastavil nasledujúcu dvojicu hodnôt až po spracovaní predchádzajúcej. Podobne aj hodnoty ostatných vstupných meraných bodov pre správy typu TRAP by mali byť nastavované až po signalizácii, že predchádzajúce hodnoty týchto meraných bodov boli už spracované. Pokiaľ existuje výstupný meraný bod s adresou TRAP_CONFIRM, tak KOM proces nastaví ďalšiu dvojicu hodnôt vstupných meraných bodov (TRAP_OID, TRAP_VALUE) až po zápise do výstupného meraného bodu s adresou TRAP_CONFIRM (zápis bude vykonávať zrejme ESL skript určený na spracovanie hodnôt ako jednu z posledných operácií). Hodnoty ostatných meraných bodov (s adresami TRAP_ENTERPRISE, TRAP_GENERIC_TRAP, TRAP_SPECIFIC_TRAP, TRAP_TIMESTAMP a TRAP_OID) budú nastavené, pokiaľ sa jedná o spracovanie prvej dvojice hodnôt (TRAP_OID, TRAP_VALUE) - v prípade ďalších dvojíc ostanú rovnaké a zmenia sa až pri spracovávaní ďalšej správy Trap. Pokiaľ výstupný meraný bod s adresou TRAP_CONFIRM neexistuje, hodnoty všetkých vstupných meraných bodov s adresami TRAP_* sú nastavované hneď po príchode správy Trap a teda môže dôjsť ku strate hodnôt v dôsledku výskytu viacerých dvojíc hodnôt v správe Trap alebo v dôsledku príchodu novej správy Trap skôr, ako užívateľský skript spracoval predchádzajúce hodnoty. |
...
| Adresa bodu | Dátový typ | Popis | ||||||
|---|---|---|---|---|---|---|---|---|
| TRAP_REQUEST_ID | Integer | Položka "Request-id" trap správy: zvyšujúce sa číslo trapu. | ||||||
| TRAP_ERROR_STATUS | Integer | Položka "Error-status" trap správy: chybový kód. Štandardne má hodnotu 0, ale potenciálne môže nadobúdať jednu z týchto hodnôt (viď RFC 1448):
| ||||||
| TRAP_ERROR_INDEX | Integer | Položka "Error-index" trap správy: rozšírený kód chyby (často 0). | ||||||
| TRAP_UPTIME_OID | OID | Položka "SysUpTime OID" trap správy: OID objektu SysUpTime.0 . Táto položka by mala mať podľa RFC 1448 hodnotu 1.3.6.1.2.1.1.3.0, ale pre prípad, že by tomu tak v konkrétnej implementácii nebolo, je možné hodnotu zistiť pomocou meraného bodu s adresou TRAP_UPTIME_OID. | ||||||
| TRAP_UPTIME_VALUE | TimeTicks | Položka "SysUpTime" trap správy: hodnota objektu sysUpTime. Pre hodnotu platí Poznámka uvedená v popise adresy TRAP_TIMESTAMP. | ||||||
| TRAP_TRAP_OID | OID | Položka "SnmpTrap OID" trap správy: OID objektu SnmpTrap.0 . Táto položka by mala mať podľa RFC 1448 hodnotu 1.3.6.1.6.3.1.1.4.1.0 (t.j. OID objektu snmpTrapOID, viď RFC 1450), ale pre prípad, že by tomu tak v konkrétnej implementácii nebolo, je možné hodnotu zistiť pomocou meraného bodu s adresou TRAP_TRAP_OID. | ||||||
| OID | Položka "SnmpTrapValue" trap správy. Jedná sa o identifikátor triedy trapu, ktorý významovo zodpovedá položke TRAP_GENERIC_TRAP v SNMP verzii V1, ale je typu OID, čo umožňuje napr. definovanie chybových kódov špecifických pre konkrétnych výrobcov a zariadenia. Významy štandardných OID, ktoré môže nadobúdať, sú podľa RFC 1450 nasledovné:
| ||||||
| TRAP_OID | OID | Rovnaký význam ako TRAP_OID v SNMP verzii V1. | ||||||
| TRAP_VALUE | ľubovolný | Rovnaký význam ako TRAP_VALUE v SNMP verzii V1. | ||||||
| TRAP_CONFIRM | Boolean | Rovnaký význam ako TRAP_CONFIRM v SNMP verzii V1. |
...
Od D2000 verzie 7.02.006 je podporovaná dynamická zmena adresy meraného bodu pomocou TELL príkazu SETPTADDR, ktorá spolu s adresou meraného bodu GETNEXT_OID umožňuje vyčítavanie celého stromu hodnôt pomocou SNMP požiadavky GetNext.
| Kotva | ||||
|---|---|---|---|---|
|
...