Versions Compared


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


Below are the prerequisites for QMetry Test Management application

1. Java v1.8.x must be installed (Reference: How to install Java), and JAVA_HOME must be setup.

titleExpand for steps to verify
  • To verify, execute command: java -version
  • Check your JDK 8 path using command:  sudo alternatives --config java
  • JAVA_HOME Environment Variable must be set:
    • To set JAVA_HOME variable
      • Run command: sudo export JAVA_HOME=/usr/java/jdk1.8.0_xx (Note: You need to replace the actual path and version of your Java installation directory)
    • To set PATH variable
      • Run command: sudo export PATH=$PATH:$JAVA_HOME/bin
    • To change above settings permanently which stays even after machine reboot
      • Run command: sudo vi /etc/environment then add below lines: (Replace the actual path and version of your Java Installation directory)
         export JAVA_HOME=/usr/java/jdk1.8.0_xx
         export JRE_HOME=/usr/java/jdk1.8.0_xx/jre
         export PATH
      • Save configuration with Esc + :wq!

2. Set Java Cryptography Extension (JCE)

titleDownload & Set Java Cryptography Extension (JCE)
 Set Java Cryptography Extension (JCE)

3. Installed MySQL v5.7.xx

titleInstalling MySQL

Downloading and Installing MySQL

  • Download the attached and copy it over to the /opt/ directory.
  • Execute the below command:
    • sudo chmod 775 /opt/

  • To Install MySQL, execute the below command which downloads and installs MySQL v5.7.23 
    • sudo sh -x /opt/
  • Restart MySQL services using below command:

    • sudo service mysql.server restart
  • Run the command: export PATH=$PATH:/usr/local/mysql/bin
  • To be able to access MySQL using `mysql` command, add the following lines to /etc/environment file.
    • Run command: sudo vi /etc/environment then press " i " to go into insert mode, and add the following lines:
    • export PATH=$PATH:/usr/local/mysql/bin
      export PATH
    • Save configuration with Esc + :wq!

The above steps install MySQL 5.7.23, under /usr/local/ directory. The username and password of MySQL are set to: username: root, password: qmetry

Note: MySQL Services can be started, stopped and restarted using below commands.

  • sudo service mysql.server start
  • sudo service mysql.server stop
  • sudo service mysql.server restart

4. Set /tmp directory to at least 15 GB

5. Request the license.key before-hand by providing the MAC address and Domain to QMetry Support ( for generating license specific to your server

Steps to install QMetry Test Management application


OptionsTypeDefault ValueComments/ Example
Do you want to upgrade an existing version of QMetry?MandatoryNo

Type "No" to begin a fresh installation of QMetry.

Enter Password of QMetry AdminMandatory


Password Policy- it must contain minimum 8 characters with at least one special character, at least one alphabet and at least one number. Allowed special characters are !@#$%^&*()

Re-Enter Password of QMetry Admin

Mandatory-Above Password
Enter email for QMetry AdminOptional-Provide QMetry Admin's email ID
Enter JVM Minimum Heap Memory in GBOptionalDefault - 3 GB3 GB
Enter JVM Maximum Heap Memory in GBOptionalDefault - 6 GB6 GB
Enter DB Connection Pool SizeOptional100100

Enter Domain URL


Public IP of your server or DNS name

Note: Provide this domain to Qmetry support to generate your license. Example: The value should not contain any protocols like http:// or https://

Enter Database Host

Mandatorylocalhost“localhost” or IP Address or DNS name

Enter Database Port

Enter Database Schema NameMandatoryqmetryqmetry

Enter Database Username


Enter Database Password


Enter Attachments Path


Enter SAML Config Path



Enter Domain SchemeMandatoryhttpChoose "http" or "https"
Enter DNS Name or IP AddressMandatorylocalhostEnter the server domain name OR keep it to localhost
Enter Port for the applicationMandatory80
  • Keep port 80 to access URL with HTTP and without port
  • Keep port 443 to access URL with HTTPS
  • OR change the port as required.