WebSphere Sensor Events 7.0 | Software Interim Fix | APAR IC71891

• About this readme file
• Included in this interim fix
• Prerequisites
• Installation
• Uninstallation
• Trademarks

About this readme file

This readme provides information about the patch available in this interim fix.

This fix can be installed on WebSphere Sensor Events 7.0.

Included in this interim fix

The following reported program defects are fixed in this update:

• IC71891: Multiple fixes related to Real-Time Location Services events and the Asset Visibility Client.

Prerequisites

Prerequisites for Microsoft Windows^® operating systems

• You must have Administrator access to update the WebSphere Sensor Events server.
• It is assumed that the WebSphere Sensor Events server is already installed.

Prerequisites for Linux^® and AIX^® operating systems

• You must have root access to update the WebSphere Sensor Events server.
• It is assumed that the WebSphere Sensor Events server is already installed.

Installation

Installation procedure for Microsoft Windows operating systems

1. Create a folder named maintenance in the WebSphere Sensor Events server C:\Program Files\IBM\WSE directory.
2. Unpack the .zip file, IC71891.zip, to the C:\Program Files\IBM\WSE\maintenance directory. The .zip file contains these files:
   • IC71891\DC\com.ibm.rfid.rtls.adapterframework_7.0.0.0-v201009071514.jar
   • IC71891\DC\sonitor_update.zip
   • IC71891\DC\ubisense_update.zip
   • IC71891\IBM_WSE_Admin_Console.ear
   • IC71891\IBM_WSE_Engine.ear
   • IC71891\IBM_WSE_RTAL_Client.ear
   • IC71891\IBM_WSE_Runtime.ear
   • IC71891\rtls_augmentation_task_agent.xml
   • IC71891\WSE70WBELocationProject.xml
   • IC71891\wseClient.jar
   • IC71891\IC71891-readme.html
   • IC71891\WebSphere_Sensor_Events.IC71891.fxtag
3. Create a folder named backup in the C:\Program Files\IBM\WSE\maintenance\IC71891 directory.
4. Back up the existing IBM_WSE_Admin_Console.ear, IBM_WSE_Engine.ear, IBM_WSE_RTAL_Client.ear, and IBM_WSE_Runtime.ear to the C:\Program Files\IBM\WSE\maintenance\IC71891\backup directory as described in the technote, Updating EAR files for WebSphere Sensor Events.
5. Apply this update to IBM_WSE_Admin_Console.ear, IBM_WSE_Engine.ear, IBM_WSE_RTAL_Client.ear, and IBM_WSE_Runtime.ear as described in the technote, Updating EAR files for WebSphere Sensor Events.
6. Create a new activation specification for event augmentation:
   • Log on to WAS Admin Console
   • Navigate to Resources -> JMS -> Activation Specifications
   • Set the Scope to Node=WSENode, Server=server1 if it is not already.
   • Click New
   • Select Default messaging provider
   • Set the following values for the new configuration:
     • Name: ibmse.rtls.event.augmentation
     • JNDI: eis/ibmse.rtls.event.augmentation.as
     • Destination Type: Topic
     • Destination JNDI Name: jms/ibmse
     • Message Selector: ibmse ='off'
     • Bus Name: ibmsensorevent
   • Click OK
   • Click Save
7. Stop the WSE server.
8. Navigate to the C:\Program Files\IBM\WSE\lib directory and copy the wseClinet.jar file to the C:\Program Files\IBM\WSE\maintenance\IC71891\backup directory.
9. Navigate to the C:\Program Files\IBM\WSE\maintenance\IC71891 directory and copy the wseClinet.jar file to C:\Program Files\IBM\WSE\lib
10. Start the WSE server.
11. Import Real-Time Location Services Augmentation Task Agent XML config:
    • Log on to WSE administrative console
    • Navigate to Data Capture Configuration -> Import Configuration
    • Click Choose File and select C:\Program Files\IBM\WSE\maintenance\IC71891\rtls_augmentation_task_agent.xml
    • Click Import
12. Update Data Capture:
    • Navigate to the C:\Program Files\IBM\WSE\maintenance\IC71891\DC directory and copy the com.ibm.rfid.rtls.adapterframework_7.0.0.0-v201009071514.jar file to C:\Program Files\IBM\HTTPServer\htdocs\IBM\WSE\bundles
    • Navigate to the C:\Program Files\IBM\HTTPServer\htdocs\IBM\WSE\bundles\bundlelists directory and update bundle list rtlsDTS.txt with new bundle com.ibm.rfid.rtls.adapterframework_7.0.0.0-v201009071514.jar.
    • Navigate to the C:\Program Files\IBM\WSE\maintenance\IC71891\DC directory and unzip sonitor_update.zip and ubisense_update.zip to C:\Program Files\IBM\HTTPServer\htdocs\IBM\WSE\bundles\update_sites
13. Navigate to the C:\Program Files\IBM\WSE\maintenance\IC71891 and copy the WebSphere_Sensor_Events.IC71891.fxtag file to the C:\Program Files\IBM\WSE\properties\version directory.

Installation procedure for Linux and AIX operating systems

1. Create a folder named maintenance in the WebSphere Sensor Events server /opt/IBM/WSE directory.
2. Unpack the .zip file, IC71891.zip, to the /opt/IBM/WSE/maintenance directory. The .zip file contains these files:
   • IC71891/DC/com.ibm.rfid.rtls.adapterframework_7.0.0.0-v201009071514.jar
   • IC71891/DC/sonitor_update.zip
   • IC71891/DC/ubisense_update.zip
   • IC71891/IBM_WSE_Admin_Console.ear
   • IC71891/IBM_WSE_Engine.ear
   • IC71891/IBM_WSE_RTAL_Client.ear
   • IC71891/IBM_WSE_Runtime.ear
   • IC71891/rtls_augmentation_task_agent.xml
   • IC71891/WSE70WBELocationProject.xml
   • IC71891/wseClient.jar
   • IC71891/IC71891-readme.html
   • IC71891/WebSphere_Sensor_Events.IC71891.fxtag
