Steps to migrate APM Insight .NET and .NET Core agents to a new DC

DC migration steps for APM Insight .NET and .NET Core agents

.NET agent

  1. Obtain the new device key.
  2. Log in to the server and update the license.key value in the apminsight.conf file located at %ProgramData%\DotnetAgent\<appname>.
  3. Delete the existing instance information file, apminsight.net.info, located at %ProgramData%\DotnetAgent\<Appname>.
  4. Restart the APM Insight .NET agent service (Windows).

.NET Core agent

  1. Obtain the new device key.
  2. Log in to the server and update the license.key value in the apminsight.conf file located at <ApplicationPublishDirectory>\DotnetAgent\.
  3. Delete the existing instance information file located at <ApplicationPublishDirectory>\DotnetAgent\.
  4. Restart the application server or .NET process.


    • Related Articles

    • DC migration steps for APM Insight agents

      For Server based installations 1. Obtain the new device key. 2. Update the license.key value in the APM Insight configuration file (or the environment variable mentioned) with the new device key. The location varies for each agent, as listed below: ...
    • DC migration steps for APM Insight Node.js agent

      Obtain the new device key. Update the licenseKey value in the apminsighnode.json file located at the <application root directory>. Log in to the server and delete the existing instance information file apminsight.json located at <application root ...
    • DC migration steps for APM Insight Ruby agent

      Obtain the new device key. Update the license.key value in the apminsight.conf file located at <APP_HOME>/. Log in to the server and delete the existing instance information file, apminsight.info, located at <APP_HOME>/. Restart the Ruby application. ...
    • DC migration steps for APM Insight Java agent

      Obtain the new device key. Update the license.key value in the apminsight.conf file located at <apminsight-javaagent.zip Extracted Directory>/. Log in to the server and delete the existing instance information file apminsight.info located at ...
    • DC migration steps for APM Insight Python agent

      Obtain the new device key. Update the license.key value in the apminsight_info.json file located at the <application root directory>. Log in to the server and delete the existing instance information file located at the <application root ...