Sunteți pe pagina 1din 15

Release 8.

InstantLink NE Interface SDK

Release Notes

Joint Confidential
Abstract
The InstantLink NE Interface SDK Release 8.0 Release Notes (Document Version 1.0) gives information on changes and new features in
an InstantLink NE Interface SDK.

Contact Information
If the information you need is not in this document, you can contact our Customer Support Services:

Phone: +358 9 694 3256


Fax: +358 9 700 11 206
Email: support@comptel.com

This service is available only to customers who have made a maintenance agreement with Comptel Corporation.

Trademarks
Comptel, Comptel logo, Comptel Dynamic OSS, Comptel Control and Charge, Comptel Policy Control, Comptel Convergent Mediation,
Comptel Charging, Comptel Interconnect Billing, Comptel Roaming Management, Comptel Bandwidth Management, Comptel Roaming
Cost Control, Comptel Dynamic Campaigning, Comptel Dynamic SIM Management, Comptel Fulfillment, Comptel Order Management,
Comptel Provisioning and Activation, Comptel Service and Resource Inventory, Comptel Inventory, Comptel Service Inventory, Comptel
Catalog, Comptel Service Repository, Comptel Subscriber Profile Repository, Comptel Subscriber Repository, Comptel Fulfillment
Solution, Comptel Convergent Mediation Solution, Comptel Convergent Charging Solutions, Comptel Voice and Data Charging Solution,
Comptel IP Prepaid Solution, Comptel Online Cost Control Solution, Comptel Rating Solution, Comptel Offline Mediation Solution,
Comptel Online Mediation Solution, Comptel Provisioning and Activation Solution, Comptel Service Repository Solution, Comptel Service
Catalog Solution, Comptel Inventory Solution, Comptel Interconnect Billing Solution, Comptel Roaming Management Solution, Comptel
Data Retention Solution, Comptel Number and Identifier Management Solution, Comptel Order Management Solution, Comptel TETRA
Solution, Comptel EventLink, Comptel InstantLink, Comptel OnlineLink, Comptel NIMS, Comptel IPAM, Comptel Number and Identifier
Management, Comptel PacketLink, Comptel ServiceLink, Comptel SMSLink, Comptel Alarm Dispatcher, Comptel Balance Management,
Comptel GTP Collector, Comptel Lookup Server, Comptel MDS, Comptel MDS/AMD, Comptel Partner Account, Comptel Rater, Comptel
Notifier, Comptel Reporter, Comptel Service Catalog, Comptel Convergent Mediation SDK, Comptel Provisioning Client, Comptel
Workflow Client, EventLink Business Logic Tool, EventLink Correlator, EventLink Developer's License, EventLink Encapsulated ARM-FR,
EventLink FTP Collector, EventLink FTP Distributor, EventLink Multi-format Encoder, EventLink Remote File Agent, EventLink Reporter,
Comptel EventLink SDK, EventLink UDP Collector, EventLink UDP Distributor, EventLink User Interface, EventLink Record Correction
Tool, InstantLink Business Service Tool, InstantLink Developer's License, InstantLink NE Interface SDK, InstantLink Provisioning Client,
InstantLink Workflow Client, OnlineLink Business Service Tool, MDS Correlator, MDS Credit Guard, MDS Remote File Agent, MDS/AMD
Developer's License, MDS/AMD-DB, MDS/ARC, MDS/ARM, MDS/ARP, and MDS/FTM are trademarks or registered trademarks of
Comptel Corporation and its subsidiaries (Comptel Group).

All other trademarks and registered trademarks are the property of their respective holders.

Copyright © 1996-2011 Comptel Corporation,


Salmisaarenaukio 1, FI-00180 Helsinki, Finland
No part of this document may be reproduced, translated, or transmitted in any form or by any means, electronic or mechanical, for any
purpose without the express written permission of Comptel Corporation or its respective Affiliate ("Comptel"), and then only on the
condition that this notice is included in any such reproduction. No information as to the contents of this document may be communicated
to any third party without the prior written consent of Comptel.

