WebSphere Sensor Events 7.0 | Software Interim Fix | APAR IC80862

• 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:

• IC80862: Ubisense adapter does not contain correct OSGi configuration.

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, IC80862.zip, to the C:\Program Files\IBM\WSE\maintenance directory. The .zip file contains these files:
   • IC80862\bundles\com.ibm.rfid.rtls.adapterframework_7.0.0.0-v201201191113.jar
   • IC80862\ubisense_update\features\com.ibm.rfid.rtls.eventconverter.ubisense.feature_7.0.0.0-v201201191113.jar
   • IC80862\ubisense_update\plugins\com.ibm.rfid.rtls.eventconverter.ubisense_7.0.0.0-v201201191113.jar
   • IC80862\ubisense_update\site.xml
   • IC80862\IC80862-readme.html
   • IC80862\WebSphere_Sensor_Events.IC80862.fxtag
3. Create a folder named backup in the C:\Program Files\IBM\WSE\maintenance\IC80862 directory:
   • Backup the C:\Program Files\IBM\HTTPServer\htdocs\IBM\WSE\bundles\update_sites\ubisense_update\ directory
   • Backup the bundle lists in C:\Program Files\IBM\HTTPServer\htdocs\IBM\WSE\bundles\bundlelists\
4. Delete previous RTLS Configurations:
   1. In the Agent Configuration page, delete the UbisenseRTLSReaderAgent if it has been installed.
5. Install Ubisense Agent:
   1. Navigate to the C:\Program Files\IBM\HTTPServer\htdocs\IBM\WSE\bundles\update_sites\ directory and replace the ubisense_update\ directory with the new version IC80862\ubisense_update\.
   2. Install the Ubisense agent located in the update site into the WSE Administrative Console as described in the Information Center. When installing the Ubisense agent, be sure to install it as a ControllerAgent.
   3. After installing the Ubisense agent, navigate to the Controllers page, click on the 'Ubisense on WSE' configuration page and add the Ubisense agent to the configuration group. Then save the configuration group by clicking 'Update'.
6. Update Data Capture bundles:
   1. Copy the new bundles from IC80862\bundles\ to C:\Program Files\IBM\HTTPServer\htdocs\IBM\WSE\bundles\.
   2. Update all bundle lists in C:\Program Files\IBM\HTTPServer\htdocs\IBM\WSE\bundles\bundlelists\ that use these bundles with the new timestamps of the bundles. This includes rtlsDTS.txt, rtlsRemoteDC.txt, rtls-sim.txt, and rtls-Ubisense.txt.
7. Navigate to the C:\Program Files\IBM\WSE\maintenance\IC80862 and copy the WebSphere_Sensor_Events.IC80862.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, IC80862.zip, to the /opt/IBM/WSE/maintenance directory. The .zip file contains these files:
   • IC80862/bundles/com.ibm.rfid.rtls.adapterframework_7.0.0.0-v201201191113.jar
   • IC80862/ubisense_update/features/com.ibm.rfid.rtls.eventconverter.ubisense.feature_7.0.0.0-v201201191113.jar
   • IC80862/ubisense_update/plugins/com.ibm.rfid.rtls.eventconverter.ubisense_7.0.0.0-v201201191113.jar
   • IC80862/ubisense_update/site.xml
   • IC80862/IC80862-readme.html
   • IC80862/WebSphere_Sensor_Events.IC80862.fxtag
3. Create a folder named backup in the /opt/IBM/WSE/maintenance/IC80862 directory:
   • Backup the /opt/IBM/HTTPServer/htdocs/IBM/WSE/bundles/update_sites/ubisense_update/ directory
   • Backup the bundle lists in /opt/IBM/HTTPServer/htdocs/IBM/WSE/bundles/bundlelists/
4. Delete previous RTLS Configurations:
   1. In the Agent Configuration page, delete the UbisenseRTLSReaderAgent if it has been installed.
5. Install Ubisense Agent:
   1. Navigate to the /opt/IBM/HTTPServer/htdocs/IBM/WSE/bundles/update_sites/ directory and replace the ubisense_update/ directory with the new version IC80862/ubisense_update/.
   2. Install the Ubisense agent located in the update site into the WSE Administrative Console as described in the Information Center. When installing the Ubisense agent, be sure to install it as a ControllerAgent.
   3. After installing the Ubisense agent, navigate to the Controllers page, click on the 'Ubisense on WSE' configuration page and add the Ubisense agent to the configuration group. Then save the configuration group by clicking 'Update'.
6. Update Data Capture bundles:
   1. Copy the new bundles from IC80862/bundles/ to /opt/IBM/HTTPServer/htdocs/IBM/WSE/bundles/.
   2. Update all bundle lists in /opt/IBM/HTTPServer/htdocs/IBM/WSE/bundles/bundlelists/ that use these bundles with the new timestamps of the bundles. This includes rtlsDTS.txt, rtlsRemoteDC.txt, rtls-sim.txt, and rtls-Ubisense.txt.
7. Navigate to the /opt/IBM/WSE/maintenance/IC80862 and copy the WebSphere_Sensor_Events.IC80862.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. Navigate to the C:\Program Files\IBM\HTTPServer\htdocs\IBM\WSE\bundles\bundlelists directory and restore backups for all modified bundle lists.
2. Navigate to the C:\Program Files\IBM\HTTPServer\htdocs\IBM\WSE\bundles\update_sites\ubisense_update\ directory and restore the backup ubisense_update\ directory.
3. In the Agent Configuration page, delete the UbisenseRTLSReaderAgent if it has been installed.
4. Re-create the Ubisense agent with the origional ubisense_update using the same method as install step 5.
5. Delete the WebSphere_Sensor_Events.IC80862.fxtag file from the C:\Program Files\IBM\WSE\properties\version directory.
6. Restart WebSphere Application Server.

Uninstallation procedure for Linux and AIX operating systems

1. Navigate to the /opt/IBM/HTTPServer/htdocs/IBM/WSE/bundles/bundlelists directory and restore backups for all modified bundle lists.
2. Navigate to the /opt/IBM/HTTPServer/htdocs/IBM/WSE/bundles/update_sites/ubisense_update/ directory and restore the backup ubisense_update/ directory.
3. In the Agent Configuration page, delete the UbisenseRTLSReaderAgent if it has been installed.
4. Re-create the Ubisense agent with the origional ubisense_update using the same method as install step 5.
5. Delete the WebSphere_Sensor_Events.IC80862.fxtag file from the /opt/IBM/WSE/properties/version directory.
6. 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 2012. All Rights Reserved. Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.