Oracle Cloud Infrastructure Documentation

Provision the APM Dotnet Agent

On successfully downloading the APM Dotnet agent, you can provision the APM Dotnet agent.

  1. Connect to the host where the application is installed and copy the APM Dotnet agent software file that you downloaded to any preferred location.
  2. 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.

  3. 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