A complete guide to setup CA APM Introscope 9 for monitoring SAP BI Platform 4.1 on Windows [PART 2/2]
Continued from: A complete guide to setup CA APM Introscope 9 for monitoring SAP BI Platform 4.1 on Windows [PART 1/2]
Step 4: Configure each BI node and application server node
In this step, we need to enable monitoring on each Apache Tomcat and BI Platform node. In this example, Apache Tomcat is installed by the SAP BI Platform installer. If you have a stand-alone install of Apache Tomcat or another Java application server you can copy the wily folder from the BI node to the Java application server node and complete the configuration as shown below.
| Using Websphere? Try this tutorial instead: |
- On the BI / Java application server node, browse to <INSTALL_ROOT>:\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java\wily\webapp then edit the file IntroscopeAgent_tomcat.profile with a text editor
- Search for $IntroscopeAgentEnterpriseManagerHost and replace this with the hostname of your Introscope Enterprise Manager
- Search for $IntroscopeAgentEnterpriseManagerPort and replace this with the agent communication port number of your Introscope Enterprise Manager
- Save the changes to IntroscopeAgent_tomcat.profile
- Launch the Apache Tomcat configuration editor (START–>Programs–>Tomcat–>Tomcat Configuration) then click on the Java tab
- Add the following Java properties under Java Options
-Dintroscope.agent.name=TOMCAT_<PORT>
-javaagent:<Path_To_Agent.jar>
-Dcom.wily.introscope.agentProfile=<Path_To_IntroscopeAgent_tomcat.profile>
Example:-Dintroscope.agent.name=TOMCAT_8080
-javaagent:C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java\wily\Agent.jar
-Dcom.wily.introscope.agentProfile=C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java\wily\webapp\IntroscopeAgent_tomcat.profile
- Click the Apply button, then click OK.
- Restart the Apache Tomcat service. If the Apache Tomcat service fails to start, check that you entered the Java properties correctly in the previous steps and that the files exist in the specified locations
- Next, launch the Central Management Console, logon as Administrator, choose Servers. Under nodes, right click on an SIA node and click Placeholders
- Edit the following Placeholder values:
Placeholder Value Description %IntroscopeAgentEnableInstrumentation% true Enables or disables Introscope instrumentation on BOE Java based servers (APS, AJS, etc) %IntroscopeAgentEnterpriseManagerHost% IEMHOSTNAME Hostname of your Introscope Enterprise Manager %IntroscopeAgentEnterpriseManagerPort% 6001 Agent listening port of your Introscope Enterprise Manager %NCSInstrumentLevelThreshold% 10 Set the instrumentation level to 10 %SMDAgentHost% localhost This property should always be set to localhost %SMDAgentPort% 6404 This port should match the port set in SapAgentConfig.xml 
- Restart the Server Intelligence Agent and repeat steps 9 and 10 for each additional SIA node
Step 5: Validate the installation/configuration is working
In this step, we will make sure that the metrics are working correctly. Before you start this step, go ahead and refresh some Web Intelligence documents, Crystal Reports, Dashboards, etc to generate some performance data in the Introscope Enterprise Manager
- Go to start, programs, CA APM, then click on Introscope Workstation Webstart or browse to http://iemhost:8081/workstation
- Logon to Introscope using user Admin and password Admin89
- Click Workstation,New Investigator
- Expand SuperDomain, then locate and expand your BI / Java application server node
- Verify that you see the following:
- Next, click Workstation, New Console and validate that the Apache Tomcat and BOE 4.0 dashboards are returning data according to the products you are using in your BI landscape
Congratulations, your BI landscape is now being monitored by CA APM Introscope. Should you face a roadblock in the configuration, you can request help from SAP by submitting an incident to component BI-BIP-DEP. Stay tuned to this space for forthcoming BI Introscope diagnostics and monitoring blogs coming soon!
Please don’t forget to rate this blog if you found this tutorial helpful.
Equally good as part1.
Thanks Mani!
Hello Toby,
Excellent and keep up the Good Work.. I am eagerly waiting on Upcoming posts.
Thank you, Toby. It is comprehensive.
Toby,
As usual thank you for this.
I have deployed it and it works very well.
Somehow I could not see Apache Tomcat under dashboard.
I could see BO 4 and other things.
Please help.
Thanks!
Raj
Hi Raj,
Do you mean, you can't see Apache Tomcat dashboard? Or do you mean you don't see metrics under this dashboard?
Thanks
Toby
I think I know why this didn't work. Theres a small typo with this path during java options.
C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java\wily\webapp\IntroscopeAgent_tomcat.profile
Its best to ensure all these paths are checked in explorer according to your system to ensure success.
Thanks
Shiva
Hey Shiva,
I dont see this typo. Where do you see it>?
Thanks
Toby
Hi Toby,
In Step.6, Add the following Java properties under Java Options
-Dcom.wily.introscope.agentProfile=C:\Program Files(x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java\wily\webapp\IntroscopeAgent_tomcat.profile
there should be a space between Files and (x86). I copy pasted the paths direct and Tomcat didn't show up first. But later I checked all the paths and found this one was a little bit off
thanks,
Shiva
Thanks Shiva, I fixed the problem. š
Hi Toby - quick [stupid] question, since I can't get Tomcat to show up via the investigator under SuperDomain... when you say at the very top of Step 4:
"In this step, we need to enable monitoring on each Apache Tomcat and BI Platform node. In this example, Apache Tomcat is installed by the SAP BI Platform installer. If you have a stand-alone install of Apache Tomcat or another Java application server you can copy the wily folder from the BI node to the Java application server node and complete the configuration as shown below."
Where should we copy the wily folder to? Tomcat7.0/<where?>
Thanks,
Missy
Hi Missy, the default location is C:\usr\sap\wily however, you can put it anywhere you want. I would just avoid having spaces in the path if possible.
Hi Toby, How this gets integrated with Solution manager . Looks like its directly reporting to wily ???
Hi Reddy
This article is for setting up Introscope with BI4.1 without Solution Manager
Hello Toby,
My customer update BI4.1 from SP5 to patch5.2. After that they found below error from SIA log, the error is repeating every minute.
Failed to read file /sap/sap_bobj/enterprise_xi40/java/wily/dsl_slproxy_pdb.config
It seems the system is reading wrong config because the correct one should be dsl_slproxy_pbd.config. But I didn't see any place that we can input this value. Do you have any idea on where the issue could come from?
Thanks,
Peter
Hi Peter,
Sounds like a bug. Have you been able to reproduce the problem? Looks like Patrick documented it here: http://service.sap.com/sap/support/notes/2141615
Regards
Toby
Dear Experts,
I am facing the issue in wily configuration. Could you please look at the thread and help me Tomcat Wily Connect - No logs and No Connect !!! Thanks a lot.
Thanks and regards,
Pradeep
Hi Toby,
The hyperlinks in the Console is not working. No action occurs when clicked. Attached screenshot. I have done the configurations as per the document. Could you please help where should I be checking to resolve this?
Thanks
Priya
Hi Priya,
I know it seems simple but try double clicking instead of single click š
Regards
Toby
Hi Toby ,
Thanks š It worked.
With respect to tomcat dashboards, i don't see any data for Apache Tomcat CPU, Apache Tomcat Http Sessions. Data is retrieved for other Tomcat Dashboards. Could this be due to any configuration issues?
Also , with the standalone version, I suppose alerts can only be viewed in the workstation and cannot be customized. Please correct me if my understanding is wrong.
Thanks
Priya
Hi Priya,
On the Tomcat server, are you using the IntroscopeAgent_tomcat.profile as suggested in this article? This one has the probe builder directives needed to include the Apache JVM metrics.
Regarding the alerts, yes with the standalone version (Right To View mode) it is read only. You would need the full version of CA Introscope to edit the alerts (management modules).
Thanks
Toby
Hi Toby,
Thank you for the response. I have re-checked the IntroscopeAgent_tomcat.profile and it has been configured as in the article. But still some metrics are not showing any data in few dashboards. To be precise, below are the metrics for which there is no data:
Apache Tomcat CPU : Apache Tomcat Host CPU Usage%, Apache Tomcat CPU used by Process%,Apache Tomcat Process CPU Time%
Apache Tomcat Hibernate Details: Hibernate - Queries - Average Method Invocation Time, Hibernate - Sessions- Average Method Invocation Time, Hibernate - Cahce Concurrency - Method Invocations Per Interval
Apache Tomcat Http Sessions:Apache Tomcat Active Http Session Count,Apache Tomcat Expired Http Session Count, Apache Tomcat Http Session Counter
Apache Tomcat Servlets: Apache Tomcat Servlets Request Count
Apache Tomcat Thread Pool Details: Apache Tomcat Acceptor Thread Count,Apache Tomcat Pooler Thread Count,Apache Tomcat Current Thread Count,Apache Tomcat Current Thread Busy Count,Apache Tomcat Send File Thread Count
Apache Tomcat Threads: Apache Tomcat Max Thread Count
Thanks
Priya
Hi Priya,
On your Tomcat server, in the directory C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java\wily\logs there should be some logs if you search on *Tomcat*.log. This may give clues to why the metrics aren't working.
Also, please provide the profile you are using for this.
You can upload the logs and .profile here: https://mdocs.sap.com/mcm/browser/v1/open?rep=share&obj=Ursgw-Vs5s4SZQLpP0MhHvQ4JFdbGt_TNpXUSibp8nA
I'll have a look
thanks
Toby
Hi Toby,
Thank you for the response. Could you please provide me another link to upload the logs and the profile ? I am not able to upload using the current one. I will also check if I can find any clues from the logs.
Thanks
Priya
Hi Priya,
Here's another link to try: Upload Link
Regards
Toby
Thanks Toby. I have uploaded the logs.
Regards
Priya
Hi Priya,
The logs don't seem to indicate a problem. I see it reading in the Tomcat pbd(s) so technically the Tomcat metrics should be working. It might be a good idea to download the latest version of the Introscope Java Agent and try this instead of the default agent that ships with BOE. What version of the Introscope Enterprise Manager are you using?
Thanks
Toby
Hi Toby,
I know this blog doesn't talk about solution manager but could you please suggest on how to use solution manager to trigger alerts in case thread count value for tomcat crosses certain threshold
Regards,
Vaibhav
Hi Vaibhav
You should be able to create a system monitoring alert against the same Tomcat metrics and monitor it via the Solman Alert Inbox.
https://wiki.scn.sap.com/wiki/display/SM/SysMon_Create+custom+metrics+and+alerts
https://help.sap.com/viewer/82f6dd44db4e4518aad4dfce00116fcf/7.2.05/en-US/9a3a73b801bd422c89672eb8a952504f.html
For more detailed instructions, Iād suggest making a post in Solution Manager SCN answers forum.
Cheers
Toby
...