IBM WebSphere Telecom Web Services Server Component, Version 6.2.0.1 Interim Fix 13 Readme

© Copyright International Business Machines Corporation 2007, 2010. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

About this interim fix

This interim fix is a cumulative fix which includes all the latest changes for the IBM® WebSphere® Telecom Web Services Server (TWSS), Version 6.2.0 This interim fix is recommended for all customers with a TWSS 6.2.0 installation.

This interim fix is installed using the WebSphere Update Installer as well as some manual updates.

Fix and update history

This interim fix includes the following APARs and fixes. This package includes all fixes for the Access Gateway, Service Policy Manager, Service Platform components, and TWSS Web service implementations.

Interim Fix 001

  • ArrayOutOfBoundsException occurs on notifymgmt.ear: (APAR LI72617) Corrects a problem in which the notifymgmt.ear gets an ArrayOutOfBoundsException during the registerNotification method.
  • Add configuration for the SMPP system_type PDU field: (APAR LI72618) Corrects a problem in the SMS and WAP services for SMPP by adding a configuration setting in the network mapper Administration Console page. The administrator can use this setting to specify the value of the system_type field that is used during the Bind Transceiver operation.
  • Memory leak in SMS, WAP, and MMS services: (APAR LI72622) Corrects a problem in the SMS, WAP and MMS service EARs and the SMPPConnector.rar that results in a memory leak.
  • Service Policy Manager Console hangs: (APAR LI72628) Corrects a problem in the Service Policy Manager Console that may result in the browser looping or hanging and requiring the user to exit the browser.
  • Missing SMS Resources cause stack dump in trace log: (APAR LI72628) Corrects a problem in the SMS service where a few resources were missing from a resource file causing exceptions to be dumped into the trace log. This was harmless but appeared to be a problem.
  • Added Attachment Size limit policy to Access Gateway: (APAR LI72628) Corrects a problem in the Access Gateway by enforcing limits on the size of attachments sent to the system.

Interim Fix 002

  • SMS & WAP JNDI Names conflict: (APAR LI72798) Corrects a problem in the SMS and WAP services such that the JNDI names are unique.
  • MMS Usage Records are updated: (APAR LI72798) Corrects a problem in the MMS service to add a missing usage record for the message delivery status. The usage record is now generated.
  • Access Gateway policy initialization script corrections: (APAR LI72798) Corrects a problem in the Access Gateway policy initialization script that resulted in a missing policy and a misspelled policy. The policy spelling is corrected, and a missing policy is added.
  • SMS and WAP Performance Improvement related to use of getProperty(): (APAR LI72798) Corrects a problem in the SMS and WAP service related to calling the getProperty() instead of getPropertyFromCache(), the service now looks in the cache appropriately.
  • SMS and WAP Performance Improvement related to use of 'reverse scan' in the DDL: (APAR LI72798) Corrects a problem in the SMS and WAP service related to the use of the 'reverse scan' clause in the DLL. When creating indexes, the reverse scan clause is removed.
  • SPM Console encrypted policies are not working properly: (APAR LI72798) Corrects a problem in the SPM Console where encrypted policies are not working properly. Encrypted policies are now displayed as obscured, and the page behavior is corrected.
  • SPM Console security and session timeout is not working properly: (APAR LI72798) Corrects a problem in the SPM Console where the session is not timing out properly when security is enabled.
  • SMS Performance improvement related to use of initProperties(): (APAR LI72798) Corrects a problem in the SMS service such that the initProperties() method is called only during initialization.
  • SMS/SMPP Usage Records updated to add charging information: (APAR LI72798) Corrects a problem in the SMS service so that the charging information passed on the Web Service request is added to the usage records.
  • Incorrect security constraints in some applications: (APAR LI72798) Corrects a problem in Address List Management, Notification Management, Presence, Terminal Status, and Call Notification so that the deployment descriptor security constraints are appropriate.
  • Server stop cleanup for Terminal Location: (APAR LI72798) Corrects a problem in Terminal Location for MLP when exceptions occurred during server stop.
  • MMS Configuration for MMSC path added: (APAR LI72694) Corrected a problem in the MMS Service configuration by enabling the URL path for the MMSC to be configurable.
  • commit() exception on Notification Manager registerNotification: (APAR LI72714) Corrects a problem in the Notification Manager application executing the registerNotification operation which was causing an exception trying to commit the transaction.

Interim Fix 003

  • MMSC HTTP 500 response code and interoperability (APAR LI72787) Corrects a problem in the MMS for MM7 service that results in an HTTP error code 500, and some additional interoperability problems that required some additional configuration. Additionally, MMS will now work without attachments.
  • Incorrect security constraints in some applications: (APAR LI72798) Corrects a problem in the Service Implementations so that the deployment descriptor security constraints are appropriate.
  • SMPP SMS Server Stop Exceptions (APAR LI72798) Corrects a problem in the SMPP Resource Adapter that causes exceptions when the SMPP SMS service is stopped.
  • Access Gateway Flow Post Processing updated (APAR LI73016) Corrects several problems in the Access Gateway post processing that is run after a TWSS Access Gateway flow is customized by WID. This update fixes the problems related to the j2ee: namespace prefix being added to several deployment descriptors in the EAR. The 6.2.0-WS-WAS-TWSS-WIDPlugins-FP000001.zip file contains the updated post processing files that are originally delivered in the WID Installer.

