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.