TSP Lab	Sga8NPol - The monitor poller	Sga8NPol

The monitor poller module
`("Sga8NPol")`

Features

Remote Monitor unit maintenance functions:
- Optional restarting the Monitor unit (only the monitoring software or complete hardware reset)
- Query version information about the Monitor program and the SGA firmware
- Handles and forwards call trace requests and results

Basic operation

Collects statistical information from monitor units and stores it in files (Sga-8001.xxx) for further processing (Statistics Display module)
Collects event information (e.g. Monitor Unit died, PCM Frame Alignment is restored) from monitor units and store it in files (Sga-8002.xxx) for further processing (Event Display module)
Uses IP network for the connection
Uses ping command to ensure that the connection with the monitor is alive
Logs the Monitor unit responses
Sends SNMP traps to the Network Operating Center (NOC) or Network Management System
Performs self maintenance functions to ensure system integrity

User interface

The main menu

Menu	Menuitem	Shortcut(s)	Meaning
[Actions]
	Reload monitor units data		Reload link data for monitor units from `SL.dat` file
	Force monitor unit time sync	()	Synchronizes the time between the server and the monitor unit (This function in this version is unavailable.)
[Log]
	Find line containing...	(Ctrl-F)	Finds text in log window
	Find next matching line	(F3)	Finds next occurrence of text in log window
	Details		Detail level of logging (Off, Normal, Detailed, or Debug)
	Log automatic Monitor queries and OK's on screen		Writes into screen and log file "Monitor OK" queries and result
[Options]
	Accept monitors	(Ctrl-A, or )	Allows the Monitor units connecting to the server
	Auto-query monitors	(Ctrl-Q, or )
	Auto scroll	(ScrollLock, or )	Allows automatic scrolling of the log screen
	Show log	(Ctrl-Tab)	Shows the log screen
	Show monitor status	(Ctrl-Tab)	Shows the monitor status screen
	Show call trace status	(Ctrl-Tab)	Shows the call trace status screen
	Save settings		Saves actual settings into the configuration (`Sga8NPol.ini`) file

The popup menu of the monitor status screen

Right-click on the monitor status screen window to access this menu!

	Menuitem	Shortcut(s)	Meaning
	Ping this monitor (and gets its version info)		Checks the connection with the Monitor unit and gets the version information of the `GPRSMonitor.exe` program and the `GPRS_R01.obj` SGA card GPRS firmware code.
	Abort current remote capturing session on this Monitor		Interrupts the remote capturing (This function in this version is unavailable.)
	Abort current http session on this Monitor		Forces the Monitor unit to close its active http connection (This function in this version is unavailable.)
	Disconnect this Monitor from Server (Poller)...		Disconnects the selected Monitor unit from the server in the normal way `(gracefully)` or immediately by breaking low layer sockets `(immediately)`(This function in this version is unavailable.)
	Restart this Monitor...		Restarts the selected Monitor unit at specified time (can be one of the following: immediately, 5 minutes later or at 3:00 AM), what means restarting the `GPRSMonitor.exe` program module. (Additional options, such as the forget MSUs and reboot PC, too in this version are unavailable)
	Cancel previous restart request for this Monitor		Cancels previous restart request for the selected Monitor unit
	File upload for this Monitor		This function in this version is unavailable. Instead of this feature use ftp connection to upload files to the monitor.

The popup menu of the call trace status screen

Right-click on the monitor status screen window to access this menu!

	Menuitem	Shortcut(s)	Meaning
	Abort this call trace session		Interrupts the selected call trace session

The bottom status-line

Uptime: time elapsed since module has been started up

Configuration (`Sga8NPol.ini`) file settings

Section	Entry	Example	Meaning
[Position]
	iLeft	140	Position of the program module on the display screen
	iTop	72	Position of the program module on the display screen
	iWidth	995	Position of the program module on the display screen
	iHeight	694	Position of the program module on the display screen