Interim Fix 004

  • UTC Time stamp values in Access Gateway (APAR LI73021) New functionality to enable time stamps to be stored either in UTC (Universal Time Code) or in local system time.
  • Problem when security is disabled for Access Gateway (APAR LI73129) Corrects the problem in Access Gateway related to the processing of the Message Element Remover mediation primitive when a notification is received from the PX Notification common component and security is disabled for Access Gateway. See the required configuration steps below.
  • Messages are sent continuously to the SMSC in the SMPP JCA Adapter (APAR LI73119) Corrects the problem in the SMPP Resource Adapter that sends two BindTransceiver requests to the SMSC.
  • WAP Push Web Service port number values are limited to 9999 and below (APAR LI73128) Corrects the problem in WAP Push over SMPP in which the port number value in the backend configuration is restricted to a maximum of 9999.
  • Sending WAP Push SMS to cell phones resulted in incorrect output (APAR LI73130) Corrects the problem with WAP Push messages being sent to the actual device not being recognized as a WAP message and displaying incorrect characters.
  • MMS over MM7, issue related to optional parameters VaspId and VasId (APAR LI73098) Corrects the problem with the optional parameters not taking effect when they are configured through the TWSS Administration Console.
  • ALM over XDMS, issue related to accepting empty string values for Provider Domain property (APAR LI73094) Corrects the problem in Address List Management over XDMS in which the Provider Domain mbean value in the backend configuration was not being set (empty string).
  • ALM over XDMS , functionality related to sending requests to XDMS when security is not enabled at Access Gateway (APAR LI73092) New functionality to enable ALM to send requests to XDMS when security is not enabled at Access Gateway and the ALM Web service is enabled at XDMS. See the required configuration steps below.
  • TPC over SIP, service.config.StatusRetainTime service policy is not being supported (APAR LI73132) Corrects the problem in Third-Party Call over SIP related to the status retain time service policy, where the mbean value is not being overridden by the service policy value.

Fix Pack 001

  • SMS over SMPP, issue related to BASE64 encoded BMP files not being handled by sendSmsLogo operation (APAR LI72968) Corrects the problem related to the sendSmsLogo operation to handle BASE64 encoded BMP files properly.
  • SMS over SMPP, issue related to RTX format not being supported by sendSmsRingTone operation (APAR LI72969) Corrects the problem related to the sendSmsRingTone operation to support messages in RTX format.
  • Issue related to the incorrect policy scope values in python script files (APAR LI73157) Corrects the problem related to the incorrect policy scope values being set in the python script files for the following TWSS services:
    • Address List Management over XDMS
    • Presence over SIP/IMS
    • Terminal Status over SIP/IMS
    • Terminal Status over Parlay
    • Terminal Location over Parlay
    • Terminal Location over MLP
  • MMS over MM7, issue related to the parsing of MM7 XML tags (APAR LI73166) Corrects the problem related to the incorrect parsing of XML tags and attributes received from MMSC.
  • SMS over SMPP, issue related to the MESSAGE ID IS INVALID ERROR response from SMSC (APAR LI73185) Corrects the problem related to the incorrect message ID being set in Deliver SM responses (DELIVER_SM_RESP PDU ) sent to SMSC from TWSS.
  • Address List Management over XDMS, issue related to the extra slash "/" in the group names (APAR LI73225) Corrects the problem related to an extra slash "/" being appended to the group name created when the user=global option is set.
  • Terminal Location over MLP, issue related to the MLP FORMAT_ERROR response from MLP Location Server (APAR LI73230) Corrects the problem related to the incorrect input XML tag and sequence of attributes being sent for the location-based operations.
  • SPM console, issue related to the connectivity problem (APAR LI73232) Corrects the problem related to the user entered Connection Details data (URL, username, password) not being validated against the specified Service Policy Manager runtime. The user will remain on the Connection Details entry page until the connectivity validation completes succesfully.

Interim Fix 005

  • SPM Console, issue related to SPM console times out for large requester group (APAR LI73289) Corrects the problem in the SPM Console when a Requester Group is being selected that contains a large number of requesters (>1500) and the Requester Browse view page receives a timeout before the list of requesters are being returned and displayed.
  • SMS over SMPP, issue related to SMS WS shows DELIVERYIMPOSSIBLE inspite of message being delivered properly (APAR LI73295) Corrects the problem in SMS over SMPP Web Service related to the message status being shown as DELIVERYIMPOSSIBLE, when the MO message uses both TLV and Short message fields.
  • MMS over MM7, issue related to incorrect status update during proper delivery reports (APAR LI73300) Corrects the problem of wrong delivery status being updated in the database, by adding a new database column named MESSAGEID. Refer to the configuration section for details.
  • TL over MLP, Configurable endpoint for callback MO messages (APAR LI73329) New configurable mbean option for the callback endpoint. Provides a configurable option for the callback endpoint URI. Refer to the configuration section for details.
  • SMS over SMPP, issues related to the occurrence of SAXPARSEEXCEPTION when SMSC sends non-English MO message (APAR LI73363) Corrects the problem in SMS over SMPP related to the occurrence of SAXPARSEEXCEPTION when SMSC sends non-English MO messages.
  • WAP Push over SMPP, issue related to sendWAPPushSI operation failure due to the incorrect datacoding option (APAR LI73369) Corrects the problem of incorrect DataCoding option being set in sendWAPPushSI. The option will be set to 0x04 if 8_bit_binary_GSM_23_038_a is selected as DataCoding. Refer to the configuration section for details.
  • SMS over SMPP, issue related to incorrect message status being updated upon receiving MO message (APAR LI73371) Corrects the problem related to the message status is not being updated correctly in the SMS Database when SMSC is using SME DELIVERY ACKNOWLEDGEMENT option.
  • TWSS AG, issue related to SOAP attachments added by custom mediator not received by Web Service client (APAR LI73414) Corrects the problem of SOAP attachments not being received by the Web service client when they are added to a response message by a custom mediator that is part of the response Access Gateway flow.
  • SMS over SMPP, issue related to NULLPointerException being observed while trying to get SmsAttachment referrence (APAR LI73435) Corrects the problem in SMS over SMPP related to NULLPointerException being thrown while trying to get SmsAttachment referrence.
  • MMS over MM7, issue related to the occurrence of NumberFormatException (APAR LI73465) Corrects the problem of parsing the status code which contains spaces and special characters in the submit response, returned by the gateway. Added functionality to check and remove any spaces or special characters in the status code tag of submit response.
  • SPM Console, issue related to SPM console does not return to normal view from portlet help page (APAR LI73477) Corrects the problem in the SPM Console when the portlet help page is being displayed and the user cannot return to the normal view.
  • SMS over SMPP, issue related to incorrect TAG value being sent to SMSC, While using optional parameters (TLVs) (APAR LI73477) Corrects the problem in the SMS over SMPP Web service related to incorrect TAG field in TLVs being sent to SMSC.
  • TWSS ServicePlatform, issue related to ClassCastException being observed while trying to retrieve an array of values (APAR LI73477) Corrects the ClassCastException problem in the class ServicePlatform, while making calls to toArray() method.

