Manager 8.7.3 Single Server Installation Guide for Linux (non-Docker)

To request assistance with upgrading or to obtain the links to self-upgrade, please click here to fill out the Upgrade Request Form.

In this guide, we will run you through step by step to install qTest Manager v8.7.3 on a single CentOS/Ubuntu machine. Please go through the guide below thoroughly before starting your installations.

Before you begin

Before you install qTest Manager, make sure following things are done:

  • Your machine needs to satisfy qTest Manager's recommended hardware requirements
  • Prerequisite applications must be installed and running prior to installing qTest Manager
    • PostgreSQL v9.5
    • Erlang
    • RabbitMQ v3.5.4
    • Redis v2.8.19

Install Prerequisite Softwares

Please follow these instructions to install prerequisite app(s) as mentioned above.

Create qTest Database in PostgreSQL server

This step is to create a database name which will be used when you configure qTest Manager

  1. Access the PostgreSQL server
  2. Switch to postgres user
    $ su postgres		
  3. Access the PostgreSQL shell
    $ psql		
  4. List out the existing databases to avoid creating a duplicate database
  5. Create a database which will be used for qTest Manager and take note of its name
    create database [database_name];		

Install qTest Manager

  1. Access to your server and log in as root user on the command shell
    $ sudo su
  2. Download the installation package
  3. Extract the downloaded zip file
    # tar qtestctl-3.5.2-linux-x64-full.tgz
  4. Access to the extracted directory (eg: qtestctl)
    # cd qtestctl/
  5. Open file qtest.config and modify its content as described below. Only sections in blue need to be updated. Other information should remain unchanged
    # vim qtest.config
    // list of applications
    apps = ['manager']
    /* external tool configurations. these are used as shared configurations to construct applications below. */
    external {
      postgres {
        host = '[PostgreSQL server's IP or hostname]'
        port = [PostgreSQL server's port number]
        auth {
          user = '[PostgreSQL's username]'
          pass = '[PostgreSQL's password]'
        db {
          qtest = '[Enter a database name for qTest Manager as you created above]'
      redis {
        host = '[Redis server's IP or hostname]'
        port = [Redis server's port number]
      rabbitmq {
        host = '[RabbitMQ server's IP or hostname]'
        amqpport = [RabbitMQ server's AMQP port]
        stompport = [RabbitMQ server's STOMP port]
        vhost = '[The virtual hostname which will be used for qTest Manager]'
        auth {
          user = '[RabbitMQ server's username]'
          pass = '[RabbitMQ server's password]'
    /* application configurations */
    manager {
      port = [HTTP port which will be used for accessing qTest Manager through a web browser]
      data = "[Enter an absolute directory path where attachments are stored]"
      logs = "[Enter an absolute directory path where logs are stored]"
      url = "http://[qTest Manager server's IP or hostname]:[HTTP port as specified above]"
  6. After you have done modifying the file, save it
  7. Execute this command to initially set up the application
    # ./qtestctl --offline start		


  8. The command will take control of the terminal. Keep it running. Open your web browser, access to qTest Manager using the URL specified above in qtest.config to validate if it has started successfully
  9. Go back to the terminal and stop the running process
  10. Execute this command to set up qTest Manager as a Linux Daemon
    # ./install	


  11. Start the service. You may need to wait for few minutes for qTest Manager to be available
    systemctl start qtest

Configure qTest Manager

After qTest Manager has been installed successfully, you can access it via your browser using the URL as specified in qtest.config file

You will need to configure your qTest Manager instance and import your licenses before it is ready for your users. Please follow this guide: Configure Manager.

Enable secure connection to qTest Manager

You will need to use any proxy tools (such as HAProxy, nginx) which are available in your organization to enable SSL for qTest Manager. In this document, we do not provide instructions to set up SSL using the proxy tool.

Powered by Zendesk