Information in this document is subject to change without notice and does not represent a commitment on the part of Comptel
Corporation. Comptel Corporation is not liable for errors contained in this document or for incidental or consequential damages in
connection with furnishing or use of this material. This document is not part of a contract or license save insofar as may be expressly
agreed in writing.

Comptel's software is protected by copyright laws. Comptel has also sought patent protection for its solutions. Comptel is continuously
keeping up with the patenting activities within its field of business. Comptel respects the intellectual property rights of third parties and
never wilfully infringes patents owned by third parties.

Copyright © 1996-2011 Comptel Corporation Document Version 1.0


All Rights Reserved
InstantLink NE Interface SDK ii
Release 8.0
Release Notes
Joint Confidential

1 Overview 1

2 Known Problems in This Release 2


3 Changes 3
3.1 Release 8.0 3

3.1.1 New Features 3

3.1.2 Fixed Problems 3

3.2 Release 7.3 6

3.2.1 New features 6

3.3 Release 7.2 6

3.3.1 New features 6

3.3.2 Fixed Problems 8

3.4 Release 7.1 8

3.4.1 New features 8

3.4.2 Fixed Problems 10

3.5 Release 7.0.1 10

3.5.1 New Features 10

3.5.2 Fixed Problems 11

3.6 Release 7.0 11

3.6.1 New Features 11

3.6.2 Fixed Problems 11

3.7 Release 6.0 11

4 Documentation 12
4.1 Customer Documents 12

4.2 Legal Notices 12

Copyright © 1996-2011 Comptel Corporation Document Version 1.0


All Rights Reserved
InstantLink NE Interface SDK 1
Release 8.0
Release Notes
Joint Confidential

1 Overview
This document describes the changes and new features in InstantLink NE Interface
SDK release 8.0.
The product release supports the following platforms:
• Microsoft Windows XP
• Java J2SE v 1.4.2 SDK
• Java J2SE v 1.5.0.04 SDK
• Java J2SE v 1.6.0

The InstantLink network element interfaces that have been developed with this
product release support the following platforms:
• AIX Version 6.1 (POWER)
• HP-UX 11i v3 (Itanium)
• Red Hat Enterprise Linux Server 5 (x86)
• Solaris 10 (SPARC)
The following third party software is required for this product release:
• Eclipse 3.5.2 Galileo
• Eclipse DLTK 0.91
• ActiveTCL 8.4.16

Copyright © 1996-2011 Comptel Corporation Document Version 1.0


All Rights Reserved
InstantLink NE Interface SDK 2
Release 8.0
Release Notes
Joint Confidential

2 Known Problems in This Release


The following table lists known problems in this release.

Description Workaround
Eclipse 3.5.2 Galileo has a compatibility problem Install Java version 1.6.2_21-b07 or higher.
with Java version 1.6.2_21-b06 for Windows
users. It causes a packaging problem in the NEI
SDK.
Eclipse prompts the error message, "Word cannot Download MicrosoftFixit50352.msi and run it
start the converter mswrd632" while opening a after exiting all Microsoft Office applications.
Microsoft Open Office XML Format (.docx) This change will effectively unregister the
document. It is caused by the security updates for converter and disable it for third-party applications
Windows XP, Windows 2000, and Windows and Microsoft Office applications. Microsoft
Server 2003. Office applications will use its own text converters
to open the files.
For more information, please refer to http://
support.microsoft.com/kb/973904.

Copyright © 1996-2011 Comptel Corporation Document Version 1.0


All Rights Reserved
InstantLink NE Interface SDK 3
Release 8.0
Release Notes
Joint Confidential

3 Changes
3.1 Release 8.0

3.1.1 New Features