Interim Fix 006

  • TWSS AG, Eliminate the requirement of removing Group Resolution mediation primitive in default flows (APAR LI73564) Eliminates the requirement of customizing a default mediation flow to remove (unwire) the Group Resolution mediation primitive from all operations of a given flow in order to not utilize the group resolution functionality. To eliminate the use of Group Resolution for all operations within a given flow module, the Group Resolution endpoint specified in the SCA module properties should be set to blank (cleared)
  • TWSS AG, Content-ID is changed when attachments are added (APAR LI73580) Corrects the problem related to incorrect content-ID being sent to the backend SI from the Access Gateway.
  • ALM over XDMS, Issue related to Malformed Input Exception (APAR LI73679)  Corrects the problem in the python script file of ALM WS, related to Malformed Input Exception being observed while executing this file.
  • TWSS AG, Attachment handler has 3 copies in memory (APAR LI73596) The Access Gateway is enhanced to provide a configuration parameter that enables attachments to be processed without using a database or a scheduler instance to improve performance. By default, the processing behaves as it did previously and utilizes a database (in ATTACHMENT_CONTENTS table). When the new Name Space Binding setting is enabled, the Access Gateway will process attachments in memory and thereby have improved performance. Attachments are propagated to the backend using SOAP requests. Check the Configuration Instructions section for the new name space binding configuration.
  • Parlay Connector, IPAPPFAULTMANAGER.SVCAVAILSTATUSIND() API needs to be supported (APAR LI73563) The Parlay Connector currently supports the IpAppFaultManager interface for receiving fault events. In Parlay 3.x, the service manager unavailability events can be received and processed via the IpAppFaultManager interface. There is no specific interface to handle the service manager availability till Parlay 3.x. This APAR implements the Generic Event Notification interface, namely the IpAppEventNotification interface, to receive generic events from Parlay Gateways. This approach can be used in addressing the service manager failure recovery.
    Note: This APAR supports the handling of service managers whose service IDs remain the same before and after the service failover, or the handling of service IDs of the format serviceID/serviceType. Other kinds of changes in service IDs are not currently supported. The Assignment ID that was returned to the client application before service manager failover may not be valid after a service manager failover.
    This iFix does not support the preservation of the same Assignment ID under failover situations. This current limitation will be addressed in future fixpacks.
  • SMS over SMPP, issue related to using SHORT:<TARGET ADDRESS> (APAR LI73703) Corrects the problem in the SMS over SMPP service in which, When using "short:" schema in a target address while sending SMS, TWSS is sending an incorrect target address to the SMSC.
  • MMS over MM7, issue related to TIMESTAMP tag, DATE format and RECIPIENTS tag For MM7 (APAR LI73694) Corrects the problem in the MMS over MM7 service in which, when using the tags “<TimeStamp>” and “<Recipients>” in “SubmitReq”, TWSS is sending incorrect tags and date format to MMSC.
  • Parlay Connector, issue related to startup exceptions (APAR LI73679) Introduces better exception handling during the service discovery process, during the Parlay Connector startup. The exceptions are thrown because some of the services may not be available when scanning through the subscribed list of services in the Parlay Gateway.
  • MMS over MM7, issue related to SOAP element (APAR LI73679) Corrects the problem in the MMS over MM7 service in which, when using the element “DeliveryReportRsp”, TWSS is an sending incorrect element name as DeliveryReportRes to MMSC.

Interim Fix 007

  • SMS over SMPP, Issue related to updating Global ID in usage records table (APAR LI73762) Corrects the problem in SMS over SMPP service in which the Global ID is always set to 000 in usage records for the stopNotiifcation operation.
  • MMS over MM7, TimerManager and WorkManager exceptions (APAR LI73799) Corrects the problem in the MMS over MM7 service in which TimerManager or WorkManager exceptions are seen during the server startup when the MMS ear is deployed.
  • MMS over MM7 (APAR LI73816) Corrects the following issues in the MMS over MM7 service:

·         Some of the MMSCs need a SOAPAction header tag to indicate the intent of the message. The absence of this header tag results in the failure of MT message delivery. The fix corrects the problem by adding a SOAPAction tag to the MT message.

·         The “start” attribute of the “Content-Type” element was missing angle brackets (< >), which caused the failure of MT message delivery for some of the MMSCs. The fix corrects the problem by adding angle brackets (< >) to the “start” attribute value of the “Content-Type” element.

·         Corrects the problem of “missing transaction id” issue by enhancing the SOAP header parsing of the MO messages.

