SNMP - Historie editací

Adamn v 11. 11. 2023, 12:17

2023-11-11T12:17:14Z

Adamn v 22. 10. 2023, 08:49

2023-10-22T08:49:52Z

Adamn v 14. 10. 2023, 07:28

2023-10-14T07:28:29Z

Adamn v 28. 10. 2022, 08:27

2022-10-28T08:27:47Z

Adamn v 5. 1. 2022, 08:32

2022-01-05T08:32:26Z

Adamn v 5. 7. 2021, 07:30

2021-07-05T07:30:06Z

Adamn: Založena nová stránka s textem „ SNMP je dostupný pro '''první''' i '''druhou''' produktovou řadu zařízení SDS. '''Simple Network Management Protocol''' ('''SNMP''') je součástí…“

2021-07-05T07:28:46Z

Založena nová stránka s textem „ SNMP je dostupný pro '''první''' i '''druhou''' produktovou řadu zařízení SDS. '''Simple Network Management Protocol''' ('''SNMP''') je součástí…“

Nová stránka

SNMP je dostupný pro '''první''' i '''druhou''' produktovou řadu zařízení SDS.

'''Simple Network Management Protocol''' ('''SNMP''') je součástí sady internetových protokolů.
Slouží potřebám správy sítí, umožňuje průběžný sběr nejrůznějších dat, pro jejich následné vyhodnocování.
Na tomto protokolu je dnes založena většina prostředků a nástrojů pro správu sítě.

Naše zařízení používají SNMP jednak pro kontrolu vlastního síťového rozhraní, tj. využívá se standardni MIB položky,
tak také pro monitorování specializovaných funkcí, poskytovaných tím kterým zařízením.

Tak lze pomocí SNMP číst aktuální stavy všech vstupů na každém ze zařízení.

