Upgrading in-place Metric Insights v6.x Deployed in a Non-Orchestrated Environment

This article covers in detail how to upgrade in-place Metric Insights v6.x deployed in a non-orchestrated environment (also known as a Simple Install).

1. Create a Backup of Metric Insights

Make sure that a backup already exists, or create a new one by running:

$ mi-app-backup -vv

Note: Backups are stored in /opt/mi/backup.

2. Download and Unpack the Metric Insights v6.x Installer

Contact Metric Insights Support for the v6.x installer. Once you receive the download link, download the install package and copy it to the MI server.

Untar the MI v6 install package by running the following tar command:

$ tar xvf MetricInsights-Installer-v6.x.x-Full.tar.gz

Move to the v6.2.1 install directory:

$ cd MetricInsights-Installer-v6.x.x-Full

3. Run the Installer

If your application's architecture has not changed, run the same installer command that has been used before. You can do this by executing: ./installer.py --use-prior-command -v, otherwise, see the example commands below:

If MySQL runs locally on the same server, run the installer as follows:

$ sudo ./installer.py --bind-address 0.0.0.0 --timezone <timezone> -vv

If MySQL runs on a remote database server, run the installer as shown below. Note, MySQL 8 must already be installed on the remote database server with the recommended Metric Insights configuration.

  • If remote database server has the same timezone as MI app:
$ sudo ./installer.py --timezone <MI app timezone> --bind-address 0.0.0.0
--dp-hostname dataprocessor --seed-hostname seed --db-hostname <remote DB host>
--db-user <remote DB root username> --db-password <remote DB root password>
--components web,data-analyzer,dataprocessor,seed,monitoring -vv
  • If remote database server has a different timezone than MI app:

Prior to MI v6.2.5:

$ sudo ./installer.py -v --components web,dataprocessor,seed 
--db-hostname <remote DB host> --db-user <remote DB root 
username> --db-password <remote DB root user password> 
--timezone <MI app timezone> --dp-mysql-option 
'&serverTimezone=<DB server timezone>' --bind-address 0.0.0.0 
--dp-options '\-Duser.timezone=<MI app timezone>'

MI v6.2.5+:

$ sudo ./installer.py --bind-address 0.0.0.0 --db-hostname 
<remote DB host> --db-user <remote DB root username> 
--db-password <remote DB root password> --timezone 
<timezone> --mysql-timezone <MySQL timezone> 
--components web,data-analyzer,dataprocessor,seed,monitoring -vv

Note: Run ./installer.py --help to see the list of available installer options.