SS7 Stack User Guide
The guide to the
Mobicents SS7 Stack
by Amit Bhayani, Bartosz Baranowski, and Oleg Kulikov
iii
Preface ............................................................................................................................. v
1. Document Conventions .......................................................................................... v
1.1. Typographic Conventions ............................................................................ v
1.2. Pull-quote Conventions .............................................................................. vii
1.3. Notes and Warnings .................................................................................. vii
2. Provide feedback to the authors! .......................................................................... viii
1. Introduction to Mobicents SS7 Stack .......................................................................... 1
1.1. Time Division Multiplexing ................................................................................... 2
1.2. The Basics ......................................................................................................... 2
1.3. Design ............................................................................................................... 3
2. Installation and Running ............................................................................................. 5
2.1. Installing ............................................................................................................. 5
2.1.1. Binary ...................................................................................................... 5
2.2. Mobicents SS7 Service ....................................................................................... 7
2.3. Installing Mobicents SS7 Service Binary ............................................................... 7
2.4. Running Mobicents SS7 Service .......................................................................... 8
2.4.1. Starting .................................................................................................... 8
2.4.2. Stopping .................................................................................................. 8
2.5. Configuring Mobicents SS7 Service ..................................................................... 9
2.5.1. Configuring M3UA .................................................................................... 9
2.5.2. Configuring dialogic ................................................................................ 10
2.5.3. Configuring SCCP .................................................................................. 11
2.5.4. Configuring ShellExecutor ....................................................................... 12
2.5.5. Configuring SS7Service .......................................................................... 13
2.6. Setup from source ............................................................................................ 14
2.6.1. Release Source Code Building ................................................................ 14
2.6.2. Development Trunk Source Building ........................................................ 15
3. Hardware Setup ......................................................................................................... 17
3.1. Dialogic ............................................................................................................ 17
4. Shell Command Line ................................................................................................. 19
4.1. Introduction ....................................................................................................... 19
4.2. Starting ............................................................................................................ 19
4.3. SCCP Management .......................................................................................... 20
4.3.1. Rule Management .................................................................................. 21
4.3.2. Address Management ............................................................................. 25
4.3.3. Remote Signaling Point Management ...................................................... 29
4.3.4. Remote Sub-System Management .......................................................... 31
4.4. M3UA Management .......................................................................................... 32
4.4.1. M3UA Management - SCTP ................................................................... 33
4.4.2. M3UA Management ................................................................................ 38
5. ISUP ........................................................................................................................... 47
5.1. ISUP Configuration ........................................................................................... 47
5.2. ISUP Usage ..................................................................................................... 49
5.3. ISUP Example .................................................................................................. 49
SS7 Stack User Guide
iv
6. SCCP ......................................................................................................................... 53
6.1. Routing Management ........................................................................................ 53
6.1.1. GTT Configuration .................................................................................. 53
6.2. SCCP Usage .................................................................................................... 57
6.3. Access Point .................................................................................................... 58
6.4. SCCP User Part Example ................................................................................. 58
7. TCAP .......................................................................................................................... 61
7.1. Mobicents SS7 Stack TCAP Usage ................................................................... 61
7.2. Mobicents SS7 Stack TCAP User Part Example ................................................. 63
8. MAP ........................................................................................................................... 67
8.1. SS7 Stack MAP ................................................................................................ 67
8.2. SS7 Stack MAP Usage ..................................................................................... 70
A. Java Development Kit (JDK): Installing, Configuring and Running ................................... 75
B. Setting the JBOSS_HOME Environment Variable .......................................................... 79
C. Revision History .......................................................................................................... 83
Index ............................................................................................................................... 85
v
Preface
1. Document Conventions
This manual uses several conventions to highlight certain words and phrases and draw attention
to specific pieces of information.
In PDF and paper editions, this manual uses typefaces drawn from the Liberation Fonts [https://
fedorahosted.org/liberation-fonts/] set. The Liberation Fonts set is also used in HTML editions if
the set is installed on your system. If not, alternative but equivalent typefaces are displayed. Note:
Red Hat Enterprise Linux 5 and later includes the Liberation Fonts set by default.
1.1. Typographic Conventions
Four typographic conventions are used to call attention to specific words and phrases. These
conventions, and the circumstances they apply to, are as follows.
Mono-spaced Bold
Used to highlight system input, including shell commands, file names and paths. Also used to
highlight key caps and key-combinations. For example:
To see the contents of the file my_next_bestselling_novel in your current
working directory, enter the cat my_next_bestselling_novel command at the
shell prompt and press Enter to execute the command.
The above includes a file name, a shell command and a key cap, all presented in Mono-spaced
Bold and all distinguishable thanks to context.
Key-combinations can be distinguished from key caps by the hyphen connecting each part of a
key-combination. For example:
Press Enter to execute the command.
Press Ctrl+Alt+F1 to switch to the first virtual terminal. Press Ctrl+Alt+F7 to
return to your X-Windows session.
The first sentence highlights the particular key cap to press. The second highlights two sets of
three key caps, each set pressed simultaneously.
If source code is discussed, class names, methods, functions, variable names and returned values
mentioned within a paragraph will be presented as above, in Mono-spaced Bold. For example:
File-related classes include filesystem for file systems, file for files, and dir
for directories. Each class has its own associated set of permissions.
Proportional Bold
This denotes words or phrases encountered on a system, including application names; dialogue
box text; labelled buttons; check-box and radio button labels; menu titl