[Options]
	bAutoQuery	True	(Refer to the `[Options]/Auto-query monitors` menu item!)
	bAutoScroll	True	(Refer to the `[Options]/Auto scroll` menu item!)
[Advanced]
	wLogDetailLevel	3	(Equals to the listed order; refer to the `[Log]/Details` menu item!)
	dwMaxPendingPerCallTrace	1000000	Number of pendings during a calltrace
	dwMaxLinesInLogWindow	1000	Number of lines in the log window on screen
	bAlternateTrapUID	False	Allows using fixed UIDs in SNMP traps
	sDataPath	d:\GPRS\data	Path for the DATA files
	sLogFilesPath	d:\GPRS\logfiles	Path for the LOG files
	sTrapFilesPath	d:\GPRS\LogFiles\Traps	Path for the SNMP Trap files to be sent

Version history

v1.11

(n) Status field to indicate count of Monitor units actually in "Down" state.

v1.10

(c) Can handle 64 Monitor units at most (instead of the former limit of 30).
(c) Log on start-up includes the section name for the particular INI settings.

v1.09

(c) Sga-8004.xxx are written onto disk again - they are used for Capability Statistics.

v1.08

(c) Excepts a maximum of 768 bytes (instead of the former 500 bytes) per packet per Monitor unit.
(f) Some error message boxes had non-informative caption.

v1.07

(n) Count of Monitors and SigLinks are logged after loading SL.DAT.
(f) "Size of pending Task #5 datagrams has exceeded INI/dwMaxPendingPerCallTrace!" error message is logged only once per call trace session (used to repeat).
(n) Checking for TCP communication ports' availability at start-up (thus cannot accidentally be started twice).
(c) Actions / "Query next statistics now!" menu item is removed.
(n) Shift-ESC combination minimizes application window.
(c) All accepted Monitor as well as Call Trace connections utilize the TCP keep-alive capability.
(c) List reflects MonitorID's change.
(c) Monitors are ordered by their ID after each Reload operation.
(f) Failed to drop Monitor from list if subsequent units were omitted.
(c) Opening and closing (and deleting) of input and output files are logged only in case of LogDetailLevel=Debug.
(f) Monitor IP number is visible in Off and Normal log level modes, too, when Invalid Magic Code is received.
(c) File upload capability is completely removed.
(c) Actions / "Force monitor units time sync" menu item becomes grayed.
(c) INI/[Advanced]/sTrapFilesPath defaults to "c:\TrapFiles" (instead of former "c:\data\traps").
(n) INF trap on module start-up ("'Sga-GPRS Monitor Poller v1.07' module is started.").
(c) Log / "Log 'Monitor OK' queries and results" menu item's name is changed to "Log automatic Monitor queries and OK's on screen".
(c) Call trace queries and SNTP answer are no longer logged on screen if "Log automatic Monitor queries and OK's on screen" is off.

v1.06

(n) Handles and forwards call trace requests and results.
(n) INI/[Advanced]/dwMaxPendingPerCallTrace (default to 1000000, logged on start-up).
(n) Call trace status window; popup menu item: "Abort this call trace session".
(c) Removed "Reload OpPref.cfg and/or IMSIPref.cfg on this Monitor" menu items.
(c) No longer handles "Reload OpPref.cfg" and "Reload IMSIPref.cfg" ACK messages.
(f) Eliminates a rare but erroneous situation that might have resulted in "Serious error: Could not open internal file for polling data!" error message.

v1.05

(n) Alternatively, SNMP trap UID's with fix codes (see doc for details)
(n) INI/[Advanced]/bAlternateTrapUID (defaults to 'False')

v1.04

(n) Optionally CEA is emitted when switching alert level of an existing one
(n) INI/[Advanced]/bCeaseBeforeSwitchingAlertLevel (defaults to "False" for compatibility with previous versions; actual setting is indicated on start-up)

v1.01

(c) Handles 24 character long statistics IDs (names) sent by the Monitors

v1.00

(n) Initial release

Known bugs

No bug is known at present.

The monitor poller module("Sga8NPol")