Why I could no longer find the PowerpackForWebSphere_Agent.jar in the APM 9.x/10.x installation binaries as per the instructions in the APM User Guide?

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

Question:

Why I could no longer find the PowerpackForWebSphere_Agent.jar in the APM 9.x/10.x installation binaries, as part of the instructions in the APM User Guide to create Custom Services for WebSphere PMI and SIBs monitoring?

 

Answer:

From APM 9.5 and onwards, the functionality of the PowerpackForWebSphere_Agent.jar has been merged into the WebAppSupport.jar. Therefore, the PowerpackForWebSphere_Agent.jar is no longer needed while configuring custom services for the Websphere Powerpack or the core agent.

With this new changes, you are only required to configure the Introscope Custom Service using the com.wily.introscope.api.websphere.IntroscopeCustomService class and have the WebAppSupport.jar defined in the classpath as was done in the past, in all scenarios. The PPCustomService class that comes with the PowerpackForWebSphere_Agent.jar has also been retired and is no longer referenced in the WebAppSupport.jar, hence should NOT be used in the classpath.

For example, a sample entry in IBM server.xml for the APM 9.5 Agent will look like this:

<customServices xmi:id="CustomService_1229337493375" enable="true" classname="com.wily.introscope.api.websphere.IntroscopeCustomService" displayName="CA Wily Custom Service for WAS distributed 9.5" description="Custom service for CA Wily WAS distributed 9.5" classpath="<Path to WebAppSupport.jar>"/>

 

Additional Information:

We are aware that the 9.x and 10.x APM documentation still contains references to the PPCustomService class, and we are working on getting it updated with the correct information.