How to Instrument Introscope Java Agent on WebLogic Windows Server

[Manish Parikh]

Is there documentation for this? I haven't found it. Our WebLogic admin tried using the doc for Unix platform and it didn't work.

the agent and APM infra are both v10.1

 

@REM BAE CSR CRM-471 CA_APM

SET CA_APM_JAVA_OPTIONS=-javaagent:%ProgramFiles%\CA\APM\Introscope10.1\wily\Agent.jar -Dcom.wily.introscope.agentProfile=%ProgramFiles%\CA\APM\Introscope10.1\wily\core\config\IntroscopeAgent.profile

SET JAVA_OPTIONS=%JAVA_OPTIONS%  %CA_APM_JAVA_OPTIONS%

 

SET CA_APM_CLASSPATH=%ProgramFiles%\CA\APM\Introscope10.1\wily\common\WebAppSupport.jar

SET CLASSPATH=%CLASSPATH% %CA_APM_CLASSPATH%

@REM END BAE CSR CRM-471 CA_APM

 

Thanks in advance for helping

Manish

[Tim_McGaughey]

Manish,

 

In newer releases, the documentation is only provided online.  Have you tried these steps? 

Oracle WebLogic - CA Application Performance Management - 10.1 - CA Technologies Documentation

[Manish Parikh]

Tim_McGaughey

Well, that's what I gave the app admin and the response I got was....

 

Please provide the syntax for Windows to set up the correct JAVA_OPTIONS and CLASSPATH. The below I copied from Linux doesn’t work and can’t start Admin Server.

@REM BAE CSR CRM-471 CA_APM

SET CA_APM_JAVA_OPTIONS=-javaagent:%ProgramFiles%\CA\APM\Introscope10.1\wily\Agent.jar -Dcom.wily.introscope.agentProfile=%ProgramFiles%\CA\APM\Introscope10.1\wily\core\config\IntroscopeAgent.profile

SET JAVA_OPTIONS=%JAVA_OPTIONS%  %CA_APM_JAVA_OPTIONS%

 

SET CA_APM_CLASSPATH=%ProgramFiles%\CA\APM\Introscope10.1\wily\common\WebAppSupport.jar

SET CLASSPATH=%CLASSPATH% %CA_APM_CLASSPATH%

@REM END BAE CSR CRM-471 CA_APM

[Tim_McGaughey]

The documentation actually shows you exactly what needs to be added to the app server.  He's choosing to use this batch file instead. The syntax in that batch file looks OK to me, but the problem is that we can't see what's actually invoking his app server.  We also can't see when this file is being executed.  On Windows, he could be using a service, which may not be using those environment variables.

 

I did provide the documentation of how to do it (your original request), and I can confirm that he appears to be setting the environment variables correctly (his request).  To get any further, we'd need need these execution details from your environment.

[Manish Parikh]

Tim_McGaughey

I will reach out to her (app admin) tomorrow AM when she comes into work and ask her what exactly is she doing, step-by-step. In the meantime, I did send her the link you gave out in your previous response to follow. Let's see how that goes in the AM, tomorrow.

 

Any chance you'd be available for a WebEx if this is goes south?

 

Thanks

Manish

[Lynn Williams]

As Tim says it depends how the AppServer is started - often with Weblogic it is a script/command file but even those options differ:

Starting and Stopping Servers

 

For my Windows Weblogic Samples Medrec server environment:

I use C:\oracle\Middleware\wlserver_10.3\samples\domains\medrec\bin\startWebLogic.cmd to start it.

I have the agent directory wily in C:\oracle\Middleware\wlserver_10.3\samples\domains\medrec.

Here is the JAVA_OPTIONS from my startWebLogic.cmd file which I have also attached:

 

set JAVA_OPTIONS=%JAVA_OPTIONS% -javaagent:%WL_HOME%\samples\domains\medrec\wily\Agent.jar -Dcom.wily.introscope.agentProfile=%WL_HOME%\samples\domains\medrec\wily\core\config\IntroscopeAgent.profile -Dweblogic.TracingEnabled=true

 

Hope it helps

 

Lynn

Attachment(s)

startWebLogic.cmd.zip   2 KB 1 version

[Lynn Williams]

My CLASSPATH is set as follows:

set CLASSPATH=%CLASSPATH%;%WL_HOME%\samples\domains\medrec\wily\common\WebAppSupport.jar

 

In Manish's above post I don't see the required ";" separator between the environment variables (delimited by "%" characters), but maybe that is just due to the post removing them?

SET JAVA_OPTIONS=%JAVA_OPTIONS%  %CA_APM_JAVA_OPTIONS% should be SET JAVA_OPTIONS=%JAVA_OPTIONS%;%CA_APM_JAVA_OPTIONS%

SET CLASSPATH=%CLASSPATH% %CA_APM_CLASSPATH% should be  SET CLASSPATH=%CLASSPATH%;%CA_APM_CLASSPATH%

[Manish Parikh]

Lynn_Williams Tim_McGaughey

 

So for me, in the "startWebLogic.cmd" file, my entry would look like

 

set JAVA_OPTIONS=%JAVA_OPTIONS% -javaagent:C:\Program Files\CA\APM\wily\Agent.jar -Dcom.wily.introscope.agentProfile=C:\Program Files\CA\APM\wily\core\config\IntroscopeAgent.profile -Dweblogic.TracingEnabled=true

 

and

My CLASSPATH will be set as follows:

set CLASSPATH=%CLASSPATH%;C:\Program Files\CA\APM\wily\common\WebAppSupport.jar

 

Are these correct?

Do I need to worry about the space in between "Program Files"?

[Tim_McGaughey]

I have not had great success with spaces in path names.  Personally, I'd try to use the short path instead of using the space.  You can find the short path for your Program Files directory from the command prompt and the command "dir /x".

[Manish Parikh]

Is the windows java agent for WebLogic a 64-bit or 32-bit?

[Tim_McGaughey]

The Java agent is written in Java, so it does not matter.  It will run using the register width of the JDK you use.

[Guenter DI Grossberger]

Hi Manish,

 

1. As Lynn_Williams mentioned you need to separate classpath entries with ';' on windows (and ':' on linux/unix) - no spaces.
2. Either use short (8.3) path names as Tim_McGaughey mentioned or put them in double quotes. Otherwise every space is interpreted as parameter delimiter.

Ciao,
Guenter

[Manish Parikh]

Ok, so, looks like it was a syntax error and all is good now. the agents are showing up in the investigator.

 

Thanks Guenter_Grossberger Lynn_Williams Tim_McGaughey