TSP Lab SS7 Monitoring System Sga-7N

System Overview - The Windows Monitors

description module version configuration files
Windows XP Professional Operating system v5.1.2600 modified registry entries
7NMonitor.exe Main monitoring software v2.54 entries of Monitor.ini
SGA47PDriver.SYS Windows driver for Sg47P16 card v1.03 <none>
Sga7N137.obj SGA card SS7 firmware v1.37 <none>
SGA-S_M-09.obj SGA47P16 card SS7 firmware SGA-S_M-09 <none>
SGA-H_M-09.obj SGA47 card HSL firmware SGA-H_M-09 <none>
StorageCreator.exe Storage buffer file creator v1.04 example of usage
Obsolete programs
Sga7Decoder.dll DLL for decoding messages
Note: SgaDecoder is included in the 7NMonitor.exe
v1.11 <none>


Operating system changes

For the trouble free operation some changes have to be applied in the operating system software.

The StorageCreator module


The Sga monitoring systems use one or more circular buffers to store collected messages on the monitor machine. With this simple MS-DOS based utility this circular buffer can be created.
Usage:
Storage files can be anywhere on the monitor machine with any filenames and can be defined for the monitor program by the [Storage]/StorageBufferPathN entry of the INI file, where N can be from 0 to 31 so maximum 32 storage buffers can be created.

An example how to use StorageCreator utility


To create a circular buffer which name is for example Monitor-00.dat and size is 100 Mbyte in the d:\ path on the monitor machine the next line has to be placed in a command prompt:

Version history


The Monitor program

Features

Built-in limitations

User interface

The main menu

Button Shortcut Meaning
Ctrl+C Shows the status of the cards working in the monitor
Ctrl+D Shows the status of the storage subsystem
Ctrl+N This window provides information about the network connections
Ctrl+M Show miscellaneous information
Ctrl+S Summaries status information about monitored signaling links
Record (Checkbox)   If checked the program saves monitored messages and card events in PKT files (for debug purposes)


Configuration (7NMonitor.ini) file settings

Description of 7NMonitor.ini used up to v2.17 version can be found here.

Section Entry Example Meaning
[General]
  RecordDir c:\7N-Monitor\Recordings Path for recording SS7 network data (if Record checkbox is checked)
  LogDir c:\7N-Monitor\Logs Path for log files
  Sga47PSysPath c:\7N-Monitor\Sga47PDriver.sys Name and path of the Windows driver
  PollerAddress 111.222.33.44 IP-address of the server running the Poller module.
  PollerPort 8000 Port where Poller module accepts the connection from Monitor
  PollerLocalAddress 111.30.40.75 Local IP address which should be used when the monitor connects to the Poller
  PollerSendBufferSize 1048576 Size of the sending buffer of the poller connection. Default: 1048576
  KeepAlive 1 Defines that the monitor uses KeepAlive feature for network connections
  NTPServerAddress 10.117.157.200 Server IP address providing NTP synchronization
  NTPSynchronIntervalSecs 900 Time synchronization interval
  NTPMinAdjustmentMSecs 3 If the different between the local and the NTP times is smaller then this value time adjusting will be skipped.
  NTPNotifyAdjustmentMSecs 5 When the needed adjustment is greater then this value an event will be sent to the server.
  NTPMaxAdjustmentMSecs 7200000 If the different between the local and the NTP times is greater then this value time adjusting will be skipped.
  NTPRoundtripTimeoutMSecs 10 Maximum roundtrip time for NTP answers. Answers received later then this roundtrip time will be skipped.
  NTPStartSynchronized 0 When it is other than 0 the monitor does not need NTP synchronization to process data.
Default: 0
  LogCardEvents 1 Enable or disable logging events about cards and links.
If it is disabled events can be followed on the Card screen.
  LogTimeOnScreen 1 Enable or disable logging timestamp of log entries.
  SortingPoolMaxSize 514244 The maximum size of messages sorting buffer. Default value is 514244.
  SortingPoolTimeoutMSecs 1000 The maximum time that a message can spend in the sorting pool
  EnableFISUs 0 If 1, turn on the handling of FISUs for Sga47P16SS7 cards
0: disable, other: enable, default: 0
  EnableLSSUs 1 If 1, turn on the handling of LSSUs for Sga47P16SS7 cards
0: disable, other: enable, default: 0
  EnableRemoteCapture 1 Turn on or off the serving of Remote Capture requests
0: disable, other: enable, default: 1
  EnableISUPCDRCollecting 1 Switch on or off the ISUP CDR collecting feature
0: disable, other: enable, default: 1
  EnableCallTrace 1 Enable or disable answering the Call Trace queries
