Knowledge Base

cancel
Showing results for 
Search instead for 
Did you mean: 

Troubleshooting Agent Issues - Installation and Start-up

This collection of articles will help users who are installing a new agent, upgrading an existing agent, or trying to resolve start-up failure

 

Installation

 

 

Q. I get the following error message when installing a Machine Agent. How should I proceed? 

Failed to find Premain-Class manifest attribute in /usr/share/appdynamics/machineagent.jar
Error occurred during initialization of VM

 

A. The error message shows that the Machine Agent jar was used as a Java Agent.

>java -javaagent:d:\AppDynamics\installs\3.5.6\MachineAgent\machineagent.jar -version
Failed to find Premain-Class manifest attribute in d:\AppDynamics\installs\3.5.6\MachineAgent\machineagent.jar
Error occurred during initialization of VM.  Agent library failed to init: instrument

 

Verify the command that is being used to start the Machine Agent. Follow the documentation to Install the Standalone Machine Agent. Open a separate command prompt and start the Machine Agent using  java -Dmetric.http.listener=true -jar machineagent.jar command.

 

 

Q. Is there a way to install the appDynamics database agent without the wizard, such as simply configuring the installation XML files? I want to monitor a client but I am having trouble when installing the agent. I cannot log in to the DB from outside the network and opening up the listener port on the DB for me right now is an issue. Is there a workaround?

 

A. You do not necessarily have to install the Database Agent on the database server. The database agent can reside on any server as long as that server can communicate to the database host. See Database Visibility System Requirements

 

Q. I'm having trouble installing a PHP Agent. What steps should I take?

 

A. After PHP Agent installation there are a few cases when the agent does not report to the Controller. Use the following article for basic troubleshooting steps to verify the installation and place the agent configuration files in proper place. PHP Agent installation troubleshooting guide.

 

Q. Is it possible to deploy an agent using Puppet?

 

A. Every deployment is different,  so this task doesn't lend itself to one master Puppet script maintained by AppDynamics. However, here is a sample that can help you get started on your own Puppet module. Agent deployment using Puppet.

 

Upgrade

 

Q. What are the steps to upgrade a mobile agent?

 

A. For iOS and Android, follow these steps. Upgrading Mobile Agents

 

Q. Where can I find information on how to upgrade an agent? 

 

A. The following documentation links will walk you through the requirements and steps for upgrading an agent.

 

 

Start-up

 

Q. My Analytics Agent fails to start and throws the following error message. What steps should I take?

java.lang.NoSuchMethodError: io.dropwizard.logging.LoggingFactory.bootstrap

 

A. This error message is normally caused by the presence of a duplicate jar file from a different version of the Analytic Agent. 

 

It can occur when the user unzips a new version of their machine-agent.zip file into the same directory where the older Machine Agent resides, creating a duplicate presence of the same jar files.

 

The solution is to first take a backup of the old agent, then delete or rename the Machine Agent, and then unzip the new machine-agent.zip . 

 

 

Q. My Analytic Agent fails to start and shows the following error message in the logs. What do I do?

Analytics agent failed to connect to the controller registration endpoint.

 

A. This issue occurs when using a self-signed certificate for the Controller. The Analytics Agent uses a truststore for the JRE to validate the certificate of the connecting server. The truststore does not have self-signed certificates added to the store by default.

 

Import the client certificate to the JRE truststore, which is located in the Java directory used by the Analytics Agent by default. Example: JAVA_HOME/lib/security/cacerts  
 
 

More Troubleshooting Guides:

 

 

Published 2/26/2018

 

 
Version history
Revision #:
8 of 8
Last update:
‎02-26-2018 01:51 PM
Updated by:
 
Labels (3)
Contributors
0 Kudos
Comments
nayakccna

C:\Users\xyz\Downloads\MachineAgent-4.4.2.742>java -jar C:\Users\xyz\Downloads\MachineAgent-4.4.2.742\machineagent.jar
Using Java Version [1.8.0_121] for Agent
Using Agent Version [Machine Agent v4.4.2.742 GA Build Date 2018-02-01 01:38:32]
[INFO] Agent logging directory set to: [C:\Users\xyz\Downloads\MachineAgent-4.4.2.742]

 

I am getting above mention issue.How i can resolve this for machine agent