Unattended Installation for .NET

The .NET Agent provides a command-line unattended installation when you have multiple servers that require the same Splunk AppDynamics configuration. Using unattended installation, you only configure once, and then use the command-line scripts to automate installation and instrumentation on multiple servers

To install and configure the agent manually, see Install the .NET Agent for Windows.

Create a Setup Configuration File

You can use the .NET Agent MSI installer package to specify the path to a setup configuration file to perform an unattended installation. The setup configuration file contains all the properties you need to enable instrumentation for your .NET applications.

You must run the .NET Agent MSI installer package on one machine before you can use the Splunk AppDynamics Agent Configuration utility to create a setup configuration file. See Install the .NET Agent for Windows.

Setup configuration files created in previous versions of the Splunk AppDynamics Agent Configuration utility work with the 4.0 installer.

  1. Launch the Splunk AppDynamics Agent Configuration utility from the command line. Use the -s parameter to specify the setup configuration file destination.
    CODE 
    %ProgramFiles%\AppDynamics\AppDynamics .NET Agent\AppDynamics.Agent.Winston.exe -s <path to setup configuration file>

    For example:

    CODE 
    %ProgramFiles%\AppDynamics\AppDynamics .NET Agent\AppDynamics.Agent.Winston.exe -s "c:\temp\configurationSavedSetupConfiguration.xml"
  2. Complete the steps of the configuration wizard step. The configuration utility saves the setup configuration file to the path you specified.
    Note: The configuration utility only configures instrumentation for IIS applications.
  3. (Optional) To perform the unattended installation for Windows services or for standalone applications, you must edit the setup configuration file manually. See Configure the .NET Agent for Windows Services and Standalone Applications.

Setup Configuration File Properties

Winston Element

The Winston element is the root element of the configuration file.

Required element: <winston>

Log File Directory Element

The Log File Directory element is a child element of the Winston element. Use the directory attribute to specify the log directory. If you omit the logFileDirectory element, Splunk AppDynamics uses the default directory:

Windows Server 2008 and later: %ProgramData%\AppDynamics\DotNetAgent\Logs

Optional element: <logFileDirectory directory="C:\ProgramData\AppDynamics\DotNetAgent\Logs" />

Log File Folder Access Permissions Element

The Log File Folder Access Permissions is a child element of the Winston element. Unless you set the defaultAccountsEnabled attribute to false, Splunk AppDynamics grants write access to the Logs folder for the default accounts:

  • LOCAL SERVICE
  • SYSTEM
  • NETWORK SERVICE
  • ApplicationPool Identity

Optional element: <logFileFolderAccessPermissions defaultAccountsEnabled="false">

Account Element

The Account element is a child element of the Log File Folder Access Permissions element. Create an Account element for the Windows account you use to run your application.

Set the name attribute to the name of the account you use to run your application, that is the account for the application pool for IIS or the Windows service account.

The display name attribute is a user-friendly name you choose for the account. The display name shows up in log entries about assigning permissions for the account.

Optional element: <account name="MyAppPoolIdentity" displayName="Custom ApplicationPool Identity" />

For example, if you run a Windows service under a domain account:

<account name="MYDOMAIN\service_acct" displayName="Domain Service Account" />

Splunk AppDynamics Agent Element

The Splunk AppDynamics Agent element is a child of the Winston element. It follows the same format as the config.xml file to define the agent configuration for all your .NET applications. See .NET Agent Configuration Properties.

Required element: <appdynamics-agent xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">