This is TikiWiki 1.9.7 -Sirius- © 2002–2006 by the Tiki community Thu 20 of Dec, 2007 [16:11 UTC]

History: ss7mon User Manual

Source of version: 30 (current)

!Overview
---
Sangoma cards can be used as passive WAN and SS7 monitors.

__Contents__{maketoc}
!Installation
---
!!Hardware Installation
#Install a Sangoma A102 or A104 card in a Linux box. A box that has a faster CPU and a lot of memory is better since ss7mon is a user space application. A 1 GHz CPU and 512 MB RAM box is sufficient.
#Build a ((Monitor Tap Cable)).
#Insert the ss7mon E1/T1 tap cable in the circuit that will be monitored. __Do not__ plug the monitor taps into the ss7mon ports at this time.
#Ensure the SS7 link is working.

!!Software Installation

#Get latest smginstall package and put in /usr/local and untar
#cd /usr/local/smginstall-<version>
#./smginistall ss7mon
#Verify wanrouter version
#Verify Sangoma driver installation by asking it to report on cards that it can see.~pp~[root@b1 wanpipe]# wanrouter hwprobe

-------------------------------
| Wanpipe Hardware Probe Info |
-------------------------------
1 . AFT-A104-SHc : SLOT=9 : BUS=1 : IRQ=11 : CPU=A : PORT=1
2 . AFT-A104-SHc : SLOT=9 : BUS=1 : IRQ=11 : CPU=A : PORT=2
3 . AFT-A104-SHc : SLOT=9 : BUS=1 : IRQ=11 : CPU=A : PORT=3
4 . AFT-A104-SHc : SLOT=9 : BUS=1 : IRQ=11 : CPU=A : PORT=4

Card Cnt: S508=0 S514X=0 S518=0 A101-2=0 A104=1 A300=0
~/pp~

!Configuration
---
#[http://sangoma.editme.com/wanpipe-linux-asterisk-appendix#hotplug|Disable Hotplug] services for wanpipe drivers.
#Create configuration for wanpipe1 and wanpipe2 from template files
##cd /etc/wanpipe
##cp wanpipe1.conf.mon wanpipe1.conf
##cp wanpipe2.conf.mon wanpipe2.conf
#Modify ((ss7mon Wanpipe Configuration File)) if needed
#Edit wanrouter.rc so that WAN_DEVICES="wanpipe1 wanpipe2"
#Verify wanpipe operation
##/ss7box/Tail
##wanrouter start
##Verify that both wanpipe1 and wanpipe2 started
##wanrouter stop
##/ss7box/Tail off
#Modify ((ss7mon Configuration File))

!Operation
---
!!Starting ss7mon
#Ensure tap cables are connected to ports 1 and 2 of the Sangoma card.
#cd /ss7box
#Start ss7mon
**Console interactive mode with MSU decode and FISU summary reports:~pp~# ./ss7mon -i --decode --fisu~/pp~
**Background mode with MSU decode and FISU summary reports:~pp~# ./ss7mon --decode --fisu~/pp~
**Help:~pp~# ./ss7mon -h~/pp~
**Version:~pp~# ./ss7mon --ver~/pp~

!!Stopping ss7mon
*If operating in console interactive mode, use ctl-c.
*If operating in background
##ps axj | grep ss7mon
##kill <pid of ss7mon>

