Install or Update MI via Installation Packages

This article provides a step-by-step instruction on how to install Metric Insights on your virtual machine and describes the ways available to update the system to a newer version.


NOTE: Metric Insights by default installs to /opt. MySQL by default installs to /var. The installer and the application makes use of /tmp. If the three directories live as separate partitions on the host server, please ensure there is adequate disk space to support the application and database.

Metric Insights app directory = /opt/mi
MySQL default directory = /var/lib/mysql
Temp files = /tmp

For disk space requirements, please see What are the system requirements for a Metric Insights server?

1. Connect to the server by ssh

  1. Use ssh root@ and replace the zeros with the server IP address
  2. When prompted, enter the root password provided by your IT specialist

2. Download MI installation package

  1. Depending on the system version your organization plans to install, Metric Insights team will provide you with a link to a corresponding installation package version
  2. Along with a link, Username and Password should be provided by the MI support team.; enter credentials into corresponding fields
  3. Check the box to confirm your agreement with terms and conditions of Metric Insights usage
  4. Click Submit

The download process of the .zip archive containing all files required to install the system will begin.

3. Operating Systems Supported

3.1. Additional Actions for Operating Systems

Different operating systems require specific additional steps to be performed before and after installation process. Refer to the table below to learn additional commands that should be run for successful package installation.

If you are using a firewall on the linux machine, inbound TCP ports 443 and 8443 are necessary for Metric Insights to work correctly. To open them use the following commands:

Examples for iptables:

iptables -A INPUT -p tcp --dport 80 -m state --state NEW,ESTABLISHED -j ACCEPT
iptables -A OUTPUT -p tcp --sport 80 -m state --state ESTABLISHED -j ACCEPT
iptables -A INPUT -p tcp --dport 443 -m state --state NEW,ESTABLISHED -j ACCEPT
iptables -A OUTPUT -p tcp --sport 443 -m state --state ESTABLISHED -j ACCEPT
iptables -A INPUT -p tcp --dport 8443 -m state --state NEW,ESTABLISHED -j ACCEPT
iptables -A OUTPUT -p tcp --sport 8443 -m state --state ESTABLISHED -j ACCEPT

Examples for ufw:

ufw allow 80/tcp
ufw allow 443/tcp
ufw allow 8443/tcp

Examples for firewall-cmd:

firewall-cmd --zone=public --add-port=80/tcp --permanent
firewall-cmd --zone=public --add-port=443/tcp --permanent
firewall-cmd --zone=public --add-port=8443/tcp --permanent
firewall-cmd --reload
Operating System Additional steps
Centos 6, 7
    1. yum -y update
    2. sudo yum install epel-release
Debian 7 If you cannot get access to ssh root@, run the following command to verify whether the ssh service has been previously installed:
    service ssh status
If it is installed, the system will return the OK status, informing you that ssh is running. If the system perceives this command as unknown, install ssh servoce on Debian:
    apt-get install ssh
RedHat 7
    1. yum -y update
    2. cd /tmp/
    3. wget
    4. sudo yum install epel-release-latest-7.noarch.rpm
    5. subscription-manager repos --enable=rhel-7-server-optional-rpms

4. Unpack the downloaded zip archive using the following command

tar -xvf MetricInsights-Installer-<version_number>.tar.gz

5. Enter the new unpacked folder

cd MetricInsights-Installer-<version_number>

6. Initiate installation process


NOTE: This command can only be used by a root user.

7. MI Update via packages

NOTE: This method only works if MI has been initially installed via the installation package (as described above).

First, backup your data before executing upgrade. For this enter command below:


The backup file will appear in the directory /var/backups/mi-app-backups/

Further steps depends on whether your virtual machine is open to the web.

7.1. If VM (virtual machine) has open access to web

If the VM has open access to a web, all required code and additional files are pulled directly from the corresponding repositories upon issuing mi-update utility. The list of available arguments is described in the table below.

Positional Parameter
version Specify the exact version you want your system to be upgraded to.
Optional Parameters
-h, --help Request a help message listing all available parameters.
-y, --yes Assume yes on interactive questions.
-v, --verbose Output a diagnostic information for every file processed.
--download-only Download a package without installing it right away.
--download-folder {folder-path} By default, a new package is automatically downloaded into the folder you are currently in. If you want to download an installation package to another folder, use this command along with a path to that folder.
--channel {beta, release} By default, the updated version is downloaded from the same channel as your current version, but you can define another channel as a source of updates (Available options: beta, release).
--development {yes,no,auto} Define wther you want a development version of the application to be installed.(Available options: yes, no, auto. If this parameter is 'auto' or not determined, the value selected during the previous installation is to be applied.)
-T {full,lite,auto}, --type {full,lite,auto) Define the package type you want to download. (Available options: full, lite, auto. If this parameter is 'auto' or not determined, the value selected during the previous installation is to be applied.)

In case you want to upgrade your MI to specific release version, use a command below and replace the last argument with needed application version (e.g. 5.2.1):

mi-update -v --channel release --development no -T full 5.x.x

If you want to download release version package and install it later:

1. Download the package via command below in the current directory:

mi-update -v --channel release --development no -T full --download-only --download-folder . 5.x.x

2. Unpack downloaded package and run file with name “” inside.

7.2. If VM is closed off the web

If according to the company's security policy or due to any other reasons the Virtual Machine is closed off the web, the previous commands are not applicable. In this case a link to a package containing all the files necessary to update the system is provided by Metric Insights team.

NOTE: Internal mirrors should be set up to provide access to required repositories:

  • basic CentOS repositories (base, extras, updates -
  • epel repository -


Add your comment

E-Mail me when someone replies to this comment