Install a Production EUM Server

You can run the installer using one of the following methods:

  • Interactive console mode
  • GUI Installer
  • Silent Installer

The GUI and silent installation methods are described below. To start the installer using interactive console mode, start the installer with the -c switch. The console mode prompts you for the equivalent information that appears in the GUI installer screens.

Additionally, you can run the installer using a Response file (for unattended installations). See Installing with the Silent Installer.

Requirements

  • Before starting, download the installer distribution and extract it on the target machine. You obtain the EUM installer from the Download Center.

  • To secure connections from agents to the EUM Server, we strongly recommends that SSL traffic is terminated at a reverse proxy that sits in front of the EUM Server in the network path, and forwards connections to the EUM Server. However if this is not possible in your installation, it is possible to connect with HTTPS directly to the EUM Server. For information on setting up a custom keystore for production, see Secure the EUM Server.

    Warning: If you install and configure the Events Service with HTTPS support, you must perform a workaround for your EUM Server installation to complete properly. After the Events Service certificate configuration, install the EUM Server without Analytics enabled. Then, install the certificate into the EUM Server keystore following the steps described on the Secure the EUM Server page. Configure Analytics in the Events Services Properties, and restart the EUM Server.
  • Before you install the EUM Server, Linux systems must have the libaio library installed. See the EUM Server Requirements.

Install the EUM Server for a Production Deployment with the GUI Installer

Run the on-premises EUM installer on the machine on which you want to install the EUM Server.

  1. Start the installer:
    Linux
    1. From a command prompt, navigate to the directory to which you downloaded the EUM installer.
    2. Change permissions on the downloaded installer script to make it executable: 
      chmod 775 euem-64bit-linux-2.0.x.x.sh
    3. Run the script: 
      ./euem-64bit-linux-2.0.x.x.sh
    Windows

    Navigate to the directory where you downloaded the EUM installer, and then run the installer as Administrator: 

    euem-64bit-windows-2.0.x.x.exe
  2. In the Welcome screen, click Next to continue.
  3. Scroll to the end of the license agreement and accept the license agreement, then click Next to continue.
  4. Select the destination directory, and click Next to continue.
  5. Choose Product for the installation mode. This mode installs the EUM Server on this machine. Use this type if Splunk AppDynamics End User Monitoring and the Splunk AppDynamics Controller are installed on different hosts. Selecting this type will install a separate MySQL instance on this machine. Click Next.
  6. In the Database Setup screen:
    1. Enter a new Root User Password and confirm it.
    2. Enter a new eum_user Password and confirm it.
    3. Click Next.
      Important: Usernames and passwords can only consist of ASCII characters. In addition, passwords cannot include the characters '^', '/', or '$'.
  7. In the Splunk AppDynamics End User Monitoring Setup screen:
    1. Enter a new key store password and confirm it.
    2. Click Next, then click Finish.
This completes the initial configuration and setup of the EUM Server. When finished, the EUM Server is running.

Configure JVM Options

Windows

Update the JVM options in the $APPDYNAMICS_HOME\EUM\eum-processor\bin\eum-processor-launcher.vmoptions file. 

-XX:+UseConcMarkSweepGC
-XX:+HeapDumpOnOutOfMemoryError
-XX:CMSInitiatingOccupancyFraction=50
-XX:NewRatio=1
-Xms4096m
-Xmx4096m
-DEUM_COMPONENT=processor
-Dlogback.configurationFile=bin/logback.xml
-Dcom.mchange.v2.c3p0.cfg.xml=bin/c3p0.xml
Linux

Update the JVM options in the $APPDYNAMICS_HOME/EUM/eum-processor/bin/eum-processor file.

# Add default JVM options here. You can also use JAVA_OPTS and EUM_PROCESSOR_OPTS to pass JVM options to this script.
DEFAULT_JVM_OPTS="\
\"-server\" \
\"-XX:+UseConcMarkSweepGC\" \
\"-XX:CMSInitiatingOccupancyFraction=50\" \
\"-XX:+HeapDumpOnOutOfMemoryError\" \
\"-XX:NewRatio=1\" \
\"-Xms4096m\" \"-Xmx4096m\" \
\"-DEUM_COMPONENT=processor\" \
\"-Dlogback.configurationFile=bin/logback.xml\" \
\"-Dcom.mchange.v2.c3p0.cfg.xml=bin/c3p0.xml\""

Configure the Events Services Properties

Configure the Events Services properties in the eum.properties file:

  1. Ensure that Events Services is running.
  2. Navigate to the \EUM\eum-processor\bin directory.
  3. Open the eum.properties file to edit.
  4. In the eum.properties file, enter these values:

    Sample

    analytics.enabled=true
analytics.serverScheme=http
analytics.serverHost=hostname-events-service (needs to be the hostname of your Events Service)
analytics.port=9080
analytics.accountAccessKey=1a59d1ac-4c35-4df1-9c5d-5fc191003441

    The <analytics.accountAccessKey> is the Events Service key that appears as the appdynamics.es.eum.key value in the Administration Console:

    Events Service Key

    The configuration should display similar to this example:

    Configuration example
  5. After updating the eum.properties file, restart the EUM Server.

Connect the EUM Server with the Splunk AppDynamics Controller

Connect the EUM Server with the Splunk AppDynamics Controller:

  1. Log in to the Administration Console.
  2. Set these Controller properties:
    • eum.cloud.host: http://eum-host-name:7001 – Location where the Controller will poll for EUM metrics.
    • eum.beacon.host: http://eum-host-name:7001 – Location where the JavaScript Agent will be configured to send out beacons over the HTTP protocol.
    • eum.beacon.https.host: https://eum-host-name:7002 – Location where JavaScript Agent will be configured to send out beacons over the HTTPS protocol.
    • eum.mobile.screenshot.host: http://host-name:7001 – Location where the Controller will search for mobile screenshots.

Installing with the Silent Installer

Instead of using the GUI installer, you can use the silent installer to perform an unattended installation. The silent installer uses a response file as a source for the initial configuration settings. It's useful for scripting installation or performing large scale deployments.

To use a response file for installation:

  1. Create a file named response.varfile on the machine on which you will run EUM installer and include the following:
    sys.adminRights$Boolean=false
sys.languageId=en
sys.installationDir=/AppDynamics/EUM
euem.InstallationMode=split
euem.Host=eumhostname
euem.initialHeapXms=1024
euem.maximumHeapXmx=4096
euem.httpPort=7001
euem.httpsPort=7002
mysql.databasePort=3388
mysql.databaseRootUser=root
mysql.dbHostName=localhost
mysql.dataDir=/usr/local/AppDynamics/EUM/data
mysql.rootUserPassword=singcontroller
mysql.rootUserPasswordReEnter=singcontroller
eumDatabasePassword=secret
eumDatabaseReEnterPassword=secret
keyStorePassword=secret
keyStorePasswordReEnter=secret
eventsService.isEnabled$Boolean=true
eventsService.serverScheme=http
eventsService.host=eventsservice_host
eventsService.port=9080
eventsService.APIKey=1a234567-1234-1234-4567-ab123456
  2. Modify values of the installation parameters based on your own environment and requirements. Particularly ensure that the directory paths and passwords match your environment.
  3. Run the installer with the following command:
    Windows
    euem-64bit-windows-2.0.x.x.exe -q -varfile response.varfile
    Linux
    ./euem-64bit-linux-2.0.x.x.sh -q -varfile response.varfile