7. [Windows] Update Manager to 7.7.3

Important_icon.pngImportant:

  • Please back up your MySQL database prior to installing the update following these instructions.

These instructions provide step-by-step guidelines to update qTest from 7.2.3 to 7.7.3

Software requirements

Before you download the update for qTest OnPremise, first ensure that the prerequisite softwares are installed and running:

  1. MySQL version 5.6 has been installed and is running (click here to download).
  2. MySQL Connector/J version 5.1.34+ has been installed (This was introduced as a new prerequisite with qTest 5.x. Click here for instructions)
  3. If you are deploying qTest with a load balancer, RabbitMQ is required to be installed and running (click here to download)

button-round-warning-icon.pngNOTE:

  • qTest can be deployed either with single server instance or a load balancer. Please select one of these options from the links below.
  • For the Enterprise and Elite packages, after you have completed updating qTest, you will need to update Sessions.

Update qTest

A. Download qTest installers

qTest installer can be downloaded here. Once downloaded, double click on the installer to start the updating process.

B. Update qTest with Single Server Instance

  1. Double click on qTest installer to start the update:
  2. Click on Next to proceed:
  3. Select the option Single instance to deploy qTest with a single server. 


    button-round-warning-icon.pngNOTE: The configurations in Steps 4 through 8 below will auto-fill values based on your existing qTest configuration. If you want to maintain the existing configurations, then click Next through these screens. 
  4. OPTIONAL: By default, the Configuration Wizard has already indicated 3 port numbers for HTTP, Admin and HTTPS ports as follows:

    • HTTP port: 8080
    • Admin port: 8005
    • HTTPS port: 8443

    However, you can freely define your own ports by selecting "Use custom ports". Then type in the port numbers for each of the 3 port types.


    button-round-warning-icon.pngHINT:

    • Click here for the instruction to check which ports are available.
  5. OPTIONAL: In the next screen, you will have an option to enable a secureconnections (HTTPS) between users’ browsers andqTest OnPremise servers.

    If you have an existing certificate, you need to specify the locations of the Certificate file and the Private Key file by clicking on the Browse button.

    You can optionally provide your Chain Certificate, which is your certification authority's certificate.

  6. OPTIONAL: You may also change the default location to store attachments.
    WARNING: If you change the directory to a different folder, you won't be able to retrieve the existing attachments from the previous directory. Please keep the same directory if you wish you maintain existing attachments.
  7. OPTIONAL: Specify the path to MySQL Connector/J's jar file which is located in this server instance.

    button-round-warning-icon.pngHINT:

    • If you have not installed MySQL Connector/J on this server, please follow these instructions.
  8. OPTIONAL: You are required to configure the connection to your database. Database hostname and port number are required. You can either create a new database schema or use an existing one. 
    WARNING: If you change the database, qTest data will be refreshed until you configure back to the previous database. 

    There are 2 options:

    • Create a new MySQL database: The installer will create a new database with the name you specify. If you stick on Create using backup data from file, you will need to specify the backup file. The installer will restore data from the file to the new database.
    • Use existing external MySQL database: You can select one of the existing databases from the list.
  9. NEW: Similarly, as the above step, configure the database connection for the integration database. This is a new configuration step for qTest 6.0. 
  10. After you have input all required information and click on Next button, the wizard starts configuring the database and qTest services.
  11. After this process is done, you will be directed to the final information screen, where you can review all the installed components and their settings.

    At this stage, you can select to either Exit the Setup wizard by clicking the Finish button, or launch qTest immediately on your default web browser by selecting the "Launch qTest on the browser" check box. Then click on the Finish button.

NOTE: For the Enterprise or Elite packages - If you are updating qTest from a previous version, please proceed to update the new version of qTest Sessions.

C. Update qTest with Load Balancing

button-round-warning-icon.pngNOTE: These instructions can be used for updating an existing qTest server from a single mode into the load balancing mode.

  1. Double click on qTest installer to start the update:
  2. Click on Next to proceed:
  3. Select option Load balancing to deploy qTest


    button-round-warning-icon.pngNOTE: The configurations in Steps 4 through 9 below will auto-fill values based on your existing qTest configuration. If you want to maintain the existing configurations, then click Next through these screens. 
  4. OPTIONAL: Specify a couple of ports where you will accessqTest OnPremise throughyou web browser.

    By default, the Configuration Wizard has already indicated 3 port numbers for HTTP, Admin and HTTPS ports as follow:

    • HTTP port: 8080
    • Admin port: 8005
    • HTTPS port: 8443

    However, you can freely define your own ports by selecting "Use custom ports". Then type in the port numbers for each of the 3 port types.


    button-round-warning-icon.pngHINT:

    • Click here for the instruction to check which ports are available.
  5. OPTIONAL: In the next screen, you will have an option to enablesecured connections (HTTPS) between users’ browsers andqTest OnPremise server's.

    If you have an existing certificate, you need to specify the locations of the Certificate file and the Private Key file by clicking on the Browse button.

    You can optionally provide your Chain Certificate, which is your certification authority's certificate.

  6. OPTIONAL: You may also change the default location to store attachments.
    WARNING: If you change the directory to a different folder, you won't be able to retrieve the existing attachments from the previous directory. Please keep the same directory if you wish you maintain existing attachments.
  7. OPTIONAL: Specify the path to MySQL Connector/J's jar file which is located in this server instance.

    button-round-warning-icon.pngHINT:

    • If you have not installed MySQL Connector/J on this server, please follow these instructions.
  8. OPTIONAL: You are required to configure the connection to your database. Database hostname and port number are required. You can either create a new database schema or use an existing one. 
    WARNING: If you change the database, qTest data will be refreshed until you configure back to the previous database. 

    There are 2 options:

    • Create a new MySQL database: The installer will create a new database with the name you specify. If you stick on Create using backup data from file, you will need to specify the backup file. The installer will restore data from the file to the new database.
    • Use existing external MySQL database: You can select one of the existing databases from the list.
  9. OPTIONAL: Similarly as the above step, configure the database connection for the integration database. 
  10. NEW: Specify information to connect to Redis server; including host and port number. Click Next to continue.
  11. NEW: Specify information to connect to RabbitMQ server; including host, port numbers, the virtual host and the credentials of the user who was granted with the access. Click Next to continue.
  12. NEW: Select to install as Notification Server or as Application Server.
    • There must be only one Notification Server and qTest must be installed on it first.
    • You can install multiple Application Servers and specify the connection to the above Notification Server.
      • Internal URL: full URL from the internal network to the Notification Server, including TCP port
      • External URL: full URL from the internet to the Notification Server, including TCP port
  13. After you have input all required information and click on Next button, the wizard starts configuring the database and qTest services.
  14. After this process is done, you will be directed to the final information screen, where you can review all the installed components and their settings.

    At this stage, you can select to either Exit the Setup wizard by clicking Finish button, or launch qTest immediately on your default web browser by selecting the "Launch qTest on the browser" checkbox.", then click on Finish button.

NOTE: For the Enterprise or Elite packages - If you are updating qTest from a previous version, please proceed to update the new version of qTest Sessions