Manager 8.7.3 to 9.0 Single Server Upgrade Guide for Linux (non-Docker)


In this article, we provide step-by-step instructions to upgrade qTest Manager from 8.7.3 to 9.0 on a single CentOS/Ubuntu 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:

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

Back up qTest Manager 8.7.3

  1. Access your qTest Manager server.
  2. Log in as root user on your command shell.
  3. Access the installation directory of Manager 8.7.3.
    Example: /usr/local/qtestmanager873/qtestctl
  4. Stop qTest service:
    # systemctl stop qtest	
  5. Back up your database following the instruction here.
  6. Remove the qTest service.
    # ./uninstall	

Upgrade qTest Manager

  1. Access the qTest Manager server.
  2. Log in as root user on your command shell.
  3. Download the installation package provided to you by our Implementation Team.
  4. Extract the downloaded zip file.
  5. Access the extracted directory.
    Example: /usr/local/qtestmanager90/qtestctl
  6. Open file qtest.config and input the same configuration as in qtest.config of Manager 8.7.3 Example: /usr/local/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. It is mandatory if enable=true]'
          key = '[Location of your private key file on this server. 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]'
        logs = '[Enter a directory where logs are stored]'
        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 the outside of the server */
        ssl {
          port = [https port]
  7. After you have completed modifying the file, Save.
  8. Execute this command to initially set up the application.
    # ./qtestctl --offline start		
  9. The command will take control of the terminal. Keep it running.
  10. Open your web browser, and access qTest Manager using the URL specified above in qtest.config file.
  11. Validate if it has started successfully.
  12. Go back to the terminal and stop the running process.

Set up Linux Daemon

Follow instructions in this article to set up qtestctl as a Linux Daemon.

Import qTest License

After the upgrade, your qTest License file is not migrated to qTest Manager 9.0. You will need to manually copy the license file from qTest Manager 8.7.3 and then import to 9.0.

  1. Access 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 the Site Administration panel.
  2. Select the Import License File button.
  3. Browse to your license file located under the installation directory of qTest Manager v8.7.3: <installation_dir>/manager/build/.tc/license.lic
Powered by Zendesk