Feature Request Description
PAIDL-705 Documents for the example NEI projects have been renamed.
PAIDL-722 The WSDLToNEI feature now supports multiple initial WSDL files with
multiple endpoints involved. For more information, please refer to
InstantLink NE Interface SDK for Java Developer's Guide.
PAIDL-478 In the WSDLToNEI feature, the package structure for the codes rendered
from the WSDL is now generated based on the target name space.
PAIDL-481 In the WSDLToNEI feature, the relevant WSDL and XSD files, which are
referred by the imported WSDL file, can now be downloaded automatically
to the NEI project. These files must be located in the local system.
PAIDL-556 The TemplateToNEI feature now supports multiple request and response
templates in a single provisioning task method.
PAIDL-558 The WSDLToNEI feature now supports the Axis2 SOAP framework.
PAIDL-607 In the Create Comptel Catalog Import File feature, the relevant
response parameter(s) are now generated in the import file for CLI and
XML template based NEI projects.
PAIDL-648 The WSDLToNEI feature now supports multiple WSDL files where only one
endpoint is involved.
PAIDL-678 The NEI SDK now generates NEI document templates in Microsoft Open
Office XML Format (.docx) format.
PAIDL-399 The NEI SDK now supports updating Test Plan and Test Report for Java
NEI project.

3.1.2 Fixed Problems


Defect ID Description
PAIDL-660 Defect description:
The NEI generated using WSDLToNEI feature does not include all task
parameters specified for the operations. It also generates incorrect request
and response object when the object name and parameter object name are
identical.
Defect correction:
This is now fixed.
PAIDL-675 Defect description:
The NEI generated using WSDLToNEI feature does not handle the
exceptions properly. AxisFault and IOException are not caught correctly in
the exception handling.
Defect correction:
This is now fixed.

Copyright © 1996-2011 Comptel Corporation Document Version 1.0


All Rights Reserved
InstantLink NE Interface SDK 4
Release 8.0
Release Notes
Joint Confidential

PAIDL-743 & PAIDL- Defect description:


744 The WSDLToNEI feature is returning response parameters with empty
value. This will cause "TaskEngine - WARNING;-1;Not enough
tokens!" in InstantLink.
Defect correction:
This is now fixed. Response parameters with empty value will not be
returned.
PAIDL-669 Defect description:
The TemplateToNEI feature is not able to support multiple request and
response templates in a single provisioning task method if the template file
name prefix does not start with create, modify, delete or display.
Defect correction:
This is now fixed.
PAIDL-733 Defect description:
SOAP based NEI package, which is generated using WSDLToNEI Axis2
feature and packaged using InstantLink NEI SDK, cannot be run properly.
There is a missing library (wsdl4j-1.6.2.jar) in the packinglist and
ksh script configuration.
Defect correction:
This is now fixed.
PAIDL-711 Defect description:
For WSDLToNEI and TemplateToNEI features, the list of files imported
using wizard are not updated correctly. The files removed using the
Remove button are still imported into the project.
Defect correction:
This is now fixed.
PAIDL-486 Defect description:
In the WSDLToNEI feature, the response parameter with null value is
returned to the Java Macro Server. This causes unnecessary parameters to
be sent to the InstantLink Task Engine.
Defect correction:
This is now fixed. Response parameter no longer returns with a null value.
PAIDL-580 Defect description:
InstantLink NEI SDK does not include the latest documentation.
Defect correction:
The customer documents have now been updated.

Copyright © 1996-2011 Comptel Corporation Document Version 1.0


All Rights Reserved
InstantLink NE Interface SDK 5
Release 8.0
Release Notes
Joint Confidential

PAIDL-594 Defect description:


The NEI packages which are generated using InstantLink NEI SDK cannot
be installed in the UNIX environment.
Defect correction:
The NEI packages can now be installed in the UNIX environment.
PAIDL-606 Defect description:
In the WSDLToNEI wizard, the Finish button is not enabled once a WSDL
file is imported. This is due to different file type descriptions which have
been configured in different Windows environments.
Defect correction:
This is now fixed. The Finish button is now enabled once a WSDL file is
imported.
PAIDL-658 Defect description:
The NEI packages which are generated using InstantLink NEI SDK cannot
be run in the UNIX environment.
Defect correction:
This is now fixed.

Copyright © 1996-2011 Comptel Corporation Document Version 1.0


All Rights Reserved
InstantLink NE Interface SDK 6
Release 8.0
Release Notes
Joint Confidential

3.2 Release 7.3

3.2.1 New features


