Installing .NET Agent on Linux

The following steps will guide you through installing the APM Insight .NET agent on a Linux system using Applications Manager.

Prerequisites

The Applications Manager Data Exporter is required for .NET Core Linux Agent monitoring. Ensure the Data Exporter is installed and running before proceeding with the agent setup.

Installation Steps

1. Install the Applications Manager Data Exporter for Linux to enable communication with the Applications Manager server.
2. Run the following commands to install the .NET agent for Linux:
   wget -O InstallNetCoreAgent.zip https://www.manageengine.com/products/applications_manager/54974026/InstallNetCoreAgent.zip && unzip InstallNetCoreAgent.zip
sudo -E ./InstallNetCoreAgent.sh -LicenseKey [LICENSE KEY] -ExporterHost [DataExporter Host] -ExporterStatusPort [DataExporter Status Port] -ExporterDataPort [DataExporter Data Port]
   where,
   • [DataExporter Host] - Data Exporter Host Name
   • [DataExporter Status Port] - Data Exporter Status Port
   • [DataExporter Data Port] - Data Exporter Data Port
   • [LICENSE KEY] - Applications Manager license key
3. Once the installation is complete, configure the agent environment by choosing any one of the following methods to load the agent into your .NET application:
   • Run Wrapper Script: Use the run-dotnetapm.sh script to start your application. For example,
     $APMINSIGHT_SCRIPTS_PATH/run-dotnetapm.sh dotnet <Your_Application>.dll
     Replace <Your_Application>.dll with your actual application DLL name. Optionally, set the APMINSIGHT_APP_NAME environment variable to define your application’s display name in Applications Manager.
   • Shell Environment Script: Load the agent environment into your shell sessions using any one of the following methods:
     • Load environment variables for current session: Run the following command to load the required environment variables in your current shell session:
       source $APMINSIGHT_SCRIPTS_PATH/set-shell-env.sh
     • Load agent environment across sessions: Add the following script to your shell profile (for example, .bashrc) to automatically load the agent environment and to persist the configuration across shell sessions:
       echo 'source $APMINSIGHT_SCRIPTS_PATH/set-shell-env.sh' >> ~/.bashrc
     Optionally, set the APMINSIGHT_APP_NAME environment variable to define your application’s display name in Applications Manager.
   • Manual Configuration: Manually set the following environment variables to enable .NET agent monitoring:
     CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER="{9D363A5F-ED5F-4AAC-B456-75AFFA6AA0C8}"
DOTNETCOREAGENT_HOME="/opt/manageengine/ManageEngineDotNetCoreAgent"
CORECLR_PROFILER_PATH_64="/opt/manageengine/ManageEngineDotNetCoreAgent/x64/libClrProfilerAgent.so"
CORECLR_PROFILER_PATH_32="/opt/manageengine/ManageEngineDotNetCoreAgent/x86/libClrProfilerAgent.so"
DOTNET_STARTUP_HOOKS="/opt/manageengine/ManageEngineDotNetCoreAgent/netstandard2.0/DotNetAgent.Loader.dll"
APMINSIGHT_LICENSEKEY="YOUR_LICENSE_KEY"
APMINSIGHT_APP_NAME="YOUR_APPLICATION_NAME"
     Specify the values for APMINSIGHT_LICENSEKEY as well as the APMINSIGHT_APP_NAME (optional) environment variables to connect and to define your application’s display name in Applications Manager.
4. After completing the above configuration, start or restart your application for the changes to take effect.