DX Application Performance Management

 View Only
  • 1.  IntroscopeEPA.properties use of Environment Variables 10.5.2

    Posted Sep 18, 2017 10:55 AM

    We are installing 10.5.2 and currently working on the epagent.   In version 10.0, we had a very long discussion on how to defer the "introscope.agent.enterprisemanager.transport.tcp.host.DEFAULT" with an environment variable.  

    IntroscopeEPA.properties use of Environment Variables 


    Now in version 10.5.2 sp1, this has changed



    How do I control the enterprise manager the agent connects to with an environment variable?


    In 10.0, with the EPACtrl.sh I had

          #Determine which MOM to use
          if [ -f "/syshome/wilyapm/config/caapm.conf" ]; then

          #caapm.conf contains [PROD | NON-PROD | TEST]

          #load environment value
          . /syshome/wilyapm/config/caapm.conf;

          if [ -z "$CAAPM_ENV" ]; then
          echo "{ERROR][EPACtrl.sh] CAAPM_MOM NOT set! Please configure the appropriate MOM in       /syshome/wilyapm/config/wilymom.conf"
          exit 1;

          case "$CAAPM_ENV" in
          "PROD") CAAPM_MOM="<prod mom>"
          "NON-PROD") CAAPM_MOM="<nonprod mom>"
          "TEST") CAAPM_MOM="<test mom>"
          *) # default - if value is unknown
          echo "[ERROR][EPACtrl.sh] CAAPM_ENV = $CAAPM_ENV. Value is unknown. Check the EPACtrl.sh file."
          exit 1
          echo "[INFO][EPACtrl.sh] CAAPM_ENV = $CAAPM_ENV. CAAPM_MOM = $CAAPM_MOM";

          # the command to start the EPAgent
          EpaCmd="java -Xms${MIN_HEAP_VAL_IN_MB}m -Xmx${MAX_HEAP_VAL_IN_MB}m -Dintroscope.agent.enterprisemanager.transport.tcp.host.DEFAULT=$CAAPM_MOM -cp lib/EPAgent.jar:lib/IntroscopeServices.jar:lib/Agent.jar:epaplugins/epaMQMonitor/epaMQMonitor.jar:epaplugins/epaMQMonitor:epaplugins/epaMQMonitor/lib/com.ibm.mq.pcf.jar:epaplugins/epaMQMonitor/lib/com.ibm.mq.jar:epaplugins/epaMQMonitor/lib/connector.jar:epaplugins/epaMQMonitor/lib/com.ibm.mqjms.jar $agentconfig com.wily.introscope.api.IntroscopeEPAgent"
          #echo $EpaCmd


    So with the change in the configuration in 10.5.2 to the "agentManager.url.1=localhost:5001" what do I need to change?

  • 2.  Re: IntroscopeEPA.properties use of Environment Variables 10.5.2

    Broadcom Employee
    Posted Sep 18, 2017 11:02 AM

    Dear APM Administrators/Partners:

          Can you please share your recommendations on what you think Billy should do in this situation? 



    CA Staff; Please respond if no suggestion are provided after waiting a reasonable period of time.


    Thank you all


    Hal German

  • 3.  Re: IntroscopeEPA.properties use of Environment Variables 10.5.2
    Best Answer

    Posted Sep 18, 2017 02:16 PM

    The documentation eludes to using a system property


    "Use the following system properties to supply the URL of the Enterprise Manager, Collector, or MOM to which the agent should connect"


    So while I wait for mount point, user creation and access to the test servers, I'm guessing that I need to change the Java command line to be:


    EpaCmd="java -Xms${MIN_HEAP_VAL_IN_MB}m -Xmx${MAX_HEAP_VAL_IN_MB}m -DagentManager.url.1=$CAAPM_MOM -cp lib/EPAgent.jar $agentconfig com.wily.introscope.api.IntroscopeEPAgent"


    The only JAR within the lib directory is the EPAgent.jar and so all the other included JAR files are not needed.


    Looks like the agent config parameter did not change [com.wily.introscope.epagent.properties] since it is present within the <agent>/conf/EPAService.conf as




    So how close am I?


    Hopefully I can get this tested this week so I can move on to the other agents.

  • 4.  Re: IntroscopeEPA.properties use of Environment Variables 10.5.2

    Broadcom Employee
    Posted Sep 18, 2017 02:42 PM

    Hi bwcole,

    Analyzing this informations, I think that you need put :
    EpaCmd="java -Xms${MIN_HEAP_VAL_IN_MB}m -Xmx${MAX_HEAP_VAL_IN_MB}m -DagentManager.url.1=$CAAPM_MOM:5001 -cp lib/EPAgent.jar $agentconfig com.wily.introscope.api.IntroscopeEPAgent"


    Now, In agents 10.X the port composes this information.


    Please, let me know If helped you.




  • 5.  Re: IntroscopeEPA.properties use of Environment Variables 10.5.2

    Broadcom Employee
    Posted Sep 19, 2017 10:35 AM

    Dear Billy:

    Have not heard back anything further from you on this. So marking as answered since with Vinicius or your own answer, you seem close. However, this thread can continue as needed with your status, and follow-up questions



    Hal German