Unbrowse Automation 1 : Adding SNMP Agents

This is the first of a two part article about Unbrowse SNMP scripting.

It is not uncommon for network administrators to deal with hundreds of devices scattered over a large geographical area. The device details are usually stored in a network management system such as HP Openview or CiscoWorks (both trademarks of their respective organizations). This article explains how you can use scripting to import SNMP agents into the Unbrowse database.

scriptagent.JPGUnbrowse SNMP is a MIB Browser and Trap Receiver that is intended to be used as a powerful troubleshooting and an all around utility. Unbrowse keeps track of agents (devices) and stores information such as IP addresses, community strings, timeouts, SNMP versions, V3 usernames, auth and priv passwords, and so forth. This allows the administrator to quickly manage devices without having to enter these details each time. This will work as long as the number of devices are few, when you are dealing with hundreds of devices it is not feasible to enter them manually into a tool like Unbrowse. Dont worry, help is at hand. You can write simple scripts in VBScript or Ruby to add devices automatically into Unbrowse.

Part 1 : The Automation objects

In this section, we will look at the methods and properties of the automation interface.

The Agent Manager object

This object is createable via the “UnbrowseSNMP.AgentManager” id. To create this object in

VBScriptSet Mgr = CreateObject("UnbrowseSNMP.AgentManager")Ruby

agentMgr = WIN32OLE.New("UnbrowseSNMP.AgentManager")



Name Purpose
Init Initialize the manager (not necessary to call this)
NewAgent Create a new agent object. You can then set the properties of this object
AddToRepository Parameter: an agent object. Add this agent to the database
RemoveFromRepository Parameter: an agent object. Remove this agent
FindAgent Find an agent by name. Returns the agent object or null

The SNMP Agent object

The following table show the supported properties on the object

Name Purpose
IPAddress The IP Address of the SNMP agent (can be an IPv6 address)
Name Name of agent
Name Purpose
SNMPVersion Version used to communicate (0=v1, 1=v2c, 3=v3)
ReadComm The community used for reading from agent (v2 only)
WriteComm The community used for SET requests (v2 only)
SecurityName The v3 USM user name
ContextName The v3 context name
SecurityLevel The type of v3 security (0 = noAuthNoPriv, 1 = authNoPriv, 2= authPriv)
AuthProtocol v3 authentication protocol (0=MD5, 1=SHA)
PrivProtocol v3 privacy protocol (0=DES, 1=AES)
Port The UDP port to which requests are sent
Timeout Timeout in milliseconds
Retries Number of times to retry communication before declaring error


Thats all. You only have to now write scripts to manipulate these two objects. It is really easy. In the next part we will write a script in Ruby to import devices from a CiscoWorks DCR v3 file.


[tags] MIB Browser, SNMP Agent, VBScript SNMP, Unbrowse, CiscoWorks, DCRv3 format, Ruby SNMP [/tags]

New MIB Packages released for Unbrowse SNMP

What is a MIB Package ? 

A MIB Browser is only as brainy as the number of MIBs you have installed in it. Out of the box, Unbrowse SNMP comes only with a few standard MIBs such as RFC1213-MIB , IF-MIB and a dozen others. You then compile in whatever MIBs your particular network element (router, switch, server) requires.

If you dont want to hunt around and compile the MIBs yourself, you can install “MIB Packages”. A MIB Package is a special ZIP file that contains pre compiled MIBs along with the corresponding text MIB file. Unleash Networks creates these MIB packages by tracking the public MIBs of popular vendors.

See this page for more information

We have released the following SNMP MIB packages for popular vendors today (19-Dec-06). Grab them for free !


  • All Cisco MIBs (updated) – A monster MIB package with all the latest public MIBs from Cisco Systems.  This contains 998 modules and over 65,000 objects ! The best way for you to get started with Cisco is to just download this MIB package and install it in Unbrowse SNMP. Instantly, Unbrowse will be able to decode all of Cisco Traps, you can do MIB browse Cisco switches and routers, etc. All of Cisco equipment including Altiga is included in this monster collection. The download is about 30MB, required disk space is 150MB, and it takes about 3-5 minutes to install. Download here
  • Juniper JunOS MIBs (updated) – Contains all the mibs for JUNOS Software Enterprise MIBs for J-series, M-series, and T-series Platforms Release 8.1. These mibs for Release 8.1 were published on the Juniper Networks website on 6-Nov-06.
  • Juniper ERX MIBs (updated) – Contains all the mibs for the Juniper Networks ERX E-Series Edge router version 7.3 release on 14-Nov-06
  • Motorola Canopy Wireless MIBS ( new ! ) – Some of our users are working with the Motorola Canopy Wireless platform. This package contains SNMP mibs for Canopy Enterprise MIBS for CMM Micro, Subscriber Modules, Access Points and Back Haul Radios. Version 7.3.6. Note: We have included two modules for the CANOPY-SYS-MIB. Even though they have the same names – one of them is used for the 45 Mbps backhaul links and the other for 300 Mbps backhaul. Choose the one you want by Right-Clicking the module and selecting “Open SMI”.

We also released a new build of Unbrowse SNMP available at the downloads page. This release fixes some problems with (a) compiling certain MIBs with incorrect SNMPv1 TRAP TYPE objects, (b) errors with custom UDP ports, (c) other minor fixes.

[tags] Cisco MIBs, Cisco SNMP, Juniper SNMP, Canopy MIBS, Motorola Canopy Wireless, Enterprise MIBs, MIB browser packages [/tags]

Unbrowse SNMP permissions on Windows 2000

A couple of users said they had trouble installing / running Unbrowse SNMP due to permission issues on Windows 2000 systems. This post is intended to give more detail on how this can be resolved. Also see Unbrowse FAQ.

Unbrowse SNMP abides by Microsofts guidelines for managing user data and settings (See Microsoft Technet article). What this means is : all user settings are stored under the users Application Data folder. This folder can be viewed by typing in %APPDATA% in the Start Menu > Run box.

When a user first launches Unbrowse SNMP, it tries to create a place for storing configuration data under the above mentioned %APPDATA% folder. The subdirectory is called “Unleash Networks\Unbrowse”. If this directory cannot be created you will be confronted with a dialog box similar to the one shown below.


Checking permissions of the APPDATA folder

1. Select “Start -> Run” and type in %APPDATA% in the box. Then click the OK button.

2. Right-click on an blank area (not on any file) and select “Properties”.

3. This will bring up the Properties window of the Application Data folder. Switch to the “Security Tab”. You should see something like this.

Figure below : Administrator has “Full Control” privileges. Correct !


Not like this.

Figure below : User vivk1 does not have Write/Modify privileges. BAD !


Check the “Full Control” item to give Read-Write access to the folder.


If there is a folder called “Unleash Networks” within the Application Data folder. Delete it. Unbrowse SNMP will recreate it on first run.

Hope this helps.

[tags] snmp, mib browser, windows2000, permissions [/tags]