background image

SS7 Quick Start Guide 

 

45 

A  List of Acronyms 

Acronym 

Expanded Form 

API 

Application Programming Interface 

CIC 

Circuit Identification Code 

DPC 

Destination Point Code 

ESF 

Extended Super Frams 

ISDN 

Integrated Services Digital Network 

ISO 

International Standards Organization 

ISUP 

ISDN User Part 

LNP 

Local Number Portability 

MAPI 

Messaging Application Programming Interface 

MML 

Man Machine Language 

MTP 

Message Transfer Part 

MSU 

Message Signal Unit 

OAM&P 

Operation, Administration, Maintenance, and Provisioning 

OPC 

Originating Point Code 

OSI 

Open System Interconnect 

PCS 

Personal Communication System 

PMC 

PCI Mezzanine Card 

PSTN 

Public Switched Telephone Network 

Summary of Contents for SS7

Page 1: ...EdgeIQ R11 0 SS7 Quick Start Guide ...

Page 2: ...or other intellectual property rights owned by Solacom or licensed from third parties by Solacom whatsoever Purchasers of product are also hereby notified that the use of this information or product in certain ways or in combination with Solacom or non Solacom furnished goods or services may infringe patents or other intellectual property rights This document and related products contain valuable ...

Page 3: ...spatch qualified personnel for field support including training installation configuration QoS audits personalized requirements and more We offer a complete range of services to support you and your system You may request support online or by phone Web services solacom com Email services solacom com North America toll free 1 888 Solacom 1 888 765 2266 Phone anywhere 1 613 693 0641 Our normal busin...

Page 4: ......

Page 5: ...ipment has a three conductor AC power cable This power cable must be plugged into an approved three contact electrical outlet with the grounding wire green firmly connected to an electrical ground at the power outlet The power cables meet International Electrotechnical Commission IEC safety standards Keep away from live circuits Operating personnel must not remove modules or otherwise tamper with ...

Page 6: ...ions when handling modules As a minimum precaution use grounded wrist straps at all times when handling modules Do not modify the product Do not install substitute parts or modify the product Contact an authorized Sales and Service Office for service and repair to ensure that product integrity is maintained Solacom Technologies Inc 84 Jean Proulx Gatineau QC J8Z 1W1 Canada Tel 613 693 0641 Fax 613...

Page 7: ...on 7 2 8 SS7 Duplication 7 3 Getting Started with SS7 9 3 1 Reviewing the Factory Configuration 9 3 2 Connecting the SS7 Module to the Network 11 3 3 Viewing the Mesoware ini Configuration 11 3 4 Configuring SS7 using the IQadmin 13 3 4 1 SS7 Trunk Group Configuration 16 3 4 2 Channel based Trunk Group Configuration 18 3 5 Launching the MML Interface 21 3 5 1 Viewing the SS7 Stack Configuration 22...

Page 8: ...nation 37 5 Troubleshooting 39 5 1 Viewing the SS7 Command Log File 39 5 2 Viewing the SS7 Command History Log File 40 5 3 Viewing the SS7 Master Event Log Files 40 5 4 Viewing the SS7 Alarm Files 41 5 5 Generating SS7 Event Reports 43 5 6 Generating SS7 Alarm Reports 43 5 7 Viewing the Log Files 44 A List of Acronyms 45 B Level 2 Tracing SS7 47 1 1 Tracing SS7 Using L2TOOL 47 1 2 Automated Decodi...

Page 9: ...lt MML Prompt 21 Figure 8 MML Display Commands 22 Figure 9 The MML Help Menu 24 Figure 10 Help for modify port Command 26 Figure 11 Sample Network Configuration 27 Figure 12 Network Connections with MML Commands 29 Figure 13 SS7 Command Log Sample 40 Figure 14 SS7 Command History Log Sample 40 Figure 15 SS7 Master Event Log Sample 41 Figure 16 SS7 Master Alarm Sample 42 Figure 17 Sample Log 44 Fig...

Page 10: ......

Page 11: ...de ix Tables Table 1 MTP Level to Layer Mapping 4 Table 2 SS7 Module Side A Default Parameters 23 Table 3 SS7 Module Side B Default Parameters 23 Table 4 apm_report Command Options 43 Table 5 ebs_report Command Options 43 ...

