APMInsight Guided-Installation Troubleshooting Steps

APMInsight Guided-Installation Troubleshooting Steps

Steps to troubleshoot errors while executing the Guided-Installation command: (Applicable for APM v172100 & above)

Prerequisite:

  1. Connectivity: Ensure that a connection between the Applications Manager server and the application server is established.
  2. PermissionPowerShell Script execution permission or terminal command execution with admin privilege is required for the targeted application server to execute the command below.

Common Errors and Solutions:

1. "Running Scripts is Disabled on This System"

  1. If you encounter this error, kindly enable the script execution policy & try running the command again. Steps to enable scripting in windows

2. "Unable to Connect to the Remote Server"

  1. Ensure that you can access the Applications Manager from the application-installed server. This can be verified by anyone of the below ways
    1. Accessing the Applications Manager UI from the application-installed server browser. 
    2. Use TELNET command to verify the connection between Applications Manager server and application-installed server. Open Command Prompt and execute the below command:
      1. Command: telnet <Applications_Manager_Server_IP> <Port>
      2. Example: telnet apm-server 9090

3. "Instance Limit Exceeded"

  1. If this error occurs, please ensure that you have a valid AppManager license and monitors count not exceeding the purchased limit. Navigate to "Settings" -> "Product License" -> "License Information" to refer license details. 

4. An Error Occurred While Downloading the Agent Zip File

  1. If you encounter this error, ensure there are no network restrictions that prevent file transfer between the application-installed server and the Applications Manager server. In case of any environmental restrictions, kindly use "Switch to manual steps" option in APM Insight Add Monitor page GUI to follow the manual installations steps.

How APM Insight Guided-Installation works ?

  1. Provide your application details in the Applications Manager GUI based on that we will generate a command to be executed in the Application-installed server. 
  2. Command will perform the steps like moving agent & other files to the application-installed server and also agent installation, configuration & connectivity checks. 
  3. Once agent installation is completed successfully, follow the steps shown in APM GUI to complete the monitor addition:
    1. For Java: configure 'JAVA Agent Argument' in your application startup file --> restart your application to be monitored --> perform some transactions to start monitoring.
    2. For DotNet: Ensure IISRESET is performed & then perform some transactions to start monitoring.

Reference Links:

  1. Java Agent Installation Help page
  2. Dotnet Agent Installation Help page



                  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 ...
                    • Troubleshooting steps if you don't see any data after installing the PHP agent

                      Problem statement: After installing the APM Insight PHP agent, you may encounter a situation where no data is displayed in the AppManager Console. Troubleshooting steps: 1. Ensure that both the APM Insight PHP agent and the AppManagerDataExporter ...
                    • 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 ...
                    • Troubleshooting steps to check if installation of PHP has been done properly

                      Please check if the below steps have been performed to successfully install PHP: Create a sample .php file within your web application that contains the following: <?php phpinfo();?> Navigate to this page in a web browser and scroll through the ...
                    • Troubleshooting steps for Server Hardware Health Monitoring

                      1. SNMP Mode of monitoring: Monitoring Dell hardware status: Dell OpenManage Server Administrator and make sure SNMP agent is enabled Installation steps:  http://www.dell.com/downloads/global/power/ps2q06-20050112-Lou-OE.pdf Monitoring HP hardware ...