iReasoning product documentation

MIB Browser Version 16 User Guide

Learn how to query SNMP agents, work with MIB modules, monitor devices, and automate trap handling with iReasoning MIB Browser.

iReasoning MIB Browser is a desktop tool for managing SNMP-enabled devices and applications. It loads standard and proprietary MIB modules, tolerates some malformed MIB files, runs SNMP queries and updates, visualizes device data, and processes incoming notifications through a built-in Trap Receiver and rule engine. It is powered by the iReasoning SNMP API.

Major features

Requirements

Download and run MIB Browser

  1. Download the appropriate MIB Browser installer or archive. On Windows, run setup.exe. On macOS, Linux, or another UNIX platform, use the package provided for that platform or extract the archive to the directory of your choice.
  2. Start the application:
    • Windows: Open MIB Browser from its application shortcut.
    • Linux: A DEB or RPM installation adds iReasoning MIB Browser to the desktop application menu. It can also be started from a terminal with ireasoning-mibbrowser. For a ZIP installation, open the MIB Browser installation directory and run browser.sh.
    • macOS 10.8 or later: Download mibbrowser.pkg, then install it in /Applications from Terminal:
      sudo installer -store -pkg mibbrowser.pkg -target /
      On earlier macOS versions, extract mibbrowser.zip, open the ireasoning/mibbrowser directory, and run browser.sh.

Linux DEB and RPM packages

Native Linux installers are available for Professional Edition and for paid and evaluation Enterprise Edition. Choose the package format and architecture for your system: Debian and Ubuntu use amd64 or arm64 DEB files; Fedora, RHEL, Rocky Linux, AlmaLinux, and compatible distributions use x86_64 or aarch64 RPM files. The package filenames do not contain a product version; the complete version and release remain available in the package metadata.

Install an Enterprise package on Debian or Ubuntu:

sudo apt install ./ireasoning-mibbrowser-enterprise_amd64.deb
sudo apt install ./ireasoning-mibbrowser-enterprise_arm64.deb

# Enterprise Evaluation Edition
sudo apt install ./ireasoning-mibbrowser-enterprise-eval_amd64.deb
sudo apt install ./ireasoning-mibbrowser-enterprise-eval_arm64.deb

Install an Enterprise package on an RPM-based distribution:

sudo dnf install ./ireasoning-mibbrowser-enterprise.x86_64.rpm
sudo dnf install ./ireasoning-mibbrowser-enterprise.aarch64.rpm

# Enterprise Evaluation Edition
sudo dnf install ./ireasoning-mibbrowser-enterprise-eval.x86_64.rpm
sudo dnf install ./ireasoning-mibbrowser-enterprise-eval.aarch64.rpm

Install Professional Edition:

# Debian or Ubuntu
sudo apt install ./ireasoning-mibbrowser-professional_amd64.deb
sudo apt install ./ireasoning-mibbrowser-professional_arm64.deb

# Professional Evaluation Edition
sudo apt install ./ireasoning-mibbrowser-professional-eval_amd64.deb
sudo apt install ./ireasoning-mibbrowser-professional-eval_arm64.deb

# Fedora, RHEL, Rocky Linux, AlmaLinux, or a compatible distribution
sudo dnf install ./ireasoning-mibbrowser-professional.x86_64.rpm
sudo dnf install ./ireasoning-mibbrowser-professional.aarch64.rpm

# Professional Evaluation Edition
sudo dnf install ./ireasoning-mibbrowser-professional-eval.x86_64.rpm
sudo dnf install ./ireasoning-mibbrowser-professional-eval.aarch64.rpm

The native packages install a desktop application-menu entry and the ireasoning-mibbrowser command. They do not place a shortcut in each user's Desktop folder. Run the GUI as the logged-in user, without sudo. Professional Edition is a desktop application and does not install a system service.

Start the GUI after installing a Linux package

  1. Open the desktop's application menu or launcher. Search for iReasoning MIB Browser, then select it. Depending on the desktop, the launcher appears under Network or in the general application list. If a desktop session does not display a newly installed launcher immediately, sign out and back in, or use the terminal command below.
  2. Alternatively, open a terminal and run:
    ireasoning-mibbrowser
    The package installs this command as /usr/bin/ireasoning-mibbrowser, so it can be run from any directory. Do not use sudo; the GUI creates configuration and log files for the current user.
  3. With Enterprise Edition, the GUI connects to the local Enterprise server that the package starts as a system service. To use a server on another computer, open File > Server Address and enter that server's address. The Professional package starts only the desktop application and has no server service.

A ZIP installation does not add the menu entry or terminal command. Extract it, change to its installation directory, and run ./browser.sh instead.

Enterprise Edition