Page 12: ......

Page 13: ...roughout this document For reference Appendix A contains a list of the acronyms used and their expanded form Other documents in the SS7 solution include the following EdgeIQ Configuration Guide EdgeIQ Configuration Reference Managed API Reference OAMP Reference SS8 Distributed7 User Manual NewNet D7 User Guide Release Notes Documents are stored on the Administration server in the I Documents OEM S...

Page 14: ......

Page 15: ...gement and tear down wireless services such as personal communications services PCS wireless roaming and mobile subscriber authentication local number portability LNP toll free 800 888 and toll 900 wireline services enhanced call features such as call forwarding calling party name number display and three way calling efficient and secure worldwide telecommunications The Solacom SS7 Solution consis...

Page 16: ...2 MTP3 ISUP is a third party offering The hardware and software functions of the SS7 protocol are categorized into levels that map to the Open Systems Interconnect OSI 7 layer model defined by the International Standards Organization ISO The association is shown below MTP Level OSI Layer 1 Physical layer physical electrical functional 2 Data link layer end to end transmission 3 Network layer messa...

Page 17: ...MTP3 ISUP running on the processor card 2 3 SS7 Stack MTP3 ISUP The SS7 MTP3 ISUP Stack has several different UNIX daemons that control the two different levels of the SS7 protocol stack The SS7 stack receives SS7 messages from the SS7 module and performs MTP3 ISUP processing on the SS7 messages The SS7 Module Solaris processor Solaris or Windows Solaris Windows or Linux Telephony Application Vers...

Page 18: ...bit ANSI or 12 bit ITU circuit identification code CIC also known as the Interface ID in the Solacom domain 2 4 Solacom s SS7 SIL and VSOS The SS7 SIL provides the interface between the SS7 stack and the EdgeIQ s VSOS The SS7 SIL and SS7 stack run on the same processor whereas the VSOS can operate on the same processor or on an external server If VSOS is operating on an external server the SS7 SIL...

Page 19: ...are ini file are also shown italicized characters The first SS7SIL to start registers all trunk groups When the second SS7SIL starts the first SS7SIL transfers control of a set of trunk groups to the second SS7SIL An SS7SIL configured as the listen port in the Mesoware ini file controls the odd bearer spans and an SS7SIL configured as the connect port controls the even bearer spans The SS7SILs are...

Page 20: ... T1 bearer spans SS7DuplicationMode listen T1 Span with SS7 signalling channels Solaris SBC Card SS7 Module To VSOS Server Ethernet MatedMesowareIP Ethernet Cross connect SS7DuplicationIP Handles even T1 bearer spans SS7DuplicationMode connect To VSOS Server SS7SIL ISUP MTP3 MTP2 MTP1 SS7 module SS7 module Processor card Processor card Side A Side B Side A Side B ...

Page 21: ... software and hardware is already installed in your EdgeIQ platform Your system is configured as follows One SS7 module is installed in PMC slot 1 of the processor card Figure 3 SS7 Module SER Serial debug port Not used L1 T1 Line 1 LED Red Green Yellow L2 T1 Line 2 LED Red Green Yellow Line 1 T1 Line 1 port RJ 48C Line 2 T1 Line 2 port RJ 48C SS7 Module dipswitches SW1 to SW4 are in the OFF posit...

Page 22: ...installation path is export home NewNet Solacom s VSOS configuration file is configured for your system The filename and default location is export home SS7SIL Mesoware ini The lifetime SS7 license filename and default location is export home NewNet access etc license dat The PATH is set up to contain the following export home NewNet access bin export home SS7SIL The VERSATEL_PATH is set up to con...

Page 23: ...aces located on the SS7 module Sample connections for a redundant system are listed below Side A SS7 Module Line 1 connection to the network using an RJ 48C straight cable Maximum cable length is 100 feet Side B SS7 Module Line 1 connection to the network using an RJ 48C straight cable Maximum cable length is 100 feet Typically one or two channels from a span are used to convey signaling informati...