0: disable, other: enable, default: 1
  EnableRoamingCDRCollecting 1 Roaming CDR collecting can be turned off with this parameter
0: disable, other: enable, default: 1
  EnableINAPCDRC 1 Enables sending INAP messages to INAP Poller. (Task24)
0: disable, other: enable, default: 0
  EnableSRICDRCollecting 0 SendRoutingInfo messages are sent to the server. (Task10)
0: disable, other: enable, default: 0
  EnableGTPUCollecting 0 GTP User Plane messages are sent to GTPAssembler module.
0: disable, other: enable, default: 0
  EnableGTPCCollecting 0 GTP Control Plane messages are sent to GTPAssembler module.
0: disable, other: enable, default: 0
  StoreGTPU 0 GTP User Plane messages are stored.
0: disable, other: enable, default: 0
  EnableDiameterCollecting 0 Switch on or off the Diameter message collecting feature.
0: disable, 1: enable, default: 0
  AssembleTCP 0 Switch on or off the TCP assembling feature.
0: disable, 1: enable, default: 0
  CountryCode 36 This value will be used as the country code in roaming related IAM messages
  OperatorCode 30 This value will be used as the operator code in roaming related IAM messages
  HideUSSD 1 0: False
1: True
empty: True
When it is false the ussd-string parameter will not be hidden on the disc.
Even in this case the proper user rights are needed to see the parameter.
  HideDTMF 1 0: False
1: True
empty: True
When it is True the DTMF codes are hidden on the disc.
  EnableWatchdog 0 0: disable watchdog, other: enable, default: 0
  WatchdogIntervalSecs 5 Time period for sending reset messages to the watchdog utility
  WatchdogPort 7474 Port of WatchDog utility (default: 7474)
[Hints]      
  RNC 200,201 A comma-separated list of RNC point codes, which helps RANAP messages to be recognized
[Task9]      
  IncomingRangeX 30208 Incoming IAM's are only sent to the server for creating roaming statistics if they fall in one of the incoming ranges.
The X can run from 0 to 63.
[Task24]      
  PollerAddress 10.20.30.24 IP address of the PC where the INAP Poller is running on.
  PollerPort 8020 Port for Poller connection
  PollerSendBufferSize 1048576 Size of the sending buffer of the poller connection. Default: 1048576
  EnableRemoteRestart False Sets that the monitor software can be restarted from the INAP Poller
[GTPAssembler]     7NMonitor can connect to a GTP Assembler module that processes GTP messages.
  Address 10.20.30.36 IP address of the GTP Assembler module.
  Port 8050 Port for Poller connection
  SendBufferSize 1048576 Size of the sending buffer of the connection. Default: 1048576
[DiameterAssembler]     7NMonitor can connect to a Diameter Assembler module that processes Diameter messages.
  Address 10.20.30.38 IP address of the Diameter Assembler module.
  Port 8060 Port for Poller connection
  SendBufferSize 1048576 Size of the sending buffer of the connection. Default: 1048576
[UserPrivileges]     This section is not used any more!
  SS7PrivilegedUser UsErNaMe The client program connected to the monitor with this identifier gets the ussd-string parameters unhidden.
To see ussd-string parameters a proper 7w decoder needed.
(Warning: This identifier is corresponding with the Oracle User Group username in the SgaAutho module and is not equal the "username" used by the user typed when starting the client.)
This key has been obsolete since v1.01 version.
[Storage]     In this section the storage buffer files used by the Monitor are defined
  StorageBufferPathN d:\Monitor-00.dat The storage files have to be defined here in order to the Monitor can use them. N must be the sequential number of the circular buffer from 0 to 31
[Card0]     For every card in the Monitor unit belongs a [CardN] section containing its setting.
(N must be replaced with the sequential number of the card, e.g. [Card0] for the 0th, [Card1] for the 1st card, etc.)
  ID 0 The ID set on the N'th card. This can be adjusted with switches on the sga47 cards. In the case of Sga47P16 cards IDs are set automatically by the host PC. All IDs must be unique within a Monitor unit.
  Type Sga47SS7 This defines that the Sga47 card monitors SS7 links
This card can monitor DSS1, as well. In this case Type=Sga47DSS1 must be set. The following settings are the same.
  TMSObjectPath Sga7N135.obj DSP code filename (and its path if needed).
  AM186CodePath AM186.bin This value can be needed for card type Sga47SS7 and Sga47DSS1. This defines the path and file name of the AM186 processor code. If it is not set card does not use AM186 processor (this provides a "messages buffer" between DSP processors and host PC).
  AmplifyX 1 Sga47 cards can amplify connected PCM trunks if its voltage level is too low to work correct. (X must be 0 or 3.)
