================================================================================ readme.txt October 2009 - Dialogic(R) NaturalAccess(TM) 9.0 for Windows Readme - ================================================================================ - The following features have been added since the NaturalAccess(TM) 8.x release: - Support for Windows Server 2008 Enterprise, SP2 for 32 bit - Support for Windows Server 2008 Enterprise, SP2 for 64 bit - Support for RHEL5.3 32-bit (Update 3 released on 1/19/09) Kernel - 2.6.18-128 - Support for RHEL 5.3 64-bit (compatiibility mode ) Kernel - 2.6.18-128 - Support for Solaris 10 (5/09) Sparc 64 bit and compatibility mode - Support for Solaris 10 (5/09) Intel 32 bit - Incorporate SAI and NCCSIP packages under the Natural Access package. - Native play & record added to EVRC codec ( supports the EDTX file format and the raw EVRC file format). - Added DTMF parameter control to Fusion encoders - ISDN: Q.Sig Transfer ( path replacement ) support added - Before carrying out a NaturalAccess installation, uninstall all previous versions. This procedure will ensure a valid NAturalAccess(TM) product configuration on your system. To perform an uninstall for Windows from the command prompt, type: C:\WINNT\IsUninst.exe -fd:\nms\Uninst.isu -c"d:\nms\Uninst.dll" - Natural Access products do not include patent or other intellectual property rights ("IPR") with respect to vocoders complying with the industry standards G.723.1 and/or G.729. For those customers who have not licensed such rights independently from the respective IPR holders, NMS will provide such rights with respect to either or both standards for an additional charge. This charge is passed through to the respective holders. Contact your Dialogic sales representative. - The cgsetkey program, installed as part of Natural Access,was derived from source code obtained from the KAME project,http://www.kame.net. This source code was used in accordance with the following license: /* * Copyright (C) 1995, 1996, 1997, 1998, and 1999 WIDE Project. * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * 3. Neither the name of the project nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF * SUCH DAMAGE. */ (C)Copyright 2009 Dialogic Corporation ******************************************************************************** ****************************IMPORTANT NOTICES*********************************** The product(s) to which this material pertains is/are part of the NMS Communications Platforms business sold by NMS Communications Corporation (NMS) to Dialogic Corporation (Dialogic) on December 8, 2008. All copyrights associated with the product(s) and materials previously held by NMS are now owned by Dialogic Corporation. Due to time constraints, the references to NMS or NMS Communications herein or elsewhere have not been changed, but all such references should be understood to be references to Dialogic and for clarity any end user license agreements associated with the product(s) and materials are between you and Dialogic. - For the availability of this software package for other operating system platforms, or for updates for this software package, please check the "Software and Downloads" page at http://www.dialogic.com/products/media/cg/default.htm ================================================================================ 1. Contents of Natural Access ================================================================================ NaturalAccess(TM) 9.0 for Windows contains the following products: NaturalAccess(TM) 4.23 OAM 1.24 CAS 2.36 ISDN 1.99 NaturalFax(TM) 4.31 NaturalConference(TM) 2.22 Fusion(TM) 4.59 DLCP 1.22 NMSLM 2.27 NCCSIP 2.01 SPACCESS 1.21 ================================================================================ 2. Product Compatibility ================================================================================ All products contained in NaturalAccess(TM) are fully compatible with each other. Product compatibility and dependency checking for the products is part of the Windows NaturalAccess(TM) installation procedure. You will be informed of known dependencies and incompatibilities during the NaturalAccess(TM) installation process. There is no support for Windows NT, XP, Windows Server 2003, or Vista with NaturalAccess(TM) 9.0. ================================================================================ 3. Installation Overview ================================================================================ Refer to the installation booklet for detailed installation instructions. ================================================================================ 3.1. NMS Products ================================================================================ The installation program prompts you for system environment information so it can determine the applicable NMS products for your system. It then launches the individual installation programs for each of these products using the information specified. ================================================================================ 4. Installation Specifications ================================================================================ Only one installation cycle is required to install all the applicable products for your system. The following tables illustrate what products and protocols correspond to your system environment specifications. The (base_install_dir)\install.log file contains a record of all the NaturalAccess(TM) product installations. ================================================================================ 4.1. Board Family Specifications ================================================================================ ================================================================================ Board Family | Natural Access Products ================================================================================ AG | CT Access | NMS OAM | NaturalFax | NaturalConference | NMS CAS* | NMS ISDN* -------------+-------------------------------------------------------- CG | CT Access | NMS OAM | NaturalFax | NaturalConference | NMS CAS* | NMS ISDN* | NMS Fusion -------------+-------------------------------------------------------- CX | CT Access | NMS OAM | CX 2000 -------------+-------------------------------------------------------- * These packages install protocols applicable to the country specification that has been made. See the following country specifications table for protocol installation details. The Natural Access installation updates the [ctasys] section of the cta.cfg file with service and service manager specifications as follows: Package | cta.cfg Update ------------------------------------------------------------------ Natural Access | Service = ncc, adimgr | Service = adi, adimgr | Service = dtm, adimgr | Service = ppx, ppxmgr | Service = swi, swimgr | Service = vce, vcemgr | Service = sai, saimgr | Service = sip, sipmgr ------------------------------------------------------------------- OAM | Service = oam, oammgr ------------------------------------------------------------------- CX 2000 | Service = cdi, cdimgr ------------------------------------------------------------------ NaturalFax | Service = nfx, nfxmgr | Service = fax, faxmgr | Service = fxm, adimgr ------------------------------------------------------------------ NaturalConference | Service = cnf, cnfmgr ------------------------------------------------------------------ NMS ISDN | Service = isdn, adimgr | Service = imgt, adimgr ------------------------------------------------------------------ NMS Fusion | Service = msp, mspmgr ------------------------------------------------------------------ ================================================================================ 4.2. Installation Type Specifications ================================================================================ Typical installation will require approx. 100.0 Mb ================================================================================ 5. Product Release Notes ================================================================================ Each NaturalAccess(TM) product has its own release notes. These release notes are accessible by using the CD Browser on the Release Notes page. They are displayed in the default *.txt file program. These files are installed with their package in the (base install dir)\doc directory and are also accessible in the following directories: ====================================================================== Product | Directory ===================+================================================== Natural Access | readme.txt (this file) -------------------+-------------------------------------------------- Natural Access | ctaccess\disk1\readme_cta.txt (formerly | CT Access) | -------------------+-------------------------------------------------- NMS OAM | oam\disk1\readme_oam.txt -------------------+-------------------------------------------------- NaturalFax | nfx\disk1\readme_nfx.txt -------------------+-------------------------------------------------- NaturalConference | cnf\disk1\readme_cnf.txt -------------------+-------------------------------------------------- QX | qx\disk1\readme_qx.txt -------------------+-------------------------------------------------- CX 2000 | cx2000\disk1\readme_cx2000.txt -------------------+-------------------------------------------------- NMS CAS | ag-cas\disk1\readme_cas.txt -------------------+-------------------------------------------------- NMS ISDN | ag-isdn\disk1\readme_isdn.txt -------------------+-------------------------------------------------- NMS Fusion | fusion\disk1\readme_fusion.txt -------------------+-------------------------------------------------- NMS License Manager | nmslm\disk1\readme_nmslm.txt -------------------+-------------------------------------------------- ================================================================================ 5.1. Product Documentation ================================================================================ NaturalAccess(TM) documentation is available from the Software Download page on the Dialogic web site, www.dialogic.com. ================================================================================ 6. New Features/OS Support ================================================================================ The NaturalAccess 9.0 release supports the following new products and features: - Support for Windows Server 2008 Enterprise, SP2 for 32 bit - Support for Windows Server 2008 Enterprise, SP2 for 64 bit - Support for RHEL5.3 32-bit (Update 3 released on 1/19/09) Kernel - 2.6.18-128 - Support for RHEL 5.3 64-bit (compatiibility mode ) Kernel - 2.6.18-128 - Support for Solaris 10 (5/09) Sparc 64 bit and compatibility mode - Support for Solaris 10 (5/09) Intel 32 bit - Incorporate SAI and NCCSIP packages under the Natural Access package. - Native play & record added to EVRC codec ( supports the EDTX file format and the raw EVRC file format). To support EDTX EVRC file playback, set the encoding to ADI_ENCODE_EDTX_EVRC_FR_HDR_FREE for both the adiSetNativeInfo() and the adi play function. To support raw EVRC file playback, set play_encoding = ADI_ENCODE_EDTX_EVRC_FR_HDR_FREE for the function adiSetNativeInfo(). Then, set the encoding type to ADI_ENCODE_EVRC_FR for the adi play function. The evrc_convert utility converts raw EVRC files to EDTX file formats and vice versa. Type evrc_convert -h for the list of options. The natprtest utility has been updated to accept the new EVRC codec ids. - Added DTMF parameter control to Fusion encoders - ISDN: Q.Sig Transfer ( path replacement ) support added ================================================================================ 6.1. AG Board Support ================================================================================ The AG2000 and AG2000C continue to be supported under Natural Access 9.0 ================================================================================ 6.2. CX Board Support ================================================================================ CX2000 support is not included in this intial release of Natural Access 9.0 ================================================================================ 6.3. CG Board Support ================================================================================ CG 6565, CG 6565C and CG6565e Natural Access 9.0 supports the CG 6565(C) board, which is a high density platform for IVR,Fax,VoIP, and Media server applications. For more information,refer to the CG 6565(C) Installation and Developer's Manual. CG 6565C ethernet ports are reversed. In CG 6565C Installation and Developer's manual, "Configurating the DIP switch" section shows S3 has dip switch 1,2,3 ON and the rest OFF. dip switch 3 should be OFF. The setting for dip switch 1,2,3 are correctly set from manufacture when the board is shipped. Throughpacket is not functional. CG 6060 and CG 6060C Natural Access 9.0 supports the CG 6060(C) board, which is a platform for IVR,Fax,VoIP, and Media server applications. For more information,refer to the CG 6060(C) Installation and Developer's Manual. Throughpacket is not functional. IPSEC is only available for IPv6. Currently there exist the following IPSEC limitations: - IKE is not supported (manual keying only) - Algorithms supported are: AH/MD5, AH/SHA-1, ESP/DES-CBC - SA Bundles are not supported (e.g. AH + ESP) - ESP Authentication is not supported. - It is strongly recommended that manipulations of the SADB and SPD which affect a given MSPP channel are only performed when the MSPP channel is disabled. NOTE: CG boards support "pure" IPv4 and IPv6 dual stack, It does not support any transition strategies, such as mapped IPv4 addressing (FFFF:a.b.c.d.), or packets flow from IPv4 to IPv6. ================================================================================ 6.4. Hot Swap Support for cPCI ================================================================================ Natural Access 9.0 does not inlcude support for CPCI Hot swap support. ================================================================================ 6.5. Natural Access ================================================================================ Name Change =========== The following table shows the relationship between earlier versions of CT Access software and the Natural Access release package: CT Access Natural Access Package ------------- ------------------------ 4.23 NA 9.0 4.22 NA 8.1 4.21 NA 8.0 4.20 2005-1 Service Pack 5 4.19 2005-1 Service Pack 4 4.18 2005-1 Service Pack 3 4.17 2005-1 Service Pack 2 4.16 2005-1 Service Pack 1 4.15 2005-1 4.13 2004-1 4.12 2003-1 4.11 2002-1 4.03 2001-1 4.02 2000-2 4.01 2000-1 3.01 1999-5 3.0 1999-4 2.11 1999-3 2.1 1999-2 ================================================================================ 6.6. NMS OAM ================================================================================ No new features added to OAM in NaturalAccess(TM) 9.0 - Support for EOL boards has been removed in oamgen: Boards no longer supported under Natural Access 9.0 include: - AG 4000 - AG 4000C - AG 4040 - AG 4040C - CG 6000 - CG 6000C - CG 6100C - CG 6500C - QX 2000 ================================================================================ 6.7. NaturalConference ================================================================================ No new features added to Natural Conference in NaturalAccess(TM) 9.0 ================================================================================ 6.8. Fusion ================================================================================ - Added DTMF parameter control to Fusion encoders: A new filter command has been added to modify DTMF detection parameters in Fusion encoders. Command ID: ------------ MSP_CMD_ENCODE_DTMFDETECT_PARMS Value: 0xC Description: ------------ Modifies the DTMF detection parameters. Requires a pointer to a msp_FILTER_ENCODE_DTMFDETECT_PARMS_CMD structure (see below). Details: ------------ When an encoder is enabled, its dtmf detector parameters are set to default values. The values can be modified by sending an MSP_CMD_ENCODE_DTMFDETECT_PARMS command to the filter while it is enabled. The command must accompanied by a pointer to an msp_FILTER_ENCODE_DTMFDETECT_PARMS_CMD structure. typedef struct tag_msp_FILTER_ENCODE_DTMFDETECT_PARMS_CMD { WORD columnfour; // 1=detect DTMFs A,B,C,D; 0=don't WORD onqualampl; // min input lev to qual tone WORD onthreshold; // Talkoff versus Cutthrough qualify level WORD onqualtime; // qualify time of DTMF WORD offqualampl; // min input lev of valid DTMF WORD offthreshold; // Hysteresis for talkoff versus cutthrough WORD offqualtime; // disqualify time for tone (ms) } msp_FILTER_ENCODE_DTMFDETECT_PARMS_CMD; All values must be set. Note that there is no capability to query the settings. The initial values that are set when the filter is enabled are shown below. Field values are in proprietary units. The following table describes the conversion from dB or milliseconds, and the useful range of values for each field. field default min max equiv min max notes columnfour | 1 0 1 | onqualampl | 504 128 16000|-39 dBm0 -51 -9 |linear scale, 0 dBm0 = 45632 onthreshold | 276 173 347 |-2.0 dB -6.0 0 |linear scale, 0 dB = 347 onqualtime | 28 0 32767| 50 ms 22 32789|time in milliseconds minus 22 offqualampl | 252 128 16000|-45 dBm0 -51 -9 |linear scale, 0 dBm0 = 45632 offthreshold| 200 173 347 |-4.8 dB -6.0 0 |linear scale, 0 dB = 347 offqualtime | 35 0 32767| 40 ms 5 32772|time in milliseconds minus 5 Use the following formula to convert dB input values to linear: linear= 10**(dB/20) * <0 dB value> For example, using 'C' code: int dBm0 = -39; unsigned onqualampl = pow (10, (double)dBm0/20) * 45632; double dB = -2.0 unsigned onthreshold = pow (10, dB/20) * 347; int msec = 50; unsigned onqualtime = msec - 22; By comparison, the ADI dtmf detector API (adiStartDTMF) performs the above conversions for qualification amplitude and time, but not for the threshhold values. You can convert ADI values for offthreshold and onthreshold by dividing by 188. Example: The default value of ADI.DTMFDETECT.onthreshold is 0xcab0 or 51888. The equivalent encoder value is 51888/188 = 276. ================================================================================ 6.9. ISDN ================================================================================ - ISDN: Q.Sig Transfer ( path replacement ) support added ================================================================================ 6.10. License Manager ( NMSLM ) ================================================================================ You must install the latest Java runtime for License Manager to function properly. Latest Java runtime can be installed from here: http://www.java.com/en/download/manual.jsp Without the latest java runtime, you may experience the following error: ./nmslm_tool Exception in thread "main" java.lang.UnsatisfiedLinkError: /opt/nms/nmslm/jre/li b/i386/libawt.so: libXp.so.6: cannot open shared object file: No such file or di rectory at java.lang.ClassLoader$NativeLibrary.load(Native Method) at java.lang.ClassLoader.loadLibrary0(ClassLoader.java:1586) at java.lang.ClassLoader.loadLibrary(ClassLoader.java:1503) at java.lang.Runtime.loadLibrary0(Runtime.java:788) at java.lang.System.loadLibrary(System.java:834) at sun.security.action.LoadLibraryAction.run(LoadLibraryAction.java:50) at java.security.AccessController.doPrivileged(Native Method) at sun.awt.NativeLibLoader.loadLibraries(NativeLibLoader.java:38) at sun.awt.DebugHelper.(DebugHelper.java:29) at java.awt.Component.(Component.java:506) Solution: Using JVM 1.5 fixes the problem. ( rpm -ivh jre-1_5_0_07-linux-i586.rpm ) ================================================================================ 7.0. Bug fixes integrated since the last version of Natural Access ================================================================================ Bug# Product Description ---------------------------------------------------------------------- No. Product Problem 3310 NaturalFax NFXERR_NO_REMOTE reported if DCN from transmitter is not recognized 3375 Natural Access VCE copy help incorrectly includes EDTX format 3323 Natural Access CG board uses 100% CPU when ethernet unplugged during video loadtest 3367 NaturalFax TIFF tag BadFaxLines is non-zero 3356 NaturalFax ConsecutiveFaxBadLines had invalid value 3421 ISDN Multi-byte IE with 0 length caused the stack to drop the entire message 3422 ISDN ETSI: Channel IE is mandatory only if the message is the first response to the incoming SETUP 3423 ISDN DMS250: Capability mask wasn't set correctly. 3425 ISDN Generic: DMS100: Display IE with no data causes the parser to drop subsequent IE's 5193 Natural Access Unable to run oammon in background 5335 NMSLM Java exception in nmslm_tool ( SEE NOTE ABOVE in SECTION 6.10 ) 5377 CG6x6x "Board did not indicate it was ready for use at the time of driver initialization" for CG6x6x. Disambiguates CG driver message. Logs error on allocation failure 5357 CG6565 CG6565 becomes unresponsive during load test 5381 Natural Acecss oamsys crashes Netra T2000 with CG6565 5398 Natural Access CTAERR_DRIVER_RECEIVE_FAILED from ctaWaitEvent 5400 CAS OPS0: blocking an ROOS line would result in line being stuck in pending block state 5403 NaturalFax Change tracemask when logging the sending of the PPM 5404 NCCSIP SIP 2.0: Application crash when calling nccHandleTransferRequest 5405 Fusion Purify reports FMM (Freeing mismatched memory) in mspmgr 5410 CAS EL7: Answering with zero rings does not work correctly 5418 NaturalFax NFX: nfx memory leak 5424 NCCSIP nmssip crashes when processing certain OPTIONS messages 5425 CG6565 PCI Getting many Code Violations on some T1 trunks 5423 CAS OPS: Disconnect event comes before media done event 5420 NCCSIP SIP 2.0: nmssip fails to resend INVITE when challenged and using SIP_IE_BODY 5421 NCCSIP SIP 2.0: Events sent to wrong context 5414 NCCSIP SIP 2.0: Registration failures when authentication is used ================================================================================ 7.1 Known issues. ================================================================================ - Unable to open contexts if number of boards greater than 8. There is a trade off between the maximum number of boards and the maximum number of contexts per board.   The board limit was reduced in July 2006 beginning with Natural Access 2005-1 SP2, to accomodate a higher number of contexts per board. ================================================================================ 8. Migration Information for Natural Access ( Compilers used ) ================================================================================ From NaturalAccess(TM) 8.x ========================== Visual Studio Vc 9.0 has been used to build NaturalAccess(TM) 9.0 32-bit & 64-bit version ================================================================================ 9. List of Files Shipped with NaturalAccess(TM) 9.0 ================================================================================ Natural Access contains the following files and directories: ====================================================================== Directory Path | Description ===========================+========================================== autorun.inf | Launches setup. ---------------------------+------------------------------------------ contact.txt | Contact information. ---------------------------+------------------------------------------ demo.dbd | DemoShield files. ds32.dll | ---------------------------+------------------------------------------ ag-cas\automode.ini | Automated installation specifications. ag-cas\disk(x)\* | Installation program files. ---------------------------+------------------------------------------ ag-isdn\automode.ini | Automated installation specifications. ag-isdn\disk(x)\* | Installation program files. ---------------------------+------------------------------------------ cnf\automode.ini | Automated installation specifications. cnf\disk(x)\* | Installation program files. ---------------------------+------------------------------------------ ctaccess\automode.ini | Automated installation specifications. ctaccess\disk(x)\* | Installation program files. ---------------------------+------------------------------------------ cx2000\automode.ini | Automated installation specifications. cx2000\disk(x)\* | Installation program files. ---------------------------+------------------------------------------ doc\html\* | Product manuals in HTML format. ---------------------------+------------------------------------------ install_win.pdf | Natural Access Installation booklet. ---------------------------+------------------------------------------ naccess\disk(x)\* | Installation program files. ---------------------------+------------------------------------------ nfx\automode.ini | Automated installation specifications. nfx\disk(x)\* | Installation program files. ---------------------------+------------------------------------------ pkgscr.flag | ---------------------------+------------------------------------------ cnf\automode.ini | Automated installation specifications. cnf\disk(x)\* | Installation program files. ---------------------------+------------------------------------------ oam\automode.ini | Automated installation specifications. oam\disk(x)\* | Installation program files. ---------------------------+------------------------------------------ qx\automode.ini | Automated installation specifications. qx\disk(x)\* | Installation program files. ---------------------------+----------------------------------------- fusion\automode.ini | Automated installation specifications fusion\dis(x)\* | Installation program files. ---------------------------------------------------------------------- readme.txt | This file. ---------------------------+------------------------------------------ setup.exe | Runs the Natural Access installation. ---------------------------+------------------------------------------ Installation program files -------------------------- For each product, the following directory structure exists containing all the installation program files: disk1\ * _inst32i.ex_ * _isdel.exe * _setup.dll * _sys1.cab * _user1.cab * Data.tag * data1.cab * lang.dat * layout.bin * os.dat * readme_(xxx).txt * Setup.exe * Setup.ini * setup.ins * setup.lid disk2\ * data2.cab disk(x)\ * data(x).cab * - Indicates files that may be distributed to your customers. Note: Details of the list of files installed for each package can be found in each product's release notes. See the "Documentation Overview, Product Release Notes" section for details. ================================================================================ 10. Additional Information for OEMs ================================================================================ All NMS product installations included in NaturalAccess(TM) are capable of being run with an initialization file that supplies all the information normally obtained in dialog boxes. An example of an initialization file for each product is provided in the product directory. It is named automode.ini and contains specifications for a "Typical" installation. This file can be used as a base, edited manually or by another installation program, and specified for use with the command line option "-i" to the setup program as shown: setup -i(full path specification)\automode.ini When used in this manner, the Natural Access installation programs will not display dialog boxes. However, they will display the product identification image, background and progress indicators. This feature provides OEMs with a method for automatic installation of the included NMS products.