© Copyright International Business Machines Corporation 2007. 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
  • Fix and update history
  • Software compatibility
• Installation requirements
  • Hardware requirements
  • Software requirements
• Installation instructions
• Uninstall instructions
• Updates, limitations, and known problems
• Trademarks

About this fix pack

This interim fix is a cumulative fix which includes the previous fix pack contents for the IBM® WebSphere® Telecom Web Services Server (TWSS), Version 6.1.1.1. This interim fix is recommended for all customers with a TWSS 6.1.1 installation.

This fix pack 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. See the previous fix pack readme for details of the problems fixed in that fix pack. For fixes related to Parlay or SMPP Services, look for the latest iFix or fix pack covering that content.

• Service Policy Manager exception during validateRequester: (APAR LI72397) Corrects a problem when the EnableNewRequesters policy is set to true, and the SPM tries to validate a requester.
  
• enableInProcessConnections interferes with HTTP session: (APAR LI72402) Corrects a problem when enableInProcessConnections is enabled and HTTP session affinity is needed.
  
  

Software compatibility

• Operating Systems:
  • Red Hat Enterprise Linux ® AS 4.0 Update 4
  • SUSE Linux Enterprise Server 9 SP 3
  • AIX ® 5.3 SP 5300-04-01
• Application Server
  • WebSphere Application Server Network Deployment, Version 6.1.0.3
  • iFix PK31203
  • iFix PK35193
• Java™
  • JDK, Version 1.5 (included with WebSphere Application Server Network Deployment, Version 6.1.0.3)
• Databases
  • IBM DB2 Universal Database™ Version 8.2 FixPak 4
  • Oracle Database Version 10.2.0

Installation requirements

Hardware requirements

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

http://publib.boulder.ibm.com/infocenter/wtelecom/v6r1/index.jsp?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/v6r1/index.jsp?topic=/com.ibm.twss.doc/com_prereqs.html

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

WebSphere Application Server Version 6.1.0.3 must be applied to the base WebSphere Application Server for the Service Implementations. The fix pack can be retrieved from the following link: http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24013772

Additionally, the WebSphere Application Server iFix PK31203 is also required, and provides a fix to the SIP Proxy. The fix is located at http://www-1.ibm.com/support/docview.wss?uid=swg24014163

The WebSphere Application Server iFix PK35193 is also required, and provides a fix to a memory leak. The fix is located at http://www-1.ibm.com/support/docview.wss?uid=swg24014591

Installation instructions

Before you begin, ensure that the following service has been applied to the application server where the Service Implementations are installed:

• Fix Pack 3 (WebSphere Application Server Version 6.1.0.3)
• iFix IFPK31203
• iFix IFPK35193

To apply the fix pack, complete the following steps:

1. Verify that WebSphere Application Server version is 6.1.0.3, and that the appropriate iFix or iFixes have been applied.
2. 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.
3. If you need a fix to a Parlay- or SMPP-based service, look for the latest iFix or fix pack that covers that content.
4. Download the TWSS Update Installer package 6.1.1-WS-WAS-TWSS-SP-IF000003.pak into the WAS_HOME/updateInstaller/maintenance directory.
5. Download the TWSS Update Installer package 6.1.1-WS-WAS-TWSS-IMSServices-IF000003.pak into the WAS_HOME/updateInstaller/maintenance directory.
6. Download the TWSS Update Installer package 6.1.1-WS-WAS-TWSS-AG-IF000003.pak into the WAS_HOME/updateInstaller/maintenance directory.
7. Start the Update Installer as described in the WebSphere documentation, and select the TWSS fix pack(s) to be installed.
   6.1.1-WS-WAS-TWSS-SP-IF000003.pak contains updates to the Service Platform and must be installed first.
   6.1.1-WS-WAS-TWSS-AG-IF000003.pak contains updates to the Access Gateway and must be installed on a separate cluster from the Service Platform.
   6.1.1-WS-WAS-TWSS-IMSServices-IF000003.pak contains updates to the IMS Services.

   Install 6.1.1-WS-WAS-TWSS-SP-IF000003.pak first, followed by 6.1.1-WS-WAS-TWSS-IMSServices-IF000003.pak.

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

8. Update the component EARs that are deployed on the application server:
   
   1. Start the 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:
      • Installing the Service Policy Manager component: http://publib.boulder.ibm.com/infocenter/wtelecom/v6r1/topic/com.ibm.twss.install.doc/spm_c.html
      • Installing Access Gateway components: http://publib.boulder.ibm.com/infocenter/wtelecom/v6r1/topic/com.ibm.twss.install.doc/esb_c.html
      • Installing Common components: http://publib.boulder.ibm.com/infocenter/wtelecom/v6r1/topic/com.ibm.twss.install.doc/cc_c.html
      • Installing SIP Services: http://publib.boulder.ibm.com/infocenter/wtelecom/v6r1/topic/com.ibm.twss.install.doc/deploy_services_c.html

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-306.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. 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 Telecom Web Services Server Version 6.1.1.1:
http://www-1.ibm.com/support/search.wss?word=aw&wfield=&nw=&apar=include&tc=SS2PVA&atrn=SWVersion&atrv=6.1.1.1&atrn1=&atrv1=&atrwcs=on&lang=all&dr=all&r=10&cc=us&from=advs&loc=en_US&rs=3075&cs=utf-8&Submit.x=39&Submit.y=16

WebSphere HTTP Proxy does not route Web Service Requests

The WebSphere Proxy Server does not route Web Services requests in a cluster. An HTTP 500 internal error may result along with a NullPointerException when this problem occurs. There are two possible workarounds for this problem:

• Add an empty SOAP header in this manner: <?xml version="1.0" encoding="UTF-8"?> <soapenv:Envelope xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <soapenv:Header /> <soapenv:Body> <p756:makeCallResponse xmlns:p756="http://www.csapi.org/schema/parlayx/third_party_call/v2_3/local"> <p756:result>wsaixlab56.1171559563921.3_1</p756:result> </p756:makeCallResponse> </soapenv:Body> </soapenv:Envelope>
• Use the HTTP Web Server Plugin instead of the WebSphere Proxy Server.

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.