Upgrade the .NET Agent from <= 3.7.7

Identify the right upgrade path based upon the method of tier naming and assignment (manual or automatic) and the type of application you instrument:

  • If you use manual tier naming and assignment, the installer package upgrades configurations for IIS applications and Windows services.
  • If you used automatic tier naming and assignment, run the configuration utility to update configurations.
  • If you used standalone applications with 3.7.7 or earlier, follow the steps for standalone applications on Configure the .NET Agent for Windows Services and Standalone Applications.

After installation, you may need to run the configuration utility to update your configuration and optionally remove legacy configurations.

Uninstall the Old.NET Agent Version

  1. Stop IIS and instrumented Windows services.

    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 .NET AgentVersion

  1. Stop w3wp processes for instrumented IIS applications. Stop instrumented Windows services or standalone applications.

  2. Download the MSI installer package from 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. Optional, if you use a single-tenant Controller account, in the Controller click Settings > License > Accountto 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.
    • Execute iisreset from the command line.
    Restart Windows services.

If you used the following environment variables with the earlier version, the MSI installer migrates the configurations to the new configuration file:

If you used the following environment variables with the earlier version, the MSI installer migrates the configurations to the new configuration file:

  • AppDynamicsAgent_CallGraphOptions
  • AppDynamicsAgent_DisableAppPools
  • AppDynamicsAgent_EnableInProcesses
  • AppDynamicsAgent_IgnoreCLREnv
  • AppDynamicsAgent_Profiler_Classes

Configure the .NET Agent

Configure the agent based on your method of tier generation and assignment: automatic or manual.

Note: The .NET Agent configuration utility only supports the configuration of one Controller per server. To configure multiple business applications, see Configure Multiple Business Application Support for .NET

Configure the Agent Using Automatic Tier Generation and Assignment

If you used automatic configuration with the earlier version of the .NET Agent, run the configuration utility to configure the agent:

  1. Use the .NET Agent Configuration utility to reconfigure instrumentation for IIS applications. Choose Automatic for the method of tier generation and assignment. See Configure the .NET Agent.

  2. Configure instrumentation for Windows services manually. See Configure the .NET Agent for Windows Services and Standalone Applications.

Configure the Agent Using Manual Tier Generation and Assignment

For agents using manual tier generation and assignment, the installer package migrates the configurations for IIS applications and for Windows services to the config.xml

Clean Up Legacy Configurations

You can clean up legacy configurations by launching the Splunk AppDynamics Agent Configuration utility. When the utility detects agent settings from a previous version, it offers you the option to clean up.

The cleanup procedure modifies the web.config files causing an IIS restart.

  1. Launch the Splunk AppDynamics Agent Configuration utility.

  2. SelectYesto clean up old Splunk AppDynamics configurations.

  3. Proceed through the wizard.
    • Verify or update the log directory, and grant write permissions to it.
    • Verify the controller connection information.
    • Verify or update manual tier assignment.

The utility removes these configurations:

    • Splunk AppDynamics configurations from web.config files for IIS applications and application.config files for Windows services.
    • Environment variables:
      • AppDynamicsAgent_IgnoreCLREnv
      • AppDynamicsAgent_CallGraphOptions
      • AppDynamicsAgent_EnableInProcesses
      • AppDynamicsAgent_DisableAppPools
      • AppDynamicsAgent_Profiler_Classes

Resume Monitoring

Start IIS and instrumented Windows services.