1.3 [Windows] Install qTest Sessions 3.0.x OnPremise

  IMPORTANT: qTest Sessions v3.0.1 only works with qTest v8.1

Before you begin

  • Download qTest Sessions 3.0.1
  • For qTest Premium and Elite editions, you will need to install qTest Sessions after you have installed qTest
  • Before proceeding, please make sure qTest is running and your qTest license file has been imported. If not, click here for instructions
  • Please check qTest's recommended hardware requirements
  • Prerequisite packages must be installed and running prior to qTest Sessions installation
    • PostgreSQL v9.4
    • Redis v2.8+
    • Elasticsearch v1.7 - v2.4.0
  • If you are upgrading qTest Sessions, please follow these instructions back up your data prior to the upgrade process

A. Install Prerequisite Softwares (Part 1 of 2)

»Install PostgreSQL on Windows Server

»Install Redis on Windows Server

»Install ElasticSearch on Windows Server

B. Install qTest Sessions (Part 2 of 2)

»Install qTest Sessions

»Configure qTest to connect to Sessions

Install qTest Sessions

  1. Download qTest Sessions 3.0.1 and double click on the installer to start the installation
    sessions-1
  2. Click the Next button to review our EULA document before proceeding
    sessions-2
  3. Select the option "I accept the terms in the License Agreement." Then click the Next button to move on to the next page, in which you will be given 2 options to perform the installation:
    • Express install: This will allow you to install with default installation directory and Start menu folder
    • Custom install: This will allow you to manually select the installation directory and Start menu folder
    sessions-3
  4. Select the Express install option, then click on Next to review the default Installation settings as illustrated below. If you would like to change these settings, click Back to return to the previous screen and select Custom install
    sessions-4
  5. Once you accept with the default settings (or enter custom settings), click on the Install button to let the installer start extracting files into the installation directory
    sessions-5
  6. After the files are extracted, you will be allowed to 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 follows:

    • 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 network by selecting Use custom ports

      IMPORTANT:

    • Please make sure the ports you selected above are not blocked by your firewall
    • When specifying the port numbers, make sure the selected ports are all available and there are no other applications running on them. Follow this instruction to check your network ports
    sessions-6
  7. In the next screen, you will have an option to enable a secured connection (HTTPS) between users’ browsers and qTest Session 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

    sessions-7
  8. You are required to configure the connection to your PostgreSQL database. Database host name, port number and a database schema are required

      IMPORTANT:

    • The database schema must be created in advance. Click here for the instructions
    • You can select the checkbox to Reset data, and existing data in the database schema will be removed
    sessions-8
  9. Specify the hostname and port number to connect to Redis server. Click Next to continue
    sessions-9
  10. Specify the information of your Elasticsearch server. qTest Sessions supports one cluster and one node. Click Next to continue

      NOTE: By default, the cluster name is elasticsearch. Click here for the instructions to get the cluster name

    sessions-10
  11. You may specify the directory to sessions data. Click Next to continue
    sessions-11
  12. Specify the URL and qTest Master Token to connect to your qTest instance. Click Next to continue

      IMPORTANT:

    • Your qTest instance must be running
    • The port must be included in the URL: http://[IP_Address]:[HTTP_Port] or http://[Domain_Name]:[HTTP_Port]
    • If your qTest is using SSL, you need to input the URL with HTTPS protocol and HTTPS port. For example: https://localhost:8443
    • Click here for instructions to get your qTest Master Token
    sessions-12
  13. After you have input all required information and click on Next button, the wizard starts configuring qTest Sessions services
    sessions-13
  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
    sessions-14
  15. Click Finish to exit the installation wizard

NOTE: qTest must be configured to connect with Sessions. Please proceed to the following steps

Configure qTest to connect to Sessions

  1. Login to your qTest using a Site Administrator username and password
  2. Click into the Site Administration page and click on the tab SYSTEM CONFIGURATIONS
  3. In the Session Manager Plugin section, input the URL of your Sessions server, such as http://[IP_Address]:[HTTP_Port]
    session-manager-plugin
  4. Click on Save button. Follow the remaining steps to validate that Sessions was installed and configured successfully
  5. From qTest's top navigation, access to qTest Sessions
    qtest-sessions
  6. Click + Session to create a new Session
    sessions-create-a-new-session
  7. Enter Session's Title and click Save & Close
    sessions-save-new-session
  8. Verify that the Session you have recently saved appears in the Query Result
    sessions-saved-session