Upgrade the .NET Agent from 3.7.8 through 3.8.6

Uninstall the Old Agent Version

  1. Stop IIS, instrumented Windows services, and instrumented standalone applications.
    Note: If you shut down IIS but continue to see active IIS Worker Processes, check the Application Pools pane in the IIS Manager and stop any started application pools.Failing to stop instrumented applications before uninstalling the .NET Agent may require you to reboot the machine.
  2. Stop the AppDynamics.Agent.Coordinator service.
  3. In the Control Panel, select Add/Remove Programs. Remove the AppDynamics .NET Agent.
    Note: In some cases, another process interferes with the .NET Agent uninstallation process by locking the profiler.dll. If uninstallation fails, use a utility such as

    Process Explorer

    to see if a process is using profiler.dll. If so, terminate the process. Otherwise, try rebooting the machine. Then retry the uninstallation.

Install the New Agent Version

  1. Stop w3wp processes for instrumented IIS applications. Stop instrumented Windows services or standalone applications.
  2. Download the MSI installer package from the Splunk AppDynamics Downloads.
  3. Launch an elevated command prompt with full administrator privileges. Logging on to Windows as a member of the Administrators group does not grant sufficient permissions to run the installer. See Start a Command Prompt as an Administrator.
  4. If you use a single-tenant Controller account, in the Controller click Settings > License > Account to view your access key.
  5. Run a command-line agent install. For single-tenant Controller accounts, specify your account access key using the AD_CONTROLLER_ACCOUNT_ACCESS_KEY parameter. For example:
    msiexec /i "%USERPROFILE%\Downloads\dotNetAgentSetup.msi" /l log.txt /q AD_CONTROLLER_ACCOUNT_ACCESS_KEY=changeme
    The installation runs silently in the background.
    Note: If you forget to add the account access key for a single-tenant Controller account, you can run the Agent Configuration Utility or manually add it to the config.xml later. See

    Account Element

    .
  6. Restart IIS:
    • Launch the Splunk AppDynamics Agent Configuration utility and click Restart IIS on the Configuration Summary window.or
    • Execute iisreset from the command line.
    Restart Windows services and standalone applications.