Enterprise Edition can run the Trap Receiver and Watches as a system service. A Watch can send email or SNMP traps when a MIB object crosses a configured threshold.

On Windows, the service starts automatically. The macOS Enterprise PKG installs the server as the system service com.ireasoning.mibent; it starts when installation finishes and at every system boot, before a user logs in. Linux Enterprise DEB and RPM packages install, enable, and immediately start ireasoning-mibbrowser-enterprise.service. Enterprise ZIP installations do not install a service; configure the operating system to run $INSTALL_DIR/lib/runserver.sh at startup when automatic startup is required.

On macOS, inspect or restart the service from Terminal with:

sudo launchctl print system/com.ireasoning.mibent
sudo launchctl kickstart -k system/com.ireasoning.mibent

On Linux, administer the native Enterprise service with:

sudo systemctl status ireasoning-mibbrowser-enterprise.service
sudo systemctl restart ireasoning-mibbrowser-enterprise.service
sudo systemctl stop ireasoning-mibbrowser-enterprise.service
sudo journalctl -u ireasoning-mibbrowser-enterprise.service

The Linux Enterprise application is installed under /opt/ireasoning/mibbrowser. Mutable server configuration, database, MIB, and license state is stored under /var/lib/ireasoning-mibbrowser, and logs are stored under /var/log/ireasoning-mibbrowser. Upgrades and reinstalls preserve these locations, including when upgrading from an evaluation package to the paid package. Removing the package removes its application and service unit but leaves server state and logs in place.

The Enterprise Java GUI runs separately as the logged-in user and stores its client state under ~/.imibrowser. Existing ZIP installations are not migrated automatically; stop both servers before manually copying mutable data from a ZIP installation.

Installed files, configuration, logs, and uninstalling

MIB Browser keeps packaged program files separate from mutable configuration and logs where the platform installer supports that separation. Back up configuration, licenses, custom MIBs, and database contents before uninstalling or manually deleting data directories.

Linux

LocationContents
/opt/ireasoning/mibbrowser Packaged application, bundled Java runtime, libraries, documentation, images, and launch scripts.
/usr/share/ireasoning-mibbrowser-enterprise/defaults Read-only Enterprise defaults used to initialize missing server state.
/var/lib/ireasoning-mibbrowser Mutable Enterprise server state. Configuration files are in config/, including mibbrowser.xml, trapd.xml, and web.properties. The database/ and mibs/ directories and license state are also kept here.
/var/log/ireasoning-mibbrowser/server.log Enterprise server application log. Service console output is also available through Journal.
~/.imibrowser Per-user Professional and Enterprise GUI state. The main GUI configuration is ~/.imibrowser/mibbrowser.xml, and its application log is ~/.imibrowser/log/log.txt.

Uninstall a native Linux package with the package manager:

# Debian or Ubuntu
sudo apt remove ireasoning-mibbrowser-enterprise
sudo apt remove ireasoning-mibbrowser-professional

# Fedora, RHEL, Rocky Linux, AlmaLinux, or a compatible distribution
sudo dnf remove ireasoning-mibbrowser-enterprise
sudo dnf remove ireasoning-mibbrowser-professional

Removing Enterprise stops and removes its service and packaged application, but deliberately preserves /var/lib/ireasoning-mibbrowser and /var/log/ireasoning-mibbrowser. Per-user ~/.imibrowser directories are also preserved. Remove those data directories separately only when their configuration, logs, license, MIBs, and database are no longer needed. To uninstall a ZIP copy, stop any manually configured service and delete the directory where the ZIP was extracted.

macOS

LocationContents
/Applications/MIB Browser.app Application bundle. Its Contents directory contains the packaged libraries, Java runtime, documentation, default configuration, MIBs, database files, and launch scripts.
~/Library/Containers/com.ireasoning.mibpro/Data/Documents Professional GUI data. The main configuration file is config/mibbrowser.xml, and the application log is log/log.txt; database and MIB data are in sibling directories.
~/Library/Containers/com.ireasoning.mibent/Data/Documents Enterprise GUI data. The main configuration file is config/mibbrowser.xml, and the application log is log/log.txt; database and MIB data are in sibling directories.
/var/root/Library/Containers/com.ireasoning.mibent/Data/Documents Enterprise service state. Its main configuration is config/mibbrowser.xml; related Trap Receiver and web settings are in the same config/ directory, and the application log is log/server.log.
/Library/Logs/iReasoning/MIB Browser Enterprise launch service standard-output and standard-error logs.
/Library/LaunchDaemons/com.ireasoning.mibent.plist Enterprise auto-start service definition.

For Personal or Professional Edition, quit MIB Browser and move MIB Browser.app from Applications to the Trash. For Enterprise Edition, stop and remove the system service before removing the application:

sudo launchctl bootout system/com.ireasoning.mibent
sudo rm -f /Library/LaunchDaemons/com.ireasoning.mibent.plist
sudo rm -rf "/Applications/MIB Browser.app"

The data under each user's ~/Library/Containers directory and the Enterprise service data under /var/root/Library/Containers are not removed by those commands. Delete them separately only if no configuration, license, custom MIB, database, or log data needs to be retained.

Windows

LocationContents
%ProgramFiles%\ireasoning\mibbrowser Application files. Important subdirectories include bin for command-line tools, config for packaged defaults and Enterprise server settings, database, docs, images, jre, lib, log, and mibs.
%USERPROFILE%\.imibrowser Per-user GUI state. The main configuration is mibbrowser.xml, and the GUI application log is log\log.txt.
%ProgramFiles%\ireasoning\mibbrowser\config Enterprise Windows service configuration, including mibbrowser.xml, trapd.xml, and web.properties.
%ProgramFiles%\ireasoning\mibbrowser\log\server.log Enterprise server application log.

Uninstall from Settings > Apps > Installed apps by finding iReasoning MIB Browser and selecting Uninstall. The Start menu also provides iReasoning > MIB Browser > Uninstall MIB Browser, or run %ProgramFiles%\ireasoning\mibbrowser\Uninstall.exe. The Enterprise uninstaller stops and removes its Windows service. Per-user files under %USERPROFILE%\.imibrowser may remain; delete that directory separately only if its saved configuration and logs are no longer needed.

The MIB Browser interface

Toolbar

MIB Browser toolbar

MIB tree pane

MIB tree pane

The MIB tree area contains the tree pane at the top and the properties pane at the bottom.

Result pane

Result pane

Query results appear in a table. If an octet string is shown in hexadecimal format, double-click it to switch display modes.

Buttons on the right toolbar:

Stop button

Stop pending SNMP queries.

Clear Table button

Clear the result table.

Raw Data button

Open a dialog that shows the raw SNMP query results.

Find button

Find strings in the result pane.

Save button

Save values from the result pane to an XML file.

Open button

Load values from an XML file into the result pane.


Trap Receiver

Main window

Open the Trap Receiver from MIB Browser, or start it as a standalone window.

Trap Receiver window

The upper pane lists received traps. Select a trap to view its details in the lower pane.

Column Description
Description A summary of the received trap.
Source The IP address of the device that sent the trap.
Time The date and time when the Trap Receiver received the trap.
Severity The trap's assigned severity: Low, Medium, or High.
Ack Indicates whether the trap has been acknowledged.
Trap Receiver controls

Trap Filter button

Filter received traps by source IP address or trap OID.

Start Trap Receiver button

Start listening for traps. The button is disabled while the Trap Receiver is running. Opening the window does not start the receiver automatically.

Stop button

Stop listening for traps.

Add Trap Rule

Add a rule for processing traps. When a trap is selected, MIB Browser pre-fills applicable fields with data from that trap.

MIB Browser evaluates all applicable rules unless one marks the trap as ignored. Rules run in name order, so renaming a rule changes its position. For example, if rules A and B match the same trap and set different severities, B runs after A and determines the final severity.

Add Rule dialog

Rule conditions

Trap OID

For an SNMPv2 trap, use its snmpTrapOID. For an SNMPv1 trap, use enterpriseOID + '.0.' + specific.
Wildcards * and ? are supported. * matches any sequence of digits and periods; ? matches zero or one digit. For example, .1.3.6.4.155.12.* matches OIDs below .1.3.6.4.155.12. The pattern .1.3.6.4.155.12.? matches suffixes from 0 through 9, but not 11.

Allowed trap source IPs

Enter source IP patterns separated by commas. Wildcards * and ? are supported. For example, 1.2.3.* matches addresses from 1.2.3.0 through 1.2.3.255, while 1.2.3.? matches 1.2.3.0 through 1.2.3.9.

Variable-binding values contain

Enter one or more keywords separated by commas or vertical bars. The condition matches when any keyword occurs in a raw variable-binding value. Raw values use the format received from the agent and are not translated for display.

Rule actions

Play sound

Play a sound when the rule conditions match.

Run command

Run a system command when the rule conditions match. Use an absolute path if the executable is not available on PATH. You can include tokens in the command.

Send email

Send email when the rule conditions match. SMTP must first be configured in the SMTP tab of Trap Receiver Settings.

Issue SNMP request

Send an SNMP GET or SET request to an agent when the rule conditions match.

Send SNMP trap

Send an SNMPv1, SNMPv2c, or SNMPv3 trap when the rule conditions match.

Suppression tab

