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

ss7mon User Manual

print

Overview


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

Contents

Installation


Hardware Installation

  1. 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.
  2. Build a Monitor Tap Cable.
  3. 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.
  4. Ensure the SS7 link is working.

Software Installation


  1. Get latest smginstall package and put in /usr/local and untar
  2. cd /usr/local/smginstall-<version>
  3. ./smginistall ss7mon
  4. Verify wanrouter version
  5. Verify Sangoma driver installation by asking it to report on cards that it can see.
    [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
    

Configuration


  1. Disable Hotplug services for wanpipe drivers.
  2. Create configuration for wanpipe1 and wanpipe2 from template files
    1. cd /etc/wanpipe
    2. cp wanpipe1.conf.mon wanpipe1.conf
    3. cp wanpipe2.conf.mon wanpipe2.conf
  3. Modify ss7mon Wanpipe Configuration File if needed
  4. Edit wanrouter.rc so that WAN_DEVICES="wanpipe1 wanpipe2"
  5. Verify wanpipe operation
    1. /ss7box/Tail
    2. wanrouter start
    3. Verify that both wanpipe1 and wanpipe2 started
    4. wanrouter stop
    5. /ss7box/Tail off
  6. Modify ss7mon Configuration File

Operation


Starting ss7mon

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

Stopping ss7mon

  • If operating in console interactive mode, use ctl-c.
  • If operating in background
    1. ps axj | grep ss7mon
    2. kill <pid of ss7mon>

Interpreting ss7mon Output

       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


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 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 powered transformer-based high impedance taps.

Finding the SS7 Channels

  1. Turn on option for bitstream capture for full E/T carrier
    # 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
  2. Run ss7mon
    cts-knpl-ss7:/usr/local/ss7box# ./ss7mon_a_2.1.23_knpl -v -i
    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).
  3. hexdump bitstream file
    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
    • 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
  4. 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
  5. Repeat procedure for bs_span_0 and bs_span_1
  6. Edit /etc/ss7box/ss7mon.conf and turn on monitoring for the resulting channels
  7. Turn off bitstream capturing in /etc/ss7box/ss7mon.conf

Created by: mike last modification: Thursday 04 of January, 2007 [20:05:31 UTC] by mike


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: 0.50 secs ]   [ Memory usage: Unknown ]   [ 26 database queries used ]   [ GZIP Disabled ]   [ Server load: 3.79 ]