Not a customer? Click the 'Start a free trial' link to begin a 30-day SaaS trial of our product and to join our community.
Existing Cisco AppDynamics customers should click the 'Sign In' button to authenticate to access the community
on 11-13-2018 11:56 AM
Installing an on-prem EUM server with an on-prem Controller can be tricky, so we’ve created a guide to walk you through the process and address areas where you might have questions.
Please note that this guide assumes that you have installed the following components:
It also assumes that the Controller and EUM Collector are HTTP. For details on this, see: How do I use my load balancer to decrypt HTTPS?
1. Go to download.appdynamics.com and download the appropriate EUM server.
2. Upload the EUM server to your host.
1. Open the admin console: http://<controller>:8090/controller/admin.jsp
2. Set the on-premise Events Service URL for both keys: appdynamics.on.premise.event.service.url
and eum.es.host
3. Grab and make note of the appdynamics.on.premise.event.service.key
value.
4. Open the file called events-service-api.properties
, which you can find under the Events Service conf directory. Make sure that the on-premise Events key matches the following values in the Events Service file called events-service-api-store.properties
. See Configure the Events Services Properties for details.
5. Stop and start the Analytics Service through the Enterprise Console or command line to pick up the new values.
6. To make sure it's configured correctly, click the "Analytics" tab and create a new search. Make sure that you do not have any AdBlockers running in your browser, since this can prevent the screen from loading properly.
7. Even though you have no analytics data, you should see the screen below. If the screen hangs for a while after creating a search and you get a grey pop-up box indicating that you don’t have an Analytics Service setup, something is wrong and you'll need to recheck the values.
Next, you need to install the EUM server, sync the license to get the key and set the Events Service values.
1. Install the EUM server.
sh euem-64bit-linux-
4.5
.
0.23508
.sh
2. Go through all the install steps (e.g., accepting the license agreement, Controller Database credentials and port settings).
3. Navigate to the directory:
cd /opt/appdynamics/EUM/eum-processor
4. Navigate back to the following directory:
/opt/appdynamics/EUM/eum-processor
5. Run the following command with the on-prem Controller license file.
./bin/provision-license /opt/appdynamics/controller/license.lic
6. You should see a similar payload (we need the "key" value from the license).
root@se43rccontroller:/opt/appdynamics/EUM/eum-processor# ./bin/provision-license /opt/appdynamics/controller/license.lic
Reading the license file at /opt/appdynamics/controller/license.lic
Successfully read the license file
Provisioning from license file /opt/appdynamics/controller/license.lic
Register the account ...
AccountRegistrationResult:
isValid:true, isAlreadyRegistered:false, description:Successfully completed account registration, Account{accountName='test-eum-account-kevinbrunette-1536344005088', globalAccountName='bogus global account name', key='[FILTERED]', timestamp=1536348662966, lastPassingMin=1536348660000, accountStatus='Y', activityStatus='Y', lastActivityTimestamp=1536348662966, activityVersion='0', controllerEumApiVersion='0', controllerVersion='unknown', crMapFilesGeneration='-1', analyticAccountCreated='N', licenseTermsUpdateSourcePrecedence='0', deleted=false, deletedTime='1970-01-01T00:00:00.000Z}
EUM Account [test-eum-account-kevinbrunette-1536344005088] with key [9522ea05-88e6-4690-bb41-4340fbd6d233] registered and license terms provisioned in the EUM PROCESSOR
root@se43rccontroller:/opt/appdynamics/EUM/eum-processor# pwd
/opt/appdynamics/EUM/eum-processor
root@se43rccontroller:/opt/appdynamics/EUM/eum-processor# ./bin/provision-license /opt/appdynamics/controller/license.lic
7. Make note of the key value in the example below since we will use it in the next step: 9522ea05-88e6-4690-bb41-4340fbd6d233
EUM Account [test-eum-account-kevinbrunette-1536344005088] with key [9522ea05-88e6-4690-bb41-4340fbd6d233] registered and license terms provisioned in the EUM PROCESSOR
8. Edit the eum.properties
file under /opt/appdynamics/eum/eum-proessor/bin/eum.properties
. The accountAccessKey should be the license key from the previous step. Make sure to set the serverHost value to your local Events Service cluster.
processorServer.httpPort=7001
processorServer.httpsPort=7002
processorServer.httpsProduction=false
processorServer.keyStorePassword=1wnl1u
# Analytics server properties
analytics.enabled=true
analytics.serverScheme=http
analytics.serverHost=129.146.149.37
analytics.port=9080
analytics.accountAccessKey=9522ea05-88e6-4690-bb41-4340fbd6d233
# Session properties
collection.sessionEnabled=true
crashProcessing.sessionEnabled=true
9. Save the file.
10. Navigate back to the eum-processor
folder.
cd /opt/appdynamics/EUM/eum-processor
11. Start the Server.
sh bin/eum.sh start
1. Log in to the admin controller.
2. Search for "key" in the top right.
3. Update the appdynamics.es.eum.key
value with the EUM license key from "Install and Configure Step 7”: 9522ea05-88e6-4690-bb41-4340fbd6d233
4. Make sure to update the EUM cloud host and beacon values with your on-prem EUM server.
5. Make note of the key: appdynamics.on.premise.event.service.key
value for future use. In this example, it’s 7e3195ae-bf2f-4150-9ec6-2b379f3fc17e
.
6. Open the file events-service-api-store.properties
which is under /opt/appdynamics/events-service/processor/conf
7. Update the keys in the file:
ad.accountmanager.key.eum
with the key from step 3 (9522ea05-88e6-4690-bb41-4340fbd6d233).
ad.accountmanager.key.controller
and ad.accountmanager.key.mds
with the appdynamics.on.premise.event.service.key
value from the previous step.Here is a key mapping guide! For a closer look, click on the image and expand it to full screen.
The sample events-service-api-store.properties
key values would be the following:
ad.accountmanager.keyNamesCSV=EUM,CONTROLLER,MDS,OPS,SLM,JF
ad.accountmanager.key.eum=9522ea05-88e6-4690-bb41-4340fbd6d233
ad.accountmanager.key.controller=7e3195ae-bf2f-4150-9ec6-2b379f3fc17e
ad.accountmanager.key.mds=7e3195ae-bf2f-4150-9ec6-2b379f3fc17e
ad.accountmanager.key.ops=de26c445-b059-4e41-9b93-0a2b50fa0ce5
8. Verify that these keys all match up.
9. For good measure, restart the Events Service. Once that is up, stop and start the EUM Server. To verify that your EUM Server and Events Service are up and running, follow the instructions outlined here.
1. Go the license page.
2. You should now see this instead of "Error retrieving license details":
Thank you! Your submission has been received!
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form