WebSphere Sensor Events 7.0 | Software Interim Fix | APAR IC79587

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

• IC79587: Unable to install IBM Real-Time Asset Locator and use APIs if Maximo security is enabled.

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.
• It is assumed that WebSphere Sensor Events interim fix - IC78286 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.
• It is assumed that WebSphere Sensor Events interim fix - IC78286 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, IC79587.zip, to the C:\Program Files\IBM\WSE\maintenance directory. The .zip file contains these files:
   • IC79587\IBM_WSE_Runtime.ear
   • IC79587\wseClient.jar
   • IC79587/DB/updateCurrentTags_db2.sql
   • IC79587/DB/updateCurrentTags_oracle.sql
   • IC79587/DB/uninstall/updateCurrentTags_db2.sql
   • IC79587/DB/uninstall/updateCurrentTags_oracle.sql
   • IC79587\IC79587-readme.html
   • IC79587\WebSphere_Sensor_Events.IC79587.fxtag
3. Create a folder named backup in the C:\Program Files\IBM\WSE\maintenance\IC79587 directory.
4. Back up the existing IBM_WSE_Runtime.ear to the C:\Program Files\IBM\WSE\maintenance\IC79587\backup directory as described in the technote, Updating EAR files for WebSphere Sensor Events.
5. Apply this update to IBM_WSE_Runtime.ear as described in the technote, Updating EAR files for WebSphere Sensor Events.
6. If using Maximo security, create a new J2C authentication alias in WAS:
   • Log on to WAS Admin Console
   • Navigate to Servers -> Server Types -> WebSphere Application Servers and click on server1.
   • Under Security click on Security Domain.
   • Expand Java Authentication and Authorization Service and click on J2C Authentication Data.
   • Create a new alias and enter the Maximo user name and password to authenticate to Maximo.
7. If using Maximo security, define two new properties in the WSE System Agent:
   • Log on to WSE Admin Console
   • Navigate to Data Capture Configuration -> Agent Configuration
   • Edit the SystemAgent
   • Click Add Property
   • Set the following values (Two properties):
     • Property 1 name: com.ibm.se.maximo.use.auth
     • Property 1 value: true
     • Property 1 description: set to true if using Maximo authentication
     • Property 2 name: com.ibm.se.maximo.user.alias
     • Property 2 value: the name of the J2C authentication alias in WAS
     • Property 2 description: the name of the J2C authentication alias in WAS
   • Click Save
8. Update Database
   The zip file contains the files: IC79587\DB\updateCurrentTags_db2.sql
   IC79587\DB\updateCurrentTags_oracle.sql
   IC79587\DB\uninstall\updateCurrentTags_db2.sql
   IC79587\DB\uninstall\updateCurrentTags_oracle.sql
9. Stop WAS.On a DB2 machine, log in as the database administrator, connect to the IBMSE database in a DB2 command shell, and run the IC79587\DB\updateCurrentTags_db2.sql script (i.e. 'db2 -tvf updateCurrentTags_db2.sql'). On an Oracle machine, log into SQLPLUS, connect to the IBMSE database, and run the IC79587\DB\updateCurrentTags_oracle.sql script.
10. Stop the WSE server.
11. Navigate to the C:\Program Files\IBM\WSE\lib directory and copy the wseClient.jar file to the C:\Program Files\IBM\WSE\maintenance\IC79587\backup directory.
12. Navigate to the /opt/IBM/WSE/maintenance/IC79587 directory and copy the wseClient.jar file to /opt/IBM/WSE/lib
13. Start the WSE server.
14. Navigate to the C:\Program Files\IBM\WSE\maintenance\IC79587 and copy the WebSphere_Sensor_Events.IC79587.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, IC79587.zip, to the /opt/IBM/WSE/maintenance directory. The .zip file contains these files:
   • IC79587/IBM_WSE_Runtime.ear
   • IC79587/wseClient.jar
   • IC79587/DB/updateCurrentTags_db2.sql
   • IC79587/DB/updateCurrentTags_oracle.sql
   • IC79587/DB/uninstall/updateCurrentTags_db2.sql
   • IC79587/DB/uninstall/updateCurrentTags_oracle.sql
   • IC79587/IC79587-readme.html
   • IC79587/WebSphere_Sensor_Events.IC79587.fxtag
