====================================================================================== readme.txt December 2012 updated January 2013 updated April 2013 Dialogic(R) NaturalAccess(TM) Development Environment Release 9.0.8 Readme (C)Copyright 2013 Dialogic Corporation ====================================================================================== ************************************************************************************** ***************************IMPORTANT NOTICES****************************************** - This release of NaturalAccess supports the following operating systems: Red Hat Enterprise Linux 6.2 Windows Server 2012 - NaturalAccess 9.0.8 supports the following boards: CG 6060, all variants (CG 6060 PCI, CG 6060C) CG 6565, all variants (CG 6565 PCI, CG 6565C, CG 6565E) - Hot Swap is not supported. - Video Access is not included in this release. - Refer to Section 6 of this document for new features supported in this release. - Before carrying out a NaturalAccess installation, uninstall all previous versions, not just of NaturalAccess, but also of VideoAccess if previously installed. This procedure will ensure a valid NaturalAccess product configuration on your system. - NaturalAccess 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, Dialogic 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 NaturalAccess, 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. */ - 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/system-release-software/download/natural-access-software.aspx ================================================================================ 1. Contents of NaturalAccess ================================================================================ NaturalAccess 9.0.8 contains the following components: ag-cas - 2.363 ag-isdn - 1.993 cnf - 2.223 ctaccess - 4.233 dlcp_cg - 1.223 fusion - 4.593 naabstrct - 4.233 nabase - 4.233 naccess - 9.04 nacore - 4.233 nademos - 4.233 nadriver - 4.233 nadsp - 4.233 naruntime - 4.233 nccsip - 2.013 nfx - 4.323 nmslm - 2.273 oam - 1.243 spaccess - 1.213 Each Natural Access component includes a module identification signature file (*.sgn). A pair of utilities, installed by the Natural Access package, use the signature files to provide version information about component modules (files). The utilities are nmsabout and nmssearch. ================================================================================ 2. Installation Overview ================================================================================ Refer to the installation PDF file, install.pdf, for detailed installation instructions. Please not the following updates to install.pdf: page 7: The Windows Setup program no longer prompts you for the board family. If the install.bat file is not present, navigate to the naccess directory and double click on naccess.msi. Video Access is not installed page 12: vaccess is not a valid package-name Additional installation notes: Remove all existing NaturalAccess components, and VideoAccess (vaccess) before the installation of NA9.0.8. (Linux only:) By default, installation of the linux 6.2-64 kernel does not install 32-bit packages. You may need to manually install the following packages that are required by NA9.0.8. libstdc++-xxx.el6.i686.rpm libgcc-xxx.el6.i686.rpm glibc-xxx.el6.i686.rpm ncurse-libs-xxx.el6.i686.rpm ================================================================================ 2.1. Minimum Installation Requirements ================================================================================ Typical installation will require approx. 150 MB ================================================================================ 3. CTA Configuration Specifications ================================================================================ The NaturalAccess installation updates the [ctasys] section of the cta.cfg file with service and service manager specifications as follows: Package cta.cfg Update ------------------------------------------------------------------ NaturalAccess | Service = ncc, adimgr | Service = adi, adimgr | Service = dtm, adimgr | Service = swi, swimgr | Service = vce, vcemgr | Service = ncc, sipmgr ------------------------------------------------------------------- OAM | Service = oam, oammgr ------------------------------------------------------------------- NaturalFax | Service = nfx, nfxmgr | Service = fax, faxmgr | Service = fxm, adimgr ------------------------------------------------------------------ NaturalConference | Service = cnf, cnfmgr ------------------------------------------------------------------ ISDN | Service = isdn, adimgr | Service = imgt, adimgr ------------------------------------------------------------------ Fusion | Service = msp, mspmgr ------------------------------------------------------------------ USAI | Service = sai, saimgr ------------------------------------------------------------------ ================================================================================ 4. OS and Compiler Support ================================================================================ Linux ----- Red Hat Linux 6 Update 2 64 bits with 64 bit applications Red Hat Linux 6 Update 2 64 bits with 32 bit applications gcc version 4.4.6 has been used to build Natural Access 9.0.8 for Linux Windows ------- Windows Server 2012 with 64 bit applications Windows Server 2012 with 32 bit applications Visual C++ 9.0 has been used to build Natural Access 9.0.8 for Windows ================================================================================ 5. Component Release Notes ================================================================================ Each Natural Access component has its own release notes. These files are installed with their package in the \nms\doc directory (Windows) or /opt/nms/doc (Linux). ================================================================================ 5.1. Product Documentation ================================================================================ NaturalAccess documentation is available from the NaturalAccess Software Download page on the Dialogic web site, www.dialogic.com. ================================================================================ 5.2. New Features included in NA 9.x ================================================================================ - Universal Speech Access (SAI) - MRCP 1.0 - SIP for Natural Call Control (NCCSIP) - Native play & record added to EVRC codec (supports the EDTX file format and the raw EVRC file format). - 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. - DTMF parameter control added to Fusion encoders - ISDN: Q.Sig Transfer (path replacement) support added - NMSabout is replacing "Ctavers" and "Naver" to check installed package versions (ctavers and Naver utilities no longer being maintained) - HiZ support for the CG 6565e PCI Express Media Board - Option to add a VLAN tag to all outgoing packets. - RTP endpoint send-2833 command. - adiQueryEnergy. - Per-channel disable control added to echo canceler -- documented below ================================================================================ 5.3. Features no longer supported ================================================================================ - PPX service - V5.2 protocol - GR303 protocol ================================================================================ 5.4. Patches included in NA 9.0.8 ================================================================================ YYYY/MM/DD Patch# Title 2012/11/20 9383 BSOD from pciscan on some win32 machines 2012/11/07 9381 Bugcheck (Blue screen) CANCEL_STATE_IN_COMPLETED_IRP 2012/10/30 9380 SIP headers are not passed to application but are dropped 2012/10/29 9379 ISDN: TBCT fails 2012/10/01 9376 Add SDP debugging for mccd... API 2012/09/05 9372 NA9.0.4 linux linkage compatibility update 2012/08/15 9369 Bugcheck (Blue screen) CANCEL_STATE_IN_COMPLETED_IRP 2012/05/22 9362 Add per-channel disable/enable of hardware echo canceling 2012/05/16 9361 debugmask sometimes not set on board 2012/04/25 9356 NA9.0.4 unix linkage compatibility update - nfx 2012/04/18 9354 Fax recovery from bad DCS 2012/04/18 9353 Limit the size of cta.idx similar to cta.log size 2012/04/18 9352 RTCP support for NbUP Endpoints 2012/04/10 9351 Make size of send / receive buffer in SIP stack programmable 2012/03/15 9349 Cannot configure CG6060 NIC ports in manual mode, such as 100BT, half duplex 2012/03/15 9348 Fax failure when Fusion active 2012/02/22 9346 ctdaemon crashes 2012/02/17 9345 problems dealing with wave files 2011/11/18 9342 ctaccess libraries - core dump 2011/10/26 9340 Not all lines come up after stopping nmssip 2011/10/03 9337 nccSendCallMessage fails for response to re-INVITE 2011/09/20 9335 SIP: Hold should set session attribute 2011/08/04 9330 SIP Linux / Solaris: Add re-trys for socket write issues 2011/08/02 9328 Fusion runtime for board crash 2011/08/02 9327 CG6565 PCI/PCIe crash in load test 2011/07/26 9325 SIP, New Feature: Create simple Refer-To header from contact information 2011/07/22 9322 ISDN does not come back up after stopping the stack 2011/07/20 9321 CG6565 PCI with 4 trunks or less shows clocking slips 2011/07/12 9320 ctdaemon crash during oamsys 2011/06/14 9313 Allow NULL in ISDN address fields 2011/06/09 9312 SIP: Make method of SIP license configuration configurable 2011/06/08 9311 ISDN: ETSI: Adding HOLD/RETREIVE feature and fix ECT transfer return result 2011/06/07 9310 SIP: Implement inbound only and outbound only trunks 2011/05/31 9306 CAS Protocols: incorrect CID data delivered to app when using CG6x6x boards 2011/04/22 9297 ISDN: Alarms on line cause trap (out of msgs/buffers) 2011/03/31 9291 LM: License Manager: License leak 2011/03/31 9290 SIP: Fix various problems with startring / stopping protocol 2011/03/30 9289 NA2005-1: CTAERR_DRIVER_SEND_FAILED Error message is printed out under high conference traffic 2011/03/09 9281 ctaRegisterWaitObject and ctaUnregisterWaitObject are not thread safe 2011/03/03 9280 NA9.0.4 unix linkage compatibility update - cnf 2011/03/03 9279 NA9.0.4 unix linkage compatibility update - oam 2011/03/03 9278 NA9.0.4 unix linkage compatibility update - ctaccess 2011/03/02 9277 NbUP crash: Unprotected filter group registration/unregistration in timer functions. 2011/02/17 9275 junk in kernel logs (schedule_timeout: wrong timeout value ffffffff) 2011/02/08 9273 Board runtime: ethcfg on 6565 leaves autonegotiation on 2011/02/06 9271 Linux RHES5 64 NA9.x: multibug in ctdaemon 2011/02/01 9270 ctaccess: Fix crash in library due to null pointer 2011/01/27 9268 SIP: When disconnect event is delayed, reason code is incorrect 2011/01/12 9264 Board runtime: Board crash with illegal memory access (HDLC problem) 2011/01/12 9263 CG6565e doesn't boot on Windows server 2008 32bit of IBM x3400 M3 2010/12/14 9255 Fix SIP stack crashing problem(s) 2010/12/09 9253 Fusion EVRC payloadID checking fix 2010/12/08 9249 ISDN: Race condition causes RESTART on stack shutdown not to be sent 2010/12/07 9247 SIP Linux: Call progress stop event comes after disconnect event 2010/12/01 91975 ISDN: Add data content checks to physical layer 2010/12/01 9243 Fusion: CBS: missing unsolicited events 2010/11/16 9236 TSI mutex timeout 2010/11/03 9231 voicemgr applies the wrong gain 2010/11/03 9229 OAM: adding support for full 64-bit windows 2008 SP2 and R2 with more than 4GB of memory 2010/11/03 92284 CG: Receive -551 error from the board 2010/11/03 9224 CTA: adding support for full 64-bit windows 2008 SP2 and R2 with more than 4GB of memory 2010/10/29 92230 Fax: NFXERR_BAD_FILE_FORMAT returned from nfxcheck 2010/10/25 92124 ISDN: Layer 2 DISC may not be sent when shutting down the stack 2010/10/21 92093 SIP: Call progress stop event comes after disconnect event 2010/10/07 9209 CNF: Application receives an exception in _dispProcessCommand generated by CNF 2010/10/01 9208 Cannot query echo device on CG 6060 PCI boards that have 1 or 2 trunks 2010/09/24 92011 ISDN, ETSI: Cannot send a NOTIFY message in the active (connected) state 2010/09/09 91907 NFX: Correct reference to 'size' member of the BUFFER_DESCRIPTOR structure 2010/09/01 9170 ISDN: Generic stack: Adding Support for 4ESS Transfer Connect SS in generic stack 2010/08/12 9162 ctaGetVersion retruns the wrong cta minor version 2010/08/02 91604 SIP: After calling nccDisconnectCall, the event NCCEVN_CALL_DISCONNECTED is not received 2010/07/14 9125 board runtime rollup patch 2010/06/22 91297 CG runtime crashes because of memory corruption 2010/06/09 9115 adding RFC4040 clearmode channel to Fusion 2010/05/28 9114 ISDN: QSIG: Supporting QSIG diversion and exposing fields to NCC layer 2010/05/07 91067 CNF: (only w2k32b): app crashes if coaching is enabled 2010/04/27 9101 Add RTP endpoint send-2833 command 2010/04/26 9100 add adiQueryEnergy API 2010/04/15 82152 board error 0x1986 2010/04/14 9097 AG2000 record function update for AG2000 support in R9.0.2 2010/04/07 9088 ISDN: Board crash when stopping the ISDN protocol on multiple trunks 2010/03/18 9078 ctdaemon handle leaks on Windows when license manager is called 2010/03/17 9076 NFX rollup patch for Windows 2010/03/15 82392 Natural Conferencing patch. 2010/03/13 90722 SIP: nmssip.exe crashes when using SIP_IE_BODY 2010/03/02 8245 board runtime rollup patch 2010/03/02 8243 spaccess: saidemo fails to start due to missing MSVCP90.dll 2010/03/01 8242 CNF rollup patch for windows 2010/03/01 8241 ISDN rollup patch for windows 2010/03/01 8240 NFX rollup patch for windows 2010/02/22 8239 ACK for re-INVITE not sent; failed REGISTER does not include SIP IEs 2010/02/03 8215 ISDN: VN6: Sending USER -> PCS request does not work correctly in generic stack 2010/01/28 6464 ds1 SNMP Agent should give correct trunk Order when Boards are reset 2009/12/01 6444 SIP: Allow SIP_IE_BODY to be treated as a string 2009/11/19 6435 SIP: Changed behavior for protocol event causes problems ================================================================================ 6. New Features included in NA 9.0.8 ================================================================================ The following new features are included, and documented below: - Per-channel disable control added to echo canceler ================================================================================ 6.1 Per-channel disable control added to echo canceler ================================================================================ The disable/enable control allows you to enable or disable the hardware echo cancellation feature for a trunk port. Unlike the bypass control, the disable control resets the echo canceler. Use swiConfigLocalTimeslot to disable or enable the canceler, and swiGetLocalTimeslotInfo to retrieve the echo canceler disable state. Set the arguments for these functions as follows: Argument Field Value -------- ----- ----- swihd Handle returned by swiOpenSwitch. args localstream Identifies the target trunk on the local bus. Specify the number of either the transmit or receive voice stream. localtimeslot Identifies the target timeslot on the trunk. Specify the timeslot number of the target trunk port on the local bus. deviceid Device type on the local bus. Valid values are MVIP95_T1_TRUNK_DEVICE and MVIP95_E1_TRUNK_DEVICE. parameterid Data item to configure or query. Set to NMS_ECHO_CHANNEL_DISABLE (0x80000023). buffer Points to the NMS_ECHO_CHANNEL_DISABLE_PARMS structure. Valid values are: 0 = NMS_ECHO_ENABLE_CHANNEL 1 = NMS_ECHO_DISABLE_CHANNEL size Size of buffer, in bytes. The NNMS_ECHO_CHANNEL_DISABLE_PARMS structure is: typedef struct { DWORD disable_channel; // 0=channel enabled, 1=channel disabled } NMS_ECHO_CHANNEL_DISABLE_PARMS; The value returned from the NMS_ECHO_CHANNEL_DISABLE_PARMS structure indicates whether the echo cancellation is enabled or disabled for the specified device. For more information about swiConfigLocalTimeslot or swiGetLocalTimeslotInfo, refer to the Dialogic® NaturalAccess™ Point-to-Point Switching API Developer's Manual. The following example shows how to set the echo canceler disable state: #include "swidef.h" /* Switching service */ #include "mvip95.h" /* MVIP-95 definitions */ #include "nmshw.h" /* Hardware-specific definitions */ DWORD mySetDisable(SWIHD swihd, SWI_TERMINUS terminus, int bDisable) { SWI_LOCALTIMESLOT_ARGS args; NMS_ECHO_CHANNEL_DISABLE_PARMS parms; args.localstream = terminus.stream; /* from board switch model */ args.localtimeslot = terminus.timeslot; /* from board switch model */ args.deviceid = MVIP95_T1_TRUNK_DEVICE; /* mvip95.h */ args.parameterid = NMS_ECHO_CHANNEL_DISABLE; /* nmshw.h */ if ( bDisable) parms.disable_channel = NMS_ECHO_DISABLE_CHANNEL; /* nmshw. */ else parms.disable_channel = NMS_ECHO_ENABLE_CHANNEL; /* nmshw.h */ return swiConfigLocalTimeslot ( swihd, /* switch handle */ & args, /* target device and config item */ ( void*) & parms, /* buffer (defined by parameterid) */ sizeof(parms)); /* buffer size in bytes */ } The following example shows how to retrieve the echo canceler disable state: #include "swidef.h" /* Switching service */ #include "mvip95.h" /* MVIP-95 definitions */ #include "nmshw.h" /* Hardware-specific definitions */ DWORD myGetDisable(SWIHD swihd, SWI_TERMINUS terminus, int* pbDisabled) { SWI_LOCALTIMESLOT_ARGS args; NMS_ECHO_CHANNEL_DISABLE_PARMS parms; DWORD swi = SWI_SUCCESS; args.localstream = terminus.stream; /* from board switch model */ args.localtimeslot = terminus.timeslot; /* from board switch model */ args.deviceid = MVIP95_T1_TRUNK_DEVICE; /* mvip95.h */ args.parameterid = NMS_ECHO_CHANNEL_DISABLE; /* nmshw.h */ swi = swiGetLocalTimeslotInfo ( swihd, /* switch handle */ & args, /* target device and config item */ ( void*) & parms, /* buffer (defined by parameterid) */ sizeof(parms)); /* buffer size in bytes */ if (parms.disable_channel == NMS_ECHO_DISABLE_CHANNEL) /* nmshw.h */ *pbDisabled = 1; // true else *pbDisabled = 0; // false return swi; } ================================================================================