8. [Windows] Update Sessions to 2.2.7

Important_icon.pngImportant:

  • The instructions below guide you through the process of updating Sessions to version 2.2.7, which needs to be performed after updating qTest to version 7.7.3. qTest instructions can be found here.
  • Before you install Sessions, please check to make sure:
      • Redis version 2.4.6+ has been installed and running (click here to download).
      • Elasticsearch version 1.7.3 has been installed and running (click here to download).
      • PostgreSQL version 9.3+ has been installed and running (click here to download). 

Double click on the qTest Sessions installer to start the updating process. qTest Sessions installer can be downloaded here

Click the Next button to proceed

button-round-warning-icon.pngNOTE: The configurations below will auto-fill based on your existing qTest Sessions configuration. If you want to maintain the existing configurations, then click Next through these screens. 

OPTIONAL: Specify web server ports for qTest Sessions. 

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

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

However, you can freely define your own ports depending on security rules of your IT department by selecting the "Use custom ports".

Important_icon.pngImportant:

  • Please make sure the ports you've specified above are not blocked by your firewall.
  • When specifying the port numbers, make sure the selected ports are all available and there are no applications being run on them. Follow instructions here to check your network ports.

Once you have finished defining these ports, click on Next button to proceed to the next stage.

OPTIONAL: You can enable SSL connections (HTTPS) to and from qTest Sessions. If you have an existing certificate, you need to specify the locations of the Certificate file and the Private Key file. You can optionally provide your Chain Certificate, which is your certification authority's certificate. Click Next button to continue.

Important_icon.pngImportant:

  • If your qTest is using SSL, it is required that qTest Sessions also uses SSL.

Specify information to connect to your PostgreSQL database, including host, port number, credentials and the schema name. If you click on the checkbox Reset data, all data in the database schema will be removed. Click Next to continue.

Important_icon.pngImportant:

  • The database schema must be created in advance. Click here for the instructions.

Specify information to connect to the Redis server; including host and port number. Click Next to continue.

Specify the information of your Elasticsearch server. qTest Sessions supports one cluster and one node. Click Next to continue.

button-round-warning-icon.pngHINT: By default, the cluster name is elasticsearch. Click here for the instructions to get the cluster name.

You may also change the default location to store session data. Click Next to continue.

Specify the URL and qTest Master Token to connect to your qTest instance. Click Next to continue.

Important_icon.pngImportant:

  • Your qTest instance must be running.
  • The port must be included in the URL.
  • If your qTest is using SSL, you need to input the URL with HTTPS protocol and HTTPS port. Eg: https://localhost:8443.
  • Click here for instructions to get your qTest Master Token.

After you have input all required information and click on Next button, the wizard starts configuring qTest Sessions services.

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.

Click Finish to exit the installation wizard.