Page 24: ...ort 15002 SS7DuplicationMode listen SS7DuplicationHost Solacom 25 2d Mesoware MesowareIp 172 16 25 104 MesowarePort 15001 MesowareDSN Nexus MatedMesoware MatedMesowareIp 172 16 25 103 MatedMesowarePort 15001 MatedMesowareDSN MatedNexus SS7SIL SS7DuplicationIp 192 168 111 9 SS7DuplicationPort 15002 SS7DuplicationMode connect SS7DuplicationHost Solacom 25 2d Processor A Front Rear Processor B Rear F...

Page 25: ...in 2 Enter DisplayHelp to display a full list of commands The interface responds to keywords so if you enter a string of one or more letters the commands containing the specified string are displayed For example to list all commands containing the string trunkgroup enter the keyword trunkgroup To get help on a specific command click the Help button More detailed information on IQadmin is provided ...

Page 26: ...efer to the figure below for sample output Sample output for a card in shelf 25 slot 2 Note that Framing and Coding of the T1 card spans is independent of the SS7 s T1 span configuration see Section 3 5 2 The fields do not have to match An SS7 trunk group must be configured with the proper destination point code DPC specific to your installation To view the default SS7 trunk group configuration 1 ...

Page 27: ...mmand DisplayTrunkGroupChannels 2 Enter 3 in the TrunkGroupNumber field Sample output In this example trunk group number 3 is an SS7 trunk group with 24 enabled channels belonging to a card in shelf 25 slot 2 and span 0 The CICs listed under the InterfaceId column for channels 0 to 23 are 24 to 47 ...

Page 28: ...roup all to display the Trunk Groups The trunk groups already defined in the switch are displayed 3 Enter createss7trunkgroup to view the syntax See example below 4 Convert point codes For example If XXX YYY ZZZ is the Point Code convert XXX to Hex AA YYY to Hex BB and ZZZ to Hex CC Then convert AABBCC to decimal 123456789 Each SS7 node has a unique identity called the Destination Point Code DPC T...

Page 29: ...ConvertVersatelDPCValueToSS7DestPointCode 331423 5 Create a trunk CreateSS7TrunkGroup 3 SS7_TG1 331423 25 2 0 24 _ MOST_IDLE 0 0 61 62 0 Note An underscore at the end of a line means continue on the same line The CreateSS7TrunkGroup command has the following parameters Parameter Values TrunkGroupNumber 3 0 134217727 TrunkGroupName SS7_TG1 string up to 50 characters DPC 331423 Integer an address un...

Page 30: ... 6 3 168 MoveSpanToTrunkGroup 25 2 7 3 192 MoveSpanToTrunkGroup 25 2 8 3 216 MoveSpanToTrunkGroup 25 2 9 3 240 MoveSpanToTrunkGroup 25 2 10 3 264 MoveSpanToTrunkGroup 25 2 11 3 288 MoveSpanToTrunkGroup 25 2 12 3 312 MoveSpanToTrunkGroup 25 2 13 3 336 MoveSpanToTrunkGroup 25 2 14 3 360 MoveSpanToTrunkGroup 25 2 15 3 384 The MoveSpanToTrunkGroup command has the following parameters Parameter Values ...

Page 31: ...pty trunk group 3 CreateSS7TrunkGroup 500 SS7_MINI_CTL_1 15728412 1 1 1 1 MOST_IDLE 0 0 61 62 0 4 CreateSS7TrunkGroup 600 SS7_RD_1 460809 1 1 1 1 MOST_IDLE 0 0 61 62 0 5 Use MoveChannelToTrunkGroup to move each one of the 12 channels into the trunkgroup Notice the InterfaceID which is the last parameter is the SS7 CIC to assign to the channel Therefore starting channel 0 gets CIC 5 channel 2 gets ...

Page 32: ...ing displays how the trunk groups will appear once they are configured Refer to Figure 7 DisplayTrunkGroup 500 Name Num TrunkGroupType HuntAlgorithm ProfileID localSp DPC DS0s LocalTxCOTToneID RemoteTxCOTToneID PercentageOfOutgoingCOT SS7_MINI_CTL_1 500 SS7 MOST_IDLE 0 0 15728412 12 61 62 0 DisplayTrunkGroup 600 Name Num TrunkGroupType HuntAlgorithm ProfileID localSp DPC DS0s LocalTxCOTToneID Remo...

Page 33: ... an MML session for your signaling point is started by entering the following command at the Solaris prompt of the processor card hosting the Distributed7 software mml 0 The 0 represents the logical signaling point number of the node This is the same value assigned to the User Part Multiplexer daemon upmd 0 and the ISDN User Part daemon isupd 0 The default MML prompt is shown below Figure 9 Defaul...

Page 34: ...ovided in the SS8 Distributed7 User Manual Figure 10 MML Display Commands 3 5 1 Viewing the SS7 Stack Configuration The SS7 stack is factory configured using a set of Man Machine Language MML commands entered at the Distributed7 MML prompt This configuration defines the rules for daemons that must run at all times The daemons are listed below Application process manager apmd Master event log mlogd...

Page 35: ... B8ZS encoding Maximum line length of 100 feet Notify is enabled for framer line alarms Network class type Class B Signaling ports 1 port port 0 on Line 1 Signaling port 0 64000 bits s with idle detection Table 2 SS7 Module Side A Default Parameters 3 5 2 2 SS7 Module Side B Parameter Description Hostname solacomXX 2d XX shelf identifier Active span Line 1 clock source is obtained from the line Sp...

Page 36: ...TE DISPLAY RTSET DISPLAY LINE DISPLAY LINESTAT DISPLAY SP DISPLAY HOST DISPLAY MTP DISPLAY ISUP DISPLAY NTWK DISPLAY ISUPCCT DISPLAY ISUPCGRP DISPLAY TCPCON Additional display commands can be used to view other configured components Or enter the help command to view all SS7 commands Sample output Figure 11 The MML Help Menu Warning Using the MODIFY ISUPCCT command with the Group and Range settings...

Page 37: ...ine_len L110 line_NTFY ON Note An underscore at the end of a line means continue on the same line Highlighted parameters may require updates to suit your requirements To change the highlighted parameters 1 Access the MML see Section 3 5 2 Update the parameter values For example to change the port s baud rate to 56000 the T1 framing mode to T1ZBTSI and the T1 line encoding to T1B7ZS enter the follo...

Page 38: ...figure a set of redundant SS7 connections linking an SSP to a single destination through two signal transfer points STPs A connection between two points is defined by a link linkset route and routeset These terms are defined below Link a physical connection to a destination Linkset a collection of links Route a collection of linksets assigned to a destination Routeset a collection of routes ...

Page 39: ...igured with a DPC of 5 7 101 A second SS7 module connects to STP2 that is configured with a DPC of 5 7 102 The destination connects to STP1 and STP2 and has a DPC of 5 7 200 Figure 13 Sample Network Configuration To become a node in the SS7 network you must modify the SP managed object to provide your protocol a unique identity point code To provide a point code 1 Access MML 0 from the solacom25 1...

Page 40: ...odify sp spno 0 name solacom spc 5 7 0 3 Repeat the above for the solacom25 2d host The details of the network connections including the MML commands to configure the connections are shown below For convenience all component labels associated with a node contain the node s DPC value when possible ...

Page 41: ..._TH add lset LSET LS_5_7_0 DPC 5 7 102 TYPE ALINK _ LOADED 1 ACTIVE 1 EMERGENCY ON MML_TH add route RTSET RS_5_7_0_1 LSET LS_5_7_0 PRIORITY 0 MML_TH add link LINK L_5_7_0 LSET LS_5_7_0 SLC 0 PRIORITY 0 _ HOSTNAME solacom25 2d BOARDNM pmc8260 INST 0 PORT 0 MML_TH mod lsetstat LSET LS_5 7 0 status SET_ACT MML_TH mod linkstat LINK L_5 7 0 status SET_ACT MML_TH add rtset RTSET RS_5 7 0_2 DPC 5 7 200 M...

Page 42: ...SS7SIL watchdog The SS7SIL watchdog monitors the SS7SIL process and re spawns the process upon unexpected termination To stop SS7 processes 1 Enter the command apm_stop to stop the processes defined in the apmconfig file 2 Enter the command vn_ss7sil_stop sh to stop the SS7SIL and the SS7SIL watchdog Sample output SS7 processes start automatically when the processor is rebooted To manually start S...

