Dialogic® Multimedia Software
for AdvancedTCA Release 1.0
Release Update
January 23, 2008
05-2548-006
Copyright © 2007-2008, Dialogic Corporation. All Rights Reserved. You may not reproduce this document in whole or in part without permission in
writing from Dialogic Corporation.
All contents of this document are furnished for informational use only and are subject to change without notice and do not represent a commitment on
the part of Dialogic Corporation or its subsidiaries (“Dialogic”). Reasonable effort is made to ensure the accuracy of the information contained in the
document. However, Dialogic does not warrant the accuracy of this information and cannot accept responsibility for errors, inaccuracies or omissions
that may be contained in this document.
®
INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH DIALOGIC
ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN A
SIGNED AGREEMENT BETWEEN YOU AND DIALOGIC, DIALOGIC ASSUMES NO LIABILITY WHATSOEVER, AND DIALOGIC DISCLAIMS ANY
EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF DIALOGIC PRODUCTS INCLUDING LIABILITY OR WARRANTIES
RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY INTELLECTUAL PROPERTY
RIGHT OF A THIRD PARTY.
Dialogic products are not intended for use in medical, life saving, life sustaining, critical control or safety systems, or in nuclear facility applications.
It is possible that the use or implementation of any one of the concepts, applications, or ideas described in this document, in marketing collateral
produced by or on web pages maintained by Dialogic may infringe one or more patents or other intellectual property rights owned by third parties.
Dialogic does not provide any intellectual property licenses with the sale of Dialogic products other than a license to use such product in accordance
with intellectual property owned or validly licensed by Dialogic and no such licenses are provided except pursuant to a signed agreement with
Dialogic. More detailed information about such intellectual property is available from Dialogic’s legal department at 9800 Cavendish Blvd., 5th Floor,
Montreal, Quebec, Canada H4M 2V9. Dialogic encourages all users of its products to procure all necessary intellectual property licenses
required to implement any concepts or applications and does not condone or encourage any intellectual property infringement and
disclaims any responsibility related thereto. These intellectual property licenses may differ from country to country and it is the
responsibility of those who develop the concepts or applications to be aware of and comply with different national license requirements.
Dialogic, Diva, Eicon, Eicon Networks, Dialogic Pro, EiconCard and SIPcontrol, among others, are either registered trademarks or trademarks of
Dialogic. Dialogic's trademarks may be used publicly only with permission from Dialogic. Such permission may only be granted by Dialogic’s legal
department at 9800 Cavendish Blvd., 5th Floor, Montreal, Quebec, Canada H4M 2V9. Any authorized use of Dialogic's trademarks will be subject to
full respect of the trademark guidelines published by Dialogic from time to time and any use of Dialogic’s trademarks requires proper
acknowledgement. Windows is a registered trademark of Microsoft Corporation in the United States and/or other countries. Other names of actual
companies and products mentioned herein are the trademarks of their respective owners.
Publication Date: January 23, 2008
Document Number: 05-2548-006
PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY
Dialogic® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 – January 23, 2008
Dialogic Corporation
About This Publication
This section contains information about the following topics:
• Purpose
• Intended Audience
• How to Use This Publication
• Related Information
Purpose
This Release Update addresses issues associated with Dialogic® Multimedia Software for
AdvancedTCA Release 1.0. In addition to summarizing issues that were known as of this
release, the Release Update will continue to be updated to serve as the primary
mechanism for communicating new issues that arise after the release date.
Intended Audience
This Release Update is intended for all users of the Dialogic® Multimedia Platform for
AdvancedTCA.
How to Use This Publication
This Release Update is organized into three sections (click the section name to jump to
the corresponding section):
• Document Revision History: This section summarizes the ongoing changes and
additions that are made to this Release Update after its original release. This section
is organized by document revision and document section.
• Post-Release Developments: This section describes significant changes to the
release subsequent to the general availability release date. For example, new features
provided in service updates are described here.
• Release Issues: This section lists issues that may affect the system release hardware
and software.
• Documentation Updates: This section contains corrections and other changes that
apply to the documentation set that were not made to the documents prior to the
release. The updates are organized by documentation category and by individual
document.
Dialogic® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008 3
Dialogic Corporation
About This Publication
Related Information
See the following for additional information:
• http://www.dialogic.com/manuals/ (for Dialogic
• http://www.dialogic.com/support/ (for Dialogic technical support)
• http://www.dialogic.com/ (for Dialogic
®
product documentation)
®
product information)
4 Dialogic® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008
Dialogic Corporation
Document Revision History
This Revision History summarizes the changes made in each published version of the
Release Update for the Dialogic
document that is periodically updated throughout the lifetime of the release.
®
Multimedia Platform for AdvancedTCA, which is a
Document Rev 06 – published January 23, 2008
Made global changes to reflect Dialogic Brand and changed title to “Dialogic® Multimedia
Software for AdvancedTCA Release 1.0 Release Update.”
In the Documentation Updates chapter:
• Removed documentation updates in Dialogic® Voice API Library Reference as a new
version of document (05-2333-004) is available.
• Removed documentation updates in Dialogic® Voice API Programming Guide as a
new version of document (05-2332-004) is available.
• Removed documentation updates in MSML Media Server User’s Guide as a new
version of document (05-2513-001) is available.
Document Rev 05 – published June 22, 2007
Updated for Service Update 81.
In the Post-Release Developments chapter:
• Added Summary of Features.
• Added Support for MSML Conferencing.
• Added Support for AMR and EVRC in MSML.
Document Rev 04 – published June 8, 2007
Updated for Service Update 80.
In the Post-Release Developments chapter:
• Added Support for QCELP Codec.
In the Release Issues chapter:
• Updated description of Known Defects: IPY00038148, IPY00038149.
• Added the following Known Defect: IPY00037689.
In the Documentation Updates chapter:
• For Dialogic® IP Media Library API Library Reference, indicated that
IPM_AUDIO_CODER_INFO structure and IPM_AUDIO_CODER_OPTIONS_INFO
Dialogic® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008 5
Dialogic Corporation
Document Revision History
structure have updates for QCELP; updated table of supported audio coders in
IPM_AUDIO_CODER_INFO section (EVRC change); updated
IPM_AUDIO_CODER_OPTIONS_INFO structure (removed
CODER_OPT_EVRC_SIGNALLING_OFF,
CODER_OPT_EVRC_SIGNALLING_DIM_AND_BURST_HALF_RATE,
CODER_OPT_EVRC_SIGNALLING_BLANK; added
CODER_OPT_SIGNALING_OFF); updated example code for
IPM_AUDIO_CODER_OPTIONS_INFO structure.
Document Rev 03 – published May 1, 2007
Updated for Service Update 77.
In the new Post-Release Developments chapter:
• Added Service Update for Dialogic® Multimedia Software for AdvancedTCA Release
1.0 section.
Added important information on the need to uninstall existing software before
installing the new Service Update.
In the Release Issues chapter:
• Updated description of Known Defect: IPY00034680.
• Added the following Known Defects: IPY00033349 (previously Resolved),
IPY00033354 (previously Resolved), IPY00038147, IPY00038148, IPY00038149.
• Added the following Resolved Defects: IPY00035425, IPY00035828, IPY00036058,
IPY00036313, IPY00036386, IPY00036831, IPY00036858, IPY00036983.
• Removed the following Known (Permanent) Defect: IPY00032616 (not a defect).
• Removed the following Known Defects (duplicate entries; previously resolved in
Service Update 70): IPY00036311, IPY00036314.
In the Documentation Updates chapter:
• Added a new version of the Dialogic® Multimedia Blade for ATCA Technical Product
Specification to the bookshelf (previously added in Service Update 70).
Document Rev 02 – published March 30, 2007
Updated for Service Update 70.
In the Release Issues chapter:
• Added SU No. to the Issues table.
• Revised the description for Known Defect IPY00032623.
• Added the following Known Defects: IPY00036858 and unnumbered defect for MSML
regarding http scheme.
• Added the following Known (Permanent) Defect: IPY00032616 (previously a Known
Defect).
6 Dialogic® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008
Dialogic Corporation
Document Revision History
• Added the following Resolved Defects: IPY00036309, IPY00036311, IPY00036314,
IPY00036601, IPY00036911.
In the Documentation Updates chapter:
• Added update to the Dialogic® Multimedia API Library Reference for
MM_VIDEO_CODEC data structure.
Document Rev 01 – published January 2007
Initial version of document.
Dialogic® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008 7
Dialogic Corporation
1.Post-Release Developments
This section describes significant changes to Dialogic® Multimedia Software for
AdvancedTCA Release 1.0 subsequent to the general availability release date.
• Service Update for Dialogic® Multimedia Software for AdvancedTCA Release 1.08
• Summary of Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
• Support for MSML Conferencing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
• Support for QCELP Codec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.1 Service Update for Dialogic® Multimedia Software for AdvancedTCA Release 1.0
A Service Update for Dialogic® Multimedia Software for AdvancedTCA Release 1.0 is
available. Service Updates provide fixes to known problems and may also introduce new
functionality. New versions of the Service Update will be released periodically. This
Release Update documents the features in the Service Updates.
For the latest service update, go to http://www.dialogic.com/support/helpweb/mmpatca/.
Caution: Depending on whether you already have a version of the Dialogic
for AdvancedTCA Release 1.0 software on your system, you may need to uninstall the
existing version before installing the Service Update:
• If you don’t have an existing version of the software on your system, you can install
the Service Update immediately.
• If you have an existing version of the software on your system, you must uninstall the
existing version before installing the Service Update. This Service Update
includes global software changes to reflect the new Dialogic brand.
®
Multimedia Software
1
To uninstall the existing version of the software, run the uninstall script, dlguninstall.sh,
distributed with the existing version of the software, located in /usr/dialogic/bin. The
uninstall script gives you an opportunity to save your configuration settings to a backup
location before starting the uninstall. After you have saved your configuration settings, run
the uninstall script again. After the uninstall has completed, it is not necessary to reboot
the system. However, you must log out and log in to restore the environment settings.
After successfully uninstalling the existing version of the software, you can install the new
software. Instructions for installing the software are provided in the Technical Product
Specification.
Dialogic® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008 8
Dialogic Corporation
1.2 Summary of Features
The following table lists the features introduced in service updates after the initial release
of Dialogic
®
Multimedia Software for AdvancedTCA Release 1.0 and where to find more
information about these features.
Feature
MSML conferencing 81 see Section 1.3, “Support for MSML
AMR and EVRC in MSML 81 see Section 1.4, “Support for AMR and EVRC in
QCELP codec 80 see Section 1.5, “Support for QCELP Codec”, on
Service
Update
Conferencing”, on page 9 and MSML Media
Server User's Guide .
MSML”, on page 9.
page 9.
1.3 Support for MSML Conferencing
With this Service Update, the MSML conferencing feature is supported. For more
information, see the MSML Media Server User's Guide.
For more information
1.4 Support for AMR and EVRC in MSML
With this Service Update, the AMR and EVRC audio codecs are supported in MSML. For
more information about MSML, see the MSML Media Server User's Guide.
1.5 Support for QCELP Codec
With this Service Update, the QCELP 8 kbps and 13 kbps coder type are now supported
for media streaming operations.
Updates to IPM_AUDIO_CODER_INFO
The IPM_AUDIO_CODER_INFO data structure has the following updates:
eCoderType
For QCELP:
• CODER_TYPE_QCELP_8K – QCELP, 8 kbps
• CODER_TYPE_QCELP_13K – QCELP, 13 kbps
Dialogic® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008 9
Dialogic Corporation
The QCELP coder type supports frame size of 20; frames per packet of 1, 2, or 3; and
eVadEnableValue of CODER_VAD_DISABLE.
Updates to IPM_AUDIO_CODER_OPTIONS_INFO
The IPM_AUDIO_CODER_OPTIONS_INFO data structure has the following additional
values:
unCoderOptions
For QCELP, set to CODER_OPT_SIGNALING_OFF.
unParm1
For QCELP, where the media type is
MEDIATYPE_AUDIO_REMOTE_CODER_OPTIONS_INFO, valid values are:
• CODER_OPT_CDMA_RATE_REDUC - Rate reduction. Bit rate is varied to
achieve a variety of average bit rates for more flexibility in bandwidth usage.
nValue1
For QCELP 8 kbps, where unParm1=CODER_OPT_CDMA_RATE_REDUC, possible
values are 0 and 4. Default value is 0.
For QCELP 13 kbps, where unParm1=CODER_OPT_CDMA_RATE_REDUC,
possible values are 0, 1, 2, 3, and 4. Default value is 0.
unParm2
For QCELP, set to 0.
nValue2
For QCELP, set to 0.
10 Dialogic® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008
Dialogic Corporation
2.Release Issues
2
The table below lists issues that can affect the hardware and software supported in the
Dialogic
each issue:
Issue Type
Defect No.
SU No.
®
Multimedia Platform for AdvancedTCA. The following information is provided for
This classifies the type of release issue based on its effect on users and its
disposition:
• Known – A minor hardware or software issue. This category includes
interoperability issues and compatibility issues. Known issues are still open but
may or may not be fixed in the future.
• Known (permanent) – A known hardware or software issue or limitation that will
not be fixed in the future.
• Resolved – A hardware or software issue that was resolved (usually either fixed or
documented) in this release.
A unique identification number that is used to track each issue reported via a formal
Change Control System. Additional information on defects may be available via the
Defect Query tool at http://membersresource.dialogic.com/search/defects (Note that
when you select this link, you will be asked to either LOGIN or JOIN.).
For defects that were resolved in a Service Update, indicates the Service Update
number. For defects that were resolved when the base release was generally
available (before any Service Updates), a “--” is shown. For non-resolved issues, this
information is left blank.
Product or Component
The product or component to which the problem relates, for example, an API.
Description
A summary description of the issue. For non-resolved issues, a workaround is
included when available.
Dialogic® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008 11
Dialogic Corporation
Issues Sorted by Type, Dialogic® Multimedia Platform
Issue Type Defect No.
SU
No.
Product or
Component
Description
Known IPY00035453 call control User cannot select TCP or UDP as mode of transport
for SIP on per call basis. It can be set for all messages
during initialization.
Known IPY00034680 CLI When accessing the CLI, the three built-in accounts
(acctmgr, admin, and craft) are not working. After the
password is entered, the login prompt is returned
instead of the cli prompt.
Workaround: (1) Use root/public as
username/password. This account will grant access
to the CLI. (2) Create a new username/password
combination and renew this combination every 90
days so it does not expire.
Known IPY00034558 CLI The man page for the adduser command has incorrect
usernames and values in the EXAMPLE portion of the
page.
The correct EXAMPLE text is:
EXAMPLE:
No 1:
adduser user1 pass1
A new User and his details can be added to the
Security table. Username and Password are
position defined and their values have to be
entered with option.
No 2:
adduser user1 pass123 -a 50 -g 50 -i
ADVENTMAINT
Known IPY00034557 CLI The man page for the edituser command shows the
wrong command in the EXAMPLE portion of the page it shows adduser instead of edituser.
The correct EXAMPLE text is:
EXAMPLE:
No 1:
edituser -p user1 pass1
Edit and modify the details of any user in the
User table. Username is position defined and
their values have to be entered with option.
NO 2:
edituser -p pass123 -g 50 -a 50 -i ADVENTMAINT
user1
12 Dialogic® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008
Dialogic Corporation
Issues Sorted by Type, Dialogic® Multimedia Platform (Continued)
Issue Type Defect No.
Known IPY00034601 clocking The TDM clock manager does not switch to a valid
Known IPY00033354 conferencing (CNF) The cnf_GetPartyList( ) function does not return
Known IPY00033349 conferencing (CNF) CNFEV_SET_ATTRIBUTE_FAIL is received when
Known IPY00035617 configuration The RFC2833 payload type is currently set to 101.
Known IPY00035616 configuration The RTCP port number is not configurable by the user.
Known IPY00035815 firmware The firmware tries to load the Rear Transition Module
Known IPY00032953 firmware QERROR_WARNING received during download with
Known IPY00037689 hardware If the Dialogic
SU
No.
Product or
Component
Description
clock that is located earlier in the fallback list before the
failed entry. For example, if the last valid trunk clock
source fails, the firmware chooses the internal oscillator
as the clock source instead of a previously recovered
trunk that is in the fallback list. The correct behavior is
that the fallback list should be rescanned from the
beginning before choosing internal oscillator.
Note: if any clock recovers while internal oscillator is
selected, then the firmware rescans the list from
the beginning.
Workaround: The user can reset the fallback list
manually. At a minimum, there will always be a valid
tx PSTN clock provided by internal oscillator.
correctly when max parties (240) are entered into the
conference.
attempting to disable tone clamping.
Even though the user may specify another payload type
for RFC2833, the software transmits RFC2833 with
payload type of 101.
RTCP port will always be RTP+1. Currently this cannot
be changed by the user.
(RTM) PCI driver even when the RTM is not present.
The firmware displays a KILLTASK message in the
/var/log/messages file because the RTM driver failed to
initialize. Since the RTM is not present, the firmware
should not try to initialize the RTM driver and should not
treat the failure as an error.
The error can be ignored.
Cause Tag: 80011, Location Tag: 49111. The warning
can be ignored.
®
Multimedia Blade is shut down with an
RTM present, the baseboard hotswap (blue) LED
remains in a blinking state and never goes to a steady
state as expected to indicate shutdown is complete.
Workaround: Wait for all software services to shut
down before extracting the board.
Dialogic® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008 13
Dialogic Corporation
Issues Sorted by Type, Dialogic® Multimedia Platform (Continued)
Issue Type Defect No.
Known IPY00038149 hardware Shut down is not supported by opening of the Dialogic®
Known IPY00038148 hardware Activation and de-activation via the shelf manager is not
Known IPY00038147 hardware If the Dialogic
Known IPY00036028 hardware The PSTN Rear Transition Module (RTM) generates
Known IPY00036026 hardware The Dialogic
Known IPY00032623 MSML ‘audiosamplerate’ and ‘audiosamplesize’ must be
Known IPY00034143 PSTN call control When using all 496 time slots on 16 E1 trunks, there is
Known
(permanent)
IPY00034168 CLI On a CLI shutdown (by dlstop), the CLI session port is
SU
No.
Product or
Component
Description
Multimedia Blade latch. The blue LED (hotswap LED)
on the blade will blink indefinitely but never turn solid to
indicate shut down complete.
Workaround: To shut down the blade, log on locally
through the serial port or connect over the network and
initiate a shutdown. The blade can be initialized by
removing and reseating in the chassis.
supported on the Dialogic
blue LED (hotswap LED) on the blade will blink
indefinitely but never turn solid to indicate shut down
complete.
Workaround: To shut down the blade, log on locally
through the serial port or connect over the network and
initiate a shutdown. The blade can be initialized by
removing and reseating in the chassis.
®
Multimedia Blade is deactivated using
the shelf manager, the kernel panics while shutting
down the system services and does not complete the
hot swap extraction cycle.
The craftsperson can then remove and/or restart the
blade.
major events to the shelf manager stating that the
sensor “RTM +1.0 V” went over the upper critical limit.
®
events to the shelf manager stating that the sensor
“SBC +1.1V SUS” went over the upper critical limit.
specified by the MSML application server when playing
a .WAV file from an offset.
a 1% failure rate with DTMF digit detection.
not immediately released. If a user does a dlstop
followed by a dlstart too quickly (within 20 seconds), the
dlstart may not be able to start the CLI session.
Workaround: If the CLI agent start part of dlstart fails,
then the workaround is to do the following from a
terminal window after around 20 seconds:
Multimedia Blade generates major
®
Multimedia Blade latch. The
dlservices cli start
If it doesn't work immediately, try again in a few
seconds. This will start the CLI agent and user will be
able to use telnet again.
14 Dialogic® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008
Dialogic Corporation
Loading...