How to upgrade Real User Monitoring Agent?

How to upgrade Real User Monitoring Agent?


For RUM Agent v3.9 and above, refer the help page to know the steps for installing service pack (.ppm file).

Steps to upgrade RUM Agent (For RUM Agent v3.8 and below)
  1. Take a backup of <RUMAgent_Home>/conf/ folder and place it outside of the RUM_Agent home folder.
  2. Uninstall the old RUM Agent.
  3. Download new RUM Agent from here.
  4. Install the RUM Agent and do not start it.
  5. Make the following changes in the new agent CONF files using the files in backup folder as reference:
    1. In <RUMAgent_Home>/conf/awsadapterconf.properties file, update the "webserver.port" key with the RUM Agent's HTTP port.
    2. In <RUMAgent_Home>/conf/sslservers.properties file, update the "rumagent" key with the RUM Agent's HTTPS port.
  6. If Geolocation API was configured earlier,
    1. Replace the <RUMAgent_Home>/conf/GeolocationAPIResources.xml file in the new agent with the backup file.
    2. In <RUMAgent_Home>/conf/AppServer.properties file, update the value of "geo.api.type" key as in the backup file.
  7.  If HTTPS connection was enabled earlier,
    1. Replace the sslcerts folder in the new agent with the backup file.
    2. In <RUMAgent_Home>/conf/AppServer.properties file, update the value of "apm.rum.isHttps" key as in the backup file.
    3. Open the rumagent.properties file located under <RUMAgent_Home>/conf/sslcerts/ folder. 
    4. Remove the encryptedkeypass key (if present).
    5. Update your keystore password in keypass key and save the changes.
  8. Start the RUM Agent.
  9. To verify if the RUM Agent has been upgraded successfully, access the RUM Agent web console (http://agenthost:agentport/)
    1. RUM Agent version and Applications Manager connectivity status can be seen in the RUM Agent UI (Supported only from RUM Agent version 3.5)



RUM Agent will be mapped to Applications Manager with the details provided in the installation shield.

Other help links
  1. RUM Agent FAQs
  2. RUM Agent Download Page