April 8, 2014

ClassCast exception when launching BIRT reports

Recently I went through a problem running BIRT reports from Maximo. Every time I launch a BIRT report I got a java.lang.ClassCastException exception like this.

java.lang.ClassCastException: org.apache.xerces.parsers.XIncludeAwareParserConfiguration incompatible with org.apache.xerces.xni.parser.XMLParserConfiguration

My colleague Daniel Hlawatsch found the solution based on two similar IBM TechNotes:

New Xerces library was introduced in CCMDB
Error connecting to WebServices

To solve the problem you just have to delete org.apache.xerces_2.9.0.v200805270400.jar file (backup this first) from the application server deployed application tree: maximouiweb.war\WEB-INF\birt\platform\plugins

Restart the application server and test BIRT reports.
If the problem is solved you also should eradicate the problem deleting the same file from the SMP directory: [SMPDIR]\maximo\maximouiweb\webmodule\WEB-INF\birt\platform\plugins

April 5, 2014

Change Maximo base web address

In some cases you need to be able to web address of Maximo to identify between different environments or systems. For example for the test system you want to change the base URL from the default address:
  • http://mxhost/maximo/
  • http://mxhost/maximotest/

In WebSphere application server this part of the web address is called 'context root'. It can be changed using WebSphere admin console under Applications > Enterprise Applications > MAXIMO > Context Root For Web Modules.

You can change this setting from WAS console but every time you will redeploy maximo.ear file it will be reset to the default value. To automate this procedure you can set the correct value in the following files.

  • [SMPDIR]\maximo\applications\maximo\META-INF\application.xml
  • [SMPDIR]\maximo\applications\maximo\META-INF\deployment-application.xml

Rebuild and deploy the maximo EAR file and check that everything is working fine.