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

Document ID : KB000035351
Last Modified Date : 27/03/2019
Show Technical Document Details
Issue:

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