WebSphere RFID Premises Server Version 1.1.0.1 Software Interim Fix - APAR IC50332

© Copyright International Business Machines Corporation 2004, 2006. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Readme file

• Description
  • Update history
  • Supported hardware and software
• Installing the fix

Description

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

This fix can be installed on IBM® WebSphere® RFID Premises Server 1.1.0.1 to correct an issue where tag metadata displays in the wrong administrative console page.

Update history

This update includes the following APAR fixes:

IC50332: Tag metadata displays incorrectly

This APAR includes fixes for the following issues:

• Tag extensions (commonly called tag metadata) were not being saved in the correct table. The tag metadata for individual tags is now saved in the table sage.tagextension.
• If a tag is first read without metadata and then read again with metadata, the metadata was not being saved. The tag metadata (when it exists) is now saved on all reads, not just the first one.
• Tags with more than one metadata pair were not being sent to the Premises Server. Only one metadata pair was sent to the Premises Server. All tag metadata is now sent to the Premises Server for processing.
• The tag event data displayed in the tag history in the WebSphere RFID Premises Server Administrative Console is now configurable using the new premises.properties setting com.ibm.rfid.premises.console.display.last.taghistory. See the installation instructions for additional information.
• The WebSphere RFID Premises Server Administrative Console displays tag read history including metadata. The information displayed for tag metadata and aggregation metadata was confusing to the user. Now, the tag metadata and aggregation metadata are displayed on the same page when using the WebSphere RFID Premises Server Administrative Console to display the metadata for an event. The behavior of the metadata processing is now configurable using the new premises.properties setting com.ibm.rfid.premises.enhanced.tag.extension. See the installation instructions for additional information.
• An exception would occur if the WebSphere RFID Premises Server Administrative Console had no activity for more than the pre-set HttpSession expiration (usually 30 minutes) while displaying a tag's metadata.

Supported hardware and software

This interim fix for WebSphere RFID Premises Server supports the hardware and software versions listed on the system requirements page.

Installing the fix

Use these instructions to install the interim fix on an existing installation of WebSphere RFID Premises Server 1.1.0.1.

1. Unzip the APAR ZIP file, IC50332.zip, included in this fix to a local directory, such as C:\IC50332.
2. Stop WebSphere Application Server and stop the WebSphere RFID Premises Server Services Management Framework (SMF).
3. Run the resetsmf.bat file from the RFID_HOME\RFID\edgecontroller\premises\smf directory.
4. Rename the PremisesBridge+1_1_0.jar file in the RFID_HOME\RFID\edgecontroller\premises\smf\bundlefiles directory to PremisesBridge+1_1_0.jar.bak.
5. Copy the PremisesBridge+1_1_0.jar file from the APAR ZIP file to the RFID_HOME\RFID\edgecontroller\premises\smf\bundlefiles directory.
6. Optional step: Add the following text to the premises.properties file located in RFID_HOME\RFID\premises\properties directory.

###################################################################
#
# Properties for the RFID Premises Server Administrative Console
#
# com.ibm.rfid.premises.console.display.last.taghistory - Directs 
# the RFID Premises Server Administrative Console's Tag page
# to display the tag's last (most recent) tag history.  If this 
# property is not set to true, then the tag's first (earliest) tag 
# history is displayed.
#
# Default = false
###################################################################
com.ibm.rfid.premises.console.display.last.taghistory=true

###################################################################
#
# Properties for tag extensions
#
# com.ibm.rfid.premises.enhanced.tag.extension - Directs 
# the RFID Premises Server to display the aggregation meta data 
# plus the tag meta data whose name begins with PREMISES in the 
# RFID Premises Administrative Console's Tag details page with the 
# tag meta data.  If this property is not set to true, then only the 
# tag extension meta data is displayed on the Tag details page.
#
# Default = false
###################################################################
com.ibm.rfid.premises.enhanced.tag.extension=true

7. Start WebSphere Application Server.
8. Stop the "IBM Premises Event Server" application by navigating to Applications -> Enterprise Applications in the WebSphere Application Server Administrative Console, selecting the checkbox beside "IBM Premises Event Server", and clicking Stop.
9. Stop the "IBM Premises Admin Console" application by selecting the checkbox beside "IBM Premises Admin Console" and clicking Stop.
10. Uninstall the "IBM Premises Event Server" application by selecting the checkbox beside "IBM Premises Event Server" and clicking Uninstall.
11. Uninstall the "IBM Premises Admin Console" application by selecting the checkbox beside "IBM Premises Admin Console" and clicking Uninstall.
12. Save your configuration changes.
13. Install the new "IBM Premises Event Server" application from the IBMPremisesEventServer.ear. To install the application, navigate to Applications -> Install New Application in the WebSphere Application Server Administrative Console. Then browse to the local path of the IBMPremisesEventServer.ear file from the APAR ZIP file. Choose the appropriate installation options for your configuration. Be sure to select the check box for Deploy EJBs and select the correct back-end folder for the database you are using (either DB2 or Oracle).
14. Install the new "IBM Premises Admin Console" application from the IBMPremisesAdminConsole.ear. To install the application, navigate to Applications -> Install New Application in the WebSphere Application Server Administrative Console. Then browse to the local path of the IBMPremisesAdminConsole.ear file from the APAR ZIP file. Choose the appropriate installation options for your configuration. Be sure to select the check box for Deploy EJBs and select the correct back-end folder for the database you are using (either DB2 or Oracle).
15. Navigate to Applications -> Enterprise Applications and click IBM Premises Admin Console.
16. On the bottom of the Configuration tab, in the Additional Properties table, click the Libraries link.
17. On the Library References page, click Add and select Struts 1.1 as the new library name. Then click OK.
18. Save your configuration changes.
19. Start the "IBM Premises Event Server" application by navigating to Applications -> Enterprise Applications in the WebSphere Application Server Administrative Console, selecting the checkbox beside "IBM Premises Event Server", and clicking Start.
20. Start the "IBM Premises Admin Console" application by navigating to Applications -> Enterprise Applications in the WebSphere Application Server Administrative Console, selecting the checkbox beside "IBM Premises Admin Console", and clicking Start.
21. Restart WebSphere Application Server.
22. Restart SMF.
23. Verify that the issues detailed in the Update History section are fixed.

Trademarks

The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:

IBM, WebSphere, and DB2 are trademarks of the IBM Corporation in the United States, other countries, or both.

Microsoft, Internet Explorer, Windows, Windows 2000, Windows 2003, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

Linux is a trademark of Linus Torvalds in the United States, other countries, or both.

Other company, product, and service names may be trademarks or service marks of others.