IBM WebSphere Presence Server Component, Version 6.1.0.1 Readme

© Copyright International Business Machines Corporation 2006. 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
• Getting started
• Updates, limitations, and known problems
• Trademarks

About this fix pack

This fix pack contains fixes and minor improvements for the IBM® WebSphere® Presence Server, Version 6.1.0 release.

Fix and update history

This fix pack includes fixes for the following APARs:

APAR LI71415 (includes fixes for multiple issues):

• When an external registrar sends an invalid NOTIFY message with 2 identical contact URIs, Presence Server now returns 400 error and an IllegalArgumentException exception instead of the incorrect 500 error.
  
• When WebSphere Presence Server receives group information notifications from Group List Server, it attempts to send notifications to the client that subscribed to the group. If the subscription from the client was cancelled or has expired, Presence Server continues to attempt to send the notifications. Therefore, an illegal state exception is returned.
  
• The Presence Server might generate a PIDF document with non-unique tuple ids that is based on the tuple ids that were published for a certain presentity. This issue was fixed by omitting all the older tuples that have non-unique ids.
  
• The Presence Server aggregation of presence document might not complete successfully if the aggregation process started from a presence document that did not contain the "tuple" element. This issue was fixed.
  
• When Presence Server attempts to subscribe to a group that does not exist in the Group List Server:
  • Only the first user who subscribes to a group that does not exist receives the Notify. Subsequent users subscribing to that same group do not receive the Notify.
  • The subsequent users receive a notification (NOTIFY) for the unsubscribe request, but the notification is not empty.
    

APAR LI71436:

• When multiple entries for the same tuple-id are entered in the PUBLISH table, the NOTIFY message will include concatenated presence information. As a result, the Presence Server generates an illegal presence document (PIDF format) with non-unique tuple-ids. To correct this problem for a given tuple-id, the Presence Server will generate a presence document which includes only the latest tuple published.
  
  For example, if there are two documents and document one was published at 12:00 with tuple-id X, and document two was published at 12:10 with tuple-id X, only the data from the last tuple is included in the presence document generated by the Presence Server.
  

Software compatibility

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

Installation requirements

Hardware requirements

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

http://publib.boulder.ibm.com/infocenter/wtelecom/v6r1/topic/com.ibm.presence.doc/com_prereqs.html

Software requirements

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

http://publib.boulder.ibm.com/infocenter/wtelecom/v6r1/topic/com.ibm.presence.doc/com_prereqs.html

In addition to the software listed in the information center, the following fix pack is required for WebSphere Application Server:

• WebSphere Application Server Fix Pack 6.1.0.2

Installation instructions

Before you begin:

• You must log in to the operating system as the actual root user in a UNIX environment.
• You must 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. Copy the file IBM_WebSphere_Presence_Server_6.1.0.1.tar.gz to a temporary location.
2. Extract the file you copied in step one. After extracting this file you will get a directory IBM_WebSphere_Presence_Server_6.1.0.1 with two sub-folders: Database_Setup and Server_application.
3. Copy the file WebSpherePresenceServerEAR.ear (from Server_application sub-folder) to was_root/installableApps/, where was_root is the directory where WebSphere Application Server is installed.

   Setting up Database: Due to changes in the Presence database tables, you will need to drop the old tables and create new ones.

4. Follow the instructions as they are listed in the information center at the following link:
   http://publib.boulder.ibm.com/infocenter/wtelecom/v6r1/topic/com.ibm.presence.install.doc/clus_cfg_db_c.html
   • When following the information Center instructions, use DropAndCreateDB2Tables.ddl or DropAndCreateOracleTables.ddl (depend on your DB provider).
   
   
5. If you have used a custom configuration, you will need to restore the configuration file in the Presence database. Follow the instructions as listed in the information center at the following link:
   http://publib.boulder.ibm.com/infocenter/wtelecom/v6r1/topic/com.ibm.presence.config.doc/intro_c.html
   
   

   Deploying Presence Server application:

6. Start WebSphere Application Server.
7. Logon to the Integrated Solutions Console.
8. Click Applications > Enterprise Applications.
9. Select the checkbox for the PresenceServer app, and click Update.
10. Click Browse to find the EAR on the local file system.
11. Select the file was_root/installableApps/WebSpherePresenceServerEAR.ear, and then Next.
12. Select the Cluster (defined for the presence server), and then Apply and Next.
13. Click Next on the following screens, and then Finish in the summary screen.

Updates, limitations, and known problems

Updates, limitations, and known problems about Presence Server are documented in technotes on the IBM Software Support Web site:

http://www-306.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 Presence Server Version 6.1.0:

http://www-1.ibm.com/support/search.wss?rs=3074&lang=en&loc=en_US&r=10&cs=utf-8&rankfile=0&cc=&spc=&stc=&apar=include&q1=6.1.*&sort=desc&tc=SS2PTT&dc=DB520+D800+D900+DA900+DA800&dtm

Trademarks

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

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.