====================================================================== readme_monitor.txt August 2009 Dialogic(R) NaturalAccess(TM) SS7 Monitor 3.0 for Red Hat Enterprise Linux ES 4.0 Readme ====================================================================== © Copyright 1996 - 2009 Dialogic Corporation. All Rights Reserved **************************IMPORTANT NOTICE**************************** All references herein to Dialogic as a company name are understood to refer to Dialogic Corporation or a subsidiary thereof. Be sure to uninstall any other versions of the NaturalAccess(NA) SS7 Monitor Software before installing NA SS7 Monitor Software Release 3.0. This will ensure a clean and valid product configuration on your system. To maintain TX board number assignments, record the information from the /opt/dialogic/tx/bin/cpcfg or /opt/nmstx/bin/cpcfg script before performing the uninstall. After the NA SS7 Monitor Software Release 3.0(R3.0) installation has completed, modify the cpcfg script to match the information recorded from the previous installation. For the availability of this software package for other operating system platforms, or for updates for this software package, please check the following website page at: http://www.dialogic.com/products/signalingip_ss7components/download/ tx-5000.htm ****************************FILE CONTENTS***************************** This file presents the following information: 1. Product Compatibility 2. Operational Recommendations 3. Installation Overview 4. Features in NA SS7 Monitor Software R3.0 5. New Features and Problems Corrected in Prior Releases 6. Uninstalling the Software 7. Location of Installed NA SS7 Monitor Software R3.0 Files ********************************************************************** ====================================================================== 1. Product Compatibility ====================================================================== The NA SS7 Monitor Software R3.0 product consists of Monitor 3.0 software and TX Base 8.0 and TX Util 1.0 software. It is a complete software package. No other combinations are valid. The NA SS7 Monitor Sofware R3.0 is source-code-backward-compatible with the NA SS7 Monitor Sofware Release 3.0 but is not binary- backward-compatible. All structure packing has been replaced as needed with padding in order to achieve pure natural alignment of all structures. This means that NaturalAccess applications built against the NA SS7 Monitor Software Release 3.0 does not require any source code changes but does require a re-build of the software in order to adopt the new field offsets / structure sizes. NA SS7 Monitor Software R3.0 is compatible with the following TX hardware: - TX 4000 - TX 4000C - TX 4000/20 - TX 5500E - TX 5020E ====================================================================== 2. Operational Recommendations ====================================================================== Flash Update Required on TX Hardware You must update the flash memory of all TX boards with the TX Base kernel that ships with this release. The software in this release is incompatible with older versions of the TX Base kernel. The monload file automatically updates the TX boards with the correct kernel. If you do not use monload, see the instructions in the TX 4000, TX 4000C, TX 4000/20, TX 5500E and TX 5020E Installation Manual for information regarding updating the kernel using the txflash utility. ====================================================================== 3. Installation Overview ====================================================================== Detailed installation instructions are found in the install pdf titled "Installing Dialogic NaturalAccess SS7 Monitor 3.0" located on the Dialogic website at - http://www.dialogic.com/products/signalingip_ss7components/ download/tx-5000.htm TX configuration files (ie. txcfg1.txt) from previous versions of monitor will not work with NA SS7 Monitor Software R3.0. In particular, the command t1opt rlm is no longer supported. Instead Loop Master should be set to monitor rather than true/false for each trunk used for monitoring. Please refer to the "Dialogic® NaturalAccess™ SS7 Monitor Software Developer's Reference Manual" for examples and more information. This manual can be located at: http://www.dialogic.com/products/signalingip_ss7components/ download/tx-5000.htm ====================================================================== 4. New Features, Noted Limitations, and Problems Corrected in NA SS7 Monitor Software R3.0 ====================================================================== . Added support for the TX 5500E and TX 5020E . Due to packet retransmission at the MTP layer, it is possible for the number of messages reported to the monitoring application to be greater than the message counts reported by the higher layer protocols. ====================================================================== 5. Features and Problems Corrected in prior NA SS7 Monitor Software releases ====================================================================== 5.1 New Features and Problems Corrected in NA SS7 Monitor Software R1.1 . None 5.2 New Features and Problems Corrected in NA SS7 Monitor Software R2.0 . None 5.3 New Features and Problems Corrected in NA SS7 Monitor Software R2.1 . Messages with long SIF are not presented to the application (discarded by the SS7 stack). According to the test results, messages with 220 bytes SIF are received OK, but messages with 269 to 272 bytes are discarded. Changing the MAX_FRAME parameter had no effect on this behavior. This problem only existed on TX 3220s. 5.4 New Features and Problems Corrected in NA SS7 Monitor Software R2.2 . None 5.5 New Features and Problems Corrected in the NA SS7 Monitor Software R2.3 . The application buffer size is now limited to the values of 300 - 1500. . Includes support for high speed links as per ANSI T1.111-1996 and Q.703/Annex A. The Tx4000 (or Tx4000C) supports up to 4 HSLs per board. Each HSL occupies a full (unchannelized) E1/T1 and monitors data at the nominal E1 (T1) rate of 2.0 (1.544) Mbps. High speed links are normally configured to use extended sequence numbers. Monitor must be told whether a link is using standard sequence numbers or extended sequence numbers. ====================================================================== 6. Uninstalling the Software ====================================================================== 6.1 To uninstall the Monitor software run the script monitor_remove located in the /opt/dialogic/tx/bin or /opt/nmstx/bin. ====================================================================== 7. Location of Installed NA SS7 Monitor Software R3.0 Files ====================================================================== SS7 Monitor 3.0 consists of Monitor 3.0, TX Base 8.0 and TX Util 1.0 software. The following lists Monitor files only. +--------------------+-----------------------------------------------+ | File | Description | +--------------------+-----------------------------------------------+ /opt/dialogic/tx/doc/ readme_ss7mon.txt Readme for NA SS7 Monitor Release /opt/dialogic/tx/bin/ moncfg Monitor configuration utility monload Monitor TX load file monmgr Monitor Manager Sample program executable monitor_remove Script to interactively remove SS7 Monitor packages monitor_version Script to display SS7 Monitor package version /opt/dialogic/tx/etc/ MONcp1.cfg Sample Monitor Configuration File txcfg1.txt Sample TX Text file opt/dialogic/tx/cp/ monitor.elf Downloadable TX Firmware that implements monitoring /opt/dialogic/tx/include/ mondefs.h Monitor definitions header file monmapi.h Monitor management API header file monver.h Monitor version header file /opt/dialogic/tx/lib/ libmonmapi.so Monitor software management API library /opt/dialogic/tx/src/monitor/monapp monapp Monitor Data Collection Sample program executable makefile Makefile for the Monitor demonstration application monapp.c Source code for the Monitor demonstration application monapp.h Header file for the Monitor demonstration application /opt/dialogic/tx/src/monitor/moncfg makefile Makefile for the monitor application moncfg.c Source code for the monitor data collection application /opt/dialogic/tx/src/monitor/monmgr makefile Makefile for the monitor application monmgr.c Source code for the monitor manager application