Engineer's Edition

                                Broadband Engineer's Edition

The SolarWinds Trap Editor is used to modify SNMP Trap Templates used by SolarWinds Network Management Tools. By using the Trap Editor you can create SNMP Traps of almost any structure, including mimicking Traps generated by network hardware.

Getting Started

The SNMP Trap Editor opens without loading a template.  You may either open an existing template, or create a new template from scratch.  There are a couple predefined templates that come with the toolset, and these are located in the folder C:\Program Files\SolarWinds\Common.

Start by opening the Orion-Generic-Alert Trap Template.

Adding an OID

Now add another OID to the existing Template.  This can be done by selecting Add OID in the Trap menu, or by clicking the  button.

 

A new row is added to the template.  Now you may either type the OID, or you can browse the MIB tree by clicking the  button.  When you click the  button, the Select OID dialog is displayed.

 

Browse to the OID you wish to add, and then click OK.  Now enter the value or macro you want to send with this OID.

 

Next, set the Data Type by choosing from the drop-down menu.

 

Notice the Name field automatically updates once you have chosen a Data Type.  You can now save the changes, and you can even sent the Trap to test it out. 

Send Trap

To do this, you can either select Send Trap from the Trap menu, or you can click the  button.  The Send Trap dialog is displayed.

 

Type in the Hostname or IP Address and the Community String of the device you wish to send the trap to and click Send.

A good way to test your Traps is to send them to a server/workstation that is running the SolarWinds SNMP Trap Receiver.

SNMP Trap Editor Menus

File Menu

New Trap

Opens a new SNMP Trap Template formatted for SNMP v2. 

Open Trap

Opens a previously saved Trap Template.

Save

Saves the current Trap Template.

Save As

Saves the current Trap Template into a new file.

Revert to Saved Copy

Restores to the saved Template configuration discarding any changes.

Close

Closes the current Trap Template.

Export to HTML

Exports the results to an HTML file. 

Export to Plain Text file

Exports the results to a text file. 

Export to Comma Delimited File

Exports the results to a comma delimited file. The file extension will be *.CSV. 

Export to Excel Spreadsheet

Exports the results to an Excel spreadsheet. You must have Excel installed for this to work.

Export Directly to Microsoft Excel

Exports the results to an Excel spreadsheet and then opens the spreadsheet in Excel. You must have Excel installed for this to work. 

Export to PDF

Exports the results to a PDF file.

Print Preview

Previews the results exactly the same as it would appear when printed. 

Print

Prints the scan results.

Exit

Closes the Trap Editor

Edit Menu

 

Copy

Copies the highlighted value to the Windows clipboard.

Duplicate

Creates a copy of the selected OID in a new row.

Select All

Selects all cells in the current Trap Template.

Delete

Deletes the highlighted OID from the Template.

Trap Menu

Edit OID

Displays the Select OID dialog allowing you to change the current OID.

Add OID

Adds a new OID (row) to the Trap Template.

Shift Up

Moves the highlighted OID up a row.

Shift Down

Moves the highlighted OID down a row.

Send Trap

Opens the Send Trap dialog.

You can browse to an OID instead of typing it out.

To do this, click the  button next to the OID you with to add/edit.  This will bring up the Select OID dialog.

References for Understanding SNMP Traps

Cisco's article on Understanding SNMP Traps

Understanding SNMP MIBs by David T. Perkins, Evan McGinnis

References for Configuring SNMP Traps

Cisco IOS SNMP Traps Supported and How to Configure Them

Configuring SNMP Traps - Juniper.com

Q    What is an SNMP Trap

A     SNMP Traps are network notifications sent on UDP port 162.

Q    Can I send the value of any OID?

A     No, you can only send values stored in the NPM database.  These values must also have an associated macro in order for the field to populate.

Q    Can I create custom macros to add to a Trap?

A     No, only macros that are a part of NPM can be used with this tool.  For a complete list of macros and their associated values, please refer to the Alert Macros chapter.

Q    How do I copy an existing Trap Template to this tool?

A     Send a Trap with the Template you want to copy to the SolarWinds Trap Receiver, and then save the Trap to the folder C:\Program Files\SolarWinds\Common.  You can now open this Trap Template with SNMP Trap Editor.

Q    How is an SNMP v2 trap defined?

A     SNMP v2 Traps are defined by RFC1905 (http://rfc.net/rfc1905.html).  The required OIDS in a v2 trap are :

- SysUptime (1.3.6.1.2.1.1.3)

- TrapOID ? (1.3.6.1.6.3.1.1.4.1) - The authoritative identification of the trap being sent.

- Any number of variable bindings.