Manager 8.7.3 to 9.0 Single Server Upgrade Guide for Windows


In this article, we provide step-by-step instructions to upgrade qTest Manager from 8.7.3 to 9.0 on a single Windows machine. Please read the instructions thoroughly before starting your installations.

To request assistance with upgrading or obtain the self-upgrade links, complete the Upgrade Request Form and reference the OnPremise Upgrades Guide.

Note: If you are performing a fresh install, use the OnPremise New Install Form and reference the OnPremise Install Guide.

Before You Begin

Read the following:

Back Up qTest Manager 8.7.3

  1. Access the Manager 8.7.3 installation directory as an Administrator.
    Example: C:\qtestmanager873\qtestctl
  2. Stop the qTest service.
    net stop qtest	
  3. Back up your database following these instructions. 
  4. Remove the qTest service.

Upgrade qTest Manager

  1. Download the installation package provided to your by our Implementation Team.
  2. Extract the downloaded zip file.
  3. Access the extracted directory.
  4. Open the qtest.config file.
  5. Input the same configuration as in the Manager 8.7.3 qtest.config.
    Example: C:\qtestmanager873\qtestctl\qtest.config
    • IMPORTANT: Replace the blue text in the brackets with your custom values. Only the information listed below in blue should be updated, all other data 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]'
      /* common configurations */
      common {
        ssl {
          enabled = [Set it to true to enable a secure connection (HTTPS) between users’ browsers and the server]
         // key, cert, and pass are only affected if enabled is set to true
          cert = '[Location of your certificate file on this server. Please use \\ instead of \ in the path. It is mandatory if enable=true]'
          key = '[Location of your private key file on this server. Please use \\ instead of \ in the path. It is mandatory if enable=true]'
          pass = '[pass is mandatory if your ssl cert requires a passphrase, leave it empty otherwise]'
      /* 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 or https]://[qTest Manager server's IP or hostname]:[HTTP port as specified above]' 
        /* use https if SSL is enabled */
        /* server's IP or hostname must be accessible from outside of the server */
        ssl {
          port = [https port]
  6. Save the file after modification is complete. 
  7. Open a Command Prompt as an Administrator and change the directory to C:\qtestmanager90\qtestctl
  8. Execute the following command to initially set up the application.
    qtestctl.bat --offline start		
  9. The command will take control of the Command Prompt. Keep it running.
  10. Open your web browser, and access qTest Manager using the URL specified above in the qtest.config file.
  11. Validate that qTest Manager has started successfully.
  12. Navigate back to the Command Prompt and stop the running process.

Set up Windows Service

Please follow instructions in this article to set up a Windows service for qTest.

Import qTest License

After the upgrade, you will need to manually copy the qTest License file from 8.7.3 and then import it to qTest Manager 9.0. 

  1. Access your qTest Manager instance via your browser using the URL as specified in the qtest.config file.
  2. You will be redirected to the Licenses - Users tab in the Site Administration panel.
  3. Select the Import License File button.
  4. Browse to your license file located under the installation directory for qTest Manager v8.7.3:
    Example: <installation_dir>\manager\build\.tc\license.lic
  5. Your license file will import into qTest manager 9.0.



Subscribe To Our Blog
Powered by Zendesk