TSP Lab	Sga7NPol - The monitor poller	Sga7NPol

The monitor poller module
`("Sga-7N-S")`

Basic operation
User interface
Configuration
Version history

Basic operation

Accepts connections from monitors on the monitor list
Receives data from monitors and creates temporary data files for further processing
Handles keep-alive function for maintaining connections
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
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
Send passwords to monitors for roles

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.)
	Spread role passwords to monitor units		In a new pop-up window the passwords for different roles can be given (In the 7N system Role#0 and Role#1 are used. In this demo type 'p' for Role#0 and Role#1, as well.)
[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 (`Sga7NPol.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 `7NMonitor.exe` program and SGA card 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
	Reload count thresholds on this Monitor		In this version this feature is not used.
	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)`
	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 `7NMonitor.exe` program module. Additional options: such as the forget MSUs: stored MSU's will be deleted reboot PC, too: the PC will be reboot
	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.
	Abort current file upload on this monitor		This function in this version is unavailable.
	Acknowledge previous problem of this Monitor :-)		If there is a problem with a monitor unit a ':-(' sign will be shown, and this sign can be remove with this option
	Acknowledge all previous problems :-):-):-)		This option will remove all ':-(' signs

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 (`Sga-7N-S.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 call trace
	dwMaxLinesInLogWindow	1000	Number of lines in the log window on screen
	dwDataFileCutSize	10000000	Temporary files will be cut after reaching this size
	sDataFile7001Path	d:\DataFiles	Path for the Sga-7001.* files
	sDataFile7002Path	d:\DataFiles	Path for the Sga-7002.* files
	sDataFile7004Path	d:\DataFiles	Path for the Sga-7004.* files
	sDataFile7008Path	d:\DataFiles	Path for the Sga-7008.* files
	sDataFile7009Path	d:\DataFiles	Path for the Sga-7009.* files
	sDataFile7010Path	d:\DataFiles	Path for the Sga-7010.* files
	sDataFile8004Path1	d:\DataFiles\8004-1	Path for the Sga-8004.* files
	sDataFile8004Path2	d:\DataFiles\8004-2	Path for the Sga-8004.* files
	sLogFilesPath	d:\LogFiles	Path for the LOG files
	sTrapFilesPath	d:\TrapFiles	Path for the SNMP Trap files to be sent

Version history

v1.34

(c) Remove unused menu items
(n) Possibility of multiple connections from the same IP address (ID-based connetion)

v1.33

(c) Can write IMSI-IMEI data into three output folders instead of the earlier two folders
(n) [Advanced] / sDataFile8004Path3_IMEI

v1.32

(n) Handling of IMSI-MSISDN records
(c) [Advanced] / sDataFile8004Path1 ---RENAME---> sDataFile8004Path1_IMEI
(c) [Advanced] / sDataFile8004Path2 ---RENAME---> sDataFile8004Path2_IMEI
(n) [Advanced] / sDataFile8004Path1_MSISDN
(n) [Advanced] / sDataFile8004Path2_MSISDN

v1.31

(c) Call Trace related entries ("[q]: <<< Request is sent.") are only logged on "Debug" level.
(n) F12 key sets log detail level to 'Off'.

v1.30

(c) "Sga-8004.NNN" files are placed in two folders.
(c) Entry INI/[Advanced]/sDataFile8004Path is obsolete.
(n) New INI/[Advanced] entries:
- sDataFile8004Path1
- sDataFile8004Path2.

v1.29

(c) Maximum data length of CallTrace is incremented.

v1.28

(c) Can handle 400 Monitor units at most (instead of the former limit of 200).

v1.27

(n) The so-called "IC data" are collected into "Sga-8004.NNN" files.
(c) Entry INI/[Advanced]/sDataFile1Path is renamed as sDataFile7001Path.
(c) Entry INI/[Advanced]/sDataFile2Path is renamed as sDataFile7002Path.
(c) Entry INI/[Advanced]/sDataFile4Path is renamed as sDataFile7004Path.
(c) Entry INI/[Advanced]/sDataFile8Path is renamed as sDataFile7008Path.
(c) Entry INI/[Advanced]/sDataFile9Path is renamed as sDataFile7009Path.
(c) Entry INI/[Advanced]/sDataFile10Path is renamed as sDataFile7010Path.
(n) Entry INI/[Advanced]/sDataFile8004Path is the placeholder for the path of the "Sga-8004.NNN" files.

v1.26

(c) Maximum data length of CallTrace is incremented from 350 to 4192 octets.

v1.25

(n) Monitor version number is shown permanently (when known).

v1.24

(n) Handles Sga-7010.dat files (containing PRN data).
(n) INI/[Advanced]/sDataFile10Path; defaults to "c:\data".

v1.23

(n) Dialog for setting Monitor usernames for the various roles; both on start-up and later on.
(n) Menu / Actions / "Spread role usernames to monitor units"; can also be invoked with a new toolbar button.
(c) Log on start-up includes the section name for the particular INI settings.

v1.22

(c) Can handle 200 Monitor units at most (instead of the former limit of 150).

v1.21

(n) CallTrace requests can define a subset of Monitors for the queries to be spread to.

v1.20

(n) Size of output data files can globally be limited.
(n) INI/[Advanced]/dwDataFileCutSize (given in bytes, defaults to 1000000, logged at start-up).
(n) Output data files can be written into separate directories.
(n) INI/[Advanced]/sDataPath is no longer used.
(n) INI/[Advanced]/sDataFile1Path, /sDataFile2Path, /sDataFile4Path, /sDataFile8Path, /sDataFile9Path (all default to "c:\data").
(c) "Auto-query statistics" (Ctrl-Q) is renamed to "Auto-query Monitors" in the Options menu.
(n) Interval between auto-querying monitors (statistics) can globally be adjusted.
(n) INI/[Advanced]/wMonitorsQueryInterval (given in seconds, defaults to 300 (i.e., 5 minutes), logged at start-up).
(n) Statistics query is sent for those that have been omitted due to high (processor) load.
(n) Indication of count of Monitors that are *down* with red in the status bar; green (with count) if all are *up*.
(n) Count of Monitors and SigLinks are logged after loading SL.DAT.
(n) Date and time of the last reply of each call trace request are indicated.
(c) "Not connected - statistics query is not sent." is no longer reported for Monitors that are not connected.
(c) Receiving "Monitor is OK!" report (from Monitors from v2.20) clears "Is Monitor OK?" query timer as well as receiving statistics (from Monitors before v2.20).
(f) "Size of pending Task #5 datagrams has exceeded INI/dwMaxPendingPerCallTrace!" error message is logged only once per call trace session (used to repeat).

v1.19

(n) Checking for TCP communication port availability at start-up (thus cannot accidentally be started twice).
(c) Pop-up menu item "Acknowledge previous problem" in "Monitors" list becomes "Acknowledge all previous problems".
(n) New pop-up menu item in "Monitors" list: "Acknowledge previous problem of this Monitor" to acknowledge selected Monitors' problem.
(n) Clear key (NumPad-5) clears highlight (selection) in either window.
(f) Might crash after reloading SL.DAT with fewer Monitor Units.

v1.18

(c) Maximum number of Monitor Units that we can handle is incremented from 100 to 150.
(n) Multiple rows can be addressed with any remote commands in "Monitors" window.
(n) Mass software upload capability; with progress indication.
(n) "Combine MonitorID into path (preceding the file name)" option in File/Upload dialog.
(n) New menu item in "Monitors" list: "Abort current file upload on this Monitor".
(n) "Monitors" list contains "Problem" field; indicating negative response for remote command.
(n) New menu item in "Monitors" list: "Acknowledge previous problem :-)".
(n) New menu item in "Monitors" list: "Remove hilite (no selection)".
(n) Shift-ESC combination minimizes application window.

v1.17

(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.

v1.16

(f) File upload is immediately canceled when the Monitor unit being uploaded gets disconnected.
(f) File upload is immediately canceled when sending the subsequent chunk fails.
(c) Actions / "Query next statistics now!" menu item is removed.
(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.

v1.15

(c) Maximum number of Monitor Units that we can handle is incremented from 50 to 100.

v1.14

(f) Eliminates a rare but erroneous situation that might have resulted in "Serious error: File space for polling data is full!" error message.

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("Sga-7N-S")

Table of Contents