Megaco Release Notes

20002013 Ericsson AB. All Rights Reserved. The contents of this file are subject to the Erlang Public License, Version 1.1, (the "License"); you may not use this file except in compliance with the License. You should have received a copy of the Erlang Public License along with this software. If not, it can be retrieved online at http://www.erlang.org/. Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License. Megaco Release Notes Lars Thorsén, Håkan Mattsson, Micael Karlberg %VSN% notes.xml

This document describes the changes made to the Megaco system from version to version. The intention of this document is to list all incompatibilities as well as all enhancements and bugfixes for every release of Megaco. Each release of Megaco thus constitutes one section in this document. The title of each section is the version number of Megaco.

Megaco 3.16.1

Version 3.16.1 supports code replacement in runtime from/to version 3.16.0.2, 3.16.0.1, 3.16 and 3.15.1.1.

Improvements and new features

Fixed bugs and malfunctions

Buffer overrun error while flex scanner processing property parm groups.

This error occured only for large messages if a buffer realloc was needed while processing the property parm groups.

Own Id: OTP-10998

Aux Id: Seq 12263

Incompatibilities

Megaco 3.16.0.2

Version 3.16.0.2 supports code replacement in runtime from/to version 3.16.0.1, 3.16, 3.15.1.1, 3.15.1 and 3.15.

Improvements and new features

Allow whitespaces in installation path.

It is now possible to give configure and make an installation/release path with whitespaces in it.

Own Id: OTP-10107

Fix parallel make for behaviours.

Removed use of deprecated system flag, global_haeps_size, in the measurement tool mstone1.

Fixed bugs and malfunctions

Incompatibilities

Megaco 3.16.0.1

Version 3.16.0.1 supports code replacement in runtime from/to version 3.16, 3.15.1.1, 3.15.1 and 3.15.

Improvements and new features

Fixed some faulty test cases.

Removed use of deprecated system flag, scheduler_bind_type, in the measurement tool mstone1.

Own Id: OTP-9949

Fixed bugs and malfunctions

Incompatibilities

Megaco 3.16

Version 3.16 supports code replacement in runtime from/to version 3.15.1.1, 3.15.1 and 3.15.

Improvements and new features

Minor improvements to the measurement tool mstone1.

Own Id: OTP-9604

ASN.1 no longer makes use of a driver to accelerate encode/decode, instead it uses NIFs. The encoding config option is still the same, i.e. driver.

Own Id: OTP-9672

The profiling test tool has been rewritten.

Håkan Mattsson

Own Id: OTP-9679

The flex driver has been updated to support the new driver format (changed to enable 64-bit aware drivers).

Own Id: OTP-9795

Fixed bugs and malfunctions

Incompatibilities

Megaco 3.15.1.1

Version 3.15.1.1 supports code replacement in runtime from/to version 3.15.1 and 3.15.

Improvements and new features

Correct various XML errors.

Own Id: OTP-9550

Fixed bugs and malfunctions

Megaco 3.15.1

Version 3.15.1 supports code replacement in runtime from/to version 3.15, 3.14.1.1, 3.14.1 and 3.14.

Improvements and new features

Fixed bugs and malfunctions

Fixing miscellaneous things detected by dialyzer.

Own Id: OTP-9075

Megaco 3.15

Improvements and New Features

Fixing auto-import issues.

Own Id: OTP-8842

Fixed bugs and malfunctions

Megaco 3.14.1.1

Version 3.14.1.1 supports code replacement in runtime from/to version 3.14.1, 3.14, 3.13, 3.12 and 3.11.3.

Improvements and new features

Updated the performance chapter.

Own Id: OTP-8696

Fixed bugs and malfunctions

Megaco 3.14.1

Version 3.14.1 supports code replacement in runtime from/to version 3.14, 3.13, 3.12 and 3.11.3.

Improvements and new features

A minor compiler related performance improvement.

Own Id: OTP-8561

Fixed bugs and malfunctions

A race condition when, during high load, processing both the original and a resent message and delivering this as two separate messages to the user.

Note that this solution only protects against multiple reply deliveries!

Own Id: OTP-8529

Aux Id: Seq 10915

Fix shared libraries installation.

The flex shared lib(s) were incorrectly installed as data files.

Peter Lemenkov

Own Id: OTP-8627

Eliminated a possible race condition while creating pending counters.

Own Id: OTP-8634

Aux Id: Seq 11579

Megaco 3.14

Version 3.14 supports code replacement in runtime from/to version 3.13, 3.12 and 3.11.3.

Improvements and new features

Various changes to configure and makefile(s) to facilitate cross compilation (and other build system improvements).

Own Id: OTP-8323

Added a help target in the test Makefile to explain the most useful make targets, used when testing the application using the test-server provided with megaco.

Own Id: OTP-8362

Adapted megaco_filter to the new internal format.

Own Id: OTP-8403

Fixed bugs and malfunctions

Callbacks, when the callback module is unknown (undefined), results in warning messages.

A race condition scenario. As part of a cancelation operation, replies with waiting acknowledgements is cancelled. This includes informing the user (via a call to the handle_trans_ack callback function). It is possible that at this point the connection data has been removed, which makes it impossible for megaco to perform this operation, resulting in the warning message. The solution is to also store the callback module with the other reply information, to be used when cleaning up after a cancelation.

Own Id: OTP-8328

Aux Id: Seq 11384

Megaco 3.13

Version 3.13 supports code replacement in runtime from/to version 3.12 and 3.11.3.

Improvements and new features

A minor optimization by using ets:update_element instead of ets:insert for some table updates.

Own Id: OTP-8239

The documentation is now built with open source tools (xsltproc and fop) that exists on most platforms. One visible change is that the frames are removed.

Own Id: OTP-8249

Fixed bugs and malfunctions

Incompatibilities

Megaco 3.12

Improvements and new features

Improve handling of async transaction reply.

For asynchronous requests, issued using megaco:cast/3, the reply will be delivered using the handle_trans_reply/4,5 callback function.

If a receiver of a request, issued using megaco:cast/3, does not reply in time, megaco re-sends the request. If the receiver of the request sends the reply at the same time as megaco re-sends, it may also send a reply to the resent request (thinking the first reply got lost). These two replies may arrive more or less at the same time, causing confusion.

In order to improve this situation, a number of improvements have been done:

When the first reply arrives, a timer, request-keep-alive, is started. This timer is used to decide when to stop accepting replies as legitimate.

The timeout time for the timer is specified by the config option request_keep_alive_timout, which can be set per user or per connection.

We also keep track of how many replies has been received (we do this as long as the request-keep-alive timer is running).

Each reply that arrives while the request-keep-alive timer is running (including the first) will be delivered using the handle_trans_reply/4,5 callback function, but with the UserReply augmented to include a serial number indicating which reply number this is. The first reply to arrive, will be numbered one (1).

Replies arriving after the timer has expired will be delivered in the same way as before, using the handle_unexpected_trans/3,4 callback function.

Note that if the timer was not configured, megaco will act exactly as before!

Own Id: OTP-8183

Aux Id: Seq 11393

Fixed bugs and malfunctions

If the megaco app received a transaction reply, for a request issued using the call/3 function, from the wrong remote entity (wrong MId)), megaco would still deliver the reply (call/3 returnes) as if from the correct remote entity (right MId).

This has been changed so that the function now returns with an error reason.

See call/3 for more info.

*** POTENTIAL INCOMPATIBILITY ***

Own Id: OTP-8212

Aux Id: Seq 11305