Troubleshoot - RUM Agent silent installation
RUM Agent silent installation can fail on various factors based on your environment, troubleshoot with the help of error message shown while running the script. Below are the list of the error messages thrown from the script and its troubleshooting steps.
-
Unable to run the script
- RUM Agent already installed in path : <Path_provided_in_APM>
- Make sure Applications Manager is running and accessible. URL : <APM_URL>
- Redownload the script and perform installation!
- RUM Agent download failed. Check if you can manually download agent from the browser. <Download_link>
- RUM Agent installation failed!
Unable to run the script
-
Windows
- Run the downloaded installrum.ps1 file from the Powershell.
- Refer the help page to know the steps for enabling Powershell for script execution.
- Linux
- Run the downloaded installrum.sh file from the command line. (Command - sh installrum.sh).
RUM Agent already installed in path : <Path_provided_in_APM>
-
When RUM Agent is already installed in the provided installation path, installation script will fail with above message
-
To resolve the issue follow below steps
-
Go to Applications Manager -> Real User Monitor add monitor page -> Agent Configurations step
-
In Deploy Agent -> Change the installation path -> Provide another installation path
-
Download the script and run the new script again.
Make sure Applications Manager is running and accessible. URL : <APM_URL>
-
Applications Manager should be reachable from the RUM Agent server. If the server is down or not accessible RUM Agent installation fails with above message
-
To resolve the issue follow below steps
- Check if the URL shown in the error message is accessible in browser or check the ping result
- Open Applications Manager port in the firewall to make it accessible from the RUM Agent server (Check with the network team)
Redownload the script and perform installation!
-
RUM Agent download script will be valid only for two days. If the script is used for installation after two days above message will be shown
- To resolve the issue follow below steps
- Go to Applications Manager -> Real User Monitor Add monitor page -> Agent Configurations step
- In Deploy Agent -> Change the installation path (if required)
- Download the script and run the new script again
RUM Agent download failed. Check if you can manually download agent from the browser. <Download_link>
-
The script downloads RUM Agent from ManageEngine archives. If the archives link is not accessible from the RUM Agent server, RUM Agent installation will fail with above message.
- To resolve the issue follow below steps
- Check if the download link shown in the error message is accessible in browser or check the ping result (Check with the network team)
RUM Agent installation failed!
Windows
- In windows server only single RUM Agent installation is allowed. If RUM Agent is already installed in the server new agent installation script will fail
- To resolve the issue follow below steps
- Either install RUM Agent in new server or uninstall old RUM Agent from the Control Panel (if not required).
- From RUM Agent v3.9 we have PPM support for RUM Agent which you can directly use for upgrading RUM Agent
Windows and Linux
- Agent installation will fail when provided installation path has special characters which are not allowed in file naming. Above error message will be thrown.
- To resolve the issue follow below steps
- Try with different installation path without special characters.
- Check if you have required permission for the installation folder.
Still facing issues after performing above troubleshooting steps
- Contact Applications Manager support.
- Install RUM Agent manually in GUI mode. Refer the help page for the steps.
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 prerequisites to be done Real User Monitor requires the RUM Agent to be installed and mapped to the Applications Manager. Refer the help ...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. Open the AppServer.properties file ...How to troubleshoot Python agent installation or configuration
How to troubleshoot Python agent installation or configuration? Python Agent Check : Ensure that you have included the Python code snippet or are starting the application using Python as required. If not, refer to step 4 in this link. Make sure that ...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 ...How to upgrade Real User Monitoring Agent?
Currently, we don't have an update manager for the RUM Agent. Therefore, you need to uninstall the old agent and install the new RUM Agent. Steps to upgrade RUM Agent Take a backup of <RUMAgent_Home>/conf/ folder and place it outside of the RUM_Agent ...