IBM WebSphere IP Multimedia Connector Component, Version 6.2.0.1 Readme

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

Contents

About this fix pack

This fix pack addresses four issues that have been discovered in the IMS Connector Version 6.2.  It includes a fix to the IMS Security TAI (Trust Association Interceptor) to allow for a Superadmin principal.  It includes a fix to IMS Security TAI where unauthenticated users where not being handled correctly by TAI HTTP interceptor.  It resolves a problem where in issuing notifications to Diameter events, an exception could cause some of those notifications to be lost.  Finally, it adds performance enhancements to the Ro and Sh Notification Web Services by updating the methods to be asynchronous requests.

Fix and update history

This fix pack includes APAR LI73027.

APAR LI73027 includes the following fixes:

  • TAI SIP Interceptor has been fixed to prevent an incomplete URI in header p-asserted-identity of a request from getting modified. For example, the asserted identity sip:domain is added to the principal as sip:null@domain in the previous release. With this fix, the principal maintains the original sip:domain identity which allows the creation of an identity such as sip:superadmin without having to specify both a user and a domain.
  • The fix pack addresses a problem within the Sh Web Service application where one failed notification causes subsequent notifications in the same batch of notifications to fail.  This scenario arises when a single PNR Diameter packet results in notification to multiple endpoints and one of those endpoints is unresponsive. 
  • The fix pack also addresses a performance and reliability problem where the Ro and Sh Web Service applications synchronously block until they receive a response.  In this scenario, the performance of the Ro and Sh Web Services is tightly coupled with the service and availability of the respective Notification Web Services.  To loosen this coupling and improve performance, the Ro and Sh Notification WSDLs have been updated to support one-way asynchronous notification requests.  In the Ro Notify Service, the updated method is sendCCReAuth.  In the Sh Notify Service, the updated methods are notifySCSCFNameChange, notifyUserDataChange, notifyIMSUserStateChange, notifyInitialFilterCriteriaChange, and notifyPSIActivationChange.
  • TAI HTTP Interceptor has been fixed to properly handle requests that do not contain an asserted identity or a “From” field in the headers.  Those requests were being rejected in the previous release even if the configuration option “handleUnauthenticatedUser” was set to the value “true”.  With this fix, such requests are properly handled by creating a principal with the value stored in the configuration option “unauthenticatedPrincipal” if “handleUnauthenticatedUser” is set to “true”.

Software compatibility

  • Operating Systems
    • Red Hat Enterprise Linux® AS 4.0 Update 4
    • SUSE Linux Enterprise Server 9 SP 3
  • Application Server
    • WebSphere® Application Server Network Deployment, Version 6.1.0.11
  • Java ™
    • JDK ™, Version 1.5 (included with WebSphere Application Server Network Deployment, Version 6.1.0.11)
  • Databases
    • IBM DB2 Universal Database™ Version 8.2 FixPak 4
    • Oracle Database Version 10.2.0.1

 

Installation requirements

Hardware requirements

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

Software requirements

Software requirements for IMS Connector are included in the information center, and they have not changed since version 6.2.0. Refer to the following information for details:

http://www.ibm.com/software/pervasive/multisubcon/sysreqs/

Installation instructions

Before you begin, ensure that:

  • Fix Pack 11 for WebSphere Application Server (WAS) 6.1.0.11 has been applied to the server where the IP Multimedia Subsystem (IMS) Connector has been installed.
  • IMS Connector 6.2.0.0 has been installed.
  • Update Installer 6.1 is already installed on the application server.
  • The IMS Update Installer 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 this fix pack (IP Multimedia Connector Component, Version 6.2.0.1. 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
  • You are logged in to the operating system as the actual root user in a UNIX® environment.
  • You log in with the same root user authority level when unpacking a fix, fix pack, or refresh pack.

To apply the fix pack, complete the following steps:

  1. If you are updating a cluster, you must perform this step on every node within cluster.  Download the IMS Connector update installer package 6.2.0-WS-WAS-IMS-Connector-FP000001.pak into the was_root/updateInstaller/maintenance directory.
  2. Start the update installer as described by WebSphere and select the IMS Connector fix pack to be installed. The update installer will update the was_root/lib/ext directory with the DHAIMSConnectorTAI.jar. It will also update the was_root/installableApps directory with the DHADiameterShWebServiceEAR.ear and DHADiameterRoWebServiceEAR.ear files.
  3. This step is needed only if you have been using the Sh subscribe and Notification feature. Update the Sh Web Service implementation:
    1. Start WebSphere Application Server 6.1 where the IMS Connector is installed.
    2. Open the Integrated Solutions Console and log in.
    3. Click Applications->Enterprise Applications.
    4. Select the checkbox for the DHADiameterShWebServiceEAR application and click Update.
    5. Click Browse to find the EAR on the local file system.
    6. Select the file was_root/installableApps/DHADiameterShWebServiceEAR.ear.
    7. Click Next on the following screens, and click Finish in the summary screen.
    8. Save the changes.
  4. This step is needed only if you have been using the Ro subscribe and Notification feature. Update the Ro Web Service implementation:
    1. Start WebSphere Application Server 6.1 where the IMS Connector is installed.
    2. Open the Integrated Solutions Console and log in.
    3. Click Applications->Enterprise Applications.
    4. Select the checkbox for the DHADiameterRoWebServiceEAR application and click Update.
    5. Click Browse to find the EAR on the local file system.
    6. Select the file was_root/installableApps/DHADiameterRoWebServiceEAR.ear.
    7. Click Next on the following screens, and click Finish in the summary screen.
    8. Save the changes.
  5. Update the Sh and Ro Notification Web Service implementations:
    1. Use the wsdl2java program to generate the new Web Service skeletons and java proxies from the DiameterRoNotifiyService.wsdl and DiameterShNotifyService.wsdl.
  6. To update the TAI, you must shut down and restart the deployment manager and all nodes in the cluster.  The TAI has already been placed in the proper directory by the Update Installer, and the updates will be picked on server restart.

Updates, limitations, and known problems

Updates, limitations, and known problems about IMS Connector V6.2 are documented in technotes on the IBM Software Support Web site: http://www.ibm.com/software/pervasive/multisubcon/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. Each of the following links launches a customized query of the live Support knowledge base. To create your own query, go to the Advanced search page.

All technotes for IMS Connector Version 6.2.0.1:
http://www.ibm.com/support/search.wss?word=aw&wfield=&nw=&apar=include&tc=SS2P3U&tc1=SSC2P38&atrn=SWVersion&atrv=6.1.0.2&atrn1=&atrv1=&atrwcs=on&lang=all&dr=all&r=10&cc=us&from=advs&loc=en_US&rs=3073&cs=utf-8&Submit.x=45&Submit.y=17

Trademarks

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

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.

UNIX is a registered trademark of The Open Group in the United States and other countries.

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