TSP Lab SS7 Monitoring System Sga-7N

The configuration file up to v2.17

Configuration (7NMonitor.ini) file settings

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
  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.
  SortingPoolSize 20480 Size of the messages sorting buffer
  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
  EnableLocationUpdateCDRCollecting 1 Turns on or off the transferring of BSSAP LocationUpdate related messages to the server 0: disable, other: enable, default: 0
  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
  EnableBSSAPCDRCollecting 0 Enables sending BSSAP messages to BSSAP Poller. (Task34)
0: disable, other: enable, default: 0
  EnableSRICDRCollecting 0 SendRoutingInfo messages are sent to the server. (Task10)
0: disable, other: enable, default: 0
  EnableICCDRCollecting 0 CheckIMEI messages are sent to the server for collecting IMEI-IMSI pairs to build an IMEI-IMSI database. (Task84)
0: disable, other: 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.
  CounterLogIntervalSecs 900 Logging period for BSSAP LocationUpdate related counters
  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 recognizing RANAP messages
[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
[Task34.N]     7NMonitor can connect to one or more BSSAP CDR servers. Parameters of server connections are set in these sections. Number of BSSAP CDR server can be up to 4 (N: [0..3])
  PollerAddress 10.20.30.34 IP address of the PC where the BSSAP Poller is running on.
  PollerPort 8030 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 BSSAP Poller
[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
[Links]      
  SS0/0 C=0 TS=1 T4DPC=203,204 T4OPC=30,33 T9Mode=0 T34Poller=N 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 0 carries incoming messages
  • T34Poller=N: Defines the Nth BSSAP CDR server.
    •   H00/1 C=1 TS=1/31 P=MTP2H T4DPC=203,204 T4OPC=30,33 T9Mode=0 T34Poller=N 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
  • T34Poller=N: Defines the Nth BSSAP CDR server.
    •   ES0/3 PCM=12 TS=1 P=MTP2 T4DPC=203,204 T4OPC=30,33 T9Mode=0 T34Poller=N 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.
  • T34Poller=N: Defines the Nth BSSAP CDR server.
    •   EH0/5 PCM=61 TS=1/31 P=MTP2H T4DPC=203,204 T4OPC=30,33 T9Mode=0 T34Poller=N 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
  • T34Poller=N: Defines the Nth BSSAP CDR server.
    •   SA0/4 VPI=255 VCI=4000 T4DPC=300,301 T4OPC=30,33 T9Mode=0 T34Poller=N 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
  • T34Poller=N: Defines the Nth BSSAP CDR server.
    •   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 T34Poller=N
    ST0</11 T4DPC=203,204 T4OPC=30,33 T9Mode=0 T34Poller=N     		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.
  • T34Poller=N: Defines the Nth BSSAP CDR server.
    •   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 T34Poller=N
    E01</20 C=1 T4DPC=203,204 T4OPC=30,33 T9Mode=0 T34Poller=N     		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.
  • T34Poller=N: Defines the Nth BSSAP CDR server.