Methods to upgrade .NET agent

Methods to upgrade .NET agent

Since version 2.0, .NET agent has the capability to manage updates automatically without user intervention. Also, the MSI based installer has the capability to overwrite any existing installations while retaining the settings. There are three methods by which the .NET agent can be upgraded:
  • Auto upgrade
  • Manual upgrade using Site24x7 console
  • Manual upgrade from user terminal
Auto upgrade
  • By default, this feature is disabled. To enable from the Site24x7 console, go to the respective APM Insight application > Click on Edit option > Edit APM Agent Configuration Profile > Enable Agent Auto-Upgrade.
  • This will ensure that whenever a new version of the agent is available, it is automatically upgraded without user intervention 
NOTE: During an upgrade, IIS will be reset. Choose a convenient schedule by selecting the day of the week and time where a short application downtime (for a couple of minutes) will be acceptable
  • Once the agent is successfully downloaded, a notification will be shown informing the date/time of the scheduled update, along with the option to cancel the scheduled update.
NOTE: Auto upgrade will only work for major version changes in agent. Minor version changes will not be covered.

Manual upgrade using Site24x7 console:
  • Whenever a new version of the agent goes live, a notification will be shown in the Site24x7 console, to enable upgrade from the Site24x7 console itself (if Agent Auto-upgrade is disabled)
  • Click Upgrade Now and select a convenient time window to schedule the agent upgrade 
NOTE: IIS will be reset during the upgrade resulting in a short application downtime (for a couple of minutes) during the upgrade process. Choose the schedule window accordingly
  • Once the agent is successfully downloaded, a notification will be shown informing the date/time of the scheduled update, along with the option to modify/cancel the scheduled update.
Manual upgrade from user terminal:
  • Whenever a new version of the agent goes live, the users will be notified in the Site24x7 console. The latest agent can be downloaded from Add APM Insight monitor page 
  • Once the latest version has been downloaded, login to the machine where the old agent is installed 
  • Install the latest version by double clicking on the MSI. During installation, an option to overwrite the existing installation will be shown
    • If you want to use non-UI installation, type in the command msiexec /i apminsight-dotnetagent.msi /qb editconfig=false /log apmUpgrade.log
  • Proceed with the installation. It will overwrite the existing version without loss of any settings.

    • Related Articles

    • Bundled .NET and .NET Core agents in a single MSI

      In APM Insight .NET agent version 6.8.0, the .NET and .NET Core agents have been bundled into a single MSI, enabling unified monitoring of both application types. Upgrade requirements for .NET Core agent 6.7 and below If you're using .NET Core agent ...

    • Install the Net-SNMP package in Windows for SNMP-based plugins (iDRAC and HP iLO)

      Installing the Net-SNMP package is an essential prerequisite for configuring SNMP-based plugins like Dell iDRAC and HP iLO. Follow the steps below to install the Net-SNMP package, set the path of Net-SNMP, and test SNMP walk. Download and install the ...

    • Prerequisites for Node.js agent installation

      For a smooth Node.js agent installation, ensure that you've fulfilled the following prerequisites. The environment should have node version 16.20.2 or above installed. The application user should have full permission to access the agent directory. ...

    • How to uninstall the Site24x7 Windows Server Monitoring Agent

      Method 1: To uninstall the Site24x7 Windows Server Monitoring Agent, click the link below: https://staticdownloads.site24x7.com/server/Site24x7WindowsAgentUninstall.zip Unzip and execute the Uninstall.bat file in the Command Prompt as an ...

    • Basic troubleshooting tips for the APM Insight Node.js agent

      If you are experiencing issues after installing the APM Insight Node.js agent, follow these troubleshooting tips. Verify agent installation and connectivity To verify the agent installation status, you can execute the following command from the root ...