Registration

Dear SAP Community Member,
In order to fully benefit from what the SAP Community has to offer, please register at:
http://scn.sap.com
Thank you,
The SAP Community team.
Skip to end of metadata
Go to start of metadata

The Introscope Host Adapter (aka WilyHost agent) is an application which runs inside the SMDAgent. One of the tasks of the Introscope Host Adapter is to collect data from different configurable destinations and push them to the Introscope Enterprise Manager. The following picture provide a big picture of the architecture of the Introscope Host Adapter.

 

All applications running inside the SMDAgent are available in the Agent Administration UI. The Introscope Host Adapter can be found as shown in the picture below.

  1. Agent Administration UI
  2. Application Configuration
  3. com.sap.smd.agent.application.wilyhost

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

The resources used by the Introscope Host Adapter application can be found under the 'Application Resources' node:

N.B.: When using the application configuration take care when performing changes. Changes should not be performed in the scope GLOBAL unless they are strictly required. The changes in scope global affect ALL SMDAgents connected to the Solution Manager system.

In Solution Manager 7.10, the Introscope Host Adapter is configured during the activity 'Introscope Host Adapter' of the Managed System Configuration for the target system. The following picture shows the exact location:

When the activity Introscope Host Adapter is performed, the application is configured to collect data from the managed system that will be monitored. The main files used by the agent are the following:

  • Files create/modified by setup:
    • SAPAgentConfig.xml
      • File created during the Introscope Host Adapter setup activity. It contains the destinations configuration and the link to actions to be performed for each destination
    • IntroscopeSAPAgent.profile
      • File is created from the IntroscopeSapAgent.profile.template. The host and port of the Enterprise Manager are configured in this file.
  • Files used by application:
    • WilyHostAgentTemplate.xml
      • The is a global template file that defines all the possible actions possible for collecting all the Introscope Host Adapter data.
    • WilyHost.xsd
      • The is the XML schema file that defines the rules of validation for the WilyHostAgentTemplate.xml file. If you modify the action template it needs to conform to the schema.

N.B.: No manual configuration must be performed to the above files. The activity Introscope Host Adapter will configure the application automatically.

The file SAPAgentConfig.xml holds the configuration of the Destinations and the Actions that will be used/performed to collect data from the managed system.

  • Destinations: The destinations will point out where the information will be collected. The destinations are configurable, for example a destination might be a Jco connection to the managed system or the location of a specific file.

For a typical double stack system you will have configurations generated for the following destinations:

    • ABAP instance
    • JAVA instance
    • SAPStartSrv
    • SAPHOSTAGENT
    • File (for GC)

The following picture shows an example of a Jco destination. As you can see, the Jco destination has the connection information to the managed system, client, user, password, system number and hostname of the application server.






  • Actions: The actions indicates to the Introscope Host Adapter what are the metrics to be collected from the managed system. For all destinations in the SAPAgentConfig.xml a pool of actions are configured. The actions point to an action templates that are defined in the WilyHostAgentTemplate.xml file.

The following picture shows an example of some actions defined in a SAPAgentConfig.xml.

 

 

 

 

The SAPAgentConfig.xml fully configured looks as follows:

 

 

 

 

 

 

 

The following picture describes how the destinations and actions work in the managed system. As you can see, the destinations are the location where the data will be collected and the actions are the collections of data.

The file IntroscopeSAPAgent.profile holds the connection configuration to the Introscope Enterprise Manager. This file will tell the Introscope Host Adapter application what is the Enterprise Manager that the application must connect. The activity Introscope Host Adapter in the Managed System Configuration uses the IntroscopeSapAgent.profile.template file and then creates the IntroscopeSapAgent.profile. The following picture shows an example of IntroscopeSapAgent.profile.












Troubleshooting

If the Introscope Host Adapter applications shows issues, for example: agent is not connected to the Enterprise Manager or managed system metrics are not being collected. Then the SMDAgent logs must be checked to find out what is the root cause of the issue. The Introscope Host Adapter application may not work correctly due to distinct issues and the SMDAgent logs will show the root cause.

Logging InformationLog File
Host Agent Information when trying to connect to the Enterprise Manage/usr/sap/SMD/SMDA<xx>/work/jvm_SMDAgent.out
RFC Connections/usr/sap/SMD/SMDA<xx>/SMDAgent/dev_jrfc.trc
SMD Agent Application log file. All of the interesting logging for the Wily Host Agent will be found hereSMDAgentApplication.X.log
SMD Agent System log fileSMDSystem.X.log

Frequently Asked Questions/Issues

 

 

 

 

 

 

 

  • No labels

6 Comments

  1. Former Member

    How do we enable or configure the Java agent for monitoring the Java stack into the SAP applications?

    1. Hello Aniket,

      For the Introscope JAVA Agent (ISAgent), firstly you need to have the ISAgent SCA file deployed in the Solman JAVA stack as mentioned by Satish below. Then it is required to run the Byte Code Adapter Installation in the Managed System Configuration for the target system. Finally, a restart of the managed system is required to start the ISAgent. If you have issues to start it, then check the WIKI page mentioned by Satish as well:

      Byte Code Adapter does not start

      For more information about the Byte Code Adapter, check my blog post below:

      http://scn.sap.com/people/allam.drebes/blog/2014/06/15/byte-code-adapter-introscope-java-agent

      Regards,

      Allam

       

  2. Former Member

    Hi Aniket,

    Byte Code Adapter Installation step from Managed system configuration via Solution Manager and restart of Managed system are required for java metrics.

    As a prerequisite, install ISAGENT (Java byte code instrumentation agent for monitored systems) on Solution Manager

    Details: File ISAGENTJ501*.SCA - Java bytecode instrumentation agent for monitored systems for automated installation using the SMD setup application. ... -> Solution Manager JAVA Stack -> WILY INTRO AGT 9.7 MIN J5 VIA SM -> OS independent file available in SMP.

    Thank you

    Satish Kumar

     

     

  3. Former Member

    Hi Allam/Satish,

     

    We have SMD agent version 7.2 and 7.42 on some of the SAP managed systems that we are looking to monitor. Do we need to have any specific version of SMD agent to be installed to fulfill "Host Adapter" configuration to work as per expectation or 7.2 and 7.42 version will be ok to go with the monitoring using introscope.

     

    Regards,

    Aniket

  4. Hi,

     

    Thanks for the information.

     

    Has anyone already found a way to perform the managed system Introscope Host Adapter setup task in batch for all managed systems ?

     

    Thanks,

    Aidan