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?