Suppression provides a cancellation window before a rule performs external actions. It is useful when a second, related trap reports that a problem has cleared, or when an operator acknowledges the original trap before notifications and automated actions should run.

To configure suppression for a rule:

  1. Open Add Rule or Edit Rule, configure the rule's Conditions and Actions, and then select the Suppression tab.
  2. Select Enable action suppression and enter a positive number in Delay actions for ... minutes.
  3. Optionally enter one or more related-trap conditions under Match any of the following. These conditions use OR logic: a match in any field cancels the pending actions. If every field is empty, acknowledging the original trap can still cancel them.
  4. Click Save Rule. A matching trap now creates pending actions instead of running them immediately.
Suppression cancellation conditions
Original trap is acknowledged Acknowledge the original trap in the Trap Receiver during the delay window. Its pending rule actions and delayed system-wide email are cancelled.
Trap OID Enter the OID of a related or clearing trap, or use Browse.... The same * and ? wildcard rules described for rule conditions are supported.
Trap source IPs Enter one or more source IP patterns separated by commas. Wildcards are supported.
Variable-binding values contain Enter one or more text values separated by commas or vertical bars. A related trap matches when a raw variable-binding value contains any entered value.

During the delay window, sound, rule-generated email, command execution, SNMP requests, and outgoing trap actions are held. If the window expires without cancellation, the actions run once. The rule's severity and description changes are applied immediately because they describe the received trap rather than perform an external action.

System-wide email forwarding: When Enable forwarding traps via email is selected in SMTP settings, a trap that matches a suppression-enabled rule also delays the system-wide email. This works even when the rule has no action selected on its Actions tab. If the original trap is acknowledged or a related trap matches during the window, the system-wide email is not sent. A related trap that cancels pending work is treated as a clearing event and does not trigger external actions of its own during that evaluation.

If several suppression-enabled rules match the same trap, each rule's own actions use its configured delay. The single system-wide email waits for the longest applicable delay and is cancelled when any applicable rule's cancellation condition is met. Traps that do not match a suppression-enabled rule continue to use immediate system-wide email forwarding.

Manage Rules

Edit or delete existing rules.

Clear Table button

Remove all rows from the trap table.

Export Table to CSV

Export table data to a CSV file.

Options

Open the Trap Receiver settings.


Options

Command-line tools

Command-line tools are located in $INSTALL_DIR\bin.


Keyboard shortcuts

Ctrl-L

Load a MIB file.

Ctrl-F

Find a MIB node.

Ctrl-G

Run an SNMP GET operation.

Ctrl-N

Run an SNMP GET-NEXT operation.

Ctrl-E

Run a Get Subtree operation.

Ctrl-S

Run an SNMP SET operation.

Ctrl-W

Run an SNMP walk.

Ctrl-P

Stop current operation.

Enter

When the Operations list or Go button has focus, press Enter to repeat the last operation.

Ctrl-T

Open Table View.

Ctrl-R

Plot a graph.

Ctrl-D

Add to Watches.

Ctrl-O

Open the Watches pane.

Ctrl-I

Open the Trap Receiver pane.


Choose an edition

Personal Edition is free for private use on one workstation. You may redistribute the complete package for private use, but you may not use this edition for commercial or professional work.

Professional Edition adds management and monitoring features and is licensed for commercial or professional use.

Enterprise Edition adds service-based operation, advanced Trap Receiver capabilities, and enhanced monitoring.


Feature comparison

Feature Personal Edition Professional Edition Enterprise Edition

Runs on Windows, macOS, Linux, and other UNIX platforms

Included

Included

Included

Supports basic SNMP operations

Included

Included

Included

Table view for MIB tables

Included

Included

Included

SNMPv3 USM user management

Included

Included

Trap Receiver

Included

Included

Included

Trap Sender

Included

Included

Included

Supports IPv6

Included

Included

Included

Supports SNMPv1/v2c

Included

Included

Included

Supports loading any standard or private MIB

Included

Included

Included

Maximum number of loaded MIBs

10

No restrictions

No restrictions

Free

Included

Supports SNMPv3

Included

Included

SNMP expressions

Included

Included

Watches

Included

Included

Address Groups

Included

Included

Network discovery

Included

Included

ICMP Ping tool

Included

Included

ICMP Traceroute tool

Included

Included

Performance graph

Included

Included

Port view

Included

Included

Switch port mapper

Included

Included

Device snapshot

Included

Included

Cisco device snapshot

Included

Included

Device comparison

Included

Included

Trap forwarding by email

Included

Included

Periodic MIB table refresh

Included

Included

Dynamic table-row creation and deletion

Included

Included

Rule engine for processing traps

Included

Included

Run the Trap Receiver and Watches as a service

Included

Watch actions

Included

Email template

Included