Feature Request Description
PAIDL-490 The SDK now supports automatic generation of template based Java NEI
by importing template files. The templates can be either in CLI (Command
Line Interface) or XML format.
For more information, see InstantLink NE Interface SDK User’s Guide and
InstantLink NE Interface SDK Java Developer’s Guide documents.
PAIDL-520 The NEI SDK now contains Java Macro Server 1.4 EB1.
Service Repository (SR) has been renamed to Comptel Catalog.
PAIDL-561 The NEI SDK now generates log files for troubleshooting purposes.

3.3 Release 7.2

3.3.1 New features


Feature Request Description
PAIDL-55 To make the NE Interface project creation more convenience in Eclipse, the
create NEI project wizard auto focus should be on wizard page first input
field.
PAIDL-70 A new pop up menu Run Test File is introduced to automate the request
sending of a request test file to Java Macro Server or Expect Macro Server.
For more information, see InstantLink NE Interface SDK Users Guide.
PAIDL-71 The translatefile should be properly documented.
InstantLink NE Interface SDK Users Guide has been updated.
PAIDL-123 There are no instructions on how to develop a Virtual NEI.
InstantLink NE Interface SDK Users Guide has been updated.
PAIDL-72 InstantLink NE Interface SDK Users Guide document now contains the
step on how to locate the .packinglist file.
For more information, see InstantLink NE Interface SDK Users Guide.
PAIDL-79 The SDK is now running on Eclipse version 3.5.2 (Galileo).
PAIDL-126 The term 'macro set' is now changed to 'NEI' in the SDK example project
source code.
PAIDL-144 The SOAP NEI example documentation should explain the response values
of the SOAP simulator.
InstantLink NE Interface Java SOAP Example Functional Description has
been updated.
PAIDL-147 The new common methods (ILDL-415 and ILDL-414) introduced in Java
Macro Server 1.3 Enhancement Bundle 1 should be properly documented.
InstantLink NE Interface SDK for Java Developer's Guide has been
updated.
PAIDL-178 The SDK now supports the features of Java Macro Server 1.3 Enhancement
Bundle 1.

Copyright © 1996-2011 Comptel Corporation Document Version 1.0


All Rights Reserved
InstantLink NE Interface SDK 7
Release 8.0
Release Notes
Joint Confidential

PAIDL-185 To make the InstantLink SDK NEI training more challenging, the SOAP
simulator supports now the following commands:
• createService
• deleteService
• displayService
The new commands are implementing only to the simulator. So in the SDK
training the trainee should create a NEI that supports the new commands.
PAIDL-213 The following new common methods introduced in Java Macro Server 1.3
Enhancement Bundle 1 are added to SOAP NEI example:
• checkMissingMandatoryParameter
• sendData
• getStatusLookup
• getTraceLevel
InstantLink NE Interface Java SOAP Example Functional Description has
been updated to include status lookup feature.
PAIDL-214 Localization of the Java NEI should be instructed in the SDK document.
InstantLink NE Interface SDK Java Developer Guide has been updated
with new chapter on how to configure the ksh script of the Java NEI to
handle localization.
PAIDL-233 The SDK SOAP NEI Example now contains annotation types in
Connection and Constant classes.
PAIDL-282 The SDK now supports two new features:
• Create Test Scripts
• Create SR Import File
For more information, see InstantLink NE Interface SDK Users Guide
document.
PAIDL-390 The SDK now supports auto-generation of Java SOAP NEI by importing
WSDL (Web Services Description Language) and XSD (XML Schema
Definitiaon) files.
For more information, see InstantLink NE Interface SDK Users Guide and
InstantLink NE Interface SDK Java Developer Guide.
PAIDL-403 The SDK now contains Java Macro Server 1.3 EB2 for Java NEI
development (JDK 5).
The NEI can now use the available annotation types.
PAIDL-404 The SDK now contains Java Macro Server 1.4 for Java NEI development
(JDK6) and Expect Macro Server 4.2 for Expect NEI development.

Copyright © 1996-2011 Comptel Corporation Document Version 1.0


All Rights Reserved
InstantLink NE Interface SDK 8
Release 8.0
Release Notes
Joint Confidential

3.3.2 Fixed Problems


