WebSphere Sensor Events 6.2 | Software Interim Fix | APAR IC72076
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:
- IC72076: Tags are sending false low battery alerts.
Prerequisites
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.
- It is assumed that Location Aware Services is already installed.
Installation
This issue is resolved in the Sonitor adapter.
The Sonitor adapter can be run in the WSE/LAS server, or in conjunction with an external adapter.
Server-Side Installation
- Create a folder named maintenance in the WebSphere Sensor Events server C:\Program Files\IBM\RFID directory.
- Unpack the .zip file, IC72076.zip, to the C:\Program Files\IBM\RFID\maintenance directory. The .zip file contains these files:
- IC72076\AtlasEventConverter.jar
- IC72076\LasIbmseEventModel.jar
- IC72076\LASLowLevelEventProcessing.jar
- IC72076\LASSonitorAdapter.jar
- IC72076\AtlasDataAccessLayer.jar
- IC72076\PremisesLasAdapterFramework.jar
- IC72076\registerSonitorAdapter.bat
- IC72076\addSystemProperty.bat
- IC72076\LASGenericSocketAdapterConfigurationForSonitor.properties
- IC72076\LASGenericSocketAdapterForSonitor.bat
- IC72076\IC72076-readme.html
- IC72076\WebSphere_Sensor_Events_LAS.IC72076.fxtag
- Create a folder named backup in the C:\Program Files\IBM\RFID\maintenance\IC72076 directory.
- Navigate to the C:\Program Files\IBM\WebSphere\AppServer\lib\ext\ directory and copy the AtlasEventConverter.jar file to the C:\Program Files\IBM\RFID\maintenance\IC72076\backup directory.
- Navigate to the C:\Program Files\IBM\WebSphere\AppServer\lib\ext\ directory and copy the LasIbmseEventModel.jar file to the C:\Program Files\IBM\RFID\maintenance\IC72076\backup directory.
- Navigate to the C:\Program Files\IBM\WebSphere\AppServer\lib\ext\ directory and copy the LASLowLevelEventProcessing.jar file to the C:\Program Files\IBM\RFID\maintenance\IC72076\backup directory.
- Navigate to the C:\Program Files\IBM\WebSphere\AppServer\lib\ext\ directory and copy the AtlasDataAccessLayer.jar file to the C:\Program Files\IBM\RFID\maintenance\IC72076\backup directory.
- Navigate to the C:\Program Files\IBM\RFID\maintenance\IC72076 directory and copy the following files to C:\Program Files\IBM\WebSphere\AppServer\lib\ext:
- AtlasEventConverter.jar
- LasIbmseEventModel.jar
- LASLowLevelEventProcessing.jar
- AtlasDataAccessLayer.jar
- LASSonitorAdapter.jar
- Navigate to the C:\Program Files\IBM\RFID\premises\client\AdapterFramework\jars\ directory and copy the PremisesLasAdapterFramework.jar file to the C:\Program Files\IBM\RFID\maintenance\IC72076\backup directory.
- Navigate to the C:\Program Files\IBM\RFID\maintenance\IC72076 directory and copy the following files to C:\Program Files\IBM\RFID\premises\client\AdapterFramework\jars\:
- PremisesLasAdapterFramework.jar
- Register the new adapter by opening a DB2 command line on the machine hosting the WSE/LAS database and running the registerSonitorAdapter.bat job.
- Register the new system property by opening a DB2 command line on the machine hosting the WSE/LAS database and running the addSystemProperty.bat job.
- Stop and restart the WebSphere Application Server.
- Navigate to the C:\Program Files\IBM\RFID\maintenance\IC72076 and copy the WebSphere_Sensor_Events_LAS.IC72076.fxtag file to the C:\Program Files\IBM\RFID\properties\version directory.
External Adapter Installation
- Create a folder named maintenance in the WebSphere Sensor Events server C:\Program Files\IBM\RFID directory.
- Unpack the .zip file, IC72076.zip, to the C:\Program Files\IBM\RFID\maintenance directory. The .zip file contains these files:
- IC72076\AtlasEventConverter.jar
- IC72076\LasIbmseEventModel.jar
- IC72076\LASLowLevelEventProcessing.jar
- IC72076\LASSonitorAdapter.jar
- IC72076\AtlasDataAccessLayer.jar
- IC72076\PremisesLasAdapterFramework.jar
- IC72076\addSystemProperty.bat
- IC72076\registerSonitorAdapter.bat
- IC72076\LASGenericSocketAdapterConfigurationForSonitor.properties
- IC72076\LASGenericSocketAdapterForSonitor.bat
- IC72076\IC72076-readme.html
- IC72076\WebSphere_Sensor_Events_LAS.IC72076.fxtag
- Create a folder named backup in the C:\Program Files\IBM\RFID\maintenance\IC72076 directory.
- Navigate to the C:\Program Files\IBM\RFID\premises\client\AdapterFramework\jars\ directory and copy the AtlasEventConverter.jar file to the C:\Program Files\IBM\RFID\maintenance\IC72076\backup directory.
- Navigate to the C:\Program Files\IBM\RFID\premises\client\AdapterFramework\jars\ directory and copy the LasIbmseEventModel.jar file to the C:\Program Files\IBM\RFID\maintenance\IC72076\backup directory.
- Navigate to the C:\Program Files\IBM\RFID\premises\client\AdapterFramework\jars\ directory and copy the LASLowLevelEventProcessing.jar file to the C:\Program Files\IBM\RFID\maintenance\IC72076\backup directory.
- Navigate to the C:\Program Files\IBM\RFID\premises\client\AdapterFramework\jars\ directory and copy the PremisesLasAdapterFramework.jar file to the C:\Program Files\IBM\RFID\maintenance\IC72076\backup directory.
- Navigate to the C:\Program Files\IBM\RFID\maintenance\IC72076 directory and copy the following files to C:\Program Files\IBM\RFID\premises\client\AdapterFramework\jars:
- AtlasEventConverter.jar
- LasIbmseEventModel.jar
- LASLowLevelEventProcessing.jar
- LASSonitorAdapter.jar
- PremisesLasAdapterFramework.jar
- Create a new subdirectory C:\LAS\SonitorAdapter
- Navigate to the C:\Program Files\IBM\RFID\maintenance\IC72076 directory and copy the following files to C:\LAS\SonitorAdapter:
- LASGenericSocketAdapterConfigurationForSonitor.properties
- LASGenericSocketAdapterForSonitor.bat
- Navigate to the C:\Program Files\IBM\WebSphere\AppServer\lib\ext\ directory and copy the AtlasDataAccessLayer.jar file to the C:\Program Files\IBM\RFID\maintenance\IC72076\backup directory.
- Navigate to the C:\Program Files\IBM\RFID\maintenance\IC72076 directory and copy the following files to C:\Program Files\IBM\WebSphere\AppServer\lib\ext:
- Register the new adapter by opening a DB2 command line on the machine hosting the WSE/LAS database and running the registerSonitorAdapter.bat job.
- Register the new system property by opening a DB2 command line on the machine hosting the WSE/LAS database and running the addSystemProperty.bat job.
- 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\SonitorAdapter to that machine. The CLASSPATH settings in LASGenericSocketAdapterForSonitor.bat have to be adjusted for this.
- Navigate to the C:\Program Files\IBM\RFID\maintenance\IC72076 and copy the WebSphere_Sensor_Events_LAS.IC72076.fxtag file to the C:\Program Files\IBM\RFID\properties\version directory.
Adapter Customization
To communicate with a Sonitor 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:
- Connectivity type must be Socket Gateway or LAS Socket
- Parameter must be 'IPAddress=IP address;Port=43210;' where IP address is the IP address of the machine hosting the Sonitor system
Input Event Conversion:
- Implementation Name must be 'Sonitor'
- Parameter should be preferrably set to 'coordinatesBased=TRUE;usedCoordinates=LAS;processExtendedData=true;'
External Adapter
Connectivity:
- Connectivity type must be JMS Gateway
- Parameter must be 'IPAddress=IP address;Port=port no.;' where IP address is the IP address of the machine hosting the adapter and port no. is the port number configured in adapter (see below)
Properties File
External adapters need a properties file containing their parameters.
See LASGenericSocketAdapterConfigurationForSonitor.properties for an example.
In the properties file's Any additional adapter specific parameters section, the following entries have to be made:
- socketAdapterUseUDP = false
- socketAdapterIPAddress = IP address // IP address of the machine hosting the Sonitor system
- socketAdapterPort = 43210
- socketBinaryData = false
- socketAdapterBufferSize = 0
- The value of controllerID must match the ID of the corresponding event provider definition (which is found in the portlet)
- The value of commandsListenerPort must match port no. in the event provider definition
If the sample properties file is used, additional settings need to be changed to point to the machine hosting WSE/LAS:
- wsHost (and, possibly, wsPort)
- jmsHost (and, possibly, jmsPort)
LAS Configuration
With the settings above, additional LAS configuration steps have to be performed.
Basically, all Sonitor detectors have to be modeled as LAS devices. This is done through the Topology ---> Devices portlet of the LAS console.
For each device definition:
- Hub has to be set to the previously defined event provider definition
- ID must be the detecttor's IP address-the detector's channel no., (e.g. 192.168.0.175-3)
- Type must be Reader
- Device Location must be Static Location
- X0, Y-, Z- Coordinate have to be the detector's coordinates in the LAS SMC
Uninstallation
Uninstallation procedure for Microsoft Windows operating systems
- Navigate to the C:\Program Files\IBM\RFID\maintenance\IC72076\backup directory and copy the AtlasEventConverter.jar file to all previously updated directories.
- Navigate to the C:\Program Files\IBM\RFID\maintenance\IC72076\backup directory and copy the LasIbmseEventModel.jar file to all previously updated directories.
- Navigate to the C:\Program Files\IBM\RFID\maintenance\IC72076\backup directory and copy the LASLowLevelEventProcessing.jar file to all previously updated directories.
- Navigate to the C:\Program Files\IBM\RFID\maintenance\IC72076\backup directory and copy the AtlasDataAccessLayer.jar file to all previously updated directories.
- Navigate to the C:\Program Files\IBM\RFID\maintenance\IC72076\backup directory and copy the PremisesLasAdapterFramework.jar file to all previously updated directories.
- Navigate to the C:\Program Files\IBM\RFID\properties\version directory and delete the WebSphere_Sensor_Events_LAS.IC72076.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 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.