ss7box.conf

The ss7box configuration file is /etc/ss7box/ss7box.conf. An example of this file follows:

# This is the configuration file for Xygnada ss7box release 0.1 and 0.3
# Copyright 2004, Michael J. Mueller

# This a comment line

# The order of elements, the bracketed elements, and the order and type
# of information elements must adhere to the pattern specified.

# All index values must be sequential with a skip value of one (1).

[GLOBAL]
#
# SS7 Protocol: ITU/ANSI
#
# Self Point Code:
#       ITU format is 14 bit unsigned integer
#       ANSI format is <network> <cluster> <member>
#               network is an 8 bit unsigned integer
#               cluster is an 8 bit unsigned integer
#               network is an 8 bit unsigned integer
#
# SS7 Prot.  Self Point Code Serial No. Authorization Code            Verbose Group
  ITU           201           xlb3      86d74c6041412a16250670152b74750b 2

[CLI]
#       Local
#       address                 port
        127.0.0.104             55063
#       Remote
#       address                 port
        127.0.0.105             55063

[CROSSLINK]
# Mode <SIMPLEX | DUPLEX>       Local IP Addr   Local Port      Remote IP Addr  Remote Port
  SIMPLEX                       na              na              na              na
# DUPLEX                        192.168.1.21    54030           192.168.1.22    54020

[FACILITIES]
#
# Card Name:
#       wanpipeX where X is 1..n; see Sangoma documentation for more information;
#       don't care for UDP facilities
## Index Card Name Numeral       Frame/Packet    Clear Chan.
  0     1                       80              y
  end
# No more than four facilities supported at this time.

[MTP2LINKS]
# Index Fac  Slot LSet Link T1    T2    T3    T4e   T4n   T5    T6    T7
  0     0    15   0    0    13.00 11.50 11.50 0.60  2.30  0.12  3.00  1.00
  end
# Up to 93 links may be configured.

[MTP3TIMERS]
#
# Timer Value
  1     0.80
  2     1.40
  3     0.80
  4     0.80
  5     0.80
  6     0.80
  7     1.50
  8     1.20
  9     0.00
  10    30.00
  11    30.00
  12    1.50
  13    1.50
  14    3.00
  15    3.00
  16    2.00
  17    1.50
  18    20.00
  19    600.00
  20    120.00
  21    120.00
  22    15.00
  23    15.00
  24    15.00
  25    35.00
  26    15.00
  27    5.00
  28    35.00
  29    65.00
  30    35.00
  31    120.00
  32    120.00
  33    600.00
  34    120.00
# Periodic Facility Check Timer
  35    10.00
# Periodic Signaling Link Test Message Timer
  36    120.00
# Crosslink Test Acknowledge Timer (must be less the timer 35 Periodic Facility Check Timer
# that controls the Crosslink Test Message)
  37    5.00

In the MTP3LINKSETS section the linkset are defined. A linkset is a collection of links between ss7box and its adjacent nodes. Each entry in the table is a different linkset.
  • Index - identifies the linkset in the configuration; sequential, no skips, 0..15
  • APC - adjacent point code, point code of node on remote end of linkset
  • slt - signal link test: y - on, n- off
  • prio: SIO priority value in SNM and SLT
  • ni: SIO networking indicator value in SNM and SLT
  • Links in Linkset: listed in order of SLC (0..15), entry is MTP2LINKS index, the Link value in MTP2LINKS for selected entry must match the SLC column selected; if index 0 has link value 3 then insert '0' in the SLC 3 column of the table
[MTP3LINKSETS]
#                              Links in Linkset (associated MTP2 link indices)
# Index APC   slt prio ni SLC: 0  1  2  3  4  5  6  7  8  9 10 11 12 13 14 15
  0     4000  y   0    2       0 na na na na na na na na na na na na na na na
  end

In the PATHS section, linksets are grouped so that one or two linksets will be used as a single equivalent and load-balanced path to a destination. This is how the ANSI combined linkset in implemented. The PATH concept allows the combined linkset idea to be used in both ANSI and ITU implementations. ss7box routes messages to paths instead of linksets.
  • Index - identifies the path in the configuration, sequential, no skips, 0..15
  • Linkset-A - mandatory, index of linkset in MTP3LINKSETS section; linkset index may be used only once in the PATHS section.
  • Linkset-B - optional, index of linkset in MTP3LINKSETS section; linkset index may be used only once in the PATHS section.
[PATHS]
# Index     Linkset-A     Linkset-B (optional)
  0         0             na
  end

In the ROUTES section the destination point codes recognized by a particular ss7box are defined. It is mandatory that all adjacent point codes be entered in the table. Non-adjacent destinations are accessible by going through the adjacent point codes.
  • Index - identifies the route in the configuration, sequential, no skips, 0..63
  • DPC - destination point code
  • Protocol - MTP3 or M3UA; MTP3 is the SS7 network; M3UA is a SIGTRAN IP network that is under development (experimental)
  • P/Path - Primary Path, index from PATHS section, the path this used normally for reaching the DPC
  • A/Path - Alternate Path, index from PATHS section, the path that is used if the Primary Path is not available
  • Crosslink - y/n, use link connecting two ss7boxes in a duplex/redundant configuration, used when the Primary Path is not available and before trying the Alternate Path
[ROUTES]
#
# Must enter routes for adjacent and non-adjacent nodes.
#
# Index         DPC             Protocol  P/Path  A/Path  Crosslink
  0             4000            MTP3      0       na      N
  end

[M3UA]
# local  ipv4 addr and port
   127.0.0.44           50220
# remote ipv4 addr and port
   127.0.0.43           50220

Created by: mike last modification: Wednesday 16 of May, 2007 [20:43:08 UTC] by mike

The original document is available at http://www.ss7box.com/tiki-index.php?page=ss7box.conf