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)
- Take a backup of <RUMAgent_Home>/conf/ folder and place it outside of the RUM_Agent home folder.
- Uninstall the old RUM Agent.
- Install the new RUM Agent and do not start it.
- Make the following changes in the new agent CONF files using the files in backup folder as reference:
- In <RUMAgent_Home>/conf/awsadapterconf.properties file, update the "webserver.port" key with the RUM Agent's HTTP port.
- In <RUMAgent_Home>/conf/sslservers.properties file, update the "rumagent" key with the RUM Agent's HTTPS port.
- If Geolocation API was configured earlier,
- Replace the <RUMAgent_Home>/conf/GeolocationAPIResources.xml file in the new agent with the backup file.
- In <RUMAgent_Home>/conf/AppServer.properties file, update the value of "geo.api.type" key as in the backup file.
- If HTTPS connection was enabled earlier,
- Replace the sslcerts folder in the new agent with the backup file.
- In <RUMAgent_Home>/conf/AppServer.properties file, update the value of "apm.rum.isHttps" key as in the backup file.
- Open the rumagent.properties file located under <RUMAgent_Home>/conf/sslcerts/ folder.
- Remove the encryptedkeypass key (if present).
- Update your keystore password in keypass key and save the changes.
- Start the RUM Agent.
- To verify if the RUM Agent has been upgraded successfully, access the RUM Agent web console (http://agenthost:agentport/)
- 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
New to ADSelfService Plus?
Related Articles
Real User Monitor (RUM) - Troubleshooting
If the monitor has not polled data for a long time, follow the steps below for troubleshooting: Step 1: Check the RUM Agent configuration Real User Monitor requires the RUM Agent to be installed and mapped to the Applications Manager. Refer the help ...Real User Monitoring Agent - Frequently asked questions
How to change Applications Manager details in RUM Agent? Open the AppServer.properties file located under <RUMAgent_Home>/conf/ directory in any text editor. Update Applications Manager hostname in apm.host key. Update Applications Manager SSL Port ...Self monitor Applications Manager using Real User Monitoring
We can monitor the Applications Manager using Real User Monitoring with a Java Script injection and this can be used to measure the Applications Manager's performance continuously. All you need is to install and setup the Real User Monitoring (RUM) ...How to get ISP and Region data in Real User Monitor?
The default setting of the Real User Monitor does not display ISP and region data for the end user. To obtain the data, you have the option to use a third-party Geolocation API. Currently, RUM exclusively supports APIs that provide responses in JSON ...How to enable HTTPS connection between end user and RUM Agent?
By default end user data will be collected and sent via HTTP connection to RUM Agent. To enable HTTPS connection you should have an valid SSL Certificate (keystore file basically), not a self signed certificate. This step applies only to RUM Agent ...