Installing the Java Introscope Agent

Install the Java Introscope agent on all server nodes in an SAP Mobile Platform Server cluster.

1. Navigate to the SAP Service Marketplace Software Download Center at https://support.sap.com/swdc
2. In the left pane, select  Support Packages and Patches  Browse Download Catalog , then select  SAP Technology Components  SAP Solution Manager  SAP Solution Manager 7.1  Entry by Component  Agents for Managed System .
3. Select  WILY INTRO AGT 9 MIN J5  # OS Independent , and select the Introscope Java agent.
4. Stop the server.
5. Under <SMP_HOME>\MR30, create a directory called "IntroscopeAgent" at the same level as the Servers directory.
6. Under the IntroscopeAgent directory, create a directory called "Java".
7. Copy the Wily directory and all its contents from the Introscope Agent Java release to the Java directory.
8. Extract the contents of the config.zip file to <SMP_HOME>\MR30\IntroscopeAgent\Java\wily\core\config, overwriting existing files.
9. Extract ext.zip into <SMP_HOME>\MR30\IntroscopeAgent\Java\wily\core\ext, overwriting existing files.
10. Configure the Java agent on the server:
    1. For the application service node, add the following properties to the Java option in the <SMP_HOME>\MR30\Servers\UnwiredServer\bin\mlsrv.ext.ini file:

       -javaagent:<SMP_HOME>/MR30/IntroscopeAgent/Java/wily/Agent.jar
       -Dcom.wily.introscope.agentProfile=<SMP_HOME>/MR30/IntroscopeAgent/Java/wily/core/config/IntroscopeAgent.profile
       -Dcom.wily.introscope.agent.agentName=%CLUSTER_NAME%_%MOBILINK_SERVERNAME%

       Note Substitute the following path variables with property values in the <SMP_HOME>\MR30\Servers\UnwiredServer\Repository\Instance\com\sybase\sup\server\SUPServer\sup.properties file:

       • %CLUSTER_NAME% – replace with the value of sup.cluster.name.
       • %MOBILINK_SERVERNAME% – replace with the value of ml.servername.
    2. For the scale-out node, add the following properties to the <SMP_HOME>\MR30\Servers\UnwiredServer\bin\websrv.ini file:

       -javaagent:<SMP_HOME>/MR30/IntroscopeAgent/Java/wily/Agent.jar
       -Dcom.wily.introscope.agentProfile=<SMP_HOME>/MR30/IntroscopeAgent/Java/wily/core/config/IntroscopeAgent.profile
       -Dcom.wily.introscope.agent.agentName=%CLUSTER_NAME%_%MOBILINK_SERVERNAME%

    3. Open the <SMP_HOME>\MR30\Servers\UnwiredServer\config\configure-sup.xml file, and make these changes:
       • Uncomment line 8 <property name="introscope.properties.file" value="introscope-agents.properties"/>
       • Uncomment line 11 <property file="${introscope.properties.file}" />
       • Add ${introscope.agent.property} to both:
         • The configure-mobilink Java option, and
         • configure-websrv-ini
         Note Look at the configure-sup.xml file for examples of how to configure these properties.
    4. In <SMP_HOME>\MR30\Servers\UnwiredServer\config, create a file called introscope-agents.properties, and add the following to it:

       -javaagent:<SMP_HOME>/MR30/IntroscopeAgent/Java/wily/Agent.jar
       -Dcom.wily.introscope.agentProfile=<SMP_HOME>/MR30/IntroscopeAgent/Java/wily/core/config/IntroscopeAgent.profile
       -Dcom.wily.introscope.agent.agentName=%CLUSTER_NAME%_%MOBILINK_SERVERNAME%

11. On a command line, run:

    setx Cor_Enable_Profiling 0x1 /m

12. Set the Enterprise Manager (EM) host and port for the Java agent:
    1. Edit the Java profile in the <SMP_HOME>\MR30\IntroscopeAgent\Java\wily\core\config\ IntroscopeAgent.profile file.
    2. Set the value of the introscope.agent.enterprisemanager.transport.tcp.host.DEFAULT property to the IP address of the EM host.
    3. Set the value of the introscope.agent.enterprisemanager.transport.tcp.port.DEFAULT property to the EM port number.
    4. Restart the server.
13. (Optional) To disable the agent:
    1. Run: setx Cor_Enable_Profiling 0x0 /m
    2. Remove the properties that you added in step 10, and restart the server.
14. (Optional) To reenable the agent after disabling it:
    1. Run: setx Cor_Enable_Profiling 0x1 /m
    2. Repeat step 10, and restart the server.