Share

ISG Tools

File Release Notes and Changelog

Release Name: isgtools-0.0.3

Notes:
ISG Tools is a small set of scripts and html that allow you to perform most of
the commands that are utilized in a telnet session to a uBR via a web based
interface. Modem searches (by partial or full mac address) take about 15
seconds on a 7 uBR system.

ISG Tools also comes with several backend monitoring scripts that do
things like ip address logging.

Current and historical ip data can be searched thru using two included cgi
scripts.

ISG Tools is designed for use with Cisco uBRs. Other equipment may require
manual editing of the scripts and some of the commands used within them.
There are a couple of configuration requirements for both the host machine
and the uBRs. It also may be useful to note that this was developed and is
in operation on a redhat 7.x system.

ISG Tools was developed in a real world enviorment. This package is
currently being used to assist in supporting a 15,000+ user system.
What used to take 3-8 minutes over the phone can now be done in a matter
of seconds.


CGI Features:
 * Search for a modem (searches all uBR's) using partial mac address
   Modem Search ping tests the modem and both hosts behind the modem.
   It also lists the modem, host, previous days flap, and live
   flap statistics. After the search is complete you can reset the modem,
   clear either host, clear the modem from the flaplist, "watch" the signal
   levels (signal level page that auto refreshes every 1-3 seconds), or pull
   the modems logfile with a single click. There is also a "text version"
   link that has the same information in text format for easy copying and
   pasting into email or an internal ticket based support system

 * Two simplified versions of the above search script. One that is geared
   for a dispatch or tech oriented enviorment where you don't need to
   reveal more than basic signal information and you want to hide client
   ip addresses, and one that is a self service cgi for customers to
   access to test their own modems. The second script is in plain language,
   has basic mac and ip information, modem name/uptime, ping tests, pass or
   fail upstream/downstream/snr test, if it detects more than 30 flaps
   it will display 3 different warning messages.

 * Pull live statistics from any of the uBR's. Includes: IOS Version, Uptime
   Information, SNR information for every blade, and modem statistics

 * Pull the daily flaplist from any uBR

 * Pull a live flaplist from any uBR

 * Look at modems currently offline from any uBR

 * Look at modems currently in the init state

 * Look at modems that are currenlty max screamers

 * Realtime search for an ip address (shows modem & hosts behind it)

 * Historical (Month/Day/Hour) search for an ip address


Backend Features:
 * Creates daily flaplist, clears the flaplist, and emails the results to
   selected mail recipients.


 * Logs IP addresses from all uBR's. Keeps a 1 year compressed backlog.

 * Searches ip logs daily for invalid ip addresses and emails the results
   to selected mail recipients.



Changes: 05.01.02 / v0.0.3 * fixed bug w/long ip address searches in the ip search and historical ip search scripts * fixed minor bug w/signal indicator code * added support for up 50 uBRs * eliminated errors attributed to unused/unconfigured ubrs * removed several non-standard command line switches (java binary) * added support for user/pass as well as plain password logins * updated documentation (read this if you've had any installation issues) * added word .doc and .html versions of the new (end)users guide