Provision the APM Dotnet Agent
On successfully downloading the APM Dotnet agent, you can provision the APM Dotnet agent.
- Connect to the host where the application is installed and copy the APM Dotnet agent software file that you downloaded to any preferred location.
- Unzip the
apm-dotnet-agent-installer-<version>.zip
file to a destination directory.The destination directory is the directory in which the APM Dotnet agent is provisioned. For example:
C:\tracer-home
Take note of this value since it's used in the next step: Deploy the APM Dotnet Agent.
- Check the subdirectories created in the destination directory.
The following subdirectories should exist:
- AdditionalDeps
- net
- netfx
- store
- win-x64
- win-x86
Optional - Register .NET Framework DLLs in GAC
This step is only required by .NET framework applications. If you do not have .NET framework application, skip this step.
To register .NET framework DLLs in GAC, do the following:
- Open PowerShell console and navigate to the destination directory where you provisioned the APM Dotnet agent.
- Run the following script in PowerShell and wait for all DLLs get registered completely.
[System.Reflection.Assembly]::Load("System.EnterpriseServices, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") | Out-Null $publish = New-Object System.EnterpriseServices.Internal.Publish $dlls = Get-ChildItem -Path .\netfx\ -Filter *.dll -File for($i = 0; $i -lt $dlls.Count; $i++) { $percentageComplete = $i / $dlls.Count * 100 Write-Progress -Activity "Registering .NET Framweworks dlls in GAC"` -Status "Module $($i+1) out of $($dlls.Count). Installing $($dlls[$i].Name):"` -PercentComplete $percentageComplete $publish.GacInstall($dlls[$i].FullName) } Write-Progress -Activity "Registering .NET Framweworks dlls in GAC"-Status "Ready" -Completed