Defect ID Description
PAIDL-156 Defect description:
The SOAP NEI example project did not work when installed to InstantLink
7, because the task parameter wsdl_location did not have the trailing 1.
Defect correction:
The SOAP NEI example now has the correct parameter name
(wsdl_location1).
PAIDL-200 Defect description:
The .packinglist file for EXPECT MML EXAMPLE project does not
contain new simulator commands MA, MK and MN.
Defect correction:
This problem is now fixed. The dx_simu_MA.exp, dx_simu_MK.exp and
dx_simu_MN.exp files are now included in the packinglist file.
PAIDL-210 Defect description:
Shortcut keys to access the text boxes in the third page of Create NEI
project in the eclipse plug-in are duplicated:
• NE vendor (Alt + n)
• NE type (Alt + n)
• Product name (Alt + p)
• Product version (Alt + p)
Defect correction:
This is now fixed and the shortcut keys are unique:
• NE vendor (Alt + v)
• NE type (Alt + t)
• Product name (Alt + a)
• Product version (Alt + e)

3.4 Release 7.1

3.4.1 New features


Feature Request Description
PAIDL-60 The SDK should contain a developer’s guide for the development of
asynchronous interfaces.
The SDK contains now a RMI FIFO developer’s guide and example NEI
project. The example NEI contains a simple NEI and asynchronous Java
Client that connects to the RMI interface provided by InstantLink. The aim
is to understand the usage of the RMI FIFO libraries providing the ability to
develop asynchronous NE interfaces.
PAIDL-78 The SDK now supports NE interface development on JDK 5.
PAIDL-73 The SDK should contain the latest Expect Macro Server that supports the
heart beat functionality. The SDK now contains the Expect Macro Server
4.0.x.

Copyright © 1996-2011 Comptel Corporation Document Version 1.0


All Rights Reserved
InstantLink NE Interface SDK 9
Release 8.0
Release Notes
Joint Confidential

PAIDL-101 The SDK should contain the latest Java Macro Server that supports JDK 5.
The SDK now contains the Java Macro Server 1.3.0 for JDK 5
development and Java Macro Server 1.2.3 for Java 1.4 development.
PAIDL-69 The SDK should contain an example SOAP NEI.
The SDK now contains a SOAP NE interface example with a SOAP
simulator and documentation. The SOAP NE interface and simulator are
using the Axis2 libraries.
PAIDL-100 To make the InstantLink SDK NEI training more challenging, the Expect
MML simulator now supports the following commands groups:
• ZMA
• ZMN
• ZMK
The new commands groups are implement only to the simulator. In the
SDK training the trainee should create a NEI that supports the new
command groups.

Copyright © 1996-2011 Comptel Corporation Document Version 1.0


All Rights Reserved
InstantLink NE Interface SDK 10
Release 8.0
Release Notes
Joint Confidential

3.4.2 Fixed Problems


Defect ID Description
PAIDL-108 Defect description:
Unable to reuse a RMI port for the Java RMI Example simulator after a
different port has been assigned to the Java RMI Example simulator.
Error message: RMI example simulator is not started. An
error occurred. Details:
java.rmi.server.ExportException: internal error: ObjID
already in use
Defect correction:
User is now able to reuse a RMI port for the Java RMI Example simulator.
PAIDL-114 Defect description:
Unable to start up RMI simulator in the UNIX environment.
Error message: Exception in thread "main"
java.lang.NoClassDefFoundError: org/eclipse/ui/plugin/
AbstractUIPlugin
Defect correction:
The RMI simulator can now be started up successfully in the UNIX
environment.

3.5 Release 7.0.1

3.5.1 New Features


Feature Request Description
6608 Defect Description:
The generated NEI projects (Expect and Java) should have default
error_codes.txt, phase_codes.txt, supp_codes.txt entries.
(The same default entries you get when installing EMS and JMS).
Defect correction:
The generated NEI projects have now more meaningful configuration files.
6020 Defect Description:
When creating the NEI package, the packaging process creates a temporary
directory under C:\InstantLinkNEISDK70\. Because the drive letter is
hard coded, it is not possible to install NEISDK70 in other drive than C.
Defect correction:
The SDK can now be installed also under different drives. The drive is
defined under the Eclipse preferences.
6666 Defect Description:
The generated java NEI startup script
java_<netype>_<productname>.ksh should contain also the product
version.
Defect correction:
The SDK now generates the java NEI startup script with the product
version: java_<netype>_<productname>_ <productversion>.ksh

