Seeing a Hashmap error after enabling the SOA Performance Management Agent Extension.

Document ID : KB000004223
Last Modified Date : 14/02/2018
Show Technical Document Details

After enabling the SOA Performance Management Agent Extension, we see the below exception in the log:

 Caused by: java.lang.ClassCastException: java.util.HashMap cannot be cast to 

All supported Introscope releases after APM 9.7.

The ClassCastException is due to a SOA Performance compatibility issue with the newer JAX-WS versions that expect to use instead of java.util.HashMap. Starting from APM 9.7, the below property is available to allow using instead of java.util.HashMap and to mitigate the ClassCastException.  This change does not have any side effect in the Cross Process Transaction Tracing or Cross-JVM.


1. Stop the Appserver/JVM.

2. Open the APM Agent property file : <Agent Home>/core/config/IntroscopeAgent.profile

3. Uncomment the below property to prevent the exception

    # SOA property for 2.2.6 or later versions of JAXWS Jar 

    # JAXWS jar has changed some methods in 2.2.6 and later versions 

    # Uncomment this property if JAXWS version is 2.2.6 or higher 

 4. Save and restart the Agent/Appserver,