Manager 8.4.4 to 8.7.3 Single Server Upgrade 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 upgrade qTest Manager from v8.4.4 to v8.7.3 on a single CentOS/Ubuntu machine. Please go through the guide below thoroughly before starting your installations. It is recommended to use copy & paste for the scripts

Before you begin

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

  • Your machine needs to satisfy qTest Manager's recommended hardware requirements
  • Please follow these instructions to back up your data prior to the upgrade process
  • Prerequisite packages must be running prior to upgrading qTest
    • PostgreSQL v9.5
    • RabbitMQ v3.5.4
    • Redis v2.8.19

Install Prerequisite Softwares

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

Upgrade qTest Manager

  1. Access qTest Manager server. Log in as root user on your command shell
    $ sudo su
  2. Change directory to the installation directory of qTest Manager v8.4.4 (eg: /usr/local/qtest-linux-8.4.4)
    # cd /usr/local/qtest-linux-8.4.4
  3. Shut down qTest Manager
    # ./
  4. Take note of qTest Manager v8.4.4's configuration information such as database, attachment directory and web ports. They will be used when configuring qTest Manager 8.7.3
    • View file
      # vim
    • Take note of following configuration
      DB_HOST=[PostgreSQL server's host name or IP]
      DB_PORT=[PostgreSQL server's port]
      DB_USER=[username to log in to PostgreSQL]
      DB_PASSWD=[password to log in to Postgres]
      DB_NAME=[qTest Manager's database name]
      WEB_PORT=[HTTP port]
      WEB_ADMIN_PORT=[HTTP port]
      ATTACHMENT_DIR=[directory which stores attachment]
      SEARCH_DIR=[directory which stores search index]
  5. Download the installation package
  6. Extract the downloaded zip file
    # tar qtestctl-3.5.2-linux-x64-full.tgz
  7. Access to the extracted directory (eg: qtestctl)
    # cd qtestctl/
  8. Open file qtest.config and input the same configuration of qTest Manager v8.4.4 as you have taken notes from the step above. Only information listed out in this guide needs 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 a directory where attachments are store. Please use \\ instead of \ in the path]"
      logs = "[Enter a directory where logs are stored. Please use \\ instead of \ in the path]"
      url = "http://[qTest Manager server's IP or hostname]:[HTTP port as specified above]"
  9. After you have done modifying the file, save it
  10. Execute this command to initially set up the application
    # ./qtestctl --offline start		


  11. 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
  12. Go back to the terminal and stop the running process
  13. Execute this command to set up qTest Manager as a Linux Daemon
    # ./install	


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

Import qTest License

After upgraded, your qTest License file is not migrated to qTest Manager v8.7.3. You will need to manually copy the license file from qTest Manager v8.4.4 and then import to v8.7.3

  1. Back up your license file from the installation directory of qTest Manager v8.4.4: <installation_dir>\local\.tc\license.lic
  2. Access to your qTest Manager instance via your browser using the URL as specified in qtest.config file. You will be redirected to the Licenses - Users under Site Administration panel
  3. Click Import License File button
  4. Browse to your license file

Uninstall qTest Manager v8.4.4

After verifying that qTest Manager v8.7.3 is working well, please remember to disable qTest Manager 8.4.4 or uninstall it.

  1. Access qTest Manager server. Log in as root user on your command shell
    $ sudo su
  2. Change directory to the installation directory of qTest Manager v8.4.4 (eg: /usr/local/qtest-linux-8.4.4)
    # cd /usr/local/qtest-linux-8.4.4
  3. Remove qTest Manager v8.4.4
    # ./

Enable secure connection to qTest Manager

As you can see while configuring qTest Manager v8.7.3, the installation package does not support SSL as in the previous version. 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