[Index] [FineConnection web site]

Example 1. Manually building a Shooter that monitors port 7 of a switch.

This example demonstrates how to build a Threshold Shooter that monitors port 7 of a HP2524 switch. If the link on that port goes down, a "Threshold exceeded" event is generated. Port 7 only needs to be monitored during business hours (8:00 – 18:00), not during the night.

The link status of a port can be determined by verifying a port’s ifOperStatus field (a node from the mib-2 ifTable subtree). As can be seen in the MIB tree (click on the node in the tree and read its description), a value of 1 means the link="UP". Any other value means that the link is not functioning normally.

First step - Create the Shooter body.

1. Switch to Designer mode.
2. Select Edit|Manage Classes from the menu on the main window.
3. Right-click the Class for which to build the Threshold Shooter (In this example we use a HP2524 switch) and choose Define Shooters.
4. The "Define HP2524 Shooters" window opens.
5. Right-click anywhere in the Shooters box and choose Add a Shooter.
6. The "Add/Modify a Shooter" window opens.
   
   
   
   
7. Enter the name of the Shooter in the ShooterName box. (In this example, we use the name: "LinkDownTest")
8. Select "Threshold 10" from the ShooterType box. (The port status is polled every 10 seconds)
9. Use the "from" and "until" spin-edit controls to define when the Shooter must be active (from 8:00 until 18:00)
10. Press the Save button.
11. The "Add/Modify a Shooter" window closes. The new LinkDownTest Shooter appears in the Shooters box and has focus (See the Sel.Shooter box in the upper left corner of the screen)

Second step - Add a shooter-target to the LinkDownTest Shooter.

1. Verify the Community and IPaddress fields of the Test and Inspect box. Enter the Community name and the IP address of a test device manually if Monitor one was unable to assign these values automatically.
2. Walk through the MIB tree and right-click the ifOperStatus node from the mib-2 ifTable branch. (path: iso.org.dod.internet.mgmt.mib-2.interfaces.iftable.ifEntry.ifOperStatus)
3. Right-click the ifOperStatus node and select Inspect.
4. An SNMP request frame is sent to the test device. The MIB node turns green if the test device returns a valid response. Note that only green MIB nodes can be used as Shooter-targets.
5. Right-click the green node again and choose Add to the selected Shooter.
6. The "Add/Modify a LinkDownTest shooter-target" window opens.
   
   
   
   
7. Check the Append radiobutton from the OID/Instance box and enter .7 in the edit box. (.7 means port 7 from the switch)
8. Select the "not equal to" sign (<>) from the Threshold settings box, enter "1" (=UP, see the nodes description) into the edit box and check the RAW radiobutton.
9. Optionally, check also the Custom message radiobutton and enter a warning message (i.e. "The link on port 7 is down!"). This message is shown in the event message if a "link-down" event occurs!
10. Check the Show this field on screen control.
11. Press the Add/Modify button. The shooter-target is added to the LinkDownTest Shooter. See the snapshot below.
    
    

Third step - Start the threshold Shooter.

1. Right-click the device on the map for which to start the threshold Shooter and choose Shooters/Properties.
2. Click the Background Shooters tab. The LinkDownTest Shooter appears in the Available box.
   
   
   
   
3. Right-click the LinkDownTest Shooter and choose Start this Shooter for device <DeviceName>
4. The LinkDownTest Shooter icon moves to the Launched box.
5. The LinkDownTest Shooter is now started. You can verify its status by selecting Options|Threshold control from the menu on the main window. If port 7 is "up" then the "Threshold control" window shows:
   
   
   
   and if port 7 goes down: