dialogic application note
Contents
1. 38 16 KJ LEES ISA M 38 16 1 cue i 38 A O 39 REFERENCES oa dad da 40 Using DataKinetics SS7 Products Annette Donofrio Page 3 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIA n anr DIALOGIC APPLICATION NOTE 1 Objective This application note focuses on setting up a DataKinetics SIU amp Host back to back with a PCCS6 system in order to create a test harness for an SS7 network This app note is a supplemental to the DataKinetics SW manuals and will attempt to point out any configuration difficulties that one may experience in setting up this configuration This test harness once established should be a good platform to reproduce and help resolve any SS7 customer issues This will also provide an excellent development platform in order to do SS7 application development Prior to discussing the DataKinetics SS7 products it may be a good idea to review some basic terminology and concepts about SS7 architecture and the SS7 protocol stack If you are fairly comfortable with these concepts and wish to move ahead to the DataKinetics product specifics go directly to Section 4 2 SS7 Basic Terminology and Architecture 2 1 Signaling Links SS7 messages are exchanged between network elements over 56 or 64 kilobit per second Kbps bi directional channels called signaling links Signaling occurs out of band on dedicated2. SU EE I DPC d Base CIC 1 Base CID l CIC Mask Options rem rn rrr nnn nn nnn nnnm 14 2 system txt Example system txt for the System7 Windows NT Development Package f neccessary edit this file to reflect your configuration Essential modules running on the host LOCAL 0x20 ssd Board Interface task LOCAL 0x00 Timer Task Optional modules running on the host LOCAL Oxcf s7 mgt Management config task LOCAL 0x2d ss7pong exe Example user part task LOCAL 0x3d mipsl program Modules running on the board all redirected via ssd REDIRECT 0x23 0x20 ISUP module REDIRECT 0x4a 0x20 TUP module Not currently using this REDIRECT Ox4a 0x20 NUP module Not currently using this REDIRECT 0x14 0x20 TCAP module Not currently using this REDIRECT 0x22 0x20 MTP3 module REDIRECT Ox71 0x20 MTP2 module REDIRECT 0x10 0x20 MVIP SCbus Clocking control module REDIRECT Ox8e 0x20 On board management task Redirection of status REDIRECT Oxdf 0x2d LIU MTP2 status messages to upe REDIRECT Oxef Ox2d Other indications to the user application ss7pong exe Now start up all local tasks FORK PROCESS BIMSSD EXE d NOTE the d is only for debug purposes Using DataKinetics SS7 Products
3. 4 Check clocking Ensure that one end is providing clock and one end is looking to the SS7 network for clock Can not have both ends providing or both looking to the network for clock 5 It is helpful to put d for debug in the following FORK PROCESS commands to get a verbose description of what is going on NOTE This is not documented On the PCCS6 System In run bat gctload d In system txt SSD EXE d S7 mgt exe d On the SIU Host System In run bat gctload d 6 The system txt file on the SIU should not need to be modified The only exception to this is when you need to enable protocol verification between the SIU and the host machine for debugging purposes You will want to add the nv option in both the SIU and the SIU host s system txt files as follows FORK PROCESS ABINIRSI EXE pfifo r BIN RSI_LNK EXE nv This option enables protocol verification between the SIU and the host machine The nv option should be removed from BOTH the SIU system txt file and the SIU host system txt file once the verification has been done 7 If the DataKinetics SS7 Management process on the SIU crashes with the very helpful error message S7MGT FAILED then comment out all timeslots above 24 in the MVIP XCON commands in config txt Using DataKinetics SS7 Products Annette Donofrio Page 26 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIA n anr DIALOGIC APPLICATIO
4. The inter process communication mechanism usually uses the module identifier as an index to an array of message queue pointers to provide an efficient mechanism to quickly access Using DataKinetics SS7 Products Annette Donofrio Page 11 Copyright Dialogic Corporation 1998 All Rights Reserved n anr The Name Behind the Voice DIA DIALOGIC APPLICATION NOTE 5 2 3 5 2 4 the correct message queue This feature can also be used to allow messages destined for a particular module to be re directed to an alternative message queue belonging to another module The re direction mechanism is used when messages need to be transferred to another board in the system Messages for all processes that run on the other board are redirected to a special local module which handles inter board message passing Other modules within the system do not need to know whether the modules with which they communicate are running locally or not Messages Modules communicate by sending messages to other modules in the system There are three types of messages used within the System7 protocol software MSG T FRAME and R FRAME However T FRAMEs and R FRAMES are only used on embedded processors by modules running on the same processor as the physical interface For this reason this document refers in detail only to the use of the MSG message structure The MSG message is a C structure containing a fixed format header field which is common also with
5. 0x52 0xc0 rmm io SIUB REDIRECT 0x72 0xc0 mip to SIUB REDIRECT Oxbf 0xc0 siumgt to SIUB LOCAL 0x23 ISUP on SIUA REDIRECT 0x63 0x23 ISUP from SIUB REDIRECT 0x73 0xc0 ISUP to SIUB Processes running on the remote host REDIRECT Oxef Oxb0 Remote API REDIRECT 0x0d Oxb0 Application 0 REDIRECT 0x1d 0xb0 Application 1 REDIRECT 0x2d 0xb0 Application 2 REDIRECT 0x3d 0xb0 Application 3 REDIRECT 0x4d 0xb0 Application 4 Processes running on SIUA and SIUB FORK_PROCESS alarm FORK PROCESS tim_qnx FORK PROCESS tick qnx FORK PROCESS siu mgt FORK PROCESS rsi p ram0 fifo r rsi Ink 11 m0xb0 FORK PROCESS rsi p ram0 fifo r rsi Ink I2 m0xcO Using DataKinetics SS7 Products Annette Donofrio Page 36 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIALOGIC APPLICATION NOTE FORK PROCESS cng qnx FORK PROCESS ssd FORK PROCESS rmm qnx FORK PROCESS mtp qnx Optional processes on SIUA and SIUB FORK PROCESS isp qnx ISUP Using DataKinetics SS7 Products Annette Donofrio Copyright Dialogic Corporation 1998 All Rights Reserved D n ae Page 37 The Name Behind the Voice DIALOGIC APPLICATION NOTE 16 16 1 D n ae Appendix C SIU Host Files system txt Example system txt for the System7 Windows NT Development Package If neccessary edit this file to reflect your configuration Optional modules running on
6. Each module in the system runs as a separate task process or program depending on the type of operating system The module is identified by a Module Identifier and communicates with other modules in the system by sending Messages to a Message Queue belonging to the destination module A set of Library Functions is the only operating system specific code used by a module A module handles multiple instances of the functional entity associated with the module eg MTP2 module handles multiple signaling links the MTP3 module handles multiple link sets and multiple routes the ISUP module handles multiple circuits Module Identifiers Each module has a module identifier module id which is a logical number in the range 0 to 255 t is used to identify modules within the system for the purposes of inter process communication To send a message to another process the sending module uses the module identifier of the destination process To receive a message from a modules own message queue it uses it s own module identifier Some modules operate with a fixed module identifier while others allow the module identifier to be specified at run time The module identifiers of other modules with which a module will communicate is usually a run time configuration option The module identifier is a logical value it is not the same as the task id or process id pid which is usually allocated automatically by the operating system when a process is created
7. T FRAMEs and R_FRAMEs and a buffer for variable length parameter data The message header contains a message type field which serves to identify the meaning of the message and the format of the variable parameter area The id field identifies to which instance of the entity handled by the module the message applies eg the link id or the circuit id etc The src and dst fields are the source and destination module identifiers which must be entered by the sending module prior to sending the message The rsp req field is used by the sending module to solicit a confirmation that the message has been processed by the destination process When a confirmation is requested the destination module after finishing processing the message enters a value in the status field of the message usually zero to imply success or non zero otherwise and sends the message back to the source module Message Queues Each module in the system has a single message queue which is used by other modules to send messages to the module A message queue is a system buffer which stores messages usually by reference in first in first out order Messages are read out of the message queue by the receiving module which typically waits until there is a message available and reads it it then processes the message and waits until the next message is available All input to the module is through its message queue The fact that the software is modularized in such a way allows a
8. channels rather than in band on voice channels Compared to in band signaling out of band signaling provides e faster call setup times compared to in band signaling using multi frequency MF signaling tones e more efficient use of voice circuits e support for Intelligent Network IN services which require signaling to network elements without voice trunks e g database systems e improved control over fraudulent network usage 2 2 Signaling Points Each signaling point in the SS7 network is uniquely identified by a numeric point code Point codes are carried in signaling messages exchanged between signaling points to identify the source and destination of each message Each signaling point uses a routing table to select the appropriate signaling path for each message There are three kinds of signaling points in the SS7 network Fig 1 e SSP Service Switching Point Using DataKinetics SS7 Products Annette Donofrio Page 4 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice g n an DIALOGIC APPLICATION NOTE e STP Signal Transfer Point e SCP Service Control Point SCP e SSP Ss7Links SIP SS7 Links SCP Figure 1 SS7 Signaling Points SSPs are switches that originate terminate or tandem calls An SSP sends signaling messages to other SSPs to setup manage and release voice circuits required to complete a call An SSP may also send a query message to a centr
9. contents are as follows DIA n anr bin Directory containing executable programs as follows e Windows NT device driver pecsxdvr sys e Dynamic link library gctnt dll e Interface w device driver for message passing to from board and downloading SW to board ssd exe e Board installation utility pccsxcfg exe e System7 environment executables gctload exe tim_nt exe and tick_nt exe e Protocol software configuration utility s7_mgt exe and example executables mtpsl exe and upe exe run Directory containing system configuration file system txt and Protocol configuration file config txt as well as the dc2 code file This is the directory from which the software should be run lib Directory containing library files lib for linking with the users application gctnt lib amp genlib lib src inc C header files required by an application src example Example source code to activate or deactivate an SS7 signaling link mtpsl c and an example of how to interface to MTP3 upe c 8 2 Installing the User Part Development Package Copy the contents of the User Part Development Package distribution disk into the system7src directory maintaining the sub directory structure 8 3 Installing the System7 Binary Disk Copy the appropriate Binary code file dc2 that you want downloaded to your PCCS6 card into the vun directory The title of the file tells which user parts if any
10. debugging purposes Using DataKinetics SS7 Products Annette Donofrio Page 39 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIA r DIALOGIC APPLICATION NOTE n an References 1 The white paper entitled Using DataKinetics SS7 Products by Rob Teets was used as a starting point for this Application Note 2 DataKinetics Entire Documentation Suite Using DataKinetics SS7 Products Annette Donofrio Page 40 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice
11. is Ox7fff7fff it must be changed to OxOOff7fff Using DataKinetics SS7 Products Annette Donofrio Page 23 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIA DIALOGIC APPLICATION NOTE In a multiple host single SIU configuration the following are important points 1 The DataKinetics software is designed to have a single point of contact for Management and Service types of messages i e any messages received from MTP3 and below So when the second host machine runs GCTLOAD to activate the link all that will be seen is a Link Up message and nothing else This is because the messages that Host 1 sees are Management messages from MTP2 and MTP3 Host 2 will not see these messages You might at that point ask How is Host 2 supposed to know that the link is established and can begin making calls The answer is the application code is responsible for informing each host of what is happening with the link The management messages are sent to a single place in your system to be logged and controlled by one machine That machine then informs all the other hosts you could have up to 32 hosts with a DSC231 model SIU and 16 hosts with a DSC131 model SIU There must be one ISUP_CFG_CCTGRP command in the configuration file for every span in the entire system That means that even the spans that do not have a D Channel and are not directly connected to the SIU must have an entry in this file If ther
12. is to think of each item as a module Each module can run either in the host PC or on the DataKinetics hardware PCCS6 card or SIU This is true of all software modules from the MTP3 level and up Each module uses inter process communication to send information to other modules Using DataKinetics SS7 Products Annette Donofrio Page 21 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIA n anr DIALOGIC APPLICATION NOTE Each module that runs is assigned an identifier called the module ID The system txt file creates those module ID s The system txt file contains 3 major sections 10 1 1 LOCAL The LOCAL section assigns module ID s for the modules that will run in the host machine The host machine is the computer where the application is running By placing the modules in this section it also guarantees that the queues for incoming messages from other processes will also be created 10 1 2 REDIRECT The REDIRECT section redirects messages from one module to another For example If you REDIRECT messages from your application to SSD EXE that means that the messages will be sent to the board If you REDIRECT messages from your application to RSI EXE they will be sent via TCP IP to the SIU 10 1 3 FORK PROCESS The FORK PROCESS section actually executes programs This is where each of the modules identified in the previous sections are actually run 10 2 config txt The config txt
13. system but also in the FORK PROCESS section where these process are actually executed PCCS6 System SS7pong e SS7pong i modin lt ie SS7 Link ae TICK_NT EXE Oxid mod ID E Oxef f mod ID 0x00 E Ethernet E di TCP IP Link exe mod ID Oxb0 modi Sa TIM_NT EXE Oa mod ID 0x00 RSICMD mod ID Oxfd ISUP MTP3 MTP2 running on the SIU ISUP MTP3 MTP2 running on the Board Figure 4 SIU lt gt PCCS6 Back to Back Configuration Using DataKinetics SS7 Products Annette Donofrio Page 25 Copyright Dialogic Corporation 1998 All Rights Reserved as The Name Behind the Voice DIALOGIC APPLICATION NOTE 12 DIA n anr Things to Check when there are Problems Verify that PCCS6 board is set to T1 or E1 mode with the daughtercards NOTE This is not documented For SIU s rather than opening up system send email to support datakinetics co uk with SIU serial number and they will tell you how the SIU was configured 2 Make sure that a cross over cable is used for the SS7 link Also when setting up two SIU s in dual redundancy mode a cross over cable must be used between the two SIU s 3 Make sure that each user app is compiled and linked with the appropriate development package that it will be run with The libraries are not binary compatible between PCCS6 Development Pkg and OS Specific SIU Host SW E g An application compiled and linked with the PCCS6 development package will not run on the SIU host or visa versa
14. the windows NT machine LOCAL Oxb0 RSI Module ID LOCAL Oxef s7 log Module ID recieves LOCAL Oxfd RSICMD Module ID LOCAL Oxid ss7pong exe Module ID Modules running on the SIU all redirected via rsi REDIRECT 0x23 0xb0 ISUP module REDIRECT 0x20 O0xbO SSD driver REDIRECT 0x22 0xb0 MTPS3 module REDIRECT 0x71 OxbO MTP2 module REDIRECT 0x10 OxbO MVIP SCbus Clocking control module REDIRECT Oxdf 0xb0 LIU MTP2 status messages to upe REDIRECT 0x32 0xb0 RNM Redundancy handling for SIU Now start up all local tasks FORK PROCESS _ BIN RSI EXE pfifo r BIN RSI_LNK EXE socket interface process Replaces the driver sends and receives messages to from the SIU Making use of the host operating system socket library and TCP IP FORK PROCESS _ BIN RSICMD EXE 0 Oxef 0 146 152 64 25 9000 starts the link to the SIU 9000 is the telnet port that this host will use to talk to the SIU This host is host 0 9001 host 1 Setting up initial socket connection Using DataKinetics SS7 Products Annette Donofrio Page 38 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice D n ae DIALOGIC APPLICATION NOTE FORK_PROCESS BIN s7_log EXE Siu Management Utility It receives status messages from the SIU and prints them to the console FORK_PROCESS BIN ss7pong exe m0x1d 16 2 run bat start bin gctload d NOTE The d option is only for
15. 1 0x01 0x01 OxOOff7fff 0x001e 0x00 TUP Parameters TUP CONFIG local pc lt ssf gt user id options num grps num cc s TUP CONFIG 2 0x8 Ox1d 0x0000 8 96 Define TUP circuit groups TUP CFG CCTGRP lt gid gt dpc base cic base cid cic mask options host TUP CFG CCTGHP 0 1 1 1 0x7fff7fff 0x0000 0x00 NUP Parameters NUP CONFIG local pc lt ssf gt user id options num grps lt num_ccts gt NUP CONFIG 2 0x8 0xid 0x0000 8 32 Define NUP circuit groups NUP CFG CCTGRP gid dpc base cic base cid cic mask options host NUP CFG CCTGRP 0 1 1 1 Ox7fff7fff 0x0003 0x00 SCCP Parameters SCCP CONFIG local pc ssf options Using DataKinetics SS7 Products Annette Donofrio Page 33 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice D n ae DIALOGIC APPLICATION NOTE SCCP_CONFIG 2 0x8 0x0000 Define SCCP Remote signalling points SCCP_RSP lt spc gt rsp flags SCCP_RSP 1 0x00 Define all local sub systems SCCP LSS lt ssn gt module id Iss flags SCCP_LSS 0x66 0x0d 0x0 Define all remote sub systems SCCP HSS spc ssn rss flags SCCP RSS 1 0x66 0x0 Define all local sub systems that require notification of changes in state of other signalling points or sub systems SCCP CONC LSS local ssn RSP remo
16. Annette Donofrio Page 30 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice r DIA n an DIALOGIC APPLICATION NOTE FORK PROCESS JBINITTIM NT EXE FORK PROCESS J BINITICK NT EXE FORK PROCESS BINIS7_MGT EXE d NOTE the d is only for debug purposes NOTE Recall that ss7pong exe doesn t activate signaling link from within application Also recall that mtpsl can not be run from within system txt it must be done prior to running application from command line Therefore after running run bat you must do the following two things from the command line cAmtpsl ACT 0 0 c ss7pong exe i Recall that the other side must be started before this side initiates calls 14 3 run bat start bin gctload d NOTE The d option is only for debugging purposes Using DataKinetics SS7 Products Annette Donofrio Page 31 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIALOGIC APPLICATION NOTE 15 15 1 D n ae Appendix B SIU Files config txt DSC231 Protocol Configuration File config txt Refer to the DSC131 DSC231 User Manual SIU commands Set the SIU instance Set to SIUA for standalone SIUA or SIUB for dual oper SIU_INSTANCE lt instance_token gt SIUA SIUB SIU_INSTANCE SIUA Define the network address of this SIU SIU_ADDR lt network_address gt SIU_ADDR 146 152 64 25 Define the network addr
17. C APPLICATION NOTE DIA n anr operation signaling can be load shared across the two units If one unit fails the remaining unit handles all signaling AC DC power supplies DOS Windows NT Solaris and SCO operating systems 4 1 1 1 DSC131 e DSOs CIC codes controllable DSC 131 4096 e Signaling Links DSC 131 up to 6 signaling links 2 PCCS6 cards max e Maximum of Link Sets 4 e Maximum call rate DSC 131 25 calls second e Maximum host connectivity 16 Hosts e Maximum of circuit groups configurable 128 4 1 1 2 DSC231 e DSOs CIC codes controllable DSC 231 16384 e Signaling Links DSC 231 up to 32 signaling links 12 PCCS6 cards max e Maximum of Link Sets 4 Max of 16 links link set e Maximum call rate DSC 231 80 calls second e Maximum host connectivity 32 Hosts e Maximum of circuit groups configurable 648 4 1 2 PCCS6 e An ISA card e One or two network interfaces T1 E1 or V 35 e Up to 3 SS7 signaling links e SCbus connector e CAP software running on the PC CS6 card e DOS Windows NT and SCO operating systems e DSOs CIC codes controllable 64 or 256 depending on ISUP module downloaded e Maximum of circuit groups configurable 128 when ISUP running on host 16 when 256 CIC s 4 when 64 CIC s e Maximum call rate calls second Very much host processor dependent Using DataKinetics SS7 Products Annette Donofrio Page 9 Copyright Dialogic Corporation 1998 All
18. EEEE E EA 21 9 3 6 S7 UE N E DA EEEE A A 21 9 4 Activating the Sos Cink cai e 21 9 4 1 GCTLOAD EXE E all le le lll ll dl al ell le 21 10 CONFIGURATION FIELES siscsscsssscssssesscsasseseesssscsacssstesovesecseaesseosvsasseoscoasseosssastsouesessedsdsorsousucssseeveceseessseseseassestees 21 10 T SyStOITLUXL eip tasted io qa eed cab e ead gs ee Ra SE ak ig eis decal easy 21 10 1 1 EQCAE Site cent tet eive edo RESI 22 10 1 2 REDIREGT 5 SUISSES rt tute iiie tereti ir age Hiis us 22 10 1 3 FORK PROCESS nS dei e e e a EREA 22 10 2 COMO iia cade 22 10 2 1 PECCSO Configurations x sd erste teen iia fica 22 10 2 2 SIU Confte rations ae ete pere tie e lil las 23 11 SIU PCCS6 BACK TO BACK CONFIGURATION eeeeeeeeeee seen sets se ten ast en sse en sse tns sets sets set en sse ens se tns seus 25 12 THINGS TO CHECK WHEN THERE ARE PROBLEMS eese eeee eee eee eren esset etna sett tns esee ts esee tense see tenssseno 26 13 RUNNING A SAMPLE APPLICATION LIKE SS7PONG EXE 4 ee eee eese eee een esee ense setas stets esee tno ss eno 27 APPENDEXCA e 28 14 PCCSO ULL Ur 28 14 1 COUNT DXE ore ee NR RE uem a tt E UEM te e e PUE 28 T4 2 SVSIOITAXL ae Avi dE EE EM uM 30 Tad A 1 P OF 1 SAE PE A 31 ANOETA A ON 32 15 SIV FILES eT 32 15 1 7 CONIO DI sese a a a E AR 32 12 SIM Dia A A E a a da 35 APPENDIX E OEE
19. INKSET 0 0x2 2 0x0000 A A A A Linkset ID d d od Adj PC m oe J Max number of links Flags d Using DataKinetics SS7 Products Annette Donofrio Page 28 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice D n ae DIALOGIC APPLICATION NOTE MTP_LINK 0 0 0x10 0x10 0x06 A A MTP ROUTE 2 0 0x0020 each user part is assigned a unique number A A A UP enable tupz4 sccp 3 isup 5 This is the number of bit switches to enable the right user parts so in our example above we are setting bit 5 to 1 for ISUP user part This is normally used if someone is supplying their own user part MTP USER PART 0x0a 0x23 A A Service Ind i l Mod ID Must enable ISUP s user part ISUP CONFIG 1 Oxb 0x2d 0x0734 0x0001 0x0018 A A A A A A Local PC Ug I l I SSF 1 User ID l I Options 1 I l Number of circuit groups optional d l Number of circuits optional Using DataKinetics SS7 Products Annette Donofrio Page 29 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIALOGIC APPLICATION NOTE D n ae ISUP CFG CCTGHP 0 2 0x01 0x01 OxOOff7fff 0x001e A A A A A A GID
20. N 4 16 17 3 17 17 0 MVIP_XCON 4 16 18 3 17 18 0 MVIP_XCON 4 16 19 3 17 19 O MVIP_XCON 4 16 20 3 17 20 0 MVIP_XCON 4 16 21 3 17 21 0 MVIP_XCON 4 16 22 3 17 22 0 MVIP_XCON 4 16 23 3 17 23 0 MVIP_XCON 4 16 24 3 17 24 0 MVIP_XCON 4 16 25 3 17 25 0 MVIP_XCON 4 16 26 3 17 26 0 MVIP_XCON 4 16 27 3 17 27 0 MVIP_XCON 4 16 28 3 17 28 0 MVIP_XCON 4 16 29 3 17 29 0 MVIP_XCON 4 16 30 3 17 300 MVIP_XCON 4 16 313 17 31 0 End of file 15 2 system txt DSC131 DSC231 System Configuration File system txt Generated by sysgen sSIUA ulSUP Dale Wed May 20 13 19 10 1998 Using DataKinetics SS7 Products Annette Donofrio Copyright Dialogic Corporation 1998 All Rights Reserved D n ae Page 35 The Name Behind the Voice D n ae DIALOGIC APPLICATION NOTE Definitions for both SIUA and SIUB LOCAL Oxdf siu mgt management configuration process LOCAL 0x20 ssd signalling board driver LOCAL 0x21 cong congestion management LOCAL 0x00 timer LOCAL 0xb0 rsi host to SIU communication LOCAL 0xc0 rsi SIUA to SIUB communitcation LOCAL 0x32 rmm LOCAL 0x22 mip mtp3 REDIRECT 0x71 0x20 mtp2 running on signalling card REDIRECT 0x10 0x20 switch manager running on signalling card REDIRECT 0x8e 0x20 management running on signalling card Definitions unique to SIUA REDIRECT 0x42 0x32 rmm from SIUB REDIRECT 0x62 0x22 mtp from SIUB REDIRECT Oxaf Oxdf siumgt from SIUB REDIRECT
21. N NOTE 13 Running a sample application like ss7pong exe NOTE 1 ss7pong exe is an internal demo created from the CTU demo It is not delivered with any of the DataKinetics packages To obtain a copy of this demo go to donofria2 ss7pong As part of the User Part Development Package there is a demo called CTU which is very similar to ss7pong exe The CTU demo is an example call control application that runs above a telephony user part When an incoming call is set up CTU will answer this call and attempt an outgoing call on the next circuit The ss7pong exe demo is very useful in proving a connection between two machines and in also learning the functions to prove one It sends the following ISUP messages back and forth until you hit control C IAM ACM ANM REL and RLC More importantly it does not require any voice processing HW in order to verify the SS7 link It s an excellent starting point The side that initiates i e sends the first IAM message must be started with the i option Only one call is active at a time and the two sides take turns initiating the call When terminating ss7pong to keep the ISUP modules happy ss7pong should be canceled first on the side that initiated the first call that is ss7pong i Cancel it immediately after this side sends an REL message releasing a call that the other side had initiated but before it sends its next IAM There is a one second pause between calls for this purpose Then ca
22. Rights Reserved The Name Behind the Voice g n an DIALOGIC APPLICATION NOTE 4 1 3 5 SS7 Software e TUP Telephony User Part e BT NUP e China TUP e French TUP coming soon e SUP Integrated Services User Part e ITU e ANSI e TCAP Transactions Capabilities Application Part e ITU e ANSI e Most of the SS7 software protocols are customizable e New SS7 software protocols are being added all the time DataKinetics Software Architecture The DataKinetics software architecture is very well described in the System7 Software Environment Programmer s Manual Excerpts of the manual are below Please see the manual for complete details 5 1 Introduction The DataKinetics System7 product range is comprised of a number of portable software modules for the realization of Signaling System Number 7 SS7 protocol stacks The System7 architecture is multi tasking using message passing to communicate between tasks Each module in the system is implemented as a separate task within the chosen operating environment A module implements either a layer within the protocol stack a user part or some other functional entity within the system In general a module supports multiple instances within a single process for example multiple links multiple circuits or multiple transactions are each handled by a single process For software portability each module makes a minimum demand on the host operating system Most modules req
23. U 0 007 DIALOGIC APPLICATION NOTE Using DataKinetics SS7 Products Using DataKinetics SS7 Products Annette Donofrio Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIALOGIC APPLICATION NOTE Table of Contents TABLE G1 0E 8 HE Dh Ec oisein 2 1 OBJECT DA Oper 4 2 SS7 BASIC TERMINOLOGY AND ARCHITECTURE e eeeeeeee esee en nett ntt en stent etes sse tns sets assess conca sets sens seins 4 A A O eats A rtu etri eMe D bd Ad Uem s me id 2 2 gnaling TP ollis eoe Bante oe Aten ttn CREBRO MR nda au eu QE 3 THESS7 PROTOCOL STAQCK rea cer co on vh ce eve orta Copa eee epo aee evo see eR Ro CC eae VE e e en TEE aee Pao sept ed Ca eU ev ea DEP oesie rosso sssi 5 2o Message Transrer Pater teo io Ee p et obe redu tata eot tinta ae edid 9 2 ISDN User Partis Pros cai boo aeta tcs tle aao nec pde Leo Coop cada 29 Telephone Dsar Part CLUP xii Eee ote Reo boh ES so Obr vrbe esee poe Rede de eet ie cath 3 4 Signaling Connection Control Part SCCP coooooocccccccnccncccnannonnnnncnnnncnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nn rra rnnnnna rencia 3 5 Transaction Capabilities Applications Part TCAP sssssssseeenenn enn 4 THE DATAKINETICS PRODUCT LINE eere esee eene seen aset tn aset tns eset eta aset tense set tense set tasse estesa esee tease sete sese 8 4 1 Spe
24. alized database an SCP to determine how to route a call e g a toll free 1 800 888 call in North America An SCP sends a response to the originating SSP containing the routing number s associated with the dialed number An alternate routing number may be used by the SSP if the primary number is busy or the call is unanswered within a specified time Actual call features vary from network to network and from service to service Network traffic between signaling points may be routed via a packet switch called an STP An STP routes each incoming message to an outgoing signaling link based on routing information contained in the SS7 message Because it acts as a network hub an STP provides improved utilization of the SS7 network by eliminating the need for direct links between signaling points An STP may perform global title translation a procedure by which the destination signaling point is determined from digits present in the signaling message e g the dialed 800 number calling card number or mobile subscriber identification number An STP can also act as a firewall to screen SS7 messages exchanged with other networks Because the SS7 network is critical to call processing SCPs and STPs are usually deployed in mated pair configurations in separate physical locations to ensure network wide service in the event of an isolated failure Links between signaling points are also provisioned in pairs Traffic is shared across all links in the links
25. am 8 7 1 GCTLOAD EXE The GCTLOAD EXE program is run once all the configuration files are setup correctly GCTLOAD EXE reads through the system txt file sets up the software environment then forks the executables specified in the system txt file Typically this program is run from a batch file located in the run directory For example run bat files refer to Appendix A for PCCS6 System amp Appendix C for SIU Host Once the system environment is initialized and all environmental executable processes are run it is now time to Activate the SS7 Link from There is a utility called mtpsl which is included for the user to easily activate the link The format of the mtpsl utility is Using DataKinetics SS7 Products Annette Donofrio Page 18 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIA n anr DIALOGIC APPLICATION NOTE mtpsl lt ACT DEACT gt link set lt link within linkset gt eg mtpsl ACTOO NOTE mtpsl can not be run from within the system txt file It must be run from the command line The mtpsl c sample code located in src example is provided to show users how to send messages to MTP3 to activate and deactivate links from within the user application It is expected that eventually the user will incorporate this example code into their own application to activate the link at initialization 9 Configuring the SIU amp SIU Host Systems Take the following steps to get a DataKi
26. cific Product Details A tincnhes Aecdepucts agus pat ccnaiyceaaates cnnsucesantbessecenreomeaneaevane 4 1 1 Signaling Interface Unit STU eer eene aeae eea a eee ar iaee a a reei ea edere dat 8 4 1 2 I EY E E RNA 9 4 1 3 TA A N 10 5 DATAKINETICS SOFTWARE ARCHITECTURE sccsssssscssssssecssscsesssscscccssscscesssscscsssscssessssesessssssessseees 10 bulis o este oboe ote Ea ee St euch ettet tes qM LU PEE I LONE MK Gene LR c CE 10 52 Basic GONCOPIS ereere irre lacuna adio estes eL dices tete lad eerte rdiet 11 5 2 1 Mon M nerd um EIS 11 5 24 Mod le Identifiers iode asian 11 5 2 3 Y MESSI SA a A A a e MC Ra e iie 12 5 24 X RCA 12 6 SOFTWARE DELIVERABLES FROM DATAKINETICS Leeeeeee cesse eee eee esee eene sett enn esee tense see ten esee tense se einas 13 7 HIGH LEVEL ARCHITECTURE OF SIU lt gt PCCS6 SYSTEM SETUP ee eeeeeee esee eene seen esset tns ese etnuo 13 8 CONFIGURING THE PCCS6 SYSTEM 4 eee e eene ee eee en eese tna esee ttn asset tassa etta sese teens sees eas eset etas eset eese sesto sese ena 14 8 1 Installing the PCCS6 Development Package for Windows NT oooonnnnnncccccncnccconnnannnccnnnncnnnnnnana nono 15 8 2 Installing the User Part Development Package ccoccconooooccconnccccconanancnnncnnnnncnnnnnnnncnnnnnnnnnnnnnannnnnos 16 8 3 Installing the System7 Binary Disk ooonnonnnnnnccccnnnnnncnnnnonccnnncnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn cnn c
27. ck cables etc 6 Execute the BIN gctload program from the host machine to read the system txt file on the host and FORK the appropriate executable files specified In an SIU configuration the SS7 link specific configuration is only resident on the SIU itself since that is where the SS7 cards reside so the host only has a system txt file and no config txt file For example configuration files refer to Appendix B for SIU files and Appendix C for SIU Host files 9 1 Installing the OS Specific Host SW The Win NT Host SW is distributed on a DOS format disk The installation procedure essentially involves copying the files onto your development system Using DataKinetics SS7 Products Annette Donofrio Page 19 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIA n anr DIALOGIC APPLICATION NOTE In order to set up the SIU Host system first create a new directory to serve as the root directory for the System7 software mkdir c system7 Then copy the contents of the Win NT Host SW into this according to the following sub directory structure The sub directories and their contents are as follows bin Directory containing executable programs as follows System7 environment executables gctload exe rsi exe rsi Ink exe rsicmd exe s7 log exe s7 play exe and siucmd exe run Directory containing system configuration file system txt and run bat This is the directory from which the software
28. e are multiple hosts the ISUP_CFG_CCTGRP command instructs the SIU as to where to send the messages for those particular circuits The base cic is from the switch s perspective So if you are connected to the same switch for both links the base cic will never be the same number BUT if you are connected to multiple switches the base cic could be the same number The base cid is a logical number used from the SIU s perspective That means that it will never be the same number and should be incremented for every circuit entry in the configuration file i e the base cid 0 through total circuits 1 Using DataKinetics SS7 Products Annette Donofrio Page 24 Copyright Dialogic Corporation 1998 All Rights Reserved n anr The Name Behind the Voice DIA r DIALOGIC APPLICATION NOTE n an 11 SIU PCCS6 Back to Back Configuration The following diagram illustrates a back to back configuration using an SIU on one side and a PCCS6 card on the other Configuration files are given to show exactly how to configure this setup in Appendices A C These diagrams illustrate software and hardware modules in this configuration Hardware modules are shown with black shadowing software modules with gray The following diagram shows an example of the software environment Notice that the modules in the picture map not only to the module ID s in the system txt files located in Appendix A for PCCS6 system and Appendix C for SIU Host
29. ess of the partner SIU dual operation only SIU_REM_ADDR lt remote_address gt SIU_REM_ADDR 193 195 185 251 Define the number of hosts that this SIU will connect to SIU_HOSTS lt num_hosts gt SIU_HOSTS 1 Set physical Interface Parameters PCCS6 BOARD port id lt bpos gt num pcm flags PCCS3 BOARD port id bpos num pcm flags PCCS6 BOARD 0 4 0 0x0003 MTP Parameters MTP CONFIG local spc ssf options MTP CONFIG 2 Oxb 0x0f00 ANSI setup Using DataKinetics SS7 Products Annette Donofrio Page 32 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIA r DIALOGIC APPLICATION NOTE n an Define linksets MTP LINKSET linkset id adjacent spc num links flags local spc lt ssf gt MTP LINKSET 0 1 1 0x0000 2 Oxb Define signalling links MTP LINK link id linkset id link ref slc bpos blink stream ti MTP LINK 0 0 0 0 4 0 0x10 0x10 0x06 Define a route for each remote signalling point MTP ROUTE dpc linkset id user part mask MTP ROUTE 1 0 0x0020 SUP Parameters SUP CONFIG local pc ssf user id options num grps num ccts ISUP CONFIG 2 Oxb 0x1d 0x0734 Define ISUP circuit groups ISUP_CFG_CCTGRP lt gid gt dpc base cic base cid cic mask options host ISUP CFG CCTGRP 0
30. et If one of the links fails the signaling traffic is rerouted over another link in the linkset The SS7 protocol provides both error correction and retransmission capabilities to allow continued service in the event of signaling point or link failures 3 The SS7 Protocol Stack Using DataKinetics SS7 Products Annette Donofrio Page 5 Copyright Dialogic Corporation 1998 All Rights Reserved gs The Name Behind the Voice DIA DIALOGIC APPLICATION NOTE The hardware and software functions of the SS7 protocol are divided into functional abstractions called levels These levels map loosely to the Open Systems Interconnect OSI 7 layer model defined by the International Standards Organization ISO y Application 6 Presentation EM TCAP PENE 5 Session hA N 4 Transport sccp Data Link MTP Level 2 1 Physical MTP Level 1 Figure 2 The OSI Reference Model and the SS7 Protocol Stack 3 1 Message Transfer Part The Message Transfer Part MTP is divided into three levels The lowest level MTP Level 1 is equivalent to the OSI Physical Layer MTP Level 1 defines the physical electrical and functional characteristics of the digital signaling link Physical interfaces defined include E 1 2048 kb s 32 64 kb s channels DS 1 1544 kb s 24 64kb s channels V 35 64 kb s DS 0 64 kb s and DS 0A 56 kb s MTP Level 2 ensures accurate end to end transmission of a message across a signaling link Level 2 implements flow con
31. file specifies the SS7 links connection characteristics Just like the isxxx prm files in Dialogic ISDN configurations the config txt file specifies the details of the SS7 interface The config txt file contains multiple sections In a PCCS6 configuration the config txt file is located on the host machine in the RUN directory In an SIU configuration this file is located on the SIU itself in home dklsiu This file must be modified by telnet ing into the SIU machine and editing the file Remember that the SIU has its own operating system QNX that uses a vi editor Depending on whether a PCCS6 card is being configured or an SIU the config txt file will contain different sections 10 2 1 PCCS6 Configurations Below are the following configuration characteristics that are defined in the config txt with regards to a PCCS6 configuration 10 2 1 1 Physical Configuration The PCCS6 BOARD command identifies the characteristics of the card itself Most notable items in this command include the clock source for the board how many interfaces are contained on the board and what firmware file to download to the board 10 2 1 2 MTP Configuration This section defines the characteristics of the MTP layers For example the linkset local point code and adjacent point code are defined here In a back to back configuration it is very important to verify that the Local Point Code on one side of the connection is different than the Local Point Code on t
32. for message routing A single MTP 3 entity is typically serviced by sets of subtending Message Transfer Part 2 MTP 2 data link protocol entities organized as Signaling linksets Signaling Links are organized as linksets to offer seamless switching of message load in the event of link failures Load balancing across Signaling linksets can only be performed within the same point code For this reason many applications may require MTP 3 to be Host resident 3 2 ISDN User Part ISUP The ISDN User Part ISUP defines the protocol used to set up manage and release trunk circuits that carry voice and data between terminating line exchanges e g between a calling party and a called party ISUP is used for both ISDN and non ISDN calls However calls that originate and terminate at the same switch do not use ISUP signaling 3 3 Telephone User Part TUP In some parts of the world e g China Brazil the Telephone User Part TUP is used to support basic call setup and tear down TUP handles analog circuits only In many countries ISUP has replaced TUP for call management 3 4 Signaling Connection Control Part SCCP SCCP provides connectionless and connection oriented network services and global title translation GTT capabilities above MTP Level 3 A global title is an address e g a dialed 800 number calling card number or mobile subscriber identification number which is translated by SCCP into a destination point code and subsyste
33. g DataKinetics SS7 Products Annette Donofrio Page 14 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIA n anr DIALOGIC APPLICATION NOTE 7 Enable the driver see Activating the Device Driver below 8 Verify that the driver has been enabled see Activating the Device Driver below 9 Change the Startup Mode of the driver to Automatic 0 Modify the configuration files to reflect your configuration see Configuration Files below 1 Execute the BIN gctload program to read the system txt configuration file and FORK the appropriate executable files specified in the configuration files 12 Make sure that the signaling link has been activated see Activating the SS7 Link 1 1 8 1 Installing the PCCS6 Development Package for Windows NT The PCCS Development Package for Windows NT is distributed on a DOS format disk The installation procedure essentially involves copying the files onto your development system In order to set up the PCCS6 system first create a new directory to serve as the root directory for the System7 software mkdir c system7 Then copy the contents of the PCCS Development Package into this directory according to the following sub directory structure Using DataKinetics SS7 Products Annette Donofrio Page 15 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIALOGIC APPLICATION NOTE The sub directories and their
34. he other side Using DataKinetics SS7 Products Annette Donofrio Page 22 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIA n anr DIALOGIC APPLICATION NOTE Also for a back to back configuration verify that the DPC Destination Point Code and Adjacent Point Code on one side matches the Local Point Code on the other side NOTE In the MTP ROUTE command the user part mask is a 16 bit value with bit n n 0 15 set to allow the route to be used for messages with the following SI service indicators The SI s are defined as follows SCCP 3 0x8 TUP 4 0x10 ISUP 5 0x20 Important NOTE 1 for ANSI Operation The MTP CONFIG line in config txt specifies how the Layer 2 link should be set up The sub service field argument of MTP CONFIG which is 8 by default must be set to Oxb for ANSI T1 This is NOT documented in the manuals This argument is a bit field which specifies message priorities and must be set a certain way for ANSI T1 ITU E1 does not prioritize message which is why they are mostly zero Leaving the sub service field at the default of 8 has the effect under T1 of giving highest priority to call setup messages which ANSI dictates should have the lowest priority and of giving zero priority to a other messages Important NOTE 2 for ANSI Operation Also in MTP CONFIG the Options bit field which is set to all zeroes by default must be set to Oxf00 Bits 8 amp 9 spec
35. ify ANSI operations as documented in the manuals Bits 10 amp 11 operate somehow with the sub service field to define message priorities and must be set for ANSI T1 operations 10 2 1 3 ISUP Configuration This section defines the ISUP characteristics Point codes CIC codes etc The Point Codes in this section must match those in the MTP Configuration section Important NOTE 3 for ANSI Operation Each SS7 user part has its own configuration command in config txt I m only familiar with ISUP CONFIG however the Options field of ISUP CONFIG which is a bit field must have bits 8 amp 9 set in order to enable ANSI compliant operations These bits are zero by default 10 2 2 SIU Configurations In an SIU configuration the config txt file contains all the same information in the PCCS6 configuration plus the following sections 10 2 2 1 SIU Commands This defines how many SIU s are in the system A second SIU is typically configured for redundancy 10 2 2 2 Cross Connections This section maps the inbound B channels tslots on one PCM port to the outbound B channels tslots on the other PCM port while the SIU strips off signaling information which is sent to the host s via TCP IP NOTE When enabling a T1 signaling link it is important to comment our references for T1 timeslots 25 32 in the MVIP XCON section You must also reset bits 25 32 of the CIC Mask argument of all ISUP CFG CCTGRP command lines By default this mask
36. in addition to the SS7 Message Transfer Part MTP which is always included are included in the code file The title of the file refers to the highest SS7 Protocol layer included in the code file including all sub layers Refer to Figure 3 to see which layers are considered sub layers For Example mtp dc2 includes only MTP Using DataKinetics SS7 Products Annette Donofrio Copyright Dialogic Corporation 1998 All Rights Reserved Page 16 The Name Behind the Voice DIA r DIALOGIC APPLICATION NOTE n nan isup dc2 includes ISUP amp MTP tup dc2 includes TUP amp MTP tcap dc2 includes TCAP SCCP amp MTP 8 4 Installing the Device Driver When installing a PCCS6 board there is one file pccsxdvr sys that is loaded into the BIN directory that must be moved into the WINNT system32 directory This is the device driver file This file must reside in the system32 directory for the DataKinetics software to operate properly Also a copy of the LIB gctnt dll file must be copied to the system32 directory 8 5 Activating the Device Driver Once the PCCSXDVR SYS file has been copied to the correct directory it must be activated The PCCSXCFG EXE program must be used to do this The PCCSXCFG EXE program adds the device driver to the system Example instantiation of this command to add the device driver is as follows CAsystem7 BIN pccsxcfg n1 p0x200 m0xd0000 add c winnt system32 pccsxdvr sys The parameters are a
37. m number A subsystem number uniquely identifies an application at the destination signaling point SCCP is used as the transport layer for TCAP based services Without SCCP the smallest addressable entity would be a point code With SCCP a subsystem i e a user application within a point code can be addressed Using DataKinetics SS7 Products Annette Donofrio Page 7 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIA n anr DIALOGIC APPLICATION NOTE 3 5 Transaction Capabilities Applications Part TCAP TCAP supports the exchange of non circuit related data between applications across the SS7 network using the SCCP connectionless service Queries and responses sent between SSPs and SCPs are carried in TCAP messages For example an SSP sends a TCAP query to determine the routing number associated with a dialed 800 888 number and to check the personal identification number PIN of a calling card user In mobile networks IS 41 and GSM TCAP carries Mobile Application Part MAP messages sent between mobile switches and databases to support user authentication equipment identification and roaming 4 The DataKinetics Product Line Dialogic has had a relationship with DataKinetics since 1994 Many Dialogic customers have integrated DataKinetics SS7 products into their CT applications Some of these solutions are currently deployed in the public network Dialogic is reselling the following DataKi
38. ncel ss7pong on the other side Gotchas The initiating side running ss7pong exe with the i option is hardcoded to module id Ox2d Using the m option to reset the module id has no effect The non initiating side defaults to module id Ox1d however this side can be overridden by the m command line option NOTE 2 Make sure that if you change the module id using the m option that the same module id is present in the FORK PROCESS line in system txt The ss7pong exe does not activate the signaling link For this reason mtpsl must be run prior to running the demo mtpsl must be run from the command line not from within system txt Using DataKinetics SS7 Products Annette Donofrio Page 27 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice D n ae DIALOGIC APPLICATION NOTE Appendix A 14 PCCS6 Files 14 1 config txt Example config txt for the System7 protocol configuration Edit this file to reflect your configuration Physical Configuration board id is a logical number The driver accesses the board at the i o port id and add a board at the offset its trying to start a board at 204 The i o ports and the board ID s map 1 1 so board 0 ox200 up to 16 cards PCCS6 BOARD 0 0 0 0x0002 isup76 dc2 A A A A A PortlD l BOARDID 5 pe NUM PCM t d FLAGS corria MTP CONFIG 1 Oxb 0x0f00 A A A MTP L
39. netics Products e PCCS6 is an ISA based SS7 board solution e SIU is an SS7 to TCP IP server solution e SS7 software stacks for TUP ISUP and TCAP All of these products use the same architecture and SS7 API 4 1 Specific Product Details 4 1 1 Signaling Interface Unit SIU e Anintegrated box level solution that converts the SS7 protocols to TCP IP messages e Automatically distributes SS7 messages to the appropriate voice response units VRUs based on circuit identification code CIC e SIUs can be deployed in a load sharing configuration to increase reliability e Single or dual E1 T1 V 35 interfaces per PCCS6 card present in SIU e SS7 signaling can be extracted from an incoming E 1 or T 1 PCM port into the SIU and if there are voice circuits also on that signaling link they are passed out of the 2 E 1 or T 1 PCM port on the board Alternatively the signaling can be connected using V 35 serial links or on a PCM port with no voice circuits Signaling information is automatically distributed by the SIU via a TCP IP LAN to the host application platform A portable interface library is provided which can be used on most UNIX and Windows NT platforms Two units can be configured to share the same point code providing fully resilient operation within a single point code In normal Using DataKinetics SS7 Products Annette Donofrio Page 8 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIALOGI
40. netics SIU amp SIU Host configuration working 1 Install DataKinetics software See Installing the OS Specific Host SW and Installing the User Part Development Package below 2 Connect either a dumb terminal to the SIU using the serial RS232 connector or you can telnet across the network to gain access to the SIU to edit config txt and system txt A variety of terminal emulation programs which emulate VT100 terminal type will work NOTE 1 The initial time that you configure the SIU the IP address will not be set up correctly so telnet will not work For initial setup a dumb terminal with a null modem serial cable is required NOTE 2 The SIU is not configured to allow access to a machine from another subnet You must telnet from the same subnet as the SIU in order to configure that system Also the host must be on the same subnet as the SIU 3 Modify the etc hosts file on the SIU to reflect the correct IP address for the SIU NOTE Make sure that s the same IP address that is entered in the FORK PROCESS rsicmd exe line in the host system txt file 4 Reboot the SIU for the IP address to take affect 5 ping the IP address from the host machine on the LAN must be on same subnet to verify that the machine can talk to the SIU Modify the configuration files to reflect your configuration see Configuration Files below If the host machine cannot ping the SIU there may be something physically wrong with the LAN setup Che
41. nn nnne nnne nnne 16 84 Installing the Device Driver rre nter to ne er da nhat RR EP p APP DS ets 17 8 5 Activating the Device DrIVOI scio rero tt re ener estudiar ont onera ceti toni toca tt b one Re a mut 17 8 6 DataKinetics PCCS6 Environment Executable ProgramS ooococccccnnnconoccccnnnccnnnnnnnnnnncnnnnnnnnnnnnnnnnnos 18 6 6 1 SZ MGT D om A A AAA Aaa dea 18 8 6 2 SSDEX E oi edo dare a RO EEEE A i 18 863 TIM NT ANNAN AA SAA ARA 18 8 6 4 TICK N T oreen a a a beds a dee Soe A a A aie eds weir a AE AA Ae OA AATE a 18 84 cAGDvaling the SSF ENK crop ER EI E SHEET E veda c A S 18 8 7 1 LOPE II DEA 18 9 CONFIGURING THE SIU SIU HOST SYSTEMS e eerie sees teens ette esten setis ase tns conc ncnncncoccnconcnnooccnconanononos 19 9 1 Installing the OS Specific Host SW cias adi da 19 9 2 Installing the User Part Development Package ccccccoooooccconcconononanancnnnononnncnnnnannncnnnnnnnnnnnnnnnnnnnrs 20 9 3 DataKinetics SIU amp SIU Host Environment Executable Programs ooooooocccccnncccconccnoncccnnnnccnananann nono 20 9 3 1 RSTENE 00 la da e ENS E ENSA AA Ti eee ERES Bote SE ves TER etr SENE RTI SE dE RUE 20 Dg DOS satio ee a a aseo A A M ERA RR 20 Using DataKinetics SS7 Products Annette Donofrio Page 2 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIAL ce G DIALOGIC APPLICATION NOTE cC 9 3 3 LAO IDEO Fo 20 9 3 4 NIDIB DEO EE 21 9 3 5 STE OG EXE
42. on messages from the SIU and displays these as text on the application console 9 3 6 S7 PLAY EXE This program reads message contents from an ASCII text file in a defined format and sends these messages to the SIU 9 4 Activating the SS7 Link The system environment is created and all protocol modules started by the gctload exe program 9 4 1 GCTLOAD EXE The GCTLOAD EXE program is run once all the configuration files are setup correctly GCTLOAD EXE reads through the system txt file sets up the software environment then forks the executables specified in the system txt file See Configuration Files below for details on the system txt file Typically GCTLOAD EXE is run from a batch file located in the run directory For an example SIU Host run bat file refer to Appendix C 10 Configuration Files There are 2 configuration files used when setting up the software for a DataKinetics system system txt and config txt NOTE Example config files for a PCCS6 lt gt SIU configuration are in Appendices A C 10 1 system txt The system txt file specifies how the DataKinetics software environment is set up This is NOT to say the SS7 specific software but the software that allows user applications to talk to the DataKinetics hardware The system txt file is located in the RUN directory on the SIU Host and PCCS6 machines and is present in home dklsiu on the SIU The easiest way to understand the operation of the DataKinetics software
43. pplications to be scalable from a single board configuration to a multiple SIU configuration without modifying the application The changes that are required to move to a higher density solution are configuration related Using DataKinetics SS7 Products Annette Donofrio Page 12 Copyright Dialogic Corporation 1998 All Rights Reserved n anr The Name Behind the Voice DIALOGIC APPLICATION NOTE 6 Software Deliverables from DataKinetics DIA n anr Software Develiverable System where SW Resides Software Description PCCS6 Development Package PCCS6 System Contains the device driver header files and library functions for use by an application a number of executables to be run as part of the System7 environment and a utility program to configure the protocol SW User Part Development PCCS6 System amp SIU Contains example source code to illustrate the techniques used for interfacing with the System 7 Package Host software modules OS Specific Host SW SIU Host Contains a number of executable programs and libraries or C source files that are linked with the users application System7 Binary Disks PCCS6 System Contains the code file which is downloaded to the board at run time by the driver program Code files for PCCS3 have a file suffix dc1 while code files for PCCS6 use dc2 7 High Level Architecture of SIU lt gt PCCS6 System Setup Using DataKinetics SS7 Prod
44. s follows n1 number of boards p0x200 i o port each board uses 4 ports from and including the first m0xd0000 memory address each board uses the same 4K block add add the device driver c winnt system32 pccsxdvr sys If the command was successful the following will be printed to the screen PCCS6 board 0 memory 0xd0000 ioport 0x200 If this is not displayed something did not get installed correctly In most cases this is an I O or memory conflict Check the NT Diagnostics and verify that the board is being loaded in an unoccupied location use c winnt system32 winmsd exe Also check Event Viewer for more details on failure The driver must then be removed and the add process re tried To remove the driver execute the program as follows C system7 BIN gt pccsxcfg remove Once the device has been activated using this command it can be verified by using Control Panel gt Devices and locating the device PCCS This device should say Manual and Started If so the device has been started successfully Now the devices Startup Mode should be changed to Automatic so this device is always stared upon a restart of NT Using DataKinetics SS7 Products Annette Donofrio Page 17 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIA n anr DIALOGIC APPLICATION NOTE NOTE Activating the driver only has to be done once 8 6 DataKinetics PCCS6 Environmen
45. should be run lib Directory containing library file for linking with the user s application gctlib lib src Directory where the User Part Development package will be installed 9 2 Installing the User Part Development Package Copy the contents of the User Part Development Package distribution disk into the system7 src directory maintaining the sub directory structure 9 3 DataKinetics SIU amp SIU Host Environment Executable Programs 9 3 1 RSI EXE This program manages the remote socket interface It manages the routing of messages between the host and SIU s 9 3 2 RSI LNK EXE This program is basically a pipe between the application and the SIU It utilizes the TCP IP interface and hides the TCP IP specifics from the application 9 3 3 RSICMD EXE This program establishes the initial TCP IP communication between the host PC and the SIU All subsequent messages from the host to the SIU are sent using the RSI EXE explained below The TCP IP address of the SIU is passed in as an argument to this program Using DataKinetics SS7 Products Annette Donofrio Page 20 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIA n anr DIALOGIC APPLICATION NOTE 9 3 4 SIUCMD EXE This program allows the user to issue SIU management commands as text on the host terminal to control an SIU 9 3 5 S7 LOG EXE This program is a task that receives status and management indicati
46. t Executable Programs Once the installation of the software is complete and the driver is successfully activated we can begin setting up the SS7 link There are several executable programs which must be run to get a system working Here is a list of executables needed in PCCS6 configurations and what they mean 8 6 1 S7 MGT EXE S7 MGT EXE derives configuration parameters from the config txt text file and sends protocol configuration messages to all the SS7 software modules running These messages configure the SS7 protocol This process is optional but recommended As an alternative to using it the user can also perform protocol configuration by sending messages directly to other modules in the system 8 6 2 SSD EXE SSD EXE is the process which interfaces with the device driver for passing messages to and from the board and for downloading SW 8 6 3 TIM NT Process to receive periodic tick notification from the tick nt and handle protocol timers for all other processes This executable is not used by user applications but is required by the DataKinetics internal software 8 6 4 TICK NT Protocol timer process to send periodic tick notification to the tim nt process which in turn handles protocol timers This executable is not used by user applications but is required by the DataKinetics internal software 8 7 Activating the SS7 Link The system environment is created and all protocol modules started by the gctload exe progr
47. te spc SCCP CONC LSS local ssn RSS remote spc remole ssn SCCP_CONC_LSS 0x66 RSP 1 SCCP CONC LSS 0x66 RSS 1 0x66 Define all remote signalling points that require notification of change in state of local sub systems SCCP CONC HRSP remote spc LSS local ssn AR A HF SCCP_CONC_RSP 1 LSS 0x66 The following commands allow the REM API ID module to receive notification of changes of state of other signalling points or sub sysiems SCCP_LSS 200 Oxef 0 SCCP_CONC_LSS 200 RSS 1 0x66 Cross Connections These commands control the connection of voice channels through the SIU The default configuration cross connects all timeslots other than 0 and 16 between the two poris of each PCCS6 card MVIP_XCON bpos op stream op slot mode ip stream ip slot pattern AECA HF HF MVIP XCON 4 161 3171 0 Using DataKinetics SS7 Products Annette Donofrio Page 34 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIALOGIC APPLICATION NOTE MVIP_XCON 4 16 2 3172 0 MVIP XCON 4163 3173 0 MVIP_XCON 4 16 4 3174 0 MVIP XCON 4 165 3175 0 MVIP XCON 4 166 3176 0 MVIP XCON 4 167 3177 0 MVIP_XCON 4 16 8 3178 0 MVIP_XCON 4 169 3179 0 MVIP_XCON 4 16 10 3 17 10 0 MVIP_XCON 4 16 113 17 110 MVIP_XCON 4 16 12 3 17 12 0 MVIP_XCON 4 16 13 3 17 13 0 MVIP_XCON 4 16 14 3 17 14 0 MVIP_XCON 4 16 15 3 17 15 O Signalling on Timeslot 16 MVIP_XCO
48. trol message sequence validation and error checking When an error occurs on a signaling link the message or set of messages is retransmitted MTP Level 2 is equivalent to the OSI Data Link Layer In some configurations the number of signaling links may exceed the capacity of a single PCCS6 board or MTP2 entities may need to be distributed across multiple boards for sake of fault tolerance In these Using DataKinetics SS7 Products Annette Donofrio Page 6 n anr Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIA n anr DIALOGIC APPLICATION NOTE configurations the MTP3 entity may need to reside up on the Local Host or Local Server Module capable of Inter Module communication MTP Level 3 provides message routing between signaling points in the SS7 network MTP Level 3 re routes traffic away from failed links and signaling points and controls traffic when congestion occurs MTP Level 3 is equivalent to the OSI Network Layer MTP 3 provides three key functions routing message discrimination and distribution MTP 3 is the one of most critical entities in the SS7 protocol architecture and needs to maintain knowledge of the entire SS7 network topology to ensure end to end transmission Without this level of visibility MTP 3 could not offer complete route management services signaling link management load balancing and congestion management Each MTP 3 entity is assigned a Point Code address
49. ucts Annette Donofrio Copyright Dialogic Corporation 1998 All Rights Reserved Page 13 The Name Behind the Voice g A AA DIALOGIC APPLICATION NOTE SSP or SCP D LLL SSP or SCP REN RENE Dialogic Voice Lines if present CETE NE IELE E e c hoe Di gt fe ees an el e LE 557 N twotk Terminal to control SIU T1 Crossover cable SIU Host moe RS 232 PCCS6 System ss7 IP 146 152 64 22 IP 146 152 64 33 DSC 131 SIU IP 146 152 64 25 AAA AA A AE Dialogic LAN Figure 3 The High Level Architecture of SIU lt gt PCCS6 System Setup 8 Configuring the PCCS6 System Take the following steps to get a DataKinetics PCCS6 configuration working 1 Set the I O base address on the board SW1 2 Set the IRQ jumpers on the board 3 Make sure that daughtercard is set to either either T1 or E1 position This is not documented in DataKinetics manuals 4 Install the DataKinetics software See Installing the PCCS6 Development Package for Windows NT Installing the User Part Development Package and Installing the System7 Binary disks below 5 Copy the PCCSXDVR SYS the DataKinetics driver to the WINNT system32 directory see Installing the Device Driver 6 Copy GCTNT DLL the DataKinetics DLL to WINNT system32 directory see Installing the Device Driver Usin
50. uire just 5 functions to be provided by the operating system these are required for inter process communication and memory allocation This approach makes the software easy to port to different platforms and operating environments In addition the use of message passing between Using DataKinetics SS7 Products Annette Donofrio Page 10 Copyright Dialogic Corporation 1998 All Rights Reserved The Name Behind the Voice DIA DIALOGIC APPLICATION NOTE 5 2 tasks and therefore protocol layers means that it is possible for different layers to run on different processors if required All that is required to port the System7 product to a new environment is an implementation of the 5 library functions tailored to the chosen operating system These functions are available as standard products for a number of popular operating systems NOTE There are additional library calls available in the in the event that dual SIU s are being used i e GCT_set_instance amp GCT_get_instance Basic Concepts This section introduces the basic System7 concepts and terminology used throughout the DataKinetics documentation suite 5 2 1 5 2 2 Modules A module is an implementation of a particular layer in the protocol stack eg MTP2 MTP3 a particular user part eg ISUP SCCP or a collection of other functionality which fits together as a logical entity A module may be part of the System7 product range or a User supplied module
Download Pdf Manuals
Related Search