Page 43: ... screen type CTRL C 4 If you want to resent alarm output to your screen access the alarmlog directory and enter tail f cd export home NewNet access RUN alarmlog tail f apmd started mlogd started spmd started netdstarted alarmd started dsmd started dkmd started upmd started isupd started SS7 Distributed7 software is running ...

Page 44: ...eck SS7 SIL manager status 4 Check the SS7 link status 5 Check the linkset status 6 Check the SS7 s T1 framing status 7 Check the ISUP circuit status 8 Check the ISUP circuit groups 9 Display the logs and alarms issued by the stack in real time 10 Make a test call To view the status of SS7 processes 1 Check that the SS7 stack is running The highlighted objects must be listed and their status must ...

Page 45: ...ted to the stack 3 Verify the status of the SS7 SIL process 4 Check the SS7 link status by entering the MML mode and displaying the link status ACT ON indicates that the links are active LOADED ON indicates that the links are available to carry traffic if aligned AVL ON indicates that the links are aligned at MTP Level 3 5 Check the linkset status by displaying the linkset status 6 Check the SS7 s...

Page 46: ...al timer CUR ES Errored seconds ES current interval CUR UAS Unavailable seconds UAS current interval 24H ES Total count of ES in the last 24 hours 24H UAS Total count of UAS in the last 24 hours VLDINTTOTAL Number of valid 15 Min intervals Repeat the display linestat command several times and observe that only the CURTIMER field changes The CUR ES Current Errored Seconds and the CUR UAS Current Un...

Page 47: ... be unblocked UN BLK 8 Check the configuration of the ISUP circuit groups Circuit group identifier Modulus 24 of the first CIC Interface ID of the first channel in the trunk group Trunk group identifier unique identifier for a circuit group Call control name ESP0 SS7SIL handling the even bearer spans connect side OSP0 SS7SIL handling the odd bearer spans listen side Circuit number Maximum number o...

Page 48: ...red file in the directory The alarm logs are displayed in real time Sample output To stop the real time display of alarms type CTRL C Upon failure of one or more of the above steps refer to Section 3 7 to obtain information on how to stop and restart the processes 10 Make a call to a device associated with SS7 signaling and test the audio path ...

Page 49: ... XX 100 IP address Take note of the XX digits 4 Enter telnet 172 16 XX 20 where XX is the Shelf number 5 Enter mml 0 to enter the SS7 Stack 6 Enter Display rtset to display the Route Set This shows you the routes defined to the destination Point codes 7 Enter Display route to display the Route This shows you the linkset name that the route uses 8 Add a new Destination Point Code Substitute the Poi...

Page 50: ... 125 16 _ PRIORITY 0 Note An underscore at the end of a line means continue on the same line The first command defines a Route Name and a Destination Point code and the second command defines what linkset to use to get to the Destination Point code defined by the Route Name If there was already a linkset defined then it should be the Green in the above command 9 Enter Exit to exit the MML ...

Page 51: ...og always active Event reports user initiated Alarm reports user initiated CLI command logs always active 5 1 View the SS7 Command Log File MML logs all MML commands except DISPLAY commands that are entered by an operator Each log of a command also contains the login name and ID of the user who entered the command along with the date and time at which it was entered Reviewing this file can help to...

Page 52: ...e history file is located at export home access 1 3 0 12 RUN0 config MML commands history Sample output Figure 16 SS7 Command History Log Sample 5 3 View the SS7 Master Event Log Files The master event log files continually collect messages that indicate problem cases major steps or state changes that occur during the operation of the Distributed7 software The event levels can be INFO MINOR MAJOR ...

Page 53: ... environment An alarm message includes an alarm type a hexadecimal identifier for each alarm made up of group number module number and alarm number an alarm level Info Minor Major Critical Fatal an ASCII description of the alarm maximum of 128 Bytes The alarm log files are located at export home access RUN alarmlog Each filename is prefixed with AccessAlarms The file extension is a number The high...

