AppDynamics Installation Guide

Contents 1 Activating AppDynamics for Openbravo 2 Installation 2.1 Installing the Module 2.2 Controller 2.3 Openbravo Server 2.3.1 Working with clones 2.3.2 Working with proxies 2.3.3 Checking Agents Status

Activating AppDynamics for Openbravo

AppDynamics for Openbravo is activated by Openbravo Support team. Once this process is done, you will receive:

• Access to install AppDynamics for Openbravo module with your license.
• AppDynamics controller details, which includes:
  • Controller URL
  • Credentials to operate the controller
  • account-name
  • account-access-key
  • controller-host

Installation

AppDynamics consists of two agents (Application and Machine) and a controller (UI to visualize performance data). Agents are in charge of collecting information about the Openbravo instance and sending it to the controller.

Controller and agent are configured separately. Controller is configured from AppDynamics UI whereas agents must be configured in Openbravo server.

Installing the Module

AppDynamics for Openbravo module is a convenience module which contains the two controllers and the configuration files they require as well the pre packaged application to be applied in the controller. Note it requires of extra configuration, by itself it is not able to send data to AppDynamics controller.

This can be installed as a regular Openbravo module.

Controller

AppDynamics Controller configuration is done from AppDynamics UI.

Openbravo provides a packaged default configuration that makes easier to configure AppDynamics to work with Openbravo by defining some standard Business transaction, data collectors, error detection, etc.

To apply this configuration:

• Get ob-appdynamics-config.xml file from AppDynamics for Openbravo module sources directory. It is in: [Openbravo-Source-Path]/modules/org.openbravo.utility.monitoring.appdynamics/AppDynamics/ob-appdynamics-config.xml path.
• Go to AppDynamics controller. URL and credentials are provided during the activation process.
• From home page click on View All Applications in Applications widget.

• Click on Import Application icon in the toolbar.

• In the dialog:
  • Select downloaded file.
  • Select a name for the Application. (see note below)
  • Click Import button. This process can take several minutes.

Openbravo Server

• In Openbravo server create /opt/AppDynamics directory (this might require root privileges, if so, change owner to openbravo user after creation: chown openbravo:openbravo /opt/AppDynamics).
• As openbravo user, copy the contents of [Openbravo-Source-Path]/modules/org.openbravo.utility.monitoring.appdynamics/AppDynamics to /opt/AppDynamics: cp -r [Openbravo-Source-Path]/modules/org.openbravo.utility.monitoring.appdynamics/AppDynamics/* /opt/AppDynamics
• Edit /opt/AppDynamics/AppAgent/conf/controller-info.xml file to change the following properties:
  • application-name: it will identify the Openbravo instance in AppDynamics. This name must exactly match in AppAgent, MachineAgent and AppDymics controller
  • account-name and account-access-key: these settings are provided when activating AppDynamics account.
  • controller-host: Provided in the activation process
• Edit /opt/AppDynamics/MachineAgent/conf/controller-info.xml file. Same settings as described in above should be set. They must have the exact same values
• Edit /etc/profile.d/tomcat.sh file (this might require root privileges) to add these lines at the bottom:

# AppDynamics support
export CATALINA_OPTS="$CATALINA_OPTS -javaagent:/opt/AppDynamics/AppAgent/javaagent.jar"

• Grant execution permission to machine agent daemon: chmod +x /opt/AppDynamics/MachineAgent/bin/machine-agent
• Restart Tomcat: /etc/init.d/tomcat restart
• Check openbravo.log to ensure it started correctly
• Execute Machine Agent: /opt/AppDynamics/MachineAgent/bin/machine-agent. For more information on read: /opt/AppDynamics/MachineAgent/readme.txt

After few minutes you should start seeing data in AppDynamics controller.

To check if machine agent is running, /etc/init.d/appdynamics status can be executed.

Note that machine agent is not started by default, after subsequent machine restarts command /etc/init.d/appdynamics start should be executed. To add this command to startup process not to have to execute it manually read following note.

Working with clones

When a clone of production instance is done, it is important to ensure before Tomcat is started configuration in /etc/profile.d/tomcat.sh does not include javaagent line in order to prevent sending data from this clone. Also the machine agent is not active.

If data for different clones is desired to be collected by AppDynamics each of them needs to be configured with a different application name.

Working with proxies

When the openbravo server connects Internet via proxy

• If proxy requires password create a new text file in ie./opt/AppDynamics/MachineAgent/conf/proxy-credentials.txt with a single line with the password.
• Edit AppDynamics/MachineAgent/appdynamics:
  • Edit the line for EXTRA_JAVA_PARAMS to make it look like: EXTRA_JAVA_PARAMS="-Dappdynamics.http.proxyHost=192.168.100.1 -Dappdynamics.http.proxyPort=8080 -Dappdynamics.http.proxyUser=proxyUserName -Dappdynamics.http.proxyPasswordFile=$APPDYN/MachineAgent/conf/proxy-credentials.txt"</code>. Note bold parameter values should be replaced with your actual proxy settings.
• Edit /etc/profile.d/tomcat.sh to add the following properties to CATALINA_OPTS:

-Dappdynamics.http.proxyHost=192.168.100.1 \
-Dappdynamics.http.proxyPort=8080 \
-Dappdynamics.http.proxyUser=proxyUserName \
-Dappdynamics.http.proxyPasswordFile=/opt/AppDynamics/MachineAgent/conf/proxy-credentials.txt"

Checking Agents Status

From controller, it is possible to check the status of the two agents.

From left menu, Servers > AppServers in AppServers>Health tab. Information about the uptime can be seen.

Category: Openbravo Monitoring