SDK - Is it possible to use a different version of Axis with the Cognos SDK?
The following exception is thrown when using a different axis.jar from the one in <install_location>\sdk\java\lib:
Exception in thread "main" java.lang.ClassCastException: com.cognos.developer.schemas.bibus._3.ContentManagerServiceStub incompatible with org.apache.axis.client.Stub
Axis is essentially a SOAP engine -- a framework for constructing SOAP processors such as clients, servers, gateways, etc.
The current version of Axis is written in Java, and Axis supports the
WSDL, which allows you to easily build stubs to access remote services.
We can use WSDL2Java tool for building Java stubs (on client) and skeletons (on server) from WSDL documents.
IBM Cognos ReportNet and IBM Cognos 8 client stubs are created with Axis 1.1.
IBM Cognos 10 client stubs are created with Axis 1.4.
To recompile these client stubs files against a newer version of Axis, WSDL2Java tool is commonly used.
The stub files installed by Cognos were compiled with Axis 1.1 , or in the case of Cognos 10 with Axis 1.4.
It is sometimes common to want to use versions of Axis that are greater than 1.1 or 1.4, possibly to keep up with the corporate standard or to resolve version conflicts that arrise when using SDK in a web application that uses a higher version of Axis.
Although new stubs can be successfully created using a version of Axis of your choice, you can run into errors when you try to use them to connect to the Cognos service.
The reason is that Cognos has modified the Apache Axis 1.1 and 1.4 source and created its own versions of Axis.
Resolving the problem
In order to still be able to use higher version of axis.jar, IBM Cognos software and the SDK need to use the Cognos Axis libraries with the Cognos unique path in them.
Do the following:
- remove the following files from the CLASSPATH variable setting:
axis,jar (the one from <install_location>\sdk\java\lib)
- include in the CLASSPATH variable setting the following files:
|Business Analytics||Cognos 8 Business Intelligence||Cognos Connection|
|Business Analytics||Cognos 8 Business Intelligence||Software Development Kit|
|Business Analytics||Cognos ReportNet||ReportNet|
More support for:
Cognos Business Intelligence
Software Development Kit
Software version: 8.3, 8.4, 8.4.1, 10.1, 10.1.1, 10.2, 10.2.1
Operating system(s): AIX, HP-UX, Linux, Solaris, Windows
Software edition: Edition Independent
Reference #: 1339832
Modified date: 24 September 2013