3. Create a folder named backup in the /opt/IBM/WSE/maintenance/IC71891 directory.
4. Back up the existing IBM_WSE_Admin_Console.ear, IBM_WSE_Engine.ear, IBM_WSE_RTAL_Client.ear, and IBM_WSE_Runtime.ear to the /opt/IBM/WSE/maintenance/IC71891/backup directory as described in the technote, Updating EAR files for WebSphere Sensor Events.
5. Apply this update to IBM_WSE_Admin_Console.ear, IBM_WSE_Engine.ear, IBM_WSE_RTAL_Client.ear, and IBM_WSE_Runtime.ear as described in the technote, Updating EAR files for WebSphere Sensor Events.
6. Create a new activation specification for event augmentation:
   • Log on to WAS Admin Console
   • Navigate to Resources -> JMS -> Activation Specifications
   • Set the Scope to Node=WSENode, Server=server1 if it is not already.
   • Click New
   • Select Default messaging provider
   • Set the following values for the new configuration:
     • Name: ibmse.rtls.event.augmentation
     • JNDI: eis/ibmse.rtls.event.augmentation.as
     • Destination Type: Topic
     • Destination JNDI Name: jms/ibmse
     • Message Selector: ibmse ='off'
     • Bus Name: ibmsensorevent
   • Click OK
   • Click Save
7. Stop the WSE server.
8. Navigate to the /opt/IBM/WSE/lib directory and copy the wseClinet.jar file to the /opt/IBM/WSE/maintenance/IC71891/backup directory.
9. Navigate to the /opt/IBM/WSE/maintenance/IC71891 directory and copy the wseClinet.jar file to /opt/IBM/WSE/lib
10. Start the WSE server.
11. Import Real-Time Location Services Augmentation Task Agent XML config:
    • Log on to WSE administrative console
    • Navigate to Data Capture Configuration -> Import Configuration
    • Click Choose File and select /opt/IBM/WSE/maintenance/IC71891/rtls_augmentation_task_agent.xml
    • Click Import
12. Update Data Capture:
    • Navigate to the /opt/IBM/WSE/maintenance/IC71891/DC directory and copy the com.ibm.rfid.rtls.adapterframework_7.0.0.0-v201009071514.jar file to /opt/IBM/HTTPServer/htdocs/IBM/WSE/bundles
    • Navigate to the /opt/IBM/HTTPServer/htdocs/IBM/WSE/bundles/bundlelists directory and update bundle list rtlsDTS.txt with new bundle com.ibm.rfid.rtls.adapterframework_7.0.0.0-v201009071514.jar.
    • Navigate to the /opt/IBM/WSE/maintenance/IC71891/DC directory and unzip sonitor_update.zip and ubisense_update.zip to /opt/IBM/HTTPServer/htdocs/IBM/WSE/bundles/update_sites
13. Navigate to the /opt/IBM/WSE/maintenance/IC71891 and copy the WebSphere_Sensor_Events.IC71891.fxtag file to the /opt/IBM/WSE/properties/version directory.

Installation procedure for WebSphere Sensor Events Toolkit

1. Follow the Windows install instructions above.

Uninstallation

Uninstallation procedure for Microsoft Windows operating systems

1. Reinstall the backup IBM_WSE_Admin_Console.ear, IBM_WSE_Engine.ear, IBM_WSE_RTAL_Client.ear, and IBM_WSE_Runtime.ear files as described in the technote, Updating EAR files for WebSphere Sensor Events.
2. Copy the backup wseClinet.jar file to C:\Program Files\IBM\WSE\lib
3. Navigate to the C:\Program Files\IBM\HTTPServer\htdocs\IBM\WSE\bundles\bundlelists directory and update bundle list rtlsDTS.txt to remove the com.ibm.rfid.rtls.adapterframework_7.0.0.0-v201009071514.jar bundle.
4. Delete the WebSphere_Sensor_Events.IC71891.fxtag file from the C:\Program Files\IBM\WSE\properties\version directory.
5. Restart WebSphere Application Server.

Uninstallation procedure for Linux and AIX operating systems

1. Reinstall the backup IBM_WSE_Admin_Console.ear, IBM_WSE_Engine.ear, IBM_WSE_RTAL_Client.ear, and IBM_WSE_Runtime.ear files as described in the technote, Updating EAR files for WebSphere Sensor Events.
2. Copy the backup wseClinet.jar file to /opt/IBM/WSE/lib
3. Navigate to the /opt/IBM/HTTPServer/htdocs/IBM/WSE/bundles/bundlelists directory and update bundle list rtlsDTS.txt to remove the com.ibm.rfid.rtls.adapterframework_7.0.0.0-v201009071514.jar bundle.
4. Delete the WebSphere_Sensor_Events.IC71891.fxtag file from the /opt/IBM/WSE/properties/version directory.
5. Restart WebSphere Application Server.

Uninstallation procedure for WebSphere Sensor Event Toolkit

1. Follow the Windows uninstall instructions above.

Trademarks

IBM and WebSphere are registered trademarks of International Business Machines Corporation in the United States, other countries, or both.

© Copyright IBM Corporation 2010. All Rights Reserved. Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.