If it is 1, it turns on the amplification feature for the Xth processor of Sga47SS7 cards.
If it is 0, it turns the amplification off.
[Card1]      
  ID 1  
  Type Sga47P16SS7 The PCI card also can monitor HSL and DSS1. Sga47P16HSL and Sga47P16DSS1 are the proper types.
  TMSObjectPath SGA-S_M-03.bin This object code is used for DSS1 monitoring, as well.
For HSL links SGA-H_M-03.bin can be used.
  TerminationInN 300 For Sga47P16 cards the line termination can be set by the monitor software (Sga47P16HSL and Sga47P16SS7 and Sga47P16DSS1 types). (On Sga47 cards this setting can be set physically by jumpers.)
The given value sets the termination (in Ohm) for processor N (N can be 0, 1, 2 and 3). Value can be 75 or 120 or 300.
Optional parameter. The default is 300 Ohm.
  TerminatinOutN 120 The transmission termination can be set with this parameter.
It sets termination of the Nth processor. The two possible values are 75 and 120 Ohm.
Optional parameter. The default is 120 Ohm.
  GainN 0 Amplification for Nth processor can be adjusted by this value.
Possible values are 0 and 12 and 30 dB. They are in dB.
Optional parameter. Default value is 0 dB.
[Card2]      
  ID 2  
  Type Sga155dM Sga155 card for SS7 and HSL monitoring via copper
  FPGACodePath d1550141.bin Firmware code for the FPGA
  SatelliteDriverPath d1550141.sys Driver between the FPGA and the monitor program
  TimeslotScheme 0 Defines the applied timeslot scheme for SS7 links on this card type (values: 0..4)
Scheme Number of siglinks can be defined on input PCM interfaces
0...........13 14..........27 28..........41
0
44442222222222 11111111111111 11111111111111
1
22222222222222 22222222111111 11111111111111
2
44442222222222 22222222222222 00000000000000
3
88444444444444 00000000000000 00000000000000
other
88888888000000 00000000000000 00000000000000
[Card3]      
  ID 3  
  Type Sga155dO Sga155 card for SS7 monitoring on fiber (STM1)
  FPGACodePath d1550685.bin Firmware code for the FPGA
  SatelliteDriverPath d1550685.sys Driver between the FPGA and the monitor program
[Card4]      
  ID 4  
  Type Sga155dA Sga155 card for SS7 monitoring on fiber (ATM)
  FPGACodePath d1550aa5.bin Firmware code for the FPGA
  SatelliteDriverPath d1550aa5.sys Driver between the FPGA and the monitor program
[Card5]      
  ID 5  
  Type Sga155eO Sga155e card for SS7 monitoring on fiber (STM1)
  FPGACodePath e1550686.bin Firmware code for the FPGA
  SatelliteDriverPath e1550686.sys Driver between the FPGA and the monitor program
[Card6]      
  ID 10  
  Type Tapper Card type for receiving SigTran messages from GyTapper
  Port 7001 Defines the port where the monitor waits the GyTapper's connection.
Default value is 7001
[Card7]      
  ID 20  
  Type Ethernet Direct Ethernet monitoring capability is only in the "7NMonitor v1.09-E" version.
This feature needs WinPcap v3.1 pack to be installed with the modified dll and sys files.
  InterfaceName "\Device\NPF_{B9E95D71-1460-445C-A959-6C700A0F4659}" This Ethernet interface will be capture for SigTran/M3UA messages.
The monitor program lists all existing interfaces when it starts.
  ClockDriftPerDayMSecs -864 The timestamps of captured messages will be adjusted with this value for more precise timestamps.
  ChannelN 172.29.15.19,172.28.253.1 source_IP_addres,destination_IP_address
This defines a virtual signaling link direction. N can be 0..63
[Card8]      
  ID 30  
  Type PacketStream Card type for receiving SigTran messages from PacketDistributor
  Port 7001 Defines the port where the monitor waits the PacketDistributor's connection.
