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

    • Troubleshoot the Error 404 and Error 99 for RabbitMQ

      When installing the RabbitMQ plugin, you may encounter the following errors: HTTP Error 404: Not Found: This error usually occurs when Site24x7's RabbitMQ monitoring plugin attempts to access the /api/overview page of RabbitMQ, but the resource ...
    • Monitor websites that require a HTTP POST to determine availability

      You can monitor websites that require HTTP POST to determine availability. You can configure HTTP request methods to be passed (POST/GET/HEAD/POST XML) under the HTTP Configuration while adding a monitor itself. Log in to the Site24x7 client and ...
    • Site24x7 Real User Monitoring (RUM) - Data Collection

      When you include Site24x7 RUM beacon script in your web pages, the following data is collected. All data that's being collected is in accordance with GDPR compliance. Performance details of web page load time - Metrics like response time of web page ...
    • Setting up a website monitor w.r.t content match and HTTP configuration

      Regarding the website defacement (content match) configuration, you can set keyword checks to find the existence and non-existence of keywords in your HTML response. As far as the HTTP configurations are concerned, we support HEAD, GET, and POST ...
    • Difference between website monitoring and REST API monitoring

      Website monitoring allows you to monitor your websites and web applications to ensure that they are up and running. Website monitor verifies the availability of specified, addressable, standard HTTP and HTTPS URLs from over 100+ global locations and ...