Copyright © 1996-2011 Comptel Corporation Document Version 1.0


All Rights Reserved
InstantLink NE Interface SDK 11
Release 8.0
Release Notes
Joint Confidential

3.5.2 Fixed Problems


Feature Request Description
6565 Defect Description:
InstantLink NE Interface SDK Installation Guide includes instructions for
Eclipse DLTK's installations. DLTK is fetched during the installation of
eclipse from the server and by default the latest versions is fetched. DLTK's
latest version was 0.95 and its installation does not succeed Eclipse with
3.3.1. It must be version 0.91, which is not clearly advised in the
documentation. Especially how to get the specific version of DLTK must
be clearly instructed.
Defect correction:
The open source policy allows Comptel to distribute the correct DLTK
version. The InstantLink NE Interface SDK Installation Guide has been
updated.
6194 Defect Description:
InstantLink Expect Macro server includes procedures ForbidLogging
and PermitLogging, which can be used to control MML log writing.
These procedures are not documented in macro server documentation.
Defect correction:
Usage of these procedures are now documented in
InstantLink NE Interface SDK for Expect Developer's Guide.
6021 Defect description:
The default .packinglist for the example NEI should be changed so
that the project pdf documents are located in
/<installdir>/sas/ui/webapps/sas5/docs/NEI to enable viewing
of the documents in the InstantLink UI.
Defect correction:
The pdf documents are now installed to the correct directory.

3.6 Release 7.0

3.6.1 New Features


Feature Request Description
- Added support for InstantLink NE Interface development and testing in
Windows using the Eclipse tool.

3.6.2 Fixed Problems


None.

3.7 Release 6.0


This is the first release of the InstantLink NE Interface SDK.

Copyright © 1996-2011 Comptel Corporation Document Version 1.0


All Rights Reserved
InstantLink NE Interface SDK 12
Release 8.0
Release Notes
Joint Confidential

4 Documentation
This chapter lists the InstantLink NE Interface SDK release 8.0 documentation.

4.1 Customer Documents


Customer document Document version
InstantLink NE Interface Expect MML Example Release Notes 1.0
InstantLink NE Interface Expect MML Example Functional Description 1.0
InstantLink NE Interface Expect MML Example Installation Guide 1.0
InstantLink NE Interface Java RMI Example Release Note 1.0
InstantLink NE Interface Java RMI Example Functional Description 1.0
InstantLink NE Interface Java RMI Example Installation Guide 1.0
InstantLink NE Interface Java SOAP Example Release Notes 1.0
InstantLink NE Interface Java SOAP Example Functional Description 1.0
InstantLink NE Interface Java SOAP Example Installation Guide 1.0
InstantLink NE Interface Java RMI FIFO Example Release Notes 1.0
InstantLink NE Interface Java RMI FIFO Example Functional Description 1.0
InstantLink NE Interface Java RMI FIFO Example Installation Guide 1.0
InstantLink NE Interface SDK Expect Developer’s Guide 1.0
InstantLink NE Interface SDK Functional Description 1.0
InstantLink NE Interface SDK Installation Guide 1.0
InstantLink NE Interface SDK Java Developer’s Guide 1.0
InstantLink NE Interface SDK User’s Guide 1.0
InstantLink RMI FIFO Developer’s Guide 1.0

4.2 Legal Notices


InstantLink NE Interface SDK release 8.0 uses non-commercial third party
components. The required components, source code and documentation are included
in the InstantLink NE Interface SDK release 8.0 installation package.

The following disclaimers are for information only. The full license agreements can
be found in the release package.

The following third party components are included:

• Cpio for Windows 2.6


This product includes software developed by the GnuWin32 project (http://
gnuwin32.sourceforge.net/)

Copyright © 1996-2011 Comptel Corporation Document Version 1.0


All Rights Reserved

S-ar putea să vă placă și