DX Application Performance Management

Expand all | Collapse all

Need help instrumenting webMethods Integration Server

  • 1.  Need help instrumenting webMethods Integration Server

    Posted May 04, 2017 10:39 AM

    The documentation, at best, is terrible and doesn't even mention or talk about input of java args. That documentation for webMethods Integration server and webMethods Broker is in SERIOUS NEED OF AN IN-DEPTH REVIEW. Someone please have a look at that.

     

    I already have a case (00735001) open but not getting anywhere so want to post my question here. I've instrumented webMethods Integration Server v9.5 with default java introscope agent v10.1. I am using a default agent and during the install process picked webMethods Integration Server.

     

    Here is what the app server admin input the java args in the 'server.sh' file. 

     

    CLASSPATH=${CLASSPATH}:/apps/CA/IntroscopeAgent10.1/wMethodsIntgSrvAgent/wily/common/WebAppSupport.jar
    export CLASSPATH

    if [ `uname -s` = "HP-UX" ]; then
    ${JAVA_EXEC} -classpath ${IS_PROXY_JAR} com.wm.app.server.CustomServiceUpdater -isdir ${IS_DIR} -wrapperdir "${IS_DIR}/../profiles/IS/configuration" -binpath "${SHLIB_PATH}" -jvmargs "${JAVA_MEMSET} ${JAVA_OPTS}" -progargs $1#$2#$3#$4#$5#$6#$7#$8#$9
    elif [ `uname -s` = "AIX" ]; then
    ${JAVA_EXEC} -classpath ${IS_PROXY_JAR} com.wm.app.server.CustomServiceUpdater -isdir ${IS_DIR} -wrapperdir "${IS_DIR}/../profiles/IS/configuration" -binpath "${LIBPATH}" -jvmargs "${JAVA_MEMSET} ${JAVA_OPTS}" -progargs $1#$2#$3#$4#$5#$6#$7#$8#$9
    else
    ${JAVA_EXEC} -classpath ${IS_PROXY_JAR} -javaagent:/apps/CA/IntroscopeAgent10.1/wMethodsIntgSrvAgent/wily/Agent.jar -Dcom.wily.introscope.agentProfile=/apps/CA/IntroscopeAgent10.1/wMethodsIntgSrvAgent/wily/core/config/IntroscopeAgent_TST_ESP_wMIS1.profile com.wm.app.server.CustomServiceUpdater -isdir ${IS_DIR} -wrapperdir "${IS_DIR}/../profiles/IS/configuration" -binpath "${LD_LIBRARY_PATH}" -jvmargs "${JAVA_MEMSET} ${JAVA_OPTS}" -progargs $1#$2#$3#$4#$5#$6#$7#$8#$9
    fi

     

    I am also attaching logs for anyone who wants to review. I will also go ahead and attache the "server.sh" file. Currently the logfile is empty and the wMIS starts up just fine but with some error logs. 

     

    Thanks in advance for any help

     

    Cheers

    Manish

    Attachment(s)

    zip
    server.log.zip   7 KB 1 version
    zip
    nohup.out.zip   266 B 1 version
    zip
    AutoProbe.log.zip   19 KB 1 version


  • 2.  Re: Need help instrumenting webMethods Integration Server

    Broadcom Employee
    Posted May 04, 2017 10:50 AM

    Dear Manish:

    I forwarded your Documentation comments to the proper team. Thanks for the helpful feedback

    Thanks

    Hal German



  • 3.  Re: Need help instrumenting webMethods Integration Server

    Posted May 04, 2017 10:53 AM

    Here are the directiveFile the default agent is using

     

    introscope.autoprobe.directivesFile=default-typical.pbl,hotdeploy,brtm.pbd,webmethods.pbl

     

    I am also attaching autoprobe.log which doesn't show at all the loading of "webmethod.pbl"



  • 4.  Re: Need help instrumenting webMethods Integration Server
    Best Answer

    Broadcom Employee
    Posted May 04, 2017 11:03 AM

    Hi Manish,

    I'm no expert of this, only having done it once (but it did work), but in the profiles/IS/configuration folder, you should have a wrapper.conf file, that is the startup parameters of the server.

     

    For example this was the location in my setup:

     

    /opt/softwareag/profiles/IS_default/configuration

     

    In that wrapper.conf, you should be able to add the properties to Introscope. options 7 and 8 for me.

    In that case, no modification to startup scripts is needed

     

    wrapper.java.additional.1=-Dosgi.install.area="%OSGI_INSTALL_AREA%"
    wrapper.java.additional.1.stripquotes=TRUE
    wrapper.java.additional.2=-Declipse.ignoreApp=true
    wrapper.java.additional.3=-Dosgi.noShutdown=true
    # Not valid on Java 8. Must retain the option numbering for backward compatibility.
    # wrapper.java.additional.4=-XX:MaxPermSize=256M
    wrapper.java.additional.5=-Xbootclasspath/a:"%JAVA_BOOT_CLASSPATH%"
    wrapper.java.additional.5.stripquotes=TRUE
    wrapper.java.additional.6=-Djava.io.tmpdir="%OSGI_INSTALL_AREA%/workspace/temp"
    wrapper.java.additional.6.stripquotes=TRUE
    wrapper.java.additional.7=-javaagent:/opt/Introscope_agent/Agent.jar
    wrapper.java.additional.8=-Dcom.wily.introscope.agentProfile=/opt/Introscope_agent/core/config/IntroscopeAgent.profile

     

    As far as I'm aware, webMethods Broker is monitored by the standalone agent installer that makes calls to the broker, something like IBM MQ/MB monitoring so that is another process altogether.

     

    Thanks,

    David



  • 5.  Re: Need help instrumenting webMethods Integration Server

    Posted May 04, 2017 11:09 AM

    DavidLewis

    You are correct that for webMethods Brokers you use a Stand Alone Power Pack agent. But this is for webMethods Integration Server which uses the default java agent. I installed it using an installer:

     

    So, during the java install, you pick

     

    Specify Application Server Type

    -------------------------------

     

    Specify the type of application server to monitor.

     

        1- Default

        2- JBoss

        3- Tomcat

        4- WebLogic

        5- WebSphere

        6- Interstage

     

    ENTER THE NUMBER OF THE DESIRED CHOICE: 1

     

    Then further down the installer process………….the following comes up:

     

    ===============================================================================

    Select Monitoring Options

    -------------------------

     

    Files for monitoring specific environments are installed in the agent’s

    examples folder. If you don’t select monitoring for any of these environments

    now, you can manually enable monitoring later by copying files from the

    examples folder to the agent’s ext folder.

     

        1- CA APM for TIBCO BusinessWorks

        2- CA APM for Software AG webMethods Integration Server

        3- CA APM for IBM WebSphere MQ

     

    ENTER A COMMA-SEPARATED LIST OF NUMBERS REPRESENTING THE DESIRED CHOICES, OR

       PRESS <ENTER> TO ACCEPT THE DEFAULT: 2

     

    I am struggling with webMethods Integration Server instrumentation

     

    Thanks

    Manish



  • 6.  Re: Need help instrumenting webMethods Integration Server

    Broadcom Employee
    Posted May 04, 2017 11:13 AM

    Hi Manish,

    My comment about wrapper.conf is related to webMethods Integration Server so I would check it out, your startup parameters are mentioning wrapper configuration so I assume it is the default way that IS is managed.

     

    Thanks,

    David



  • 7.  Re: Need help instrumenting webMethods Integration Server

    Posted May 04, 2017 11:17 AM

    I'll talk to app server admin and follow-up.

     

    Thanks



  • 8.  Re: Need help instrumenting webMethods Integration Server

    Posted May 04, 2017 11:18 AM

    Sorry DavidLewis, I completely misunderstood your first response, my apologies.

    Manish



  • 9.  Re: Need help instrumenting webMethods Integration Server

    Posted May 04, 2017 11:20 AM

    Where would you input the "CLASSPATH= /../../WebAppSupport.jar"? Within the .conf file or the server.sh file?



  • 10.  Re: Need help instrumenting webMethods Integration Server

    Posted May 04, 2017 11:30 AM

    I can't believe it was this easy to resolve this issue  

    Why all this info is NOT in the documentation..........is beyond me! 

     

    Thanks a lot DavidLewis for your help. You rock!



  • 11.  Re: Need help instrumenting webMethods Integration Server

    Posted May 04, 2017 03:25 PM

    DavidLewis

    Where does the CLASSPATH go? Does it go into the server.sh file or the wrapper.conf file?



  • 12.  Re: Need help instrumenting webMethods Integration Server

    Broadcom Employee
    Posted May 05, 2017 04:33 AM

    Hi Manish,

    I'm not sure to be honest, if you are wanting to use WebAppSupport.jar for JMX, you could copy it to the /core/ext folder of the agent, that works in most cases.

     

    Apart from that, by reading through the wrapper.conf, you have this option:

     

    # Java Classpath (include wrapper.jar)  Add class path elements as
    #  needed starting from 1
    wrapper.java.classpath.1=/opt/softwareag/common/lib/tw-3.5.29%WRAPPER_FILE_SEPARATOR%wrapper.jar
    wrapper.java.classpath.2=%JAVA_SYSTEM_CLASSPATH%

     

    so you could put a .3 entry for the WebAppSupport.jar here too, in which case I would leave the WebAppSupport.jar in the /wily/common folder and specify the location from there.

     

    Thanks,

    David



  • 13.  Re: Need help instrumenting webMethods Integration Server

    Posted May 04, 2017 10:13 PM

    TEC1270112 has been created by jAmEs_shIn - thanks James



  • 14.  Re: Need help instrumenting webMethods Integration Server

    Broadcom Employee
    Posted May 05, 2017 06:32 AM

    Manish:

        I have been talking with Tech Info on adding this to the documentation. So the KD is an interim step

    Thanks

    Hal German