Manager 8.4.4 to 8.7.3 Single Server Upgrade Guide for Windows

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 Windows machine. Please go through the guide below thoroughly before starting your installations.

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
  • Open the qTest Configuration Wizard of qTest Manager v8.4.4 and take notes of its configuration information. You will need to use these configurations for upgrading
  • Shutdown qTest Manager v8.4.4

Install Prerequisite Softwares

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

Upgrade qTest Manager

  1. Download the installation package
  2. Extract the downloaded zip file
  3. Access to the extracted directory (eg: C:\qtestctl)
  4. Open file qtest.config and input the same configuration of qTest Manager v8.4.4 as you have taken notes from the Configuration Wizard. Only information listed out in this guide needs to be updated. Other information should remain unchanged
    // 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]'
      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]"
  5. After you have done modifying the file, save it
  6. Open a Command Prompt as an Administrator and change directory to C:\qtestctl
  7. Execute this command to initially set up the application
    qtestctl.bat start		
  8. The command will take control of the Command Prompt. Keep it running. Open your web browser, access to qTest Manager using the URL specified above in qtest.config file to validate if it has started successfully
  9. Go back to the Command Prompt and stop the running process
  10. Execute this command to set up qTest Manager as a Windows service
  11. Start the Windows service. You may need to wait for few minutes for qTest Manager to be available
    net 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. 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
  2. Click Import License File button
  3. Browse to your license file located under the installation directory of qTest Manager v8.4.4: <installation_dir>\local\.tc\license.lic

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: Open Control panel > Uninstall a program > select to uninstall qTest Product 8.4.4 from the list of removable programs

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