Resolve .NET Agent Installation and Configuration Issues

Verify Agent Controller Communication

Use the AppDynamics UI to verify that the agent is able to connect to the Controller.

1. In a browser open:

   http://<controller-host>:<controller-port>/controller
   

   If you can't connect to the controller in Internet Explorer, see Check Internet Explorer proxy settings.

2. Log in to the AppDynamics UI.
3. Select the application to open the Application Dashboard.
4. In the left navigation panel click Servers > Tiers & Nodes and open the Health tab.

The Health tab lists the tiers, their nodes, and App Agent Status. When an agent successfully reports to the Controller, you see an "up" arrow symbol.

For details see Agent-to-Controller Connections.

• When deploying multiple agents for the same tier, determine whether you get the correct number of nodes reporting into the same tier.
• After sending a request to your web application, data should appear on the AppDynamics UI. The agents should be displayed in the Application Flow Map of the Application Dashboard.

If no data appears after a few minutes:

• Verify that the Agent is writing its log files:
  Windows Server 2008 and later: %ProgramData%\AppDynamics\DotNetAgent\Logs\AgentLog.txt
  Windows Server 2003: %AllUsersProfile%\Application Data\AppDynamics\DotNetAgent\Logs\AgentLog.txt

• If the log file exists, open it and review it for errors.
• If the log file doesn't exist, run the Windows Event Viewer and see the application messages.
• If there are no AppDynamics event messages, look for messages from the .NET Runtime.

Check Internet Explorer proxy settings

Misconfigured proxy settings in Internet Explorer may cause the App Agent for .NET to fail to connect to the controller. If Test Controller connection fails on the Controller Configuration window in the AppDynamics Agent Configuration utility, do the following:

1. Verify the Controller host and port settings are correct.

2. In Internet Explorer, open:

   http://<controller-host>:<controller-port>/controller
   

3. If the connection also fails in Internet Explorer, check the proxy settings.  See Change IE Proxy Settings.
4. Correct or remove any incorrect proxy settings.

Checklist for Resolving .NET Agent Installation Issues

	Item	Notes
	Run the installer as Administrator.	Verify Administrative privileges
	Verify that MSDTC is enabled and that it is running under the correct account.	Verify MSDTC is enabled and running under the correct account
	Verify permissions for Agent directory.	Verify that the .NET Agent directory has the correct permissions based on the site’s application pool identity.
	Verify that the Agent is compatible with the Controller.	Agent and Controller Compatibility
	Verify the correct settings in the config.xml: Windows Server 2008 and later: %ProgramData%\AppDynamics\DotNetAgent\Config\config.xml Windows Server 2003: %AllUsersProfile%\Application Data\AppDynamics\DotNetAgent\Config\config.xml	Update the config.xml file to include the .NET Agent Configuration Properties.

Resolve .NET Agent Installation Issues

If the Agent installation is failing, check the following configurations in your environment:

Verify administrative privileges

Ensure that you have the administrative privileges when you launch the installer. If the currently user doesn't have sufficient privileges, the installer prompts you for an administrator password.

Verify MSDTC is enabled and running under the correct account

If you encounter an error that MSDTC is not enabled or it is running under the wrong account, launch an elevated command prompt with full administrative privileges and execute the following command:

msdtc -install

Even if MSTDC is already installed, this command resets the service to run using the "NT Authority\NetworkServices" account.

Generate a log for agent installation failures

If the installer fails, use the command line utility to launch the installer.

msiexec /i $Path_to_the_MSI_File /l*v verbose.log

A verbose log for the .NET Agent is created at the same location where you saved the installer file.

Correct failed installation caused by other APM products

The .NET Agent installation may fail if there are other Application Performance Management (APM) products installed in the same managed environment. Remove the associated "Environment" subkey for certain services for the installed APM products.

Remove associated "Environment" subkey for W2SVC and WAS services in the registry:

1. Run Regedit or regedt32.
2. In regedit.exe, locate the following registry keys: 
   HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\W3SVC
   HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\WAS
3. Expand the keys.

4. Modify the Environment subkey to delete the following values:

   COMPLUS_ProfAPI_ProfilerCompatibilitySetting=EnableV2Profiler
       COR_ENABLE_PROFILING=1
       COR_PROFILER= {a GUID}

5. Restart the services. For more details see How to restart the W2SVC and WAS services?

Resolve Configuration Errors

• Ensure that you have correctly configured the config.xml file for the App Agent for .NET. For more detail, see .NET Agent Configuration Properties.

• If you made manual edits to the config.xml, check the AgentLog.txt and WarnLog.txt for errors. Invalid XML shows in the log as follows:

  2014-03-13 10:49:18.7199 1232 dllhost 1 1 Error ConfigurationManager Error reading the configuration file

Resolve Log Issues

The .NET Agent writes logs to the following directories: 

 %ProgramData%\AppDynamics\DotNetAgent\Logs

On Windows Server 2003, the directory is:

 %AllUsersProfile%\Application Data\AppDynamics\DotNetAgent\Logs

The agent will not generate logs if the agent directory does not have sufficient permissions.

Verify that the .NET Agent directory has the correct permissions

1. Click IIS > Application pools.
   IIS displays the list of application pools for your machine.
   
2. Right-click on a particular application pool.
3. Click Advanced Settings.
   
   IIS displays the Application Pool Identity for that application.
   
4. Ensure that your Agent Directory also has the same permissions as your site's application pools.
   • Navigate to AppDynamics .NET App Server Agent directory location.
   • Right-click on the "logs" directory for the App Server Agent and select Properties.
     
   • Click the Security tab and verify that the same Application Pool Identity is specified for the .NET Agent directory.
     

If the Agent's logs directory does not have the required permissions:

1. In the Security tab, click Edit.
2. Click Add to add new permissions to the Agent directory.
3. Click Advanced.
   
   
4. Click Find Now to find all the users, groups, or built-in security principals on your machine.
5. Select the required group (see the information given below for Allowed groups) from the list and click OK.
6. Provide the read and write permissions for the selected user/group/security principal to the Agent directory and click OK.
7. Click Apply.

Allowed groups for different IIS versions

For IIS v6.x, following settings are applicable for Application Pool Identities:

For IIS v7.0 and later, following settings are applicable for Application Pool Identities:

For example, if your application has the identity "ApplicationPoolIdentity", you must provide the permissions for "IIS_IUSRS" group to your Agent's directory.

Known Issues

You may ignore the following error from the AppDynamics.Agent.Coordinator service in the agent.log or warn.log:

2015-12-01 10:12:03.0435 3872 AppDynamics.Coordinator 1 7 Warn MaxQueueItemAgePolicy MaxQueueItemAge is beyond the integer limit: 13093467123