WebSphere® Sensor Events 6.2 | Software Interim Fix | APAR IC67546
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:
- IC67546: WBE fails when fields contain a namespace prefix.
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® 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
- Create a folder named maintenance in the WebSphere Sensor Events server C:\Program Files\IBM\RFID directory.
- Extract the .zip file, IC67546.zip, to the C:\Program Files\IBM\RFID\maintenance directory. The .zip file contains these files:
- IC67546\IBM_WSE_RUC.ear
- IC67546\IBM_WSE_RUC_BackendImpl.ear
- IC66576\ibmse_taskagent_runtime.jar
- IC67546\IC67546-readme.html
- IC67546\WebSphere_Sensor_Events.IC67546.fxtag
- Create a folder named backup in the C:\Program Files\IBM\RFID\maintenance\IC67546 directory.
- Back up the existing IBM_WSE_RUC.ear and IBM_WSE_RUC_BackendImpl.ear files to the C:\Program Files\IBM\RFID\maintenance\IC67546\backup directory as described in the technote,
Updating EAR files for WebSphere Sensor Events.
- Navigate to the C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\PremisesNodeCell\IBM_WSE_Admin_Console.ear
directory and copy the ibmse_taskagent_runtime.jar file to the C:\Program Files\IBM\RFID\maintenance\IC67546\backup directory.
- Apply this update to IBM_WSE_RUC.ear and IBM_WSE_RUC_BackendImpl.ear as described in the technote,
Updating EAR files for WebSphere Sensor Events.
- Navigate to the C:\Program Files\IBM\RFID\maintenance\IC67546 directory and copy the ibmse_taskagent_runtime.jar file to these locations:
- C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\PremisesNodeCell\IBM_WSE_ALE_Application.ear\ibmse_taskagent_runtime.jar
- C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\PremisesNodeCell\IBM_WSE_Container_Tracking.ear\ibmse_taskagent_runtime.jar
- C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\PremisesNodeCell\IBM_WSE_Diagnostics.ear\ibmse_taskagent_runtime.jar
- C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\PremisesNodeCell\IBM_WSE_DockDoor_Receiving.ear\ibmse_taskagent_runtime.jar
- C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\PremisesNodeCell\IBM_WSE_Engine.ear\ibmse_taskagent_runtime.jar
- C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\PremisesNodeCell\IBM_WSE_EPCIS_Connector.ear\ibmse_taskagent_runtime.jar
- C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\PremisesNodeCell\IBM_WSE_Event_Monitor.ear\ibmse_taskagent_runtime.jar
- C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\PremisesNodeCell\IBM_WSE_Gateway.ear\ibmse_taskagent_runtime.jar
- C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\PremisesNodeCell\IBM_WSE_Server.ear\ibmse_taskagent_runtime.jar
- Navigate to the C:\Program Files\IBM\RFID\maintenance\IC67546 and copy the WebSphere_Sensor_Events.IC67546.fxtag file to the C:\Program Files\IBM\RFID\properties\version directory.
Installation procedure for Linux operating systems
- Create a folder named maintenance in the WebSphere Sensor Events server /opt/IBM/RFID directory.
- Extract the .zip file, IC67546.zip, to the /opt/IBM/RFID/maintenance directory. The .zip file contains these files:
- IC67546/IBM_WSE_RUC.ear
- IC67546/IBM_WSE_RUC_BackendImpl.ear
- IC66576/ibmse_taskagent_runtime.jar
- IC67546/IC67546-readme.html
- IC67546/WebSphere_Sensor_Events.IC67546.fxtag
- Create a folder named backup in the /opt/IBM/RFID/maintenance/IC67546 directory.
- Back up the existing IBM_WSE_RUC.ear and IBM_WSE_RUC_BackendImpl.ear files to the /opt/IBM/RFID/maintenance/IC67546/backup directory as described in the technote,
Updating EAR files for WebSphere Sensor Events.
- Navigate to the /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/PremisesNodeCell/IBM_WSE_Admin_Console.ear
directory and copy the ibmse_taskagent_runtime.jar file to the /opt/IBM/RFID/maintenance/IC67546/backup directory.
- Apply this update to IBM_WSE_RUC.ear and IBM_WSE_RUC_BackendImpl.ear as described in the technote,
Updating EAR files for WebSphere Sensor Events.
- Navigate to the C:\Program Files\IBM\RFID\maintenance\IC67546 directory and copy the ibmse_taskagent_runtime.jar file to these locations:
- /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/PremisesNodeCell/IBM_WSE_ALE_Application.ear/ibmse_taskagent_runtime.jar
- /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/PremisesNodeCell/IBM_WSE_Container_Tracking.ear/ibmse_taskagent_runtime.jar
- /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/PremisesNodeCell/IBM_WSE_Diagnostics.ear/ibmse_taskagent_runtime.jar
- /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/PremisesNodeCell/IBM_WSE_DockDoor_Receiving.ear/ibmse_taskagent_runtime.jar
- /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/PremisesNodeCell/IBM_WSE_Engine.ear/ibmse_taskagent_runtime.jar
- /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/PremisesNodeCell/IBM_WSE_EPCIS_Connector.ear/ibmse_taskagent_runtime.jar
- /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/PremisesNodeCell/IBM_WSE_Event_Monitor.ear/ibmse_taskagent_runtime.jar
- /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/PremisesNodeCell/IBM_WSE_Gateway.ear/ibmse_taskagent_runtime.jar
- /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/PremisesNodeCell/IBM_WSE_Server.ear/ibmse_taskagent_runtime.jar
- Navigate to the /opt/IBM/RFID/maintenance/IC67546 and copy the WebSphere_Sensor_Events.IC67546.fxtag file to the /opt/IBM/RFID/properties/version directory.
Installation procedure for WebSphere Sensor Events Toolkit
- Follow the instructions to install the toolkit and add the projects to a workspace.
- Create a folder named maintenance in the RFID directory of the IBM project.
- Extract the .zip file, IC67546.zip, to the \IBM\RFID\maintenance directory. The .zip file contains these files:
- IC67546\IBM_WSE_RUC.ear
- IC67546\IBM_WSE_RUC_BackendImpl.ear
- IC66576\ibmse_taskagent_runtime.jar
- IC67546\IC67546-readme.html
- IC67546\WebSphere_Sensor_Events.IC67546.fxtag
- Create a folder named backup in the \IBM\RFID\maintenance\IC67546 directory.
- Navigate to the \IBM\RFID\maintenance\IC67546 directory and copy the WebSphere_Sensor_Events.IC67546.fxtag file
to directory \IBM\RFID\properties\version.
- Follow the installation instructions for the Windows operating systems to install this fix in all WebSphere Application Server profiles
used by the toolkit.
Configuration
Update the WBE RUC properties
- The problem was resolved by adding a new property to the WBEAgent called wbe.usernamepace. This property needs to be set to the namespace definition. For example:
- wbe.usernamespace = xmlns:hbs="http://www.ibm.com/testing"
With the property set in this way the packet header for a passive tag read going to WBE will look like this:
- <?xml version="1.0" encoding="UTF-8" ?><connector xmlns="http://wbe.ibm.com/6.2/Event/WSE_PassiveRFIDTagRead" xmlns:hbs="http://www.ibm.com/testing" name="WebSphere Sensor Events Server" version="6.2">
- If a user has multiple names the wbe.usernamespace property can be defined as an array. For example:
- wbe.usernamespace.0 = xmlns:hbs="http://www.ibm.com/testing" and wbe.usernamespace.1 = xmlns:hbp="http://www.ibm.com/testing2"
This will produce a header like this:
- <?xml version="1.0" encoding="UTF-8" ?><connector xmlns="http://wbe.ibm.com/6.2/Event/WSE_PassiveRFIDTagRead" xmlns:hbs="http://www.ibmcom/testing" xmlns:hbp="http://www.testing.com/testing1" name="WebSphere Sensor Events Server" version="6.2">
Uninstallation
Uninstallation procedure for Microsoft Windows operating systems
- Reinstall the backup IBM_WSE_RUC.ear and IBM_WSE_RUC_BackendImpl.ear files as described in the technote,
Updating EAR files for WebSphere Sensor Events.
- Navigate to the C:\Program Files\IBM\RFID\maintenance\IC67546\backup directory and copy the ibmse_taskagent_runtime.jar file to all previously updated directories.
- Delete the WebSphere_Sensor_Events.IC67546.fxtag file from the C:\Program Files\IBM\RFID\properties\version directory.
- Restart WebSphere Application Server.
Uninstallation procedure for Linux operating systems
- Reinstall the backup IBM_WSE_RUC.ear and IBM_WSE_RUC_BackendImpl.ear files as described in the technote,
Updating EAR files for WebSphere Sensor Events.
- Navigate to the /opt/IBM/RFID/maintenance/IC67546/backup directory and copy the ibmse_taskagent_runtime.jar file to all previously updated directories.
- Delete the WebSphere_Sensor_Events.IC67546.fxtag file from the /opt/IBM/RFID/properties/version directory.
- Restart WebSphere Application Server.
Uninstallation procedure for WebSphere Sensor Event Toolkit
- Navigate to the \IBM\RFID\properties\version directory and delete the WebSphere_Sensor_Events.IC67546.fxtag file.
- Follow the uninstallation instructions for the Windows operating systems to uninstall this fix from all WebSphere Application server profiles
used by the toolkit.
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.