WebSphere Sensor Events 6.2 | Software Interim Fix | APAR IC63725


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 6.2.


Included in this interim fix

The following reported program defects are fixed in this update:


Prerequisites

Microsoft Windows® operating systems


Installation

The Ubisense adapter can be run in the WSE/LAS server, or in conjunction with an external adapter.

Server-Side Installation

  1. Create a folder named maintenance in the WebSphere Sensor Events server C:\Program Files\IBM\RFID directory.
  2. Unpack the .zip file, IC63725.zip, to the C:\Program Files\IBM\RFID\maintenance directory. The .zip file contains these files:
  3. Create a folder named backup in the C:\Program Files\IBM\RFID\maintenance\IC63725 directory.
  4. Navigate to the C:\Program Files\IBM\WebSphere\AppServer\lib\ext\AtlasEventConverter.jar directory and copy the AtlasEventConverter.jar file to the C:\Program Files\IBM\RFID\maintenance\IC63725\backup directory.
  5. Navigate to the C:\Program Files\IBM\WebSphere\AppServer\lib\ext\LasIbmseEventModel.jar directory and copy the LasIbmseEventModel.jar file to the C:\Program Files\IBM\RFID\maintenance\IC63725\backup directory.
  6. Navigate to the C:\Program Files\IBM\WebSphere\AppServer\lib\ext\LASLowLevelEventProcessing.jar directory and copy the LASLowLevelEventProcessing.jar file to the C:\Program Files\IBM\RFID\maintenance\IC63725\backup directory.
  7. Navigate to the C:\Program Files\IBM\RFID\maintenance\IC63725 directory and copy the following files to C:\Program Files\IBM\WebSphere\AppServer\lib\ext:
  8. Register the new adapter by opening a DB2 command line on the machine hosting the WSE/LAS database and running the registerUbisenseAdapter.bat job.
  9. Stop and restart the WebSphere Application Server.
  10. Navigate to the C:\Program Files\IBM\RFID\maintenance\IC63725 and copy the WebSphere_Sensor_Events.IC63725.fxtag file to the C:\Program Files\IBM\RFID\properties\version directory.

External Adapter Installation

  1. Create a folder named maintenance in the WebSphere Sensor Events server C:\Program Files\IBM\RFID directory.
  2. Unpack the .zip file, IC63725.zip, to the C:\Program Files\IBM\RFID\maintenance directory. The .zip file contains these files:
  3. Create a folder named backup in the C:\Program Files\IBM\RFID\maintenance\IC63725 directory.
  4. Navigate to the C:\Program Files\IBM\RFID\premises\client\AdapterFramework\jars\AtlasEventConverter.jar directory and copy the AtlasEventConverter.jar file to the C:\Program Files\IBM\RFID\maintenance\IC63725\backup directory.
  5. Navigate to the C:\Program Files\IBM\RFID\premises\client\AdapterFramework\jars\LasIbmseEventModel.jar directory and copy the LasIbmseEventModel.jar file to the C:\Program Files\IBM\RFID\maintenance\IC63725\backup directory.
  6. Navigate to the C:\Program Files\IBM\RFID\premises\client\AdapterFramework\jars\LASLowLevelEventProcessing.jar directory and copy the LASLowLevelEventProcessing.jar file to the C:\Program Files\IBM\RFID\maintenance\IC63725\backup directory.
  7. Navigate to the C:\Program Files\IBM\RFID\maintenance\IC63725 directory and copy the following files to C:\Program Files\IBM\RFID\premises\client\AdapterFramework\jars:
  8. Create a new subdirectory C:\LAS\UbisenseAdapter
  9. Navigate to the C:\Program Files\IBM\RFID\maintenance\IC63725 directory and copy the following files to C:\LAS\UbisenseAdapter:
  10. To run the adapter on another machine, copy the content of the directories C:\Program Files\IBM\RFID\premises\client\AdapterFramework\jars and C:\LAS\UbisenseAdapter to that machine. The CLASSPATH settings in LASGenericSocketAdapterForUbisense.bat have to be adjusted for this.
  11. Navigate to the C:\Program Files\IBM\RFID\maintenance\IC63725 and copy the WebSphere_Sensor_Events.IC63725.fxtag file to the C:\Program Files\IBM\RFID\properties\version directory.

Adapter Customization

To communicate with a Ubisense system via the newly installed adapter, a new LAS Event Provider has to be defined. This is done via the LAS Console (LAS server IP address:9060/ibm/console), after navigating to Topology ---> Event Provider.

Server-Side Adapter

  • Connectivity:
  • Input Event Conversion:
  • External Adapter

  • Connectivity:
  • Properties File

    External adapters need a properties file containing their parameters.

    See LASGenericSocketAdapterConfigurationForUbisense.properties for an example.

  • In the properties file's Any additional adapter specific parameters section, the following entries have to be made:
  • If the sample properties file is used, additional settings need to be changed to point to the machine hosting WSE/LAS:

  • Adapter Configuration

    By default, the Ubisense Location Engine sends its location events to the Ubisense Location Platform (including Ubisense's visualization tool).

    Ubisense Configuration

  • To run Ubisense with LAS, these events have to be redirected:
  • When the server is re-booted, Ubisense switches back to its default settings. So, these steps need to be repeated each time.


    Uninstallation

    Uninstallation procedure for Microsoft Windows operating systems

    1. Navigate to the C:\Program Files\IBM\RFID\maintenance\IC63725\backup directory and copy the AtlasEventConverter.jar file to all previously updated directories.
    2. Navigate to the C:\Program Files\IBM\RFID\maintenance\IC63725\backup directory and copy the LasIbmseEventModel.jar file to all previously updated directories.
    3. Navigate to the C:\Program Files\IBM\RFID\maintenance\IC63725\backup directory and copy the LASLowLevelEventProcessing.jar file to all previously updated directories.
    4. Navigate to the C:\Program Files\IBM\RFID\properties\version directory and delete the WebSphere_Sensor_Events.IC63725.fxtag file.

    Trademarks

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

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