·         Corrects the issue of handling numbers in the “DeliveryReportReq" when decoration elements like '+.-() ' are sent from MMSC.

  • Terminal Location over MLP, issue related to the MLP protocol version not supported response from MLP Location Server (APAR LI73817) Corrects the problem related to the “ver” attribute not being sent in the input XML tag SVC_INIT.
  • Parlay Connector, Issue related to the detection of a service manager during recovery (APAR LI73869) Corrects the problem of maintaining  specific notations for a Parlay Gateway by introducing a generic implementation that ensures a one-to-one mapping between the service types and the assignment ID, helping in detecting the failures/recovery of a specific service. The code for the maintenance of the Assignment ID, after a service manager failover, has been incorporated.
  • Parlay Connector, Exceptions after shutting down MPCC (APAR LI73869) Introduces better exception handling during multiple service manager failure attempts.
  • Parlay Connector, Issue related to abrupt stopping of the Parlay Connector (APAR LI73869) A NullPointerException was being thrown when the Parlay Connector was abruptly stopped while a gateway handshake was in process.
  • Parlay Connector, Automatic callback refreshes after node failover (APAR LI73869) Corrects the problem in the Parlay Connector wherein, after a node was stopped and brought up in a Parlay Connector cluster, the node was not auto refreshing the callbacks that were already present.
  • Parlay Connector, Issue related to the status display in the Parlay Console (APAR LI73869) Corrects the issue in the Parlay Connector wherein, after one or more Parlay Connector node failovers, the connectivity status was not being displayed properly in the Parlay Administration Console.
  • Parlay Connector, Cutting down excessive Gateway calls (APAR LI73869) Introduces a cache that is used during the Service Discovery process. This cache helps in reducing ORB calls to the gateway.
  • Parlay Connector, Session cleanup doesn’t happen (APAR LI73869) New method in the Parlay Connector mapper layer for helping the Parlay applications clean up session objects.

Interim Fix 008

·         MMS over MM7 (APAR LI73897) provides support to the short code numbers. The short code support is provided to both MO and MT messages of MMS/MM7 SI. All MO and MT operations for short codes can be performed using “short:xxxxx” format. Where “short:” is the schema part which identifies the number as a short code and “xxxxx” is the actual number for example “short:88888”.

·         Parlay Connector, Prevent session cleanup related logging from printing in SystemOut (APAR LI74474). A statement is logged in the SystemOut.log when the session information is missing when a session cleanup is attempted. Now, this statement is displayed only when the trace is enabled. Flooding the SystemOut.log with debug statements is avoided.

·         Parlay Connector, Display Parlay connector build information when Diagnostics is used (APAR LI74474). The Parlay connector code can be shipped as an EAR or bundled along with the Parlay samples toolkit. When packaged with samples, the build date or version is not known. This feature outputs the build date and version information when the Diagnostic button in the Parlay Administration console is used, irrespective of how the Parlay connector code is bundled.

·         Parlay Connector, Providing support for Redundant notification creating during Parlay connector Refresh (APAR LI74474). This fix improves the way the Refresh operation works, by including support for redundant notification creation. This ensures that whenever notifications are refreshed, a secondary callback location is included as well for backup, so that at any point in time the reports are not lost.

·         Parlay Connector, Code for caching Assignment ID information and optimized DB Access (APAR LI74474).  This fix concentrates on the following optimizations.

1.       Service Manager Helper classes (also known as the Managed classes) use a cache for holding information that maps the connector generator ID to the gateway-generated Assignment ID.  The use of this cache nullifies the need to use the database during report flows, thereby speeding the report delivery by several factors. The cache implementation is designed in such a way that it is updated automatically during refreshes or failovers.

2.       The Session Façade design pattern is used for proper transaction boundary demarcation and optimized table data access. The Façade implementation has reduced the time taken to retrieve a record from the table. This Façade implementation is only for the SERVERPROPERTIES table, as this table is accessed much more frequently than the other tables.

·         Third Party Call over SIP to validate the incoming call identifier (APAR LI74156). This fix provides validation of the incoming call identifier. All the operations other than makeCall should have valid call identifier [returned by makeCall] value in the SOAP request.

·         Third Party Call over SIP should return only the call identifier [Parlay X standard] (APARLI74225). This fix removes the additional JSESSIONID returned to the client.  In the End-to-End environment [AG-SP-SI] the fix works in the following way.

1.      For make Call response, this fix removes the additional JSESSIONID cookie from the SOAP response and appends the cookie value to the call identifier to reuse the JSESSIONID value in future.

2.      For other Web service operations, this fix removes the appended JSESSIONID value from the call identifier [step 1] and adds as a cookie to the SOAP request.

Interim Fix 009

·         Parlay Connector, This fix introduces a way to shift the Primary callback locations and monitor the Callback statistics using the SELF_TEST button (APAR LI74493). The Parlay Connector creates redundant callbacks for the Multi Party Call Control (MPCC) Service Capability Feature (SCF). During a Refresh procedure (which happens either when the Refresh button is clicked or during a failover), the primary callback can be shifted to another node/location. Therefore the reports from the Parlay Gateway would be shifted across to another node, in a round robin manner.
The SELF_TEST button on the Parlay Administration Console now displays the statistics related to the callbacks -- for example, the count, the callback location, the Service Manager handling the notification, and so forth.

 

Interim Fix 0010

 

·         Parlay Connector, This fix improves the startup time of the Parlay connector by introducing a property cache (APAR LI74912). This fix attempts to reduce the slowness of the Parlay Console navigation when the Database is setup in a remote machine. For this, a property cache is used which will be referred during the Parlay Connector startup instead of making calls to the Database.

