Howto use SNMP with berofix

From berofix - professional SIP gateway
Jump to: navigation, search

The bero*fix SNMP server can be started by enabling the checkbox SNMP enabled in section Management -> Remote Management -> SNMP of the bero*fix GUI.

It will then run on standard port 161 and requires the "2c" version of authentication, its read-only community is public.

The SNMP MIB can be downloaded from section Management -> Remote Management of the bero*fix GUI.
Since the information provided by a bero*fix can change from one AppFS-version to another,
it is advisable to use the MIB provided by the currently used AppFS and update it after each AppFS-update.


Install the bero*fix MIB in net-snmp

To find the proper locations of the file snmp.conf and the directories where MIBs can be stored, the tool net-snmp-config can be used:

net-snmp-config --default-mibdirs
net-snmp-config --snmpconfpath

The file BEROFIX-MIB.txt must be copied in one of the paths listed by "--default-mibdirs"

If it not exists, create a file named snmp.conf in one of the directories listed by "--snmpconfpath" and add this line to it:

mibs +BEROFIX-MIB

To check that the MIB has been imported correctly, use the tool snmpwalk:

snmpwalk -v 2c -c public <IP-address of berofix> .iso


bero*fix Parameters

SNMP provides the tools snmpwalk, snmpget and snmptable to retrieve values exported by bero*fix via SNMP.

Walk over the complete tree

To see all data exported by bero*fix, use snmpwalk with the following parameters. Keep in mind to append '.iso', without it you'll only see an error-message.

snmpwalk -v 2c -c public <IP-address of berofix> .iso

Card Information

Manufacturer of card:

snmpget -v 2c -c public <IP-address of berofix> berofixManufacturer.0

Serial of card:

snmpget -v 2c -c public <IP-address of berofix> berofixSerial.0

Hardware revision of card:

snmpget -v 2c -c public <IP-address of berofix> berofixRevision.0

Version of RootFS on card:

snmpget -v 2c -c public <IP-address of berofix> berofixRootVersion.0

Version of AppFS on card:

snmpget -v 2c -c public <IP-address of berofix> berofixAppVersion.0

Version of FPGA-image on card:

snmpget -v 2c -c public <IP-address of berofix> berofixFPGAVersion.0

Table of LineInterfaces installed:

snmptable -v 2c -c public <IP-address of berofix> berofixLineInterfaceTable

Network configuration

Table of network configuration:

snmptable -v 2c -c public <IP-address of berofix> berofixNetworkTable

Uptimes

Uptime of system:

snmpwalk -v 2c -c public <IP-address of berofix> berofixSystemUptime

Uptime of ISGW:

snmpwalk -v 2c -c public <IP-address of berofix> berofixISGWUptime

CPU usage

(divide values by 10)

Percentage over the last minute:

snmpwalk -v 2c -c public <IP-address of berofix> berofixCPUusage1

Percentage over the last five minutes:

snmpwalk -v 2c -c public <IP-address of berofix> berofixCPUusage5

Percentage over the last fifteen minutes:

snmpwalk -v 2c -c public <IP-address of berofix> berofixCPUusage15

Table of all three values:

snmptable -v 2c -c public <IP-address of berofix> berofixCPUusageTable

RAM usage

Total amount of RAM:

snmpwalk -v 2c -c public <IP-address of berofix> berofixRAMtotal

Free amount of RAM:

snmpwalk -v 2c -c public <IP-address of berofix> berofixRAMfree

Amount of RAM used by ISGW:

snmpwalk -v 2c -c public <IP-address of berofix> berofixRAMisgw

Table of all three values:

snmptable -v 2c -c public <IP-address of berofix> berofixRAMusageTable

States / Statistics

Table of call statistics:

snmptable -v 2c -c public <IP-address of berofix> berofixStatisticsCallsTable

Table of errors on Layer 1 (ISDN):

snmptable -v 2c -c public <IP-address of berofix> berofixStatisticsL1ErrorTable

Table of errors on Layer 2 (ISDN):

snmptable -v 2c -c public <IP-address of berofix> berofixStatisticsL2ErrorTable

Table of state of ISDN-lines:

snmptable -v 2c -c public <IP-address of berofix> berofixStatisticsISDNStateTable

Table of SIP Registrations:

snmptable -v 2c -c public <IP-address of berofix> berofixStatisticsSIPRegTable