This page explains how to set compatibility mode for the .NET Agent. Compatibility mode allows you to collect and view machine or server metrics on a server with Machine and .NET Agents installed. 

Before You Begin

Review the list of requirements and general information about compatibility mode: 

• .NET Compatibility Mode is required for metrics from a Machine Agent and a .NET Agent on the same server to be visibly associated with the same node in the Controller UI.
• Differences may exist between metric values reported by the Machine Agent and the .NET Agent due to different averaging rates and measurement methods.
• You must enable .NET Compatibility Mode on the Machine Agent.  
• When .NET Compatibility Mode is enabled:
  • Events from Service Availability and Custom Extensions appear in the Servers tab, but are not associated with .NET applications in the Controller UI.
  • The Controller UI may show the server name with "-java-MA" appended to the host ID. Thus, a Machine Agent with a <unique-host-id> set to "ABC" might appear as "ABC-java-MA" in the Controller UI. This is expected behavior; the "-java-MA" suffix indicates that the host has a Machine Agent running in .NET Compatibility Mode. 
• Do not specify the <application-name>, <tier-name>, or <node-name> properties on the Machine Agent. These properties are used with a Machine Agent on a host that has no other  Agents installed.

Enable Compatibility Mode

To enable .NET Compatibility Mode:

1. Enable .NET Compatibility Mode on the Agent using one of two methods: 
   • Set these options in <machine_agent_home>/conf/controller-info.xml: 
     1. <dotnet-compatibility-mode>true</dotnet-compatibility-mode>  
         You may need to add this line to the controller-info.xml file.
     2. <unique-host-id><unique-host-id-of-dot-net-agent></unique-host-id> 
        For both Agents to report metrics to the same node, the Machine Agent must use the same case-sensitive Unique Host ID used by the .NET Agent. See FAQs and Troubleshooting.

   • Set the ./bin/machine-agent system property to: ./bin/machine-agent -Dappdynamics.machine.agent.dotnetCompatibilityMode=true

2. Save the controller-info.xml file. 
3. Start or restart the Machine Agent to apply the changes.