Page 54: ...ociated alarm ID range are listed below TRMOD translation module 820101 820104 SPM signaling point SP management 830101 830708 UPM user part management such as MTP Level 3 840101 840401 SCCP service connection control part management 850101 85150a MTPL1 MTP Level 1 860101 860136 MTPL2 MTP Level 2 870101 870152 ETMOD Ethernet test module 880101 880501 ISUP ISUP management 890101 890133 APM Applicat...

Page 55: ...ent messages generated by the local host on or after March 4 2008 is shown below apm_report b 030408 p 34 5 6 Generate SS7 Alarm Reports Use the ebs_report command to extract specific details from the available alarm logs and generate a report Option Description b mmddyy List alarms that occurred on or before a specified date e mmddyy List alarms that occurred on or after a specified date p priori...

Page 56: ...Logs The default maximum size of each diagnostic log file is 4 096 kbytes The file is not written to after the file reaches this size The default configuration stores 30 days of log files When a log is created after midnight the current log file is closed and a new log file is created At this time any log files older than 30 days are deleted Log files can be read using the Versatel FileReader appl...

Page 57: ...rk ISO International Standards Organization ISUP ISDN User Part LNP Local Number Portability MAPI Messaging Application Programming Interface MML Man Machine Language MTP Message Transfer Part MSU Message Signal Unit OAM P Operation Administration Maintenance and Provisioning OPC Originating Point Code OSI Open System Interconnect PCS Personal Communication System PMC PCI Mezzanine Card PSTN Publi...

Page 58: ...s 46 Acronym Expanded Form SIF Signaling Information Field SIL Signaling Interface Layer SLS Signaling Link Selection SP Signaling Point SS7 Signaling System no 7 SSP Service Switching Point STP Signal Transfer Point ...

Page 59: ...ill affect the performance of the SS7 Interface board It is not possible to relate the logs dumped from L2tool to the AccessAlarm logs because the time that is displayed in the AccessAlarm logs is the system time whereas the time displayed by L2tool output is the time the stack was started This time is cumulative and is reset when the Stack is restarted The time displayed in the L2tool is in milli...

Page 60: ...ah The following information is displayed sal pmc8260 v1 2 0 2002 Copyright c SS8 Networks Inc mtpl2 pmc8260 v1 2 0 2002 Copyright c SS8 Networks Inc 4 Enter the following commands at the prompt db level2 n rt This will begin to stream SS7 trace messages to the screen Capture this trace by copying the screen Note When the trace is complete exit the debug level correctly refer to step 5 If you do n...

Page 61: ...6949596 size 003 578 c6a100 NIC 01 time 026949606 size 003 579 a0c600 NIC 01 time 026949609 size 019 580 a0c71085 03020109 08070c18 00290200 020100 NIC 01 time 026949609 size 003 581 a0c700 NOG 01 time 026949609 size 003 582 c7a100 NIC 01 time 026949610 size 003 583 a1c700 NIC 01 time 026949611 size 003 584 a1c700 NOG 01 time 026949615 size 019 585 c7a21085 09080703 02010c18 00180001 020103 NOG 01...

Page 62: ...r to Solacom support The following procedure lists the steps to decode SS7 using Wireshark 1 Copy the ss7wireshark directory into the C EdgeIQ directory 2 Ensure Wireshark is installed at c Program Files Wireshark 3 Execute the following script from a command prompt C EdgeIQ ss7wireshark ss7wireshark vbs l2tools tracefile out txt Eg C EdgeIQ ss7wireshark ss7wireshark vbs good txt out txt Note This...

Page 63: ...8 07 03 02 01 0c 18 00 17 02 00 01 01 11 11 22 22 0000 c6 a1 0f 85 09 08 07 03 02 01 0c 18 00 17 02 00 01 01 c Output2 is the output of the command text2pcap exe out txt output2 d Output3 can be loaded into wireshark Output3 is the result of editcap T mtp2 output2 output3 5 Launch Wireshark Navigate to Edit Preferences Protocols MTP3 The Wireshark Preferences Profile Default window appears See fig...

Page 64: ...Level 2 Tracing SS7 52 7 Load output 3 into Wireshark the following window appears ...

Page 65: ......

Page 66: ...B2214167 6 SR1 ...

Reviews: