Pre-requisites of QMetry Application and Report Server Installation

Before proceeding with the installation, please ensure the following:

Finalize Deployment Architecture

Follow QMetry Deployment Document to finalize the deployment architecture.

Here, let's take an example of a 2-Tier Architecture that requires 2 Linux Servers: One for " QMetry Application" and the other for " QMetry Reporting".

Note

All the servers depending on which architecture you decide, should have support for these commands

unzip
curl

Check "unzip", "curl" and "iptables" RPM are installed

To check unzip, curl, iptables, perform the following steps:

Run following commands

rpm -qa | grep unzip 
rpm -qa | grep curl
rpm -qa | grep iptables

If results to these commands is - NOT installed, then please follow the below steps:

Install the support to these commands

Steps to install the support commands:

Run following commands

yum install unzip -y
yum install curl -y
yum install iptables -y

Internet Access on Server

Internet access should be Enabled on all the servers. This is required in order to perform installation using docker.

Check Internet is working on Server(s)

Run below command to check the internet connectivity on servers.

Firewall Status

Firewall and selinux must be "Disabled" on all the servers while installing QMetry and Reports.

Check if Firewall is running on server(s)

systemctl status firewalld (or) firewall-cmd --statesystemctl stop firewalld 
systemctl disable firewalld

Check Selinux running on Server(s)

Get the current status of SELinux. Whether SELinux is enforcing, permissive, or disabled.

getenforce

(Output to this should be disabled)

Disable Selinux

To disable selinux, perform the following steps:

Open the file at location (/etc/selinux/config).
Change the option SELINUX to disabled. (SELINUX=disabled).
After changing, restart the server.

Proxy Servers checks

Ensure if the Proxy Servers are NOT blocking downloads from the Internet.

Needs Servers to communicate

QMetry Application Server and Report server should be in the same network.
Report Server should be able to communicate with the QMetry Application Server over 80/443 and Database Server 3306/DB Port.

Check Ports on Remote Server is Open

The ports 80/443 and 3306 should be free. Check with telnet, nc and nmap using below commands.

telnet <host IP> <host port> (if telnet command not found then run => yum install telnet -y)
nc -vz <host IP> <host port> (if nc command not found then run => yum install nc -y )
nmap -p <host port> <host IP> (if nmap command not found then run => yum install nmap -y)
netstat -tunlp (if netstat command not found then install this command => yum install net-tools -y )
or
ss -nutlp

User Role to Install Docker

Docker installation requires root user access. Run below commands to start installation with root user.

sudo su (for EC2 instance)
su - (for Centos / Redhat)

Disk Space Allocation for Installation

Docker is installed under (/var/lib/) directory.
Make sure to allocate enough space so QMetry can store your data properly.

Disk Space allocation for Database

Data of QMetry database is saved under: /var/lib/docker/volumes/qmetry_mysql_data/_data.
To check Disk space at directory level use below command.
```
df -h
```

Where can I get required installation files?

Get the following files from QMetry Support:

QMetryApp.zip
QMetryReport.zip
Docker Credentials required for installation.

In this section: