Demonstrates how to use the TX SWI library to dynamically switch an SS7 link between two TX boards across the H.100/H.110 bus, and optionally across T1/E1/J1 connections.
txdynamic also registers for alarms from the two TX boards and uses the receipt of the MTP LINK_UP alarm to indicate when a link is successfully switched to a new channel.
txdynamic options[]
where options are:
Option |
Description |
-m |
Sets the master TX board (the first board to switch). Default: CP 1. |
-s |
Sets the slave TX board (the second board to switch). Default: CP 2. |
-p |
Sets the number of test passes. Default: Infinite. |
-c |
Sets the host side channel number. Default: Channel 3. |
-a |
Shows all received alarms. Default: Only show LINK_UP and LINK_DOWN. |
-v |
Shows alarm severity. Default: Not shown. |
-t |
Performs a T1 test between the TX boards. Default: No T1 test. |
-e |
Performs an E1 test between the TX boards. Default: No E1 test. |
-j |
Performs a J1 test between the TX boards. Default: No J1 test. |
txdynamic dynamically switches an SS7 link across TDM channels without rebooting the TX boards. The two TX boards are provided as slave and master boards. The master board link connection is switched first. The slave board is switched after both boards report a link failure.
Before running txdynamic, perform an ss7load of the master and slave TX boards using the configuration files (txcfgx.txt) provided with this demonstration program. For more information on running ss7load, refer to the Dialogic® NaturalAccess™ Signaling Software Configuration Manual .
Note: To test switching over T1/E1/J1 connections in addition to testing the H.100/H.110 bus, uncomment the appropriate trunk configuration entries from the configuration files before loading the TX boards. Then specify the trunk type by entering the -t, -e, or -j option when you invoke txdynamic.
The test assumes that each trunk of the master board is connected to the same trunk number of the slave board.
The following table lists the stages of the dynamic switching demonstration:
Stage |
Description |
1 |
CAPS. Retrieving the switching capabilities of both TX boards. |
2 |
REG_ALARMS. Registering to receive alarms from both boards. |
3 |
WAIT_CONNECT. Waiting for alarms indicating link up (initially connected). |
4 |
MOVE_MASTER. Moving master board's TDM connection. |
5 |
WAIT_DOWN. Waiting for both boards to send an alarm that the link is down. |
6 |
MOVE_SLAVE. Moving slave board's TDM connection. |
7 |
WAIT_UP. Waiting for both boards to alarm link up. |
8 |
ADVANCE. Advancing stream or trunk under test. |
For the H.100/H.110 bus, the test uses timeslot 1 on each H.100/H.110 stream, advancing the stream number by two with each pass to maintain the standard even/odd convention. For T1/E1/J1 trunks, the test traverses all available trunks using timeslot 1.
The following example shows the output generated by txdynamic:
***************************************
* DYNAMIC SS7 SWITCHING DEMONSTRATION *
***************************************
GETTING TX board switching capabilities...
WAITING for initial connection alarms...
ALARM: <03/30/04 09:41:01> mtp 2 18179 MTP3 Link 0 Up
ALARM: <03/30/04 09:41:02> mtp 1 18179 MTP3 Link 0 Up
SWITCHING board 1's port 1 to H.100/H.110 streams 2 and 3...
ALARM: <03/30/04 09:41:21> mtp 2 18180 MTP3 Link 0 Down
ALARM: <03/30/04 09:41:21> mtp 1 18180 MTP3 Link 0 Down
SWITCHING board 2's port 1 to H.100/H.110 streams 2 and 3...
ALARM: <03/30/04 09:41:22> mtp 1 18179 MTP3 Link 0 Up
ALARM: <03/30/04 09:41:22> mtp 2 18179 MTP3 Link 0 Up
txdynamic retrieves the switching capabilities of both TX boards. It then waits for the initial LINK_UP alarms from the boards. Once both boards report that the SS7 MTP link is up, the master board's TDM definition for the link is moved to the next stream pair.
txdynamic then waits for the boards to send an alarm that the link is down (since one half of the link is no longer defined as the same channel in use by the other half). Next, txdynamic changes the TDM definition for the slave board's link and waits until the boards send an alarm that the link is up. This is the final confirmation that the link is successfully switched. This procedure continues until each H.100/H.110 stream is visited. After the link is successfully switched to streams 30 and 31, txdynamic reports that the test is complete (if a number of passes was specified), returns to testing the H.100/H.110 stream 0 and 1 pair (if no -t|e|j is specified on the command line), or switches the link over each T1|E1|J1 trunk.