Default value is 7001
[Links]      
  SS0/0 C=0 TS=1 T4DPC=203,204 T4OPC=30,33 T9Mode=0 This format can be used for Sga47SS7 and Sga47P16SS7 card types that monitor SS7 signaling links.
  • SS0/0: The symbolic name of the link and the ID of the card to which the link belongs.
    The link ID has to consist of three alphanumeric characters and be unique in the whole monitoring system.
  • C=0: Channel id of the given card where the PCM cable containing this link is connected to.
  • TS=1: timeslot of this link
  • T4DPC=203,204: DPC filter for ISUP CDR collecting. The Monitor processes MSUs with DPCs set here. At most 16 PCs may be listed delimited with commas (no spaces between them!). If the list begins with a "!" (eg. "!203"), inverse filtering will be applied.
  • T4OPC=30,33: OPC filter for ISUP CDR collecting.
  • T9Mode=0: Task9 indicator.
    • '-' Task9 is disabled for the link
    • '0' link direction 0 carries outgoing messages
    • '1' link direction 1 carries incoming messages
  •   H00/1 C=1 TS=1/31 P=MTP2H T4DPC=203,204 T4OPC=30,33 T9Mode=0 This format can be used for Sga47P16HSL cards that monitor HSL links.
  • H00/1: Link and card ID to which the given link belongs
  • C=1: Channel id where the PCM cable is connected to
  • TS=1/31: start timeslot and the number of joined timeslots (more groups of timeslots can be defined as an HSL signaling link: "1/15,17/15" = the signaling link contains two 15-timeslot groups from 1 to 15 and from 17 to 31.)
  • P=MTP2H: used protocol (HSL)
  • T4DPC=203,204: DPC filter
  • T4OPC=30,33: OPC filter
  • T9Mode=0: Task9 indicator
  •   ES0/3 PCM=12 TS=1 P=MTP2 T4DPC=203,204 T4OPC=30,33 T9Mode=0 This format is for Sga155dO and Sga155eO card types monitoring SS7 links
  • ES0/3: Link and card ID
  • PCM=12: ordinal number of PCM in the STM1 stream
  • TS=1: timeslot of the link
  • P=MTP2: used protocol (SS7)
  • T4DPC=203,204: DPC filter for ISUP CDR collecting.
  • T4OPC=30,33: OPC filter for ISUP CDR collecting.
  • T9Mode=0: Task9 indicator.
  •   EH0/5 PCM=61 TS=1/31 P=MTP2H T4DPC=203,204 T4OPC=30,33 T9Mode=0 This format is for Sga155dO and Sga155eO card types monitoring HSL links
  • EH0/5: Link and card ID
  • PCM=61: ordinal number of PCM in the STM1 stream
  • TS=1/31: start timeslot and the number of joined timeslots
  • P=MTP2H: used protocol (HSL)
  • T4DPC=203,204: DPC filter for ISUP CDR collecting
  • T4OPC=30,33: OPC filter for ISUP CDR collecting
  • T9Mode=0: Task9 indicator
  •   SA0/4 VPI=255 VCI=4000 T4DPC=300,301 T4OPC=30,33 T9Mode=0 This link definition should be used for Sga155dA cards.
  • SA0/4: The symbolic name of the link and the ID of the card to which the link belongs
  • VPI=255 VCI=4000: VPI and VCI parameters for the link to be captured
  • T4DPC=300,301: DPC filter for ISUP CDR collecting
  • T4OPC=30,33: OPC filter for ISUP CDR collecting
  • T9Mode=0: Task9 indicator
  •   DS0/0 C=1 TS=8 DSS1PC=203 T9Mode=- This format can be used for Sga47DSS1 and Sga47P16DSS1 cards
  • DS0/0: ID of the link and the card
  • C=1: Channel ID
  • TS=8: timeslot
  • DSS1PC=203: OPC value used in IAM messages converted from DSS1/Setup
  • T9Mode=-: Task9 indicator (~disabled)
  •   ST0>/10 T4DPC=203,204 T4OPC=30,33 T9Mode=0
    ST0</11 T4DPC=203,204 T4OPC=30,33 T9Mode=0
    This format is for Tapper card types monitoring IP (e.g. SigTran) links
  • ST0>/10: Link (and its direction) and card ID
  • T4DPC=203,204: DPC filter for ISUP CDR collecting.
  • T4OPC=30,33: OPC filter for ISUP CDR collecting.
  • T9Mode=0: Task9 indicator.
  •   ST1>/10 DSS1PC=203 T9Mode=0
    ST1</11 DSS1PC=203 T9Mode=0
    This format is for Tapper card types monitoring IP carrying IUA traffic links
  • ST1>/10: Link (and its direction) and card ID
  • DSS1PC=203: OPC value used in IAM messages converted from DSS1/Setup
  • T9Mode=0: Task9 indicator.
  •   E00>/20 C=0 T4DPC=203,204 T4OPC=30,33 T9Mode=0
    E01</20 C=1 T4DPC=203,204 T4OPC=30,33 T9Mode=0
    This format is for Ethernet card types monitoring Ethernet interfaces directly
  • E00>/20: Link and card ID
  • C=0: ChannelID defined by the source and destination IP addresses
  • T4DPC=203,204: DPC filter for ISUP CDR collecting.
  • T4OPC=30,33: OPC filter for ISUP CDR collecting.
  • T9Mode=0: Task9 indicator.
  • Version history for 7N-Monitor

    Version history for Sga7Decoder.dll