·         Parlay Connector, This fix introduces a way to re-establish the Framework Access Session using the Service Manager Availability event (APAR LI74916). This fix attempts to introduce a mechanism which helps in the recovery of the Parlay connector access session with the Parlay Gateway's Framework. The Service Manager Availability Generic Event is used as a trigger to attempt this access session recovery. Please check the Configuration Instructions section for configuration settings required for this fix.

·         Parlay Connector, This fix introduces a way to propagate Generic Events to all the Managed Objects (APAR LI74941). This fix attempts to introduce a mechanism which propagates Generic Events such as Service Manager Unavailablity, Service Manager Availability to the Managed Objects. Managed Objects are the Parlay Connector and the applications which are subscribed to the Application Manager. This event propagation allows the applications to react to these events.

 

Interim Fix 0011

 

·         Parlay Connector, This fix introduces a timestamp in Parlay Connector to track delays in reports (APAR LI75144). This fix attempts to introduce a timestamp in the Multi Party Call Control (MPCC) reportNotification method to assist in tracking report delivery delays between the Parlay Gateway and the Parlay Connector.

 

Interim Fix 0012

·        Parlay Connector, Recovery problem if a JVM hangs (APAR LI75484). When a JVM hangs within a TWSS cluster, the non-hung JVM within the cluster is not able to process any reportNotifications for a long period of time until a synchronous call to the hung JVM times out. This fix attempts to process the calls by tuning the threadpool associated with the ORB resulting in better dispatch time & increased efficiency.

·        MMS over MM7 SI – Issue related to copying the content-id of one attachment to another attachment that does not have a content-id (APAR LI75493): Such a copy causes duplicate content-ids within the MMS message, resulting in unexpected behavior of the getMessage operation. This APAR corrects the getMessage operation so that all the attachments are received properly.

·        MMS over MM7 SI – Issue related to making applications to conform to ParlayX 2.1 MMS specification & ensure correct usage of the product (APAR LI75488): This APAR has necessary changes to ensure that more than one startMessageNotification can be created for the same service activation number provided the startMessageNotification request contains a unique criteria, correlator, and endpoint.

·        MMS over MM7 SI – Issue related to TWSS responding OK to SendMessage request even if the MMS has been rejected by the MMSC (APAR LI75482): This APAR corrects the problem by ensuring that the database records are updated properly when the MMSC returns a fault response in a submitRes message for the submitReq message. The user has to perform getMessageDeliveryStatus operation in order to know the message status.

Interim Fix 0013

·        MMS over MM7 SI - TWSS sends an invalid Delivery Response for MO MMS message received from MMSC (APAR LI75725): This APAR corrects the problem of identifying the notification for a given address when the address is appended with the MM1/MM4 PLMN address format such as "/TYPE=PLMN"

·        Parlay Connector, Errant pulse during recovery of hung java process (APAR LI75662):This APAR corrects the problem of deregistering the existing heartbeat callbacks of the hung JVM with the Parlay Gateway.

Software compatibility

  • Operating systems:
    • Red Hat Enterprise Linux ® AS 4.0 Update 5
    • SUSE Linux Enterprise Server 9 SP 3
    • AIX ® 5L 5.3 TL 05 SP 6
  • Application server
    • WebSphere Application Server Network Deployment, Version 6.1.0.29
    • WebSphere Application Server Enterprise Service Bus, Version 6.0.2.2
    • iFix IC53828
    • iFix JR27493
    • WebSphere Integration Developer, Version 6.0.2.2
  • Java™
    • JDK, Version 1.5 (included with WebSphere Application Server Network Deployment)
  • Databases
    • IBM DB2 Universal Database™ Version 9.1 FixPak 2
    • Oracle Database Version 10.2.0.2

 

Viewing the Changed File.list in the Update Installer .pak file

Update installer .pak files are delivered in .zip format. To view the contents of a .pak file, use any archiving tool that can read .zip files. The Java jar tool can also extract the files.list file from the .pak file.

To view the contents, type jar -tf fixpack_name.pak

To extract the files.list, type jar -xf fixpack_name.pak repository/twss.svc/files.list

Next, you can use an editor to view the files.list, which lists all of the files to be changed for the .pak file.

Installation requirements

Hardware requirements

Hardware requirements for TWSS are included in the information center and have not changed since version 6.2.0. Refer to the following information for details:

http://publib.boulder.ibm.com/infocenter/wtelecom/v6r2m0/topic/com.ibm.twss.doc/com_prereqs.html

Software requirements

Software requirements for TWSS are included in the information center. Refer to the following information for details:

http://publib.boulder.ibm.com/infocenter/wtelecom/v6r2m0/topic/com.ibm.twss.doc/com_prereqs.html

In addition to the prerequisites listed in the information center, the following maintenance fixes are required:

Installation instructions

Before you begin, ensure that the following service has been applied to the application server for the Access Gateway and Service Platform:

Note: In this section, WAS_ROOT refers to the WebSphere home directory, for example /opt/IBM/WebSphere/AppServer.

