The .NET Agent provides a command-line unattended installation procedure for cases where you have multiple servers that require the same AppDynamics configuration. Using unattended installation, you only need to configure once, then use the command-line scripts to automate installation and instrumentation on multiple servers
For more detail about how to install and configure the agent manually, see Install the .NET Agent for Windows.
Create a Setup Configuration File
The .NET Agent MSI installer package allows you 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 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 AppDynamics Agent Configuration utility work with the 4.0 installer.
Launch the AppDynamics Agent Configuration utility from the command line. Use the
-sparameter to specify the setup configuration file destination.
- Go through the configuration wizard normally.
The configuration utility saves the setup configuration file to the path you specified.
The configuration utility only configures instrumentation for IIS applications.
- 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.
Sample Setup Configuration File
The following example shows a setup configuration file that instruments: two IIS Applications, MainBC and SampleHTTPService; a Windows service, MyWindowsService.exe; and a standalone application, MyStandaloneApp.exe.
The configuration file sets the log directory as
C:\ProgramData\AppDynamics\DotNetAgent\Logs and grants write permission to four accounts.
- Microsoft Distributed Transaction Coordinator (MSDTC): MSDTC must run under the NT Authority\NetworkServices account. See 'Verify MSDTC' on Troubleshoot .NET Agent Issues.
- Windows Management Instrumentation (WMI)
Perform unattended installation
- Launch an elevated command prompt with full administrator privileges. See Start a Command Prompt as an Administrator. Logging on to Windows as a member of the Administrators group does not grant sufficient permissions to run the installer.
Run the agent MSI installer package from the elevated command prompt. Use the
AD_SetupFileparameter to pass the absolute file path to the setup configuration file.
INSTALLDIR: Specify the directory to install the .NET Agent executables and supporting files.
DOTNETAGENTFOLDER: Specify the parent directory for local data including agent configuration files and log files.
If you specify the
DOTNETAGENTFOLDERon the command line and a
logFileDirectoryin the setup configuration file, the agent creates config and data folders under
DOTNETAGENTFOLDERbut writes the log files to the
logFileDirectoryspecified in the setup configuration file.
- Restart applications you have instrumented: IIS services, Windows services, and standalone applications.
For example, to restart IIS:
Setup Configuration File Properties
The Winston element is the root element of the configuration file.
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, AppDynamics uses the default directory:
Windows Server 2008 and later:
<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, AppDynamics grants write access to the Logs folder for the default accounts:
- LOCAL SERVICE
- NETWORK SERVICE
- ApplicationPool Identity
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.
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.
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.
<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" />
AppDynamics Agent element
The 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.
<appdynamics-agent xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">