Každé zařízení má implementovaného SNMP agenta, což je služba, která na základě dotazu posílá příslušnou odpověď.
Co má být obsahem dotazu, aby byl úspěšně zpracován, je popsáno v konkrétním [http://en.wikipedia.org/wiki/Management_information_base MIB souboru].

Pro rychlý start:
* [http://www.mikrotik.com/thedude/ The Dude] - vhodný pro vizualizaci
* [http://www.ireasoning.com/products.shtml iReasoning MIB Browser] - vhodný pro analýzu komunikace, získání SNMP dat z SDS
* a velké množství dalších řešení

Uvedené programy jsou poskytovány svými výrobci zdarma, přečtěte si však jejich licenční podmínky.

== Doplňkový UDP protokol ==

Mimo SNMP (a mimo webové rozhraní, teplotní snippety a XML) je k dispozici i proprietární UDP protokol - návod pro [[M2M:_UDP_protocol|UDP: první produktová řada SDS]] a [[M2M:_S-UDP_protocol|SUDP: druhá produktová řada SDS]]

UDP protokol pro zařízení SDS umožňuje přenos informací do/ze zařízení v jednopaketové formě, a to vysokou rychlostí (tj. odešle se dotaz na SDS a ihned obratem je vrácen dynamicky generovaný UDP paket).

Komunikace probíhá na UDP portu číslo 280 (pozor na firewall) - v aktuálním firmware je samozřejmě možné změnit číslo tohoto UDP portu.

Druhá produktová řada SDS má protokol značně rozšířen (vůči první produktové řadě), vzhledem k množství funkcí které jsou navíc dostupné.

== Simple Network Management Protokol pro zařízení SDS ==

Výrobky SDS používají verzi '''SNMP v1''' (plain).

Název SNMP komunity lze změnit přes administrační webovou stránku zařízení SDS.

Název SNMP komunity je stejný pro čtení i pro zápis. Zápis lze přes webové rozhraní zablokovat či povolit.

'''Máme SNMP enterprise number, 33283, oficiálně přiřazené autoritou IANA.'''

SNMP AGENT PORT je '''161'''.

Tento SNMP port nelze změnit.

Maximální velikost datového bloku je '''1380''' bajtů - tj. čisté (skutečné) SNMP data, hlavičky dalších protokolů jsou (navíc) mimo tyto payload data (tzn. nezapočítány). SDS nikdy negeneruje větší pakety než je zde uvedeno. Pozor proto na velikost dotazů (a očekávanou velikost odpovědi), které do SDS posíláte. Dobrá praxe je posílat jeden dotaz na jeden paket.

== Způsob přenosu desetinných čísel přes SNMP ==

Protože je zde několik údajů, které jsou vyjádřeny nikoliv celočíselně, ale ve formě desetinného čísla, je potřeba je po přečtení pomocí SNMP správně zpracovat.

Všechny údaje s desetinou hodnotou (např. teplota) jsou předávány tak, že je nutné je po přečtení ze SNMP vydělit příslušným číslem, např. 100 nebo 1000. Kolik je toto číslo, je uvedeno v MIB souboru pro každý údaj, který to vyžaduje.

'''Příklady:'''

'''up_time''' je přenášen v centisekundách, to znamená, že např. reálný údaj ''123.45 sekund'' bude přenesen jako číslo ''12345'' (takže pro převod jej musíme vydělit 100).

'''I_accu_SI''' uvádí proud z/do akumulátoru. Přečtená hodnota SNMP ''187'' odpovídá ''1.87 A'', hodnota SNMP ''-1'' odpovídá ''-0.01 A'', hodnota ''-1234'' odpovídá ''-12.34 A'', hodnota ''1206'' odpovídá ''12.06 A'' atd., zde vidíme dělení surového údaje ze SNMP číslem 100, čímž získáme čistý údaj v SI jednotkách.

Stejný postup platí i pro další podobně přenášené údaje, viz konkrétní MIB soubory.

'''Pozor''' - první produktová řada SDS:

Údaje o teplotě z teplotních čidel 1-Wire® jsou přenášeny ve dvou způsobech.

Údaje o teplotě z teplotních čidel jsou předávány pomocí SNMP tabulky, kde krom jiných řádku jsou dva využity pro přenos číselného údaje. Řádek ''..._actual_temp_integer'' přenáší celočíselnou část (vše před desetinnou tečkou, tedy teplotu na celé stupně Celsia) a pak řádek ''..._actual_temp_frac'' přenáší část za desetinnou čárkou:

Příklad pro teplotní údaje: dostaneme ''..._actual_temp_integer = 25'' a ''..._actual_temp_frac = 12''. Teplota je tedy '''25.12°C'''.

A samozřejmě i jako hodnota násobená 100.

== SNMP WRITE ==

Zařízení SDS poskytují kromě možnosti číst data pomocí SNMP protokolu, také možnost zápisu dat do zařízení SDS prostřednictvím SNMP protokolu.

Ovládat tak lze tyto výstupní periférie: (první produktová řada SDS)
* relé: (stav) (kdo ovládá relé)
* PWM: (frekvence generátoru) (perioda/duty)
* stav pinu PD0, popř. pro SDS-TTCPRO směr a stav sběrnice PDx
* sériová linka: (baudrate) (data size) (stop bits) (parity)
* zápis do: sys[140] až sys[149]

Druhá produktová řada také nabízí podobný set možností.

== SNMP TRAP ==

Zařízení SDS poskytují i možnost odesílání SNMP TRAP zpráv. Tyto zprávy se odesílají na požádání vašeho vlastního programu (tzn. musíte si připravit svůj SDS-C nebo FULL-C program).

== Dostupné MIB soubory ==

Vyberte si MIB soubor pro zařízení z následujícího stromu:

enterprises
[http://www.an-d.cz AN-D.cz] = 33283

''První produktová řada SDS''

[[SDS_MACRO:_LM|SDS-MACRO-LM]] = 5
SDS MACRO LM

--- verze do listopadu 2012 ---
= 5 >> [http://sds.an-d.cz/mibs/MIBS_BEFORE_112012/AN-Dcz_SDSMACRO_MIB.txt MIB] .1.3.6.1.4.1.33283.1.5

--- verze od prosince 2012 ---
= 5 >> [http://sds.an-d.cz/mibs/AN-Dcz_SDSMACRO_MIB.txt MIB] .1.3.6.1.4.1.33283.1.5

[[SDS_MACRO:_ST|SDS-MACRO-ST]] = 32
SDS MACRO ST

= 32 >> [http://sds.an-d.cz/mibs/AN-Dcz_SDS_MACRO_ST.txt MIB] .1.3.6.1.4.1.33283.1.55

[[SDS_MICRO:_LM|SDS-MICRO-LM]] = 2
SDS MICRO LM: light, light2, E, DIN

--- verze do listopadu 2012 ---
= 2 >> [http://sds.an-d.cz/mibs/MIBS_BEFORE_112012/AN-Dcz_SDSMICRO_MIB.txt MIB] .1.3.6.1.4.1.33283.1.2

--- verze od prosince 2012 ---
= 2 >> [http://sds.an-d.cz/mibs/AN-Dcz_SDSMICRO_MIB.txt MIB] .1.3.6.1.4.1.33283.1.2
(pozor na změnu v tabulce S0 vstupů, byla tam přidána položka, dne 12.4.2013)

[[SDS_MICRO:_ST|SDS-MICRO-ST]] = 32
SDS MICRO ST

= 32 >> [http://sds.an-d.cz/mibs/AN-Dcz_SDS_MICRO_ST.txt MIB] .1.3.6.1.4.1.33283.1.32

[[SDS_MINI:_ST|SDS-MINI-ST]] = 90
SDS MINI ST

= 90 >> [http://sds.an-d.cz/mibs/AN-Dcz_SDSMINI_MIB.txt MIB] .1.3.6.1.4.1.33283.1.90

(HISTORIE) DVOUDESKA [[SDS_UPS:_LM|SDS-UPS-LM]] = 2

STARÉ VERZE HW (dvoudeska, dnes neprodávaná !): LM: sds_ups_rev2, rev3, rev3b
= 2 >> [http://sds.an-d.cz/mibs/MIBS_BEFORE_112012/AN-Dcz_SDSUPSr3a_MIB.txt MIB] .1.3.6.1.4.1.33283.1.2

JEDNODESKA [[SDS_UPS:_LM|SDS-UPS-LM]] = 10

AKTUÁLNÍ VERZE HW (jednodeska, aktuálně v prodeji): sds_ups_onedps LM
--- verze od prosince 2012 ---
= 10 >> [http://sds.an-d.cz/mibs/MIBS_BEFORE_112012/AN-Dcz_SDSUPS_ONEDPS_MIB.txt MIB] .1.3.6.1.4.1.33283.1.10

[[SDS_TTCPRO:_ST|SDS-TTCPRO-ST]] = 21

SDS TTCPRO ST (rev3+)
= 21 >> [http://sds.an-d.cz/mibs/AN-Dcz_SDSTTCrev3_MIB.txt MIB] .1.3.6.1.4.1.33283.1.21

[[SDS_IO6|SDS-IO6]] = 66

SDS IO6 rev2, rev3
= 66 >> [http://sds.an-d.cz/mibs/AN-Dcz_SDSIO6rev2_MIB.txt MIB] .1.3.6.1.4.1.33283.1.66

[[SDS_IO6_ST|SDS-IO6-ST]] = 99

SDS IO6-ST rev1 (nová generace s novým procesorem)
= 99 >> [http://sds.an-d.cz/mibs/AN-Dcz_SDSIO6_ST_MIB.txt MIB] .1.3.6.1.4.1.33283.1.99

''Druhá produktová řada SDS''

[[SDS_BIG|SDS-BIG]] = 30

SDS BIG 64 / 128
= 30 >> [http://sds.an-d.cz/mibs/AN-Dcz_SDS_BIGandSTSW_MIB.txt MIB] .1.3.6.1.4.1.33283.1.30

[[SDS_STSW|SDS-STSW]] = 30

SDS STSW (a všechny OEM výrobky založené na STSW) 64 / 128 (stejný MIB jako pro BIG)
= 30 >> [http://sds.an-d.cz/mibs/AN-Dcz_SDS_BIGandSTSW_MIB.txt MIB] .1.3.6.1.4.1.33283.1.30

[[SDS_SMALL|SDS-SMALL]] = 30

SDS SMALL 64 / 128 (stejný MIB jako pro BIG)
= 30 >> [http://sds.an-d.cz/mibs/AN-Dcz_SDS_BIGandSTSW_MIB.txt MIB] .1.3.6.1.4.1.33283.1.30

Soubory MIB stáhnete kliknutím na příslušný odkaz. Pozor na to, jakou verzi firmware (datum vydání firmware) máte ve svém SDS nahranou, podle toho zvolte i verzi MIB souboru.

== RFC references ==

SDS je navrženo podle následujících RFC:

* RFC 1155 — ''Structure and Identification of Management Information for the TCP/IP-based Internets''
* RFC 1156 — ''Management Information Base for Network Management of TCP/IP-based internets''
* RFC 1157 — ''A Simple Network Management Protocol (SNMP)''* RFC 1213 — ''Management Information Base for Network Management of TCP/IP-based internets: MIB-II''
* RFC 3410 (Informational) — ''Introduction and Applicability Statements for Internet Standard Management Framework''
* RFC 3411 (Standard 62) — ''An Architecture for Describing Simple Network Management Protocol (SNMP) Management Frameworks''
* RFC 3412 (Standard 62) — ''Message Processing and Dispatching for the Simple Network Management Protocol (SNMP)''
* RFC 3413 (Standard 62) — ''Simple Network Management Protocol (SNMP) Application''
* RFC 3415 (Standard 62) — ''View-based Access Control Model (VACM) for the Simple Network Management Protocol (SNMP)''
* RFC 3417 (Standard 62) — ''Transport Mappings for the Simple Network Management Protocol (SNMP)''
* RFC 3418 (Standard 62) — ''Management Information Base (MIB) for the Simple Network Management Protocol (SNMP)''
* RFC 3584 (Best Current Practice) — ''Coexistence between Version 1, Version 2, and Version 3 of the Internet-standard Network Management Framework''

__NOTOC__

← Starší verze		Verze z 11. 11. 2023, 12:17
Řádek 79:		Řádek 79:
	'''Informace:'''<br>		'''Informace:'''<br>
	Pro všechny SDS Druhé Produktové Řady lze, prostřednictvím konfigurace ve webovém rozhraní, povolit nebo zakázat SNMP v1 a/nebo SNMP v3. Mohou tedy být aktivní současně, nebo jen v1, nebo jen v3 - záleží to na tom, jak si to sami nakonfigurujete.		Pro všechny SDS Druhé Produktové Řady lze, prostřednictvím konfigurace ve webovém rozhraní, povolit nebo zakázat SNMP v1 a/nebo SNMP v3. Mohou tedy být aktivní současně, nebo jen v1, nebo jen v3 - záleží to na tom, jak si to sami nakonfigurujete.
		+
		+
		+	'''Minimální délka hesla:'''<br>
		+	Pro SNMP v3 je potřeba zadat heslo s délkou 8 nebo více znaků. Kratší hesla jsou zařízením SDS odmítnuta.

@@ Řádek 46: / Řádek 46: @@
 SNMP uživatele lze změnit přes administrační webovou stránku zařízení SDS. Zápis a čtení, lze pro jednotlivé uživatele, přes webové rozhraní zablokovat či povolit.
-SDS podporuje pouze USM(3), což je pro SNMP v3 standardem dle RFC.
+SDS podporuje pouze USM(3) - přičemž právě USM(3) je pro SNMP v3 standard dle RFC.
 Pro řadu SDS 64 a 128 podporuje firmware pouze NOAUTHNOPRIV security pro SNMP v3. Stále je zde možné využít rozdělení dle uživatelů. POZOR: firmware pro 64/128 s touto feature bude vydán až později.
-Pro řadu SDS 512 podporuje firmware plný security model dle RFC pro USM(3), tedy NOAUTHNOPRIV, AUTHNOPRIV, AUTHPRIV.
+Pro řadu SDS 512 podporuje firmware plný security model dle RFC pro USM(3), tedy tři možnosti, a to: '''NOAUTHNOPRIV, AUTHNOPRIV, AUTHPRIV'''. Dle vaší volby (v konfiguraci, pro jednotlivé uživatele), Lze tedy komunikovat bez ověření (NOAUTH) a šifrování (NOPRIV), nebo jen s ověřením (AUTH) bez šifrování (NOPRIV), nebo s ověřením (AUTH) a šifrováním (PRIV).
-Všechny SDS řady 512 mají, s aktuálním firmware, plnou implementaci SNMP v3.
+Všechny SDS řady 512 mají, s aktuálním firmware, plnou implementaci SNMP v3 dle RFC.
 Pro všechny SDS Druhé Produktové Řady lze, prostřednictvím konfigurace ve webovém rozhraní, povolit nebo zakázat SNMP v1 a/nebo SNMP v3. Mohou tedy být aktivní současně, nebo jen v1, nebo jen v3 - záleží to na tom, jak si to sami nakonfigurujete.

@@ Řádek 30: / Řádek 30: @@
 Druhá produktová řada SDS má protokol značně rozšířen (vůči první produktové řadě), vzhledem k množství funkcí které jsou navíc dostupné.
-Výrobky SDS používají verzi '''SNMP v1''' (plain).
+== Simple Network Management Protokol pro zařízení SDS První Produktové Řady ==
 Název SNMP komunity lze změnit přes administrační webovou stránku zařízení SDS.
-Název SNMP komunity je stejný pro čtení i pro zápis. Zápis lze přes webové rozhraní zablokovat či povolit.
+Zápis a čtení, lze přes webové rozhraní zablokovat či povolit, pro jednotlivé komunity.
-'''Máme SNMP enterprise number, 33283, oficiálně přiřazené autoritou IANA.'''
+SNMP uživatele lze změnit přes administrační webovou stránku zařízení SDS. Zápis a čtení, lze pro jednotlivé uživatele, přes webové rozhraní zablokovat či povolit.
@@ Řádek 46: / Řádek 66: @@
 Tento SNMP port nelze změnit.
-Maximální velikost datového bloku je '''1380''' bajtů - tj. čisté (skutečné) SNMP data, hlavičky dalších protokolů jsou (navíc) mimo tyto payload data (tzn. nezapočítány). SDS nikdy negeneruje větší pakety než je zde uvedeno. Pozor proto na velikost dotazů (a očekávanou velikost odpovědi), které do SDS posíláte. Dobrá praxe je posílat jeden dotaz na jeden paket.
+Maximální velikost datového bloku (pro SNMP v1) je '''1380''' bajtů - tj. čisté (skutečné) SNMP data, hlavičky dalších protokolů jsou (navíc) mimo tyto payload data (tzn. nezapočítány). SDS nikdy negeneruje větší pakety než je zde uvedeno. Pozor proto na velikost dotazů (a očekávanou velikost odpovědi), které do SDS posíláte. Dobrá praxe je posílat jeden dotaz na jeden paket.
 == Způsob přenosu desetinných čísel přes SNMP ==
@@ Řádek 71: / Řádek 92: @@
 A samozřejmě i jako hodnota násobená 100.
 == SNMP WRITE ==
@@ Řádek 213: / Řádek 235: @@
 * RFC 1157 &mdash; ''A Simple Network Management Protocol (SNMP)''* RFC 1213 &mdash; ''Management Information Base for Network Management of TCP/IP-based internets: MIB-II''
 * RFC 3410 (Informational) &mdash; ''Introduction and Applicability Statements for Internet Standard Management Framework''
-* RFC 3411 (Standard 62) &mdash; ''An Architecture for Describing Simple Network Management Protocol (SNMP) Management Frameworks''
+* RFC 3411 &mdash; ''An Architecture for Describing Simple Network Management Protocol (SNMP) Management Frameworks''
-* RFC 3412 (Standard 62) &mdash; ''Message Processing and Dispatching for the Simple Network Management Protocol (SNMP)''
+* RFC 3412 &mdash; ''Message Processing and Dispatching for the Simple Network Management Protocol (SNMP)''
-* RFC 3413 (Standard 62) &mdash; ''Simple Network Management Protocol (SNMP) Application''
+* RFC 3413 &mdash; ''Simple Network Management Protocol (SNMP) Application''
-* RFC 3415 (Standard 62) &mdash; ''View-based Access Control Model (VACM) for the Simple Network Management Protocol (SNMP)''
+* RFC 3415 &mdash; ''View-based Access Control Model (VACM) for the Simple Network Management Protocol (SNMP)''
-* RFC 3417 (Standard 62) &mdash; ''Transport Mappings for the Simple Network Management Protocol (SNMP)''
+* RFC 3417 &mdash; ''Transport Mappings for the Simple Network Management Protocol (SNMP)''
-* RFC 3418 (Standard 62) &mdash; ''Management Information Base (MIB) for the Simple Network Management Protocol (SNMP)''
+* RFC 3418 &mdash; ''Management Information Base (MIB) for the Simple Network Management Protocol (SNMP)''
 * RFC 3584 (Best Current Practice) &mdash; ''Coexistence between Version 1, Version 2, and Version 3 of the Internet-standard Network Management Framework''
 __NOTOC__

@@ Řádek 130: / Řádek 130: @@
-  [[SDS_MICRO:_ST|SDS-MICRO-ST]] = 32
+  [[SDS_MICRO:_ST|SDS-MICRO-ST]] a [[SDS_MICRO:_ST_DP|SDS-MICRO-ST-DP]] = 32
    SDS MICRO ST
@@ Řádek 176: / Řádek 176: @@
-  [[SDS_BIG|SDS-BIG]] = 30
+  [[SDS_BIG|SDS-BIG a BIG2]] (všechny varianty a sub-varianty)  = 30
-   SDS BIG 64 / 128 / 512
+   SDS BIG (BIG2) 64 / 128 / 512 (DP, DS84)
     = 30 >> [http://sds.an-d.cz/mibs/AN-Dcz_SDS_BIGandSTSW_MIB.txt MIB] .1.3.6.1.4.1.33283.1.30

@@ Řádek 178: / Řádek 178: @@
   [[SDS_BIG|SDS-BIG]] = 30
-   SDS BIG 64 / 128
+   SDS BIG 64 / 128 / 512
     = 30 >> [http://sds.an-d.cz/mibs/AN-Dcz_SDS_BIGandSTSW_MIB.txt MIB] .1.3.6.1.4.1.33283.1.30
@@ Řádek 184: / Řádek 184: @@
   [[SDS_STSW|SDS-STSW]] = 30
-   SDS STSW (a všechny OEM výrobky založené na STSW) 64 / 128 (stejný MIB jako pro BIG)
+   SDS STSW (a všechny OEM výrobky založené na STSW) 64 / 128 / 512 (stejný MIB jako pro BIG)
     = 30 >> [http://sds.an-d.cz/mibs/AN-Dcz_SDS_BIGandSTSW_MIB.txt MIB] .1.3.6.1.4.1.33283.1.30
@@ Řádek 190: / Řádek 190: @@
   [[SDS_SMALL|SDS-SMALL]] = 30
-   SDS SMALL 64 / 128 (stejný MIB jako pro BIG)
+   SDS SMALL 64 / 128 / 512 (stejný MIB jako pro BIG)
     = 30 >> [http://sds.an-d.cz/mibs/AN-Dcz_SDS_BIGandSTSW_MIB.txt MIB] .1.3.6.1.4.1.33283.1.30

@@ Řádek 161: / Řádek 161: @@
-  [[SDS_IO6|SDS-IO6]] = 66
+  [[SDS_IO6:_LM|SDS-IO6]] = 66
-   SDS IO6 rev2, rev3
+   SDS IO6 LM (rev2+)
     = 66 >> [http://sds.an-d.cz/mibs/AN-Dcz_SDSIO6rev2_MIB.txt MIB] .1.3.6.1.4.1.33283.1.66
-  [[SDS_IO6_ST|SDS-IO6-ST]] = 99
+  [[SDS_IO6:_ST|SDS-IO6-ST]] = 99
-   SDS IO6-ST rev1 (nová generace s novým procesorem)
+   SDS IO6 ST
     = 99 >> [http://sds.an-d.cz/mibs/AN-Dcz_SDSIO6_ST_MIB.txt MIB] .1.3.6.1.4.1.33283.1.99