QMetry and Reports Installation on Linux - 3 Tier (RHEL8, RHEL9 & Podman)

1. Three Linux Servers are required:

   • QMetry Database

   • QMetry Application

   • QMetry Reporting tool

2. These three servers should be on the same network and able to communicate with each other. Refer QMetry Deployment Document for the requirements.

3. All servers should support the commands: unzip, wget, curl, and vim.

4. Enable internet access on all 3 servers to install using podman, in case of online installation.

5. Ensure Proxy Servers are not blocking downloads from the Internet.

6. Application, DB, and Report servers should be in the same network. QMetry and Report Servers should be able to communicate over 80/443 (8080/443 in case of rootless installation) and Database Server 3306/DB Ports. Ports 8080 and 3306 should be open on Reports Server to allow connections from QMetry application server.

7. The ports 80/443 and 3306 on the respective servers should be free and should not be in use by other applications. QMetry App server should be able to communicate with the reports server on port 3306.

8. Install podman and podman-compose utilities using root user.

9. Get the following files from QMetry Support:

   • QMetryApp.zip

   • QMetryRDS.zip

   • QMetryReport.zip

   Also, get container repository credentials for installation.

   Post-installation, QMetry Application and Report tool both should be configured either on https or http.

10. If you are planning Jira integration with QMetry and Jira is running on https, make sure QMetry is also running over https protocol. QMetry and Jira should run on the same protocol.

11. Following Ports should be open:

    Installation	Ports that need to be enabled
    QMetry Database Server	3306
    QMetry Application	80/443 (8080/443 in case of rootless installation)
    QMetry Reporting Tool	80/443, 8080, & 3306

After installing QMetry DB, you see the message: “ QMetry RDS Installation is complete.”

1. Copy the QMetryRDS.zip file

   Copy the file received from QMetry Support to your database server. Navigate to the file’s directory and run the following commands.

   sudo su (applicable only for installation using root user)
   unzip QMetryRDS.zip
   cd QMetryRDS 
   chmod +x qmetry.sh
   ./qmetry.sh

   Enter the following parameters:

   Options	Allowed Values	Default Value	Comments
   Do you want to make an online installation (Y/N)?	Y, y, N, n	Y	To begin the online installation, enter "Y". To begin the offline installation, enter "N".

2. Enter container repository credentials shared as a part of the installation package.

3. Once the script finishes executing, enter the following parameters

   Options	Details	Example
   Enter QMetry database password for root user	Enter QMetry Application Database Password for the root user.	QMetry@123

1. Copy the QMetryApp.zip file (received from QMetry Support) to your server, then go to its directory and run the following commands.

   unzip QMetryApp.zip
   

2. Run the following command.

   cd QMetryApp 
   sudo su
   chmod +x install.sh
   ./install.sh
   

   This prompts the following options. Select 2 for installing QMetry Application:

3. Enter the following parameter:

   Table 13. Online Installation

   Options	Allowed Values	Allowed Values	Comments
   Do you want to make an online installation (Y/N)?	Y, y, N, n	Y	To begin the online installation, enter "Y". To begin the offline installation, enter "N".

   
   
   

4. Enter docker credentials shared as a part of the installation package.

5. The installer asks for a directory path on the host machine to store QMetry application data (attachments, licenses, imports, and exports). Please provide a valid path, the system creates the directory if it does not already exist.

6. Once the script finishes executing, it will prompt to enter the following parameters:

7. The installation may take a while.

   Once the installation is complete, execute the following command.

   podman ps

   

8. Get your QMetry License and Install the app.

9. Access the QMetry application

   Default QMetry login credentials.

   • Username: admin

   • Password:<user specified password in Step#4>

   Note

   With installation, MySQL 8.4.8 is installed on port 3306. Below are the details:

   • Username: root

   • Password: <user specified password in Step#5>

   • Schema: <user specified Schema in Step#5>

   This installation installs QMetry over Apache Tomcat 11.0.5, MySQL 8.4.8 and Open JDK 17.0.2 in a podman container.

10. After the above steps are completed, log into QMetry application.

    • Go to "Admin" Profile and Edit the Profile.

    • Update Email of Admin in the Email field. Enter the Base URL as your QMetry URL.

1. For users evaluating QMetry

   • You should have received an evaluation license valid for 30 days along with the installation.

2. For users requiring a commercial license:

   • Server's domain name and mac address are required to generate your QMetry License. Follow the below steps to get your server mac address and send this information along with the domain name to QMetry Support to get your QMetry License generated. Send an email to qtmprofessional@qmetrysupport.atlassian.net to reach QMetry Support.

     • Execute the below command to get your server mac address. Then send the MAC address to QMetry Support to receive the license file.

       • ifconfig (MAC address of Ethernet card e.g. eth0/eth1)

     • Once you receive license.key from QMetry Support, you can follow the Steps to Apply License file .