3. Create a folder named backup in the /opt/IBM/WSE/maintenance/IC79587 directory.
4. Back up the existing IBM_WSE_Runtime.ear to the /opt/IBM/WSE/maintenance/IC79587/backup directory as described in the technote, Updating EAR files for WebSphere Sensor Events.
5. Apply this update to IBM_WSE_Runtime.ear as described in the technote, Updating EAR files for WebSphere Sensor Events.
6. If using Maximo security, create a new J2C authentication alias in WAS:
   • Log on to WAS Admin Console
   • Navigate to Servers -> Server Types -> WebSphere Application Servers and click on server1.
   • Under Security click on Security Domain.
   • Expand Java Authentication and Authorization Service and click on J2C Authentication Data.
   • Create a new alias and enter the Maximo user name and password to authenticate to Maximo.
7. If using Maximo security, define two new properties in the WSE System Agent:
   • Log on to WSE Admin Console
   • Navigate to Data Capture Configuration -> Agent Configuration
   • Edit the SystemAgent
   • Click Add Property
   • Set the following values (Two properties):
     • Property 1 name: com.ibm.se.maximo.use.auth
     • Property 1 value: true
     • Property 1 description: set to true if using Maximo authentication
     • Property 2 name: com.ibm.se.maximo.user.alias
     • Property 2 value: the name of the J2C authentication alias in WAS
     • Property 2 description: the name of the J2C authentication alias in WAS
   • Click Save
8. Update Database
   The zip file contains the files: IC79587\DB\updateCurrentTags_db2.sql
   IC79587\DB\updateCurrentTags_oracle.sql
   IC79587\DB\uninstall\updateCurrentTags_db2.sql
   IC79587\DB\uninstall\updateCurrentTags_oracle.sql
9. Stop WAS.On a DB2 machine, log in as the database administrator, connect to the IBMSE database in a DB2 command shell, and run the IC79587\DB\updateCurrentTags_db2.sql script (i.e. 'db2 -tvf updateCurrentTags_db2.sql'). On an Oracle machine, log into SQLPLUS, connect to the IBMSE database, and run the IC79587\DB\updateCurrentTags_oracle.sql script.
10. Stop the WSE server.
11. Navigate to the /opt/IBM/WSE/lib directory and copy the wseClient.jar file to the /opt/IBM/WSE/maintenance/IC79587/backup directory.
12. Navigate to the /opt/IBM/WSE/maintenance/IC79587 directory and copy the wseClient.jar file to /opt/IBM/WSE/lib
13. Start the WSE server.
14. Navigate to the /opt/IBM/WSE/maintenance/IC79587 and copy the WebSphere_Sensor_Events.IC79587.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. Reinstall the backup IBM_WSE_Runtime.ear files as described in the technote, Updating EAR files for WebSphere Sensor Events.
2. Copy the backup wseClient.jar file to C:\Program Files\IBM\WSE\lib
3. Undo the configuration changes made in the WSE and WAS admin consoles
4. Delete the WebSphere_Sensor_Events.IC79587.fxtag file from the C:\Program Files\IBM\WSE\properties\version directory.
5. Restart WebSphere Application Server.

Uninstallation procedure for Linux and AIX operating systems

1. Reinstall the backup IBM_WSE_Runtime.ear files as described in the technote, Updating EAR files for WebSphere Sensor Events.
2. Copy the backup wseClient.jar file to /opt/IBM/WSE/lib
3. Undo the configuration changes made in the WSE and WAS admin consoles
4. Delete the WebSphere_Sensor_Events.IC79587.fxtag file from the /opt/IBM/WSE/properties/version directory.
5. Restart WebSphere Application Server.
6. Stop WAS.On a DB2 machine, log in as the database administrator, connect to the IBMSE database in a DB2 command shell, and run the IC79587\DB\uninstall\updateCurrentTags_db2.sql script (i.e. 'db2 -tvf updateCurrentTags_db2.sql'). On an Oracle machine, log into SQLPLUS, connect to the IBMSE database, and run the IC79587\DB\uninstall\updateCurrentTags_oracle.sql script.

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 2011. All Rights Reserved. Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.