Help & Documentation
Open Support Ticket

Downgrading to Older Metric Insights Versions

This article explains how to roll back the Metric Insights Platform to a previously installed version. This procedure is typically used after a failed upgrade or when immediate reversion is necessary. The process looks as follows: create a backup, clean up the environment, restore from the backup.

NOTE: Metric Insights recommends testing any version rollback in a non-production environment whenever possible.

NOTE: Installing an older version of Metric Insights over newer version is NOT allowed. It is not possible because the databse schema will not be automatically rolled back to the older version, supported by the older MI version. Instead, follow the procedure described in this article.

1. Check List Before Downgrading

  1. Backup Required: Perform a complete backup before proceeding. Data loss is permanent if the rollback fails without a valid backup.
  2. Ensure you have access to https://get.metricinsights.com/.
  3. For Simple Install: Check whether the database version was changed.
    • If the database schema was changed, downgrade mysql by cleaning the data directory. Ensure that the Metric Insights version you are downgrading to supports the MySQL version on which you will rollback.

2. Initiate Rollback

2.1. Turn Off Application

mi-control stop

2.2. Delete and Recreate Dashboard and Dashboard_Dataset Databases

NOTE: Before deleting the databases, check the previously created backup for validity on the test environment, otherwise, all data may be lost.

Drop the dashboard and dashboard_dataset databases.

drop database dashboard;
drop database dashboard_dataset;

2.3. Re-Launch Installer

3. Check Rollback Status

  1. After an older version has been successfully installed, you should see the "successfully installed" message from the installer.
  2. Open the application from the browser, if the login page is displayed, you can proceed with a restore from the backup.

4. Restore from Backup

Run restore from the previously created backup.