====================================================================== readme_monitor.txt August 2009 Dialogic(R) NaturalAccess(TM) SS7 Monitor 3.0 for SPARC Solaris 10 & Intel Solaris 10 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(R3.0). This will ensure a clean and valid product configuration on your system. To maintain TX board number assignments, record the information from the txcpcfg utility before performing the uninstall. After the NA SS7 Monitor Software R3.0 installation has completed, use txcpcfg (specifying bus, slot, and CP number) to re-assign TX board numbers to match that of 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 Release 3.0(R3.0) 5. New Features and Problems Corrected in Prior Releases 6. Location of Installed NA SS7 Monitor Software R3.0 Files ********************************************************************** ====================================================================== 1. Product Compatibility ====================================================================== The NA SS7 Monitor Software R3.0 product consists of NA SS7 Monitor 3.0, TX Base 8.0 and TX Util 1.0 software. It is a complete software package. No other combinations are valid. NA SS7 Monitor Software R3.0 is compatible with the following TX hardware: - TX 4000 - TX 4000C - TX 4000/20 - TX 5500E - TX 5020E The release images available for NA SS7 Monitor Software R3.0 -Solaris 10 SPARC Edition (32-bit Mode applications, 32 or 64 bit driver) -Solaris 10 SPARC Edition (64-bit Mode applications, 64 bit driver) -Solaris 10 Intel Edition (32-bit Mode applications, 32 bit driver) ====================================================================== 2. Operational Recommendations ====================================================================== 2.1 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. 2.2 Multi-processor and Processor Speed Issues If you plan to install on a host with a faster processor speed or a multi-processor combination other than those listed above, it is recommended that you provide for a host compatibility testing phase in your development cycle. ====================================================================== 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 3.1 Environment Variable Settings To setup your environment correctly you will need to make two changes. You need to add /opt/dialogic/tx to your PATH variable and /opt/dialogic/tx/lib to your LD_LIBRARY_PATH variable. To do this in Bourne shell type the following: export TX_ROOT=/opt/dialogic/tx export PATH=$PATH:$TX_ROOT/bin export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$TX_ROOT/lib Any users wanting to use TX software should probably add the previous statements to their profile. ====================================================================== 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, Noted Limitations and Problems Corrected in 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. . When the Monitor configuration requests a MAX_FRAME of more than 272 bytes, the configuration will not fail. ====================================================================== 6. Location of Installed NA SS7 Monitor Software R3.0 Files ====================================================================== NA SS7 Monitor Software R3.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 NA SS7 Monitor Release Notes /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 Management API DLL 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 application /opt/dialogic/tx/src/monitor/monmgr makefile Makefile for the monitor application monmgr.c Source code for the monitor application