To apply the fix pack, complete the following steps:

  1. Verify that the WebSphere Application Server (WAS) version is 6.1.0.29, and that the appropriate iFix or iFixes have been applied.
  2. Verify that the WebSphere Application Server Enterprise Service Bus (ESB) version is 6.0.2.2, and that the appropriate iFix or iFixes have been applied.
  3. If you have an earlier TWSS fix pack that was installed using the Update Installer, uninstall it. The TWSS Update Installer fix packs are cumulative.
  4. Download the WebSphere Update Installer version 6.1.0.13 on both the Access Gateway application servers and the Service Platform application servers. You will use this version of the update installer for both the Access Gateway which is based on WAS 6.0 and the Service Platform which is based on WAS 6.1
  5. Download the IMS UPDI Plugins package 6.2.0.1-WS-WAS-IMS-UPDIPlugins.pak into the WAS_ROOT/updateInstaller/maintenance directory on both the Access Gateway application servers and the Service Platform application servers.
  6. If the IMS UPDI Plugin is already installed on the WAS Update Installer (Note: After applying the IMS Update Installer Plugin, if you have upgraded or installed a new version of the WAS Update Installer (UPDI) itself, then you won’t be able to apply this fix pack. You need to download and run a reset script available on the support download site which will then allow installation of TWSS 6.2.0.1 fixpack. For details see the IMS Update Installer Plugins installation page for fix pack 6.2.0.1: http://www.ibm.com/support/docview.wss?uid=swg24017457
  7. Download the TWSS Update Installer package 6.2.0-WS-WAS-TWSS-AG-IF000013.pak into the WAS_ROOT/updateInstaller/maintenance directory on the Access Gateway servers.
  8. Download the TWSS Update Installer package 6.2.0-WS-WAS-TWSS-SP-IF000013.pak into the WAS_ROOT/updateInstaller/maintenance directory on the Service Platform servers.
  9. Download the TWSS Update Installer package 6.2.0-WS-WAS-TWSS-Services-IF000013.pak into the WAS_ROOT/updateInstaller/maintenance directory on the Service Platform servers.
  10. Start the Update Installer as described in the WebSphere documentation, and select the TWSS fix pack(s) to be installed.
    The UPDI Plugins package should be installed first to each server.
    The 6.2.0-WS-WAS-TWSS-AG-IF000013.pak contains updates to the Access Gateway.
    The 6.2.0-WS-WAS-TWSS-SP-IF000013.pak contains updates to the Service Platform and should be installed before the services.
    The 6.2.0-WS-WAS-TWSS-Services-IF000013.pak contains updates to the TWSS Services.

The Update Installer updates the WAS_ROOT/installableApps/TWSS-Base and WAS_ROOT/installableApps/TWSS-Services directory contents, but does not deploy the updates onto the application server.

  1. Update the component EARs that are deployed on the application server:
    1. Start WebSphere Application Server where the component is installed.
    2. Open the Integrated Solutions Console and log in.
    3. Click Applications > Enterprise Applications and select the appropriate Application EAR.
    4. Click Uninstall.
    5. Follow the instructions in the information center to install the new EARs included in the fix pack. Refer to the following instructions: http://publib.boulder.ibm.com/infocenter/wtelecom/v6r2m0/topic/com.ibm.twss.install.doc/intro_c.html
  2. Review iFix contents for updated database initialization (.ddl) files or policy initialization script (.py) files, and use them to initialize the database or policies according to the instructions in the InfoCenter.

 

Configuration instructions

The configuration for TWSS is the same as that described in the InfoCenter, except as specified in either the TWSS 6.2.0 Readme (WebSphereProductsForTelecomReadme.html) or this Readme.

Attachment Limit Configuration

This iFix defines a default SOAP attachment size limit of 1 MB, requiring that the size of any one attachment or the combination of all attachment parts passed on a Web service request not exceed this limit. This iFix also adds the ability to override the default attachment size limit through the use of name space bindings. There are two name space binding values that can be defined to set the size limit for attachments: one to set the individual size limit for attachment parts and the second to set the overall limit for all attachments.

To change the default SOAP attachment size limit, complete the following steps on the deployment manager and synchronize the changes with all nodes:

  1. Log in to the Integrated Solutions Console.
  2. In the navigation panel, click Environment > Naming > Name Space Bindings.
  3. Select cell_name for the Scope, and click Apply.
  4. To change the default maximum size of an attachment part that can be attached to an inbound message, create a name space binding for the SOAP attachment part maximum size:
    1. Click New.
    2. Click String for the binding type, and click Next.
    3. Type SOAP_attachment_part_max_size for the Binding Identifier.
    4. Type sca/attachments/MaxSizeAttachmentPart for the Name in Name Space.
    5. Type the maximum allowed size of an attachment part for a given message. This is an integer number measured in MBytes (when followed by 'M' or 'm'), or KBytes (when followed by 'K' or 'k'), or bytes (when followed by 'B' or 'b'). The default value used is '1M'.
    6. Click Finish, and click Save to save changes to the master configuration.
  5. To change the default maximum size of all attachment parts that can be attached to an inbound message, create a name space binding for the SOAP attachment maximum size:
    1. Click New.
    2. Click String for the binding type, and click Next.
    3. Type SOAP_attachment_max_size for the Binding Identifier.
    4. Type sca/attachments/MaxSizeAttachments for the Name in Name Space.
    5. Type the maximum allowed size of all attachment parts for a given message. This is an integer number measured in MBytes (when followed by 'M' or 'm'), or KBytes (when followed by 'K' or 'k'), or bytes (when followed by 'B' or 'b'). The default value used is '1M'.
    6. Click Finish, and click Save to save changes to the master configuration.

system_type configuration

In either the SMS or WAP applications for SMPP, use the TWSS Administration Console to locate the Network Mapper configuration page. That page contains an additional configuration setting for the value used in the system_type field of the SMPP Bind Transceiver operation.

reorgchk to optimize DB2 performance

DB2 relies upon calculated values for optimal performance. The database catalog statistics and the physical organization of the data in the tables are used to provide optimal database performance. Catalog statistics should be recomputed periodically as the data in the tables changes. This need is greatest after periods of heavy data modifications (inserts, updates, and deletes) such as during initial population or periodic purge activities. These calculations are CPU intensive and block access to the database while they run. We recommend this maintenance be performed during an appropriate service window.

The DB2 reorgchk command is the simplest way to count and record the statistical details about tables, indexes and columns. There are other more tightly focused techniques that may provide improved results. If you experience poor database performance after completing this command, consult the database administrator and inquire about using other techniques to improve the database performance.

db2 reorgchk update statistics on table all

No J2C activation specification for the MM7 Resource Adapter

When installing the MM7Connector.rar (MM7 Resource Adapter), there is no J2C activation specification associated with that adapter. Therefore, when you use the procedure titled "Installing the JCA adapter for SMPP and MM7-based Web service implementations" in the InfoCenter (http://publib.boulder.ibm.com/infocenter/wtelecom/v6r2m0/topic/com.ibm.twss.install.doc/jca_adapter_t.html), you should skip step 4 when deploying Parlay X Multimedia Messaging over MM7.

Disabling PMI improves performance

The TWSS 6.2.0.0 product readme recommends turning off PMI (Performance Monitoring Interface) in order to avoid a performance problem. There is a more specific method of disabling the specific PMI metrics that cause the performance problem, which allows PMI to be generally used.

  1. In the WAS Administration Console, on the left side, click Monitoring and Tuning > Performance Monitoring Infrastructure (PMI).
  2. Select the correct application server instance. This should be done for each application server instance when in a cluster.
  3. Ensure that Enable PMI is checked.
  4. Click Custom.
  5. On the left side of the customization area, select Web Applications.
  6. Select URIConcurrentRequests, URIServiceTime, and URIRequestCount.
  7. Select Disable.
  8. Save the changes and restart the server.

Performance improvement for DNS lookups

If you experience very slow response from the TWSS Administration Console or Parlay Administration Console, particularly on AIX, this can be due to poor or unpredictable response times from the DNS server. The Java JVM provides a system property com.ibm.cacheLocalHost that can be set to true. This will improve lookups of the localhost IP address. This Java JVM system property should be set in the Process Definition for the Deployment Manager and all Application Server instances.

Additional Configuration for MMS/MM7 service

Additional configuration settings for MM7 optional parameters has been introduced to the MMS Administration Console configuration that enables these MM7 protocol fields to be set appropriately to interoperate with various MMS-C servers. Most notably are the additional settings for VASPID, VASID, Distribution Indicator. See the help provided for these settings in the Administration Console after installing the updated EAR file.

Additional Configuration for Access Gateway and PX Notification when security is disabled at Access Gateway

Using PX Notification when security is disabled at the Access Gateway requires additional configurations such as User Name for PX Notification and the requesterExceptionList in Access Gateway.

To configure the PX Notification properties like User Name:

  1. Log in to the Administration Console that contains the TWSS Service Platform common components.
  2. In the left pane, expand TWSS Administration Console -> Web Services - > Clusters.
  3. Click the cluster name.
  4. In the Web Service Platform pane, click PXNotification.ear.
  5. In the Component Configuration pane, click PXNotification Delivery Web Service.
  6. In the Runtime properties pane enter a User Name and optionally a Password.
  7. Click OK and save the changes.

To configure the requesterExceptionList:

  1. Log in to the Administration Console that contains the TWSS Access Gateway default flow(s).
  2. In the left pane, expand Applications.
  3. Click SCA modules.
  4. In the SCA Modules pane, click one of the installed TWSS Access Gateway default flows.
  5. In the Configuration pane under Additional properties, click Module properties.
  6. Locate the MsgElementRemover.request.requesterExceptionList property. This property is a comma-delimited list of requesters for which the configured message element will not be removed.
  7. Set or add the user name you used to configure the PX Notification Delivery Web Service User Name property.
  8. Click OK and save the changes.

Both changes will become effective after the save is completed. No server restart is needed.

Additional Configuration for ALM over XDMS when security is disabled for Access Gateway

A new service policy, service.config.UserName, is added to the Address List Management over XDMS Web service implementation. The new policy accepts the user name value and needs to be configured at the Service Policy Manager. This configuration enables the Access Gateway and Address List Management systems to run with security off while using the user name (for basic authentication or asserted identity) and passing it to XDMS when security is on at XDMS. When the requester ID is specified, it will take precedence over the user name.

The precedence is Requester ID -> User Name from Service Policy -> UNAUTHENTICATED.

The following topic in the IBM WebSphere XDMS information center provides the required information on creating proper access rights when the value for the service.config.UserName service policy is different from the actual owner of the document.

http://publib.boulder.ibm.com/infocenter/wtelecom/v6r2m0/index.jsp?topic=/com.ibm.xdms.doc/grantingmanyidentitiesreadaccesstoalldocumentsinadirectory.html

Example: User Name service policy value is sip:bob@ibm.com and the actual owner for the document is sip:john@ibm.com. Access rights need to be created for sip:bob@ibm.com to read, write, update, or administer the documents owned by sip:john@ibm.com.

Additional configuration for Message Logger mediation primitive in TWSS Access Gateway

The following technote (IC53621) from WebSphere Application Server ESB provides a workaround when you require triggers or stored procedures with the Message Logger mediation primitive database table on Oracle.

http://www.ibm.com/support/docview.wss?uid=swg1IC53621

Functionality improvement to TWSS common components

This fix addresses the issue related to the XA exception when a TWSS common component (Usage Records, Notification Management or PxNotification ) interacts with the JMS queue or with database tables.

Functionality improvement to SMS over SMPP Failover

New functionality to enable the SMS over SMPP service to recreate binding with the SMSC after the TWSS system restarts.

Functionality improvement to Parlay Connector

New functionality in the Parlay Connector to maintain a unique assignment ID across the cluster even if the assignmentID changes between the managed service manager objects at the Parlay Gateway. This functionality requires the PARLAYDB to be recreated. See the TWSS 6.2 information center for details about creating the database.

Public interface for TWSS Service Platform API

New interface for TWSS Service Platform to ease the creation of custom Web Services using TWSS.

Additional configuration for SMS/SMPP service

A new configuration parameter, Connection re-try interval, has been introduced to the SMS SMPP ENQUIRELINK MBean in TWSS SMS Administration Console configuration. It provides an option to configure the time interval used to trigger the connection bind. It is used for establishing the connection with the SMSC when it has valid notifications at the time of TWSS server start. The default value is 3 minutes. The valid range is 3-60 minutes. See the help provided for these settings in the Administration Console after installing the updated EAR file.

Additional information

The SMS over SMPP and WAP Push over SMPP Web services cannot coexist on the same application server.

Additional Configuration for MMS/MM7 service

Run MmsDataDb2.ddl or MmsDataOra.ddl to update the table MMSSENDDATA with the column MESSAGEID. Verify that a new column with name MESSAGEID is created.

To configure the Destination Element:

  1. Log in to the Administration Console that contains the TWSS Service configuration.
  2. In the left pane, expand TWSS Administration Console -> Web Services - > Clusters.
  3. Click the cluster name.
  4. In the Web Service pane, click IMS Multimedia Messaging.
  5. In the Component Configuration pane, click Multimedia Messaging Web Service.
  6. Under the Destination Element attribute, select the appropriate destination element depending on the DeliveryReportReq from the gateway. This field defines the element to be used to get the destination number. This configuration option is used to switch between the Sender and Recipient element of DeliveryReportReq depending on the MMSC's interpretation of the MM7 spec.
  7. Click OK and save the changes.

Additional Configuration related to callback endpoint for TL/MLP service

The callback endpoint is being used in the StartPeriodicNotification & StartGeographicalNotification operations. The configurable Callback Endpoint provides an option to configure the endpoint to receive MO/notification messages. It is mandatory to configure a callback endpoint before attempting to start the notification operations. Otherwise the system would give a MalformedURLException.

To configure the Callback Endpoint address:

  1. Log in to the Administration Console that contains the TWSS Service configuration.
  2. In the left pane, expand TWSS Administration Console -> Web Services - > Clusters.
  3. Click the cluster name.
  4. In the Web Service pane, click PX21_TL_MLP.
  5. In the Component Configuration pane, click Terminal Location Notification Web Service.
  6. In the Runtime properties pane enter a Callback Endpoint:

This is the callback endpoint URL where the callback server is listening for MO-Notification messages from an MLP location server. Example value: http://HostName:PortNumber/TWSS/ParlayX21/TerminalLocation/MLPCallback/services/MLPCallBack. When a firewall is in place, replace the HostName and PortNumber values with the firewall router's IP address & Portnumber and map the WebSphere Application Server (WAS) deployment manager's IP address and PortNumber with those of the firewall, as routing point. When there is no firewall, replace HostName & PortNumber with the WAS Deployment Manager's IP address and PortNumber.

  1. Click OK and save the changes.

Additional Configuration related to DataCoding for WAPPush/SMPP service

To configure the DataCoding in WAPPushSMPPNetworkAttributeMBean

  1. Log in to the Administration Console that contains the TWSS Service configuration.
  2. In the left pane, expand TWSS Administration Console -> Web Services - > Clusters.
  3. Click the cluster name.
  4. In the Web Service pane, click WAP10_PUSH_SMPP.
  5. In the Component Configuration pane, click WAPPush Backends.
  6. Click on the backend that is configured. On the backend configuration panel, select 8_bit_binary_GSM_23_038_a as the DataCoding value
  7. Click OK and save the changes.

Additional name space binding configuration related to Access Gateway Attachment In Memory processing

The Name Space Binding is: sca/attachments/InMemoryProcessing=TRUE

Note that this setting should be set at the cluster, cell, or node scope, and not at server scope.

 

The Name Space Bindings can be viewed and modified in the Websphere Administration Console at this location:

Environment -> Naming -> Name Space Bindings.

Configuration in Parlay Connector for Automatic Framework Recovery (APAR LI74916)

For Automatic Framework Recovery to work, the Parlay Connector failover property LIVE_FRAMEWORK_FAILOVER must be set to "true". This can be done in the following manner: In the MBean configuration under the following link in the Parlay Administration Console, PX21_Parlay -> Parlay Connector -> Template that is created -> Configuration Tab. Set the dropdown for Live Framework Failover to true.

Uninstall instructions

The TWSS product InstallShield installers provide an uninstaller. However, the uninstaller does not uninstall Update Installer .pak files. To uninstall TWSS components, uninstall any Update Installer packages first. Then use the product InstallShield uninstallers.

Updates, limitations, and known problems

Updates, limitations, and known problems about Telecom Web Services Server are documented in technotes on the IBM Software Support Web site: http://www.ibm.com/software/pervasive/serviceserver/support/

As limitations and problems are discovered and resolved, the IBM Software Support team updates the knowledge base. By searching the knowledge base, you can quickly find workarounds or solutions to problems that you experience. The following link launches a customized query of the live Support knowledge base. To create your own query, go to the Advanced search page.

All technotes for Telecom Web Services Server Version 6.2.0:
http://www.ibm.com/support/search.wss?rs=3075&tc=SS2PVA&dc=DB520+D800+D900+DA900+DA800+DB560&dtm

Trademarks

The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both: IBM, WebSphere, DB2 Universal Database, and AIX

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.