FAQ

Frequently asked Questions about Unbrowse SNMP

Answers

Help

I am really stuck, where can I go for help ?

You can press the F1 key to access the Unbrowse SNMP online help (or)
email us at for help

Installation

How can I install Unbrowse SNMP for all users on a machine ?

To install Unbrowse SNMP for all users follow these steps.

Login as a user with local administrator rights
Type msiexec /I setup_unbrowse_R_xxx.msi ALLUSERS=1

I have installed successfully but when I run it for the first time, I get a “Check Permissions” error message. What is going on ?

Unbrowse SNMP follows Microsofts recommendation for storing user settings and application data. It stores all information in the %APPDATA% folder (usually C:\Documents and Settings\(Your User Name)\Application Data\Unleash Networks\Unbrowse SNMP. You therefore need full permissions on this folder. If you do not have sufficient permissions you may get an error dialog similar to the one shown below.

To fix this problem,

Right click on that folder and select the "Security" tab.
Make sure your user/group is listed and permissions is set to "Full Control"

Do I need to install a runtime before installing Unbrowse SNMP ?

No, Unbrowse SNMP is a native windows application. It does not require Java or .NET runtimes.

How can I delete all modules and start over afresh ?

Sometimes, you may want to just start everything afresh. Reinstalling Unbrowse SNMP will still read in old configuration data and old MIBs.

To start afresh locate and delete the %APPDATA%\Unleash Networks\Unbrowse SNMP folder. The next time you start Unbrowse SNMP it will recreate all the necessary folders and configuration files.

Can I put Unbrowse SNMP in Free Features mode ?

During the eval period all the Power Features are enabled and I want to see what life looks like after the eval period.

Yes, to forcefully disable all Power Features during the eval period, select Help->Disable Power Features menu

Compiling MIBs

How do I compile MIBs and organize them ?

You can organize modules into folders (called repositories) or alternately just let Unbrowse SNMP dump all modules in the “All User Modules” repository.

To compile MIB files and place them in a repository, Right click on that repository and select “Add ASN.1 MIB files”. You can select any number of mib files for compilation.

Click here for a Flash Video demonstrating how this is done.

How can I compile MIBs that do not follow any file naming conventions ?

The unwritten convention among MIB file authors are that the name of the MIB file must be the name of the module defined in the MIB. The file extension can be .my , .smi, .mib, or .txt. This helps with the compilation process because it is easy to locate an imported module by just searching for a matching filename.
For example : A file defining the module CISCO-VTP-MIB will be named CISCO-VTP-MIB.my

Today, it seems this convention is not followed. We know of several vendors who name their MIB files independently of module names. To deal with this enable the “Deep Search for Imported Modules” option in the Compiler Dialog. This option is turned on by default. Compilation time could take slightly longer especially for the first few modules, but overall should not have any significant impact.

How can I make the MIB compiler tighter ? It seems to compile anything I throw at it !

Unbrowse SNMP ships with the default compiler settings set to “very lenient”. Even if some key imported modules cannot be found, Unbrowse will compile it and assign the module to the .0 tree. (Which is invalid). To tighten the compiler set the Strictness level to 4 or above in the Compiler tab of the settings.

Strictness option

MIB Browser / Walker

How can I enter binary data into the “spreadsheet” ?

By default, the data you enter into the table for OCTETSTRINGs is considered to be an ASCII string. If you want to qualify your input you can use the HEX: and TEXT: qualifiers in front of your string.

Default All OCTETSTRING cells are considered to be plain ASCII text. This is the default behavior
Entering binary data If you want to enter binary data into an OCTET STRING cell. Precede the hex string by the literal "HEX:"
Entering text data You can optionally precede strings with the literal "TEXT". The string is then interpreted as ASCII text.

How can I retrieve objects from various modules ?

You can select objects from retrieval by select all the tree nodes, then right clicking and selecting the “Create New Walk” item. You can also drag and drop nodes into an existing walk window.

Click here for a Flash Video demonstrating how this is done.

Trap Console

How can I change the HTTP port of the Trap Console ?

By default, the trap console can be accessed remotely at the port 12801.
If you want to change it, use the following steps.
1. Locate the file %APPDATA%\Unleash Networks\Unbrowse\Cfg\TBCFG.xml
2. Change the "minihttp_port" parameter from 12801 to any port of your choice.

How can I change the look of the HTML generated ?

The trap console uses stylesheets to render the HTML. Unbrowse SNMP comes with some stock styles. You can use these styles or write your own stylesheet.
To change the stylesheet.
1. Select Tools->Customize->Advanced from the main menu
2. In the Miscellaneous section, scroll down and locate the Trap Console group
3. Locate the item names "Stylesheet for HTML Export"
4. Click on the item and select from "Custom, Brazilian Taste, Clear Blue, or 10 minutes"

The stylesheets are located in the Program Files\Unleash Networks\Unbrowse SNMP\Cfg folder. You can edit them if you wish.

Should I use Winpcap or Windows Raw Sockets (the default ) ?

Like its bigger cousin Unsniff Network Analyzer, Unbrowse SNMP uses the concept of providers to access network data. The default provider for Unbrowse SNMP is Windows Raw Sockets. You can also install Winpcap for much more enhanced functionality.
The advantages are :
1. Winpcap provides access to VLAN information
2. Using Winpcap, you have have Unbrowse SNMP view all traps irrespective of source or destination.
3. Overall better performance due to internal buffering.

Is authPriv supported ? Why not ?

Yes. Unbrowse SNMP supports decrypting and authenticating SNMPv3 Traps.

Can I be notified via email / SMS when some traps are received ?

Yes. The Unbrowse scripting interface allows you to perform any custom action upon receiving a trap. This approach combines the high performance of a C++ native Windows Trap Receiver with the flexibility of a scripting language like Ruby or VBScript.

We have ready to use samples for :

Where should I connect the trap console ?

Unlike other trap receivers, Unbrowse SNMP does not need to be a trap target in order to collect traps. This allows you to stick Unbrowse SNMP in any location in your network and start collecting traps.
Here are some tips.

For small number of traps, you can install Unbrowse on the management station (eg, Cisco Works, HP Open View)
Attach a network tap adjacent to the network segment containing the management stations. This will ensure a high visibility into trap activity.
SPAN a port adjacent to the management stations.
Tap or SPAN a port adjacent to network elements. Use this method if you are debugging a specific router.