Pre-requisites of QMetry Application & Report Server Installation
- 1 Pre-requisites of QMetry Installation
- 2 Check "unzip", "curl" and "iptables" RPM are installed
- 3 Install the support to these commands
- 4 Internet Access on Server
- 5 Check Internet is working on Server(s)
- 6 Firewall Status
- 7 Check if Firewall is running on server(s)
- 8 Check Selinux running on Server(s)
- 9 Disable Selinux
- 10 Proxy Servers checks
- 11 Needs Servers to communicate
- 12 Check ports on remote server is open
- 13 User role to install Docker
- 14 Disk Space allocation for Installation
- 15 Disk Space allocation for Database
- 16 Where can I get required installation files?
Pre-requisites of QMetry Installation
Finalize the Deployment Architecture by following QMetry Deployment Document.
Here, let's take an example of a 2-Tier Architecture that requires 2 Linux Servers: One for "QMetry Application" & the other for "QMetry Reporting".
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
Steps to check:
Login to Server(s)
Run following commands -
rpm -qa | grep unzip
rpm -qa | grep curl
rpm -qa | grep iptablesIf 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:
Login to Server(s)
Run following commands -
yum install unzip -y
yum install curl -y
yum install iptables -yInternet 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.
Login to Server(s)
ping google.comFirewall Status
Firewall and selinux must be "Disabled" on all the server(s) while installing QMetry and Reports.
Check if Firewall is running on server(s)
Login to Server(s)
systemctl status firewalld (or) firewall-cmd --statesystemctl stop firewalld
systemctl disable firewalldCheck Selinux running on Server(s)
This below command will report the current status of SELinux. Whether SELinux is enforcing, permissive, or disabled.
getenforce(Output to this should be disabled)
Disable Selinux
Steps to disable selinux:
1. Open the file at location (/etc/selinux/config)
2. Change the option SELINUX to disabled. (SELINUX=disabled)
3. After changing, restart the server.
Proxy Servers checks
Ensure if the Proxy Servers are NOT blocking downloads from the Internet.
Needs Servers to communicate
1. QMetry Application Server and Report server should be in the same network.
2. 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 and should not be in use by other applications. 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 -nutlpUser 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
1. Docker is installed under (/var/lib/) directory.
2. We recommend, allocating enough space here to ensure QMetry has enough space to save your data.
Disk Space allocation for Database
1. Data of QMetry database is saved under: /var/lib/docker/volumes/qmetry_mysql_data/_data
2. To check Disk space at directory level use below command.
df -hWhere can I get required installation files?
You will get the following files from QMetry Support:
1. QMetryApp.zip
2. QMetryReport.zip
3. Docker Credentials required for installation.