!!Interpreting ss7mon Output
~pp~
MARK < >
-------------------------------------------------------------------------
0000 91 f7 3f 83 00 04 00 12 - 09 80 03 0d 18 0a 12 08 ..?.............
0010 00 12 04 53 64 55 10 90 - 0b 12 08 00 12 04 44 77 ...SdU........Dw
0020 58 10 22 00 62 62 60 48 - 04 e3 00 01 80 6b 1e 28 X.".bb`H.....k.(
0030 1c 06 07 00 11 86 05 01 - 01 01 a0 11 60 0f 80 02 ............`...
0040 07 80 a1 09 06 07 04 00 - 00 01 00 15 02 6c 38 a1 .............l8.
0050 36 02 01 01 02 01 2e 30 - 2e 84 06 91 53 64 55 10 6......0....SdU.
0060 90 82 07 91 53 34 08 83 - 05 41 04 1b 11 01 0a 91 ....S4...A......
0070 53 64 55 10 10 00 00 00 - 0f c3 30 9b 0d 9a d5 68 SdU.......0....h
0080 b6 5c ce 46 c3 dd 00 0d - 34 .\.F....4
-------------------------------------------------------------------------

<east1> Span 0 Chan 0 MSU: BIB 1 BSN 17 FIB 1 FSN 119
SIO: 0x83 NI (2) PRIORITY (0) SI (3)
DPC 1024 OPC 2048 SLS 1
SERVICE TYPE: SCCP
~/pp~

Note: The program uses ASCII arrows to indicate MSU flow direction. A problem with tikiwiki prevents free use of the ACSII arrows (<- -> and <= =>). The symbols <east1>, <east2>, <west1>, <west2> are used instead of the ASCII arrows in the output examples above.

Not all MSU are decoded. In these cases, the hex output can be edited and submited to the [http://www.linkbit.com/support-decoder.html|Linkbit web decoder].

!Troubleshooting
---
!!Low Impedance Interference
Sangoma cards are low impedance devices. When they are used as a passive monitor with the monitor tap cable, they may interfere with normal operation of the circuit under observation. If the observed link will not go into service with the tap cables inserted into ss7mon, then remove the tap cables and get the observed link running. Then reconnect the tap cables to ss7mon and determine if both ss7mon and the observed circuit function simultaneously. For critical applications, consider using [http://www.lan-wan-tap.com/Products/WAN_TAPs/T1_E1_Model_1/t1_e1_model_1.html|powered transformer-based high impedance taps].
!!Finding the SS7 Channels
#Turn on option for bitstream capture for full E/T carrier~pp~
# Card Name Number Frame/Packet Clear Chan. b/s harvest Channels/Frame
1 50 n y 24
# Card Name Number Frame/Packet Clear Chan. b/s harvest Channels/Frame
2 50 n y 24~/pp~
#Run ss7mon~pp~
cts-knpl-ss7:/usr/local/ss7box# ./ss7mon_a_2.1.23_knpl -v -i~/pp~Two files will be produced: bs_span_0 and bs_span1 where bs_span_0 is from the interface card defined near the top of the conf file (Card 1 in the example above), and bs_span_1 is from the interface card defined near the bottom of the conf file (Card 2 in the example above).
#hexdump bitstream file~pp~cts-knpl-ss7:/usr/local/ss7box# hexdump -f hd.conf bs_span_1
.........
100f8 ff ff ff ff ff ff ff ff 8d 9f ff ff ff ff ff ff ff ff ff ff ff ff ff ff
10110 ff ff ff ff ff ff ff ff c0 bf ff ff ff ff ff ff ff ff ff ff ff ff ff ff
10128 ff ff ff ff ff ff ff ff 98 e1 ff ff ff ff ff ff ff ff ff ff ff ff ff ff
10140 ff ff ff ff ff ff ff ff a6 ed ff ff ff ff ff ff ff ff ff ff ff ff ff ff
10158 ff ff ff ff ff ff ff ff fe 82 ff ff ff ff ff ff ff ff ff ff ff ff ff ff
10170 ff ff ff ff ff ff ff ff c8 f8 ff ff ff ff ff ff ff ff ff ff ff ff ff ff
10188 ff ff ff ff ff ff ff ff fa b0 ff ff ff ff ff ff ff ff ff ff ff ff ff ff
101a0 ff ff ff ff ff ff ff ff 8d 9f ff ff ff ff ff ff ff ff ff ff ff ff ff ff
101b8 ff ff ff ff ff ff ff ff c0 bf ff ff ff ff ff ff ff ff ff ff ff ff ff ff
101d0 ff ff ff ff ff ff ff ff 98 fe ff ff ff ff ff ff ff ff ff ff ff ff ff ff
101e8 ff ff ff ff ff ff ff ff a6 c2 ff ff ff ff ff ff ff ff ff ff ff ff ff ff
10200 ff ff ff ff ff ff ff ff fe db ff ff ff ff ff ff ff ff ff ff ff ff ff ff
10218 ff ff ff ff ff ff ff ff c8 85 ff ff ff ff ff ff ff ff ff ff ff ff ff ff
10230 ff ff ff ff ff ff ff ff fa f0 ff ff ff ff ff ff ff ff ff ff ff ff ff ff
10248 ff ff ff ff ff ff ff ff 8d e1 ff ff ff ff ff ff ff ff ff ff ff ff ff ff
10260 ff ff ff ff ff ff ff ff c0 be ff ff ff ff ff ff ff ff ff ff ff ff ff ff
10278 ff ff ff ff ff ff ff ff 98 fe ff ff ff ff ff ff ff ff ff ff ff ff ff ff
10290 ff ff ff ff ff ff ff ff a6 fc ff ff ff ff ff ff ff ff ff ff ff ff ff ff
102a8 ff ff ff ff ff ff ff ff fe 85 ff ff ff ff ff ff ff ff ff ff ff ff ff ff
102c0 ff ff ff ff ff ff ff ff c8 b7 ff ff ff ff ff ff ff ff ff ff ff ff ff ff
102d8 ff ff ff ff ff ff ff ff fa 8b ff ff ff ff ff ff ff ff ff ff ff ff ff ff~/pp~
**Leftmost column is octet offset from beginning of file
**Remaining columns each contain the octet streams in each channel; the second column from the left is channel 1 and the rightmost column is channel 24
**There are hexdump format files for T1 and E1 provided
#Find a repeating pattern of 7 octets in a column; this corresponds to the stream of FISU on an SS7 link; take the column number and subtract one to get the ss7mon channel number
#Repeat procedure for bs_span_0 and bs_span_1
#Edit /etc/ss7box/ss7mon.conf and turn on monitoring for the resulting channels
#Turn off bitstream capturing in /etc/ss7box/ss7mon.conf


Menu [hide]
Toggle  Wiki
Powered by TikiWiki Powered by PHP Powered by Smarty Powered by ADOdb Made with CSS Powered by RDF
RSS Wiki
[ Execution time: 3.11 secs ]   [ Memory usage: Unknown ]   [ 16 database queries used ]   [ GZIP Disabled ]   [ Server load: 5.92 ]