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

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

    • How to identify and resolve conflicts between other APM products and the APM Insight .NET agent

      Problem statement: You are experiencing either of the below issues and suspect that another APM product is interfering with the Site24x7 .NET agent. 1. The .NET monitor is not created under APM > APM Insight > Applications, even after the .NET agent ...

    • Device/Licence Key

      Device Key is a unique and secure alphanumeric key that can be accessed by logging in and navigating to Admin > Developer > Device Key. It is an authentication mechanism where the Site24x7 agent pushes the performance metrics to site24x7.com to ...

    • Breakdown of the bulk action codes in the audit logs

      Use the below codes to read and understand the bulk actions in the audit logs: Bulk Action Codes Threshold Profile 0 Location Profile 1 Notification Profile 2 User Alert Groups 3 Check Frequency 4 IT Automation 5 Activate Monitor 6 Suspend Monitor 7 ...