You can run the installer in one of three modes. The GUI and silent installation methods are described below. To start the installer in 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, as described below.
In addition, you can run the installer using a Response file (for unattended installations). See Installing with the Silent Installer.
Before starting, download the installer distribution and extract it on the target machine. You can get the EUM installer from the AppDynamics Download Center.
To secure connections from agents to the EUM Server, AppDynamics 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. If this is not possible in your installation, however, it is possible to connect with HTTPS directly to the EUM Server, as described below. For information on setting up a custom keystore for production, see Secure the EUM Server.
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 found on Secure the EUM Server. Configure Analytics in the Events Services Properties, and restart the EUM Server.
Note that Linux systems must have the
libaio library installed before you install the EUM Server. See the EUM Server Requirements for more information.
Run the on-premises EUM installer on the machine on which you want to install the EUM Server, as follows:
From a command prompt, navigate to the directory to which you downloaded the EUM installer.
Change permissions on the downloaded installer script to make it executable, as follows:
chmod 775 euem-64bit-linux-4.5.x.x.sh
Run the script as follows:
Run the installer:
Usernames and passwords can only consist of ASCII characters. In addition, passwords cannot include the characters '^', '/', or '$'.
In the AppDynamics End User Monitoring Setup screen:
With the initial configuration information gathered, the installer completes the setup of the EUM Server. When finished, the EUM Server is running.
After installing the EUM Server, you must perform the additional post-installation tasks:
Configure the Events Services properties in the
Secure the EUM Server by setting up a custom keystore
The EUM Server Installer only configures the HTTP port. If you are installing the 4.5 EUM Server or upgrading to the 4.5 EUM Server, you'll need to configure the EUM Server and update the AppDynamics Controller settings to connect to the HTTPS port. See Configure the HTTPS Port for the 4.5 EUM Server for instructions.
Update the JVM options in the
-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
Update the JVM options in the
# 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\""
Follow the provision instructions for your deployment:
To configure the Events Services properties in the
eum.propertiesfile for editing.
eum.properties file, enter the values as follows:
analytics.enabled=true analytics.serverScheme=http analytics.serverHost=events.service.hostname analytics.port=9080 analytics.accountAccessKey=1a59d1ac-4c35-4df1-9c5d-5fc191003441
<eum_key> is the Events Service key that appears as the
appdynamics.es.eum.key value in the Administration Console:
The configuration should appear similar to the following example:
eum.properties file, restart the EUM Server.
To connect the EUM Server with the AppDynamics Controller:
eum.cloud.host: http://eum-host-name:7001– This tells you where the controller will poll for EUM metrics.
eum.mobile.screenshot.host: eum-host-name:7001– This tells you where the Controller will look for mobile screenshots.
Instead of using the installer in GUI mode, you can use the silent installer to perform an unattended installation. The silent installer takes 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:
Create a file named
response.varfile on the machine on which you will run EUM installer with 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
Modify values of the installation parameters based on your own environment and requirements. Particularly ensure that the directory paths and passwords match your environment.
Run the installer with the following command:
./euem-64bit-linux-4.5.x.x.sh -q -varfile response.varfile
On Windows, use:
euem-64bit-windows-4.5.x.x.exe -q -varfile response.varfile