Startup parameters to allow Java Agent and IBM Cognos 10.2 to start.

Products

• CA Application Performance Management Agent (APM / Wily / Introscope)
• INTROSCOPE

Issue/Introduction

The customer was installing Java Agent to monitor a IBM Cognos server.  The Agent starts but Cognos fails to start. IBM Cognos is not certified to be   supported with the Java Agent but this suggestion could help if you are having this same trouble.

Environment

Application Performance Management Java Agent 9.7
Java 1.6.0 J9 IBM
zLinux Suse
IBM Congos 10.2

Cause

 IBM requires the changes below to make it work with the Java Agent.

Resolution

1. Stop the app server (Cognos).
2. Save the existing “bootstrap_wlp_winx64.xml” file (Copy it and call it “bootstrap_wlp_winx64_orig.xml” and put/move it somewhere safe)
3. Edit “bootstrap_wlp_winx64.xml” file. Insert the following highlighted lines before the existing “-javaagent…” lines (as shown below):

   • <param>"-javaagent:E:/apps/CA/IntroscopeAgent10.1/Cognos10.2/wily/AgentNoRedefNoRetrans.jar"</param>

     <param>"-Dcom.wily.introscope.agent.agentName=Cognos_Global_TST"</param>

     <param>"-Dcom.wily.introscope.agentProfile=E:/apps/CA/IntroscopeAgent10.1/Cognos10.2/wily/core/config/IntroscopeAgent.NoRedef.Cognos_TST.profile"</param>

     <param>"-Dorg.osgi.framework.bootdelegation=com.wily.*"</param>

     <param>"-javaagent:${install_path}/wlp/bin/tools/ws-javaagent.jar"</param>                            

     <param>-jar</param>

     <param>"${install_path}/wlp/bin/tools/ws-server.jar"</param> 

     <param>cognosserver</param>

4. Save the file
5. Startup app server (Cognos)

Additional Information

 Here is a document link to IBM for more information on the need to use this Java Option

 http://www-01.ibm.com/support/docview.wss?uid=swg21666604