Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
sdk:status-values-via-snmp [2015/07/03 14:44]
fachet
sdk:status-values-via-snmp [2020/07/21 08:31] (current)
fachet [Access via SNMP]
Line 30: Line 30:
 ===== Access via SNMP ===== ===== Access via SNMP =====
  
-Please use SNMP v3 for accessing the router +Using SNMP v1/2c there are two communitiesThe "read" ​community only allows to read data. The "​write"​ or "​admin"​ gives read and write access. With "​allowed hosts" you can restrict ​the SNMP access to the router via an IP range. ​"0.0.0.0" ​can be used for any access. 
-First create a user (SYSTEM->​Authentication->​User accounts)"snmp" ​with the password ​"snmp01password"​. ​+ 
 +You can also use SNMP v3 for accessing the router
 Attention must be paid to the fact that SNMP passwords have to be more than 8 characters long. Shorter passwords have to be doubled for SNMP (e.g. admin01 becomes admin01admin01). ​ Attention must be paid to the fact that SNMP passwords have to be more than 8 characters long. Shorter passwords have to be doubled for SNMP (e.g. admin01 becomes admin01admin01). ​
 +Only the user "​admin"​ can be used 
 To see the values run on linux: \\ To see the values run on linux: \\
 **snmpwalk -v 3 -u <​user>​ -n ""​ -l authNoPriv -a MD5 -x DES -A <​password>​[<​password>​] <​IPaddress> ​ 1.3.6.1.4.1.31496.10.90** **snmpwalk -v 3 -u <​user>​ -n ""​ -l authNoPriv -a MD5 -x DES -A <​password>​[<​password>​] <​IPaddress> ​ 1.3.6.1.4.1.31496.10.90**
Line 47: Line 49:
  
 {{:​sdk:​mibbroswersettings.jpg|}} {{:​sdk:​mibbroswersettings.jpg|}}
 +
 {{:​sdk:​snmp.jpg |}} {{:​sdk:​snmp.jpg |}}
  
 +*if you use SNMP v1/2c with the MibBrowser please set either the "​Community"​ (=read only) or the "Write Commuinity"​ (=read-write),​ but not both at the same time.
  
 +For easier use please copy the NetModule private MIB (NETMODULE-VENDOR-MIB.mib into the MIB directory (e.g. C:\Program Files\MibBrowser Free Tool\mibs) and load it File->​Load MIB .
  
 ===== Useful ===== ===== Useful =====
Line 97: Line 102:
 </​code>​ </​code>​
  
 +===== Extended example =====
 <code c status_snmp2.are>​ <code c status_snmp2.are>​
 /* DESC: This script extends MIB entries of the SNMP agent  /* DESC: This script extends MIB entries of the SNMP agent 
- * with values from nb_status for temperature,​ signal level  + * with values from nb_status for temperature,​ signal level 
- ​* ​and transferred data on mobile network+ * transferred data on mobile network ​and 
 + * reset of transferred data counter
  * Copyright (coffee) 2014 NetModule AG, Switzerland  * Copyright (coffee) 2014 NetModule AG, Switzerland
  */  */
Line 108: Line 114:
 if (nb_snmp_register("​DOWNLOADED",​ 3, "​s",​ "​ro"​) == -1)exit(3); if (nb_snmp_register("​DOWNLOADED",​ 3, "​s",​ "​ro"​) == -1)exit(3);
 if (nb_snmp_register("​UPLOADED",​ 4, "​s",​ "​ro"​) == -1)exit(4); if (nb_snmp_register("​UPLOADED",​ 4, "​s",​ "​ro"​) == -1)exit(4);
 +if (nb_snmp_register("​RESET_DATA",​ 5, "​s",​ "​rw"​) == -1)exit(5);
    
 if (nb_snmp_link() == -1)exit(6); if (nb_snmp_link() == -1)exit(6);
Line 119: Line 125:
    if (nb_snmp_update("​DOWNLOADED",​ struct_get(wan,​ "​WANLINK1_DATA_DOWNLOADED"​)) == -1) exit(9);    if (nb_snmp_update("​DOWNLOADED",​ struct_get(wan,​ "​WANLINK1_DATA_DOWNLOADED"​)) == -1) exit(9);
    if (nb_snmp_update("​UPLOADED",​ struct_get(wan,​ "​WANLINK1_DATA_UPLOADED"​)) == -1) exit(10);    if (nb_snmp_update("​UPLOADED",​ struct_get(wan,​ "​WANLINK1_DATA_UPLOADED"​)) == -1) exit(10);
-   sleep(5); +    
-+   if (s = nb_snmp_listen(5)) 
 +      if (s.name == "​RESET_DATA"​ && s.value == "​reset"​) { 
 +          nb_reset_statistics("​wanlink0"​); 
 +          if (nb_snmp_update("​RESET_DATA",​ strftime("​%d.%m.%Y %H:​%M:​%S",​ localtime(time()))) == -1) exit(11); 
 +      } 
 +} </​code>​ 
 + 
 +Please extend the NetModule router MIB (VENODR-MIB.txt before "trap objects"​ with: 
 +<​code>​ 
 +-- **************************************************************************** 
 +-- NBSdkTable 
 +-- **************************************************************************** 
 +sdkTemperature OBJECT-TYPE 
 +    SYNTAX ​ DisplayString 
 +    MAX-ACCESS ​ read-only 
 +    STATUS ​ current 
 +    DESCRIPTION 
 +        "The temperature of the WWAN Module 1" 
 +    ::= { sdk 1 } 
 +     
 +sdkRSRQ OBJECT-TYPE 
 +    SYNTAX ​ DisplayString 
 +    MAX-ACCESS ​ read-only 
 +    STATUS ​ current 
 +    DESCRIPTION 
 +        "The RSRQ of the WWAN Module 1" 
 +    ::= { sdk 2 } 
 +     
 +sdkDataDownloaded OBJECT-TYPE 
 +    SYNTAX ​ DisplayString 
 +    MAX-ACCESS ​ read-only 
 +    STATUS ​ current 
 +    DESCRIPTION 
 +        "The data downloaded on the WAN interface"​ 
 +    ::= { sdk 3 } 
 +     
 +sdkDataUploaded OBJECT-TYPE 
 +    SYNTAX ​ DisplayString 
 +    MAX-ACCESS ​ read-only 
 +    STATUS ​ current 
 +    DESCRIPTION 
 +        "The data uploaded on the WAN interface"​ 
 +    ::= { sdk 4 }    
 + 
 +sdkDataReset OBJECT-TYPE 
 +    SYNTAX ​ DisplayString  
 +    MAX-ACCESS ​ read-write 
 +    STATUS ​ current 
 +    DESCRIPTION 
 +        "Write '​reset'​ to reset the up- and download counters for the WAN interface."​ 
 +    ::= { sdk 5   ​
 </​code>​ </​code>​
  
 +{{:​sdk:​mibbrowser_status_snmp2.jpg|}}