ChanStat program Description Code for One account number used on several pages.

FindLink Banner Exchange and Search Engine
FindLink Banner Exchange and Search Engine

Russian version

CISCO channel statistics program

Download

Aport Ranker

Version 3.1

(C) Serge Ryvkin, 1999

E-Mail: ryvkin@i.am


0. Program registration
1. Common information
2. Used CISCO OS commands
3. Installation
4. Program description
5. Used tools
6. Acknowledgments
7. History
8. Future plans
9. Technical support
10. Usefull links





0. Program registration ^


From version 3.0 the program is distributed as ShareWare. In unregistered version could be used vithout any limitations all functions of previous FreeWare versions, but registration gives additional benefits.

From version 2.0 format of configuration data and encryption algorithms changed. You should store new data by running program, entering passwords and pressing OK in configuration window. The same must be done after saving new registration file (ChanLoad.key).


1. Common information ^


This client/server program was developed for system administrator and network users would be able to see main Internet channel statistics in real time. It can show for selected channel such information as:

To decrease CISCO router usage, the program may work as HTTP server. In this mode it gets router statistics and can distribute these data by browser request.


2. Used CISCO OS command ^

For this program was used following blocks of commands:

  1. to update current statistics:
  2. to clear channel counters
  3. to enable IP accounting
  4. to disable IP accounting
  5. to get and clear IP accounting data
  6. to get CPU utilization data


3. Program installation ^

The program don't need installation, to run it Microsoft windows sockets should be installed. For deinstall program you can delete unnecessary Registry information, after that delete all files from working directory.

During first start of program banner advertisement block from Aureate Media Corporation is initializing. You can enter requested information to receive only interesting for you advertisement information in the future. If you don't want to enter any information, you can press CALCEL. In this situation default information settings will be used. In registered version of the program banner advertisement will not be shown.

After installation of new program version on the old, the good idea would be to enter into configuration window, check data and press OK to overwrite configuration data.

4. Program description ^

The program was developed as client/server Win32 Internet/Intranet application. Server part of it regularly connects vial TELNET to the CISCO router and gets statistic information about selected channel. Client part regularly connects to the server to get the same information. After it, the program shows got information.

Program command line options

ChanLoad [/DEBUG] [Router name]

where

[Router name] - using this parameter in Server mode may be run multiple instances of program with different configuration data

[/DEBUG] - using this parameter you can receive internal error messages and error messages of interaction with router during program run in file DEBUG.LOG

After startup, main program icon appears on System Tray. With context menu administrator should set up parameters:

Configuration window screenshot

With Configuration command of context menu administrator must set up following parameters

CISCO host: IP address or DNS name of host
CISCO port: port number for TELNET connection (Usually 23)
User name: user name for AAA password authentication
TELNET PSW: standard password for TELNET connection
Admin PSW: administrative password
Interface(s): nterface name to show it statistics. Multiple interfaces may be delimited by ';'. If Multi Channel check box is not checked, information will be get from first of listed. It is possible add extended name to the interface for improve visuability of information. In this case each interface name may consist with name and extended name, delimited by '!'
Refresh time: time between statistic request (in ms). Must be not less than 5000 ms.
Logging time (min): time interval (in minutes) between saving of Log with average for this interval information. Zero value disables logging.
Log Name: name of Log file. Log file contains following information:
  • Date-time,
  • Router name,
  • Channel name,
  • Channel State,
  • Channel Load (Input),
  • Channel Load (Output),
  • Volume (Input),
  • Volume (Output)
about all listed in Interface(s) channels (depending on MultyChannel switch). About adding date and time information to Log file name see later.
BandWidth: Maximum channel bandwith (bit/s). If select 'Auto' Bandwidth will be retrieved from channel statistic information (Bandwidth parameter of channel setup)

(HTTP Server)
Enable: Enable / Disable embedded HTTP server
Port: IP port, for HTTP server. If this port is already busy, the program is trying to find first free port incrementing this value
Time GMT: Difference between local time and Grinvich time (GMT)
Name / Password: Name and Password for get access to HTTP server
Autorefresh: During HTTP server work it is possible autorefresh pages generation with refresh time corresponded to period of data receiving from CISCO router. I suggest to not use this option during work via Proxy.

(IP accounting)
Enable: enable/disable receiving IP accounting information
Switch On After Start: switch IP accounting ON after program start
Switch Off Before Finish: switch IP accounting OFF before program termination
Clear: clear IP accounting during program work. I don't sugest use this mode because of non stable results of CPS measurement and grouth of used router memory
Interfaces: interfaces list (delimited by ';'), for which the program counts the IP accounting information about outpout packets
Subnet / Mask: Inner subnet for which the program counts IP accounting information. It is possible multiple subnet accounting. Each Subnet address/Mask should be delimited by ';'. If you want to watch all addreses, set Mask to '0.0.0.0'
Host by Address Enable enable/disable show of DNS (NetBios) host name on IP accounting graphic. In correspondance with this switch will be written or no host names to Log file. For properly work the Wins server must exists in the network (or it analog - LMHOSTS file ) or all hosts must have reverse PTR record on DNS server (or HOSTS file). If not, it would be inpossible get host name by IP address
Logging time (min): time interval (in seconds) between saving traffic information of each subnet IP address. Zero value disables logging. Must be not less than 5 min.
!!!! ATTENTION !!!!
Log file contains ALL information about subnet workstation traffic during this time interval, so it size may race fast
Log Name: name of Log file with traffic information. If file with such name does not exist, the program creates new file and writes header with column names. So, if user want to change Log file format, he should change file name or delete old Log file. During worktime it is opened in mode to enable another program open it in ReadOnly mode. Log file contains following information:

Full Log Enabled

  • Date-time,
  • Router name,
  • IP address in watching subnet,
  • Host name (if request host name by address enabled)
  • IP address (corresponded),
  • Host name (if request host name by address enabled)
  • Input Volume,
  • Output Volume

Volumes are counting from last saving time. Only non-zero volume values are writing. About adding date and time information in Log file name see later.
Full Log Enables write Full IP accounting Log - with addresses of source and destination hosts
Look after correspondents Enables mode for watching correspondent addresses' traffic throught router. !WARNING!This mode may decrease productivity. All information about correspondent addresses (including Host Names) will be cleared every time after writing IPA log
Threshold: number of records in memory for IP accounting. If this number or frequency of IP accounting data receiving is not enough, message 'Low IP accounting threshold memory !!!' apears in the status line of Subnet Traffic window.

Session window enable/disable window with text of current telnet session
Multy Channel enable get information from multiple interfaces, listed in Interface(s)
CPU Utilization enable get information about CISCO CPU utilization and show it in common statistic window. ChanStat retrieves such data about CPU utilization as
  • Average last 5 second CPU utilization
  • i.e. for interrupts
  • Average last 1 minute CPU utilization
  • Average last 5 minutes CPU utilization
If checkbox is checked, average received data will be written to common log file.
Clear counters clear Volume traffic counters, correspondently, never, everyday, every week on monday, 1-st day everymonth. Button press clears counters at once. This button available only on Server, and only if was entered CISCO administration password.
Select default mode Gives possibility to select, which window will be opened by double click on program's Tray Icon. User can select between 'Top 10 Traffic Makers' and 'Common Statistics'

Buttons on configuration window:
Cancel: Undo last changes and close configuration window
OK: test values, set up parameters and save them in Registry. After that the program tries to restart.
Clear Registry clear all previous entered data from Registry. After this the program exits. It's safe to delete directory with th program to finish deinstallation
Help English / Russian hyper-link to corresponding home-page


All parameters are saved in registry key:

HKEY_CURRENT_USER\Software\ChanLoad\Config

ConfigData - Config parameters

Multy, Session, IPA, Config - correspondent windows parameters

password parameters are encrypted.

Name of Log file can have information about date and time (for example, to everyday logging). To do it, user should add (D) before Log file name. In the file name can be used following symbols:

After setting the configuration parameters, tray icon of the application shows current channel summary load gauge. Application hint shows this information in digital way. Double click on it opens full statistical window. To close this window you should click to flashing circle on the right. Depending on working state, this circle can be filled with three colors. Red - state, when data is retrieving from router. Yellow - data is treated. Green - data information is ready for show.

Single channel mode

If multiple channel mode is set, tray icon, hint and status bar in statistical windows show information about first listed channel. To select another, user should click to such channel chart in statistical window. Data about this channel will be shown by tray icon and hint.

Multiple channel mode

If IP accounting is enabled in the program, it enables accounting on router after start and disables before finish (this process needs some timeout time). During worktime the program regulary receives traffic information from CISCO router. Full translated information it writes to the Log file. User can see 'Top Ten Subnetwork traffic makers' graphic. It can be shown by menu command 'Subnet Traffic'. To close Traffic Information Window user should click to flashing cyrcle.

In registered version of program there is gray cyrcle in left upper corner of each filled line. After click on it another watch mode will be enabled. In this mode user can look after correspondents of selected address. Gray window with summary of selected address' traffic will be moved to the top (and cyrcle will became blue), and in white windows will contain traffic information for corresponded addresses. To return into normal mode user should click to blue cyrcle.

Subnet traffic mode

If HTTP server enabled, embedded HTTP server can answer browser requests like:

HTTP://Server Name:Port

his answer contains page with list of all running on this computer ChanStat servers with possibility to request information about channel load and subnet traffic from each of them

Context menu command Disable/Enable can stop/start getting information. To exit application, user should use EXIT command from context menu.

5. Used tools ^

For developing this application was used following tools:


6. Acknowledgments ^

Особая благодарность за новые идеи и помощь в отладке


7. History ^

28.06.1999 (Version 3.2)

28.06.1999 (Version 3.1)

03.05.1999 (Version 3.0)

09.03.1999 (Version 2.1)


03.03.1999 (Version 2.0)


29.01.1999 (Version 1.2)


18.01.1999 (Version 1.1)


29.12.1998 (Version 1.0)


8. Future plans ^


9. Technical support ^

I will provide technical support for registered users through E-mail. If you want help to resolve some problems with my program, please write me a message with following information:

It is possible send message to ChanStat maillist. Messages sent to this maillist will be received by all ChanStat registered users, so somebody may help you to resolve some problems.

10. Usefull links ^




Serge Ryvkin ryvkin@i.am
ICQ 4970265

Qwerks