Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Reverted from v. 3

Table of Contents
maxLevel2
absoluteUrltrue

...

  1. QMetry Installation is supported only on Linux  - Cent OS 7 and 8, and RHEL 7 and 8. No other OS is certified for QMetry Installation.
  2. Three Linux Servers are required: QMetry Database, QMetry Application, and QMetry Reporting tool. These three servers should be on the same network and able to communicate with each other. Refer QMetry Deployment Document for the requirements. All the servers should have support of these commands: unzip, wget, curl and vim.
  3. Internet access should be enabled on all 3 servers to install using docker.
  4. Firewall and selinux must be disabled on the server while installing QMetry and Reports.
  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 and Database Server 3306/DB Ports. Ports 8080 and 33061 should be enabled/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 33061.
  8. Docker installation requires root user access. To install using a non-root user, follow the steps specified here before starting the install on both QMetry and Report servers.
  9. Docker is installed under /var/lib/ directory. We recommend allocating enough space here to ensure QMetry has enough space to save your data.
    • Data of QMetry database is saved under : /var/lib/docker/volumes/qmetry_mysql_data/_data
    • Data of QMetry attachments added is saved under : /var/lib/docker/volumes/qmetry_attachment/_data
  10. Get the following files from QMetry Support : QMetryApp.zip, QMetryRDS.zip, Spark_Report_Install.zip and docker credentials required for installation. Post installation, QMetry Application and Report tool both should be configured either on https or http.
  11. If you are planning Jira integration with QMetry and Jira is running on https, make sure your QMetry is also running over https protocol. QMetry and Jira should run on the same protocol.
  12. Following Ports should be open:

...

InstallationPorts that need to be enabled
QMetry Database Server3306
QMetry Application80/443
QMetry Reporting Tool80/443, 8080, 8000, 33061

Setting up QMetry DB Server

Step 1. Copy the QMetryRDS.zip file received from QMetry Support to your database server. Navigate to the directory where this file is kept and execute the following commands.

...

After waiting for about a minute, command docker ps should return the following : 

Image Modified

Step 4 - Restart Reports Services

...

Go to QMetry > Customization > Insight Configuration

    Under Database Configuration tab
  • Enter Host : Reports Server Host Public IP/DNS
  • Enter Port : 33061
  • Enter Username : root
  • Enter Password : qmetryreports@!Nf0#
  • Enter Database Name : qtmanalytics

...

Cick Test to ensure successful connection and then hit

...

"

...

Image Removed

...

Test

...

and

...

Save"

...

Note : "Sync Data" is required first time after reports installation. Time taken to sync depends on amount of data in QMetry. Sync Progress and Status can be monitored as shown in the below screenshot. QMetry custom reports remain inaccessible during a sync in progress and is recommended to be run only during off-peak hours.

Users can start using QMetry Reports when the sync is completed. QMetry remains available during this time.

...

Image Added


Your QMetry and Reports Installation is complete.

...