Manager 8.4.4 Single Server Installation Guide for Windows

In this guide, we will run you through step by step to install qTest Manager v8.4.4 on a single Windows machine. Please go through the guide below thoroughly before starting your installations.

Before you begin

Before you install qTest Manager, make sure following things are done:

  • Your machine needs to satisfy qTest Manager's recommended hardware requirements
  • Prerequisite applications must be installed and running prior to installing qTest Manager
    • PostgreSQL v9.5
    • Java JDK v8

Install Prerequisite Softwares

Please follow these instructions to install prerequisite app(s) as mentioned above

Install qTest Manager

  1. Download qTest Manager's installation package here
  2. Once downloaded, double click on the installer to start the installing process. Click Next to review the EULA
    1 Welcome
  3. Select "I accept the terms in the License Agreement", then click Next to move on to the next page
    2 EULA
  4. You will be given 2 options to perform the installation. Select the Express install option and then click Next
    • The Express install option will allow you to install qTest OnPremise with all default configurations, such as Installation directory, program menu directory, default data and attachment directory
    • The Custom install option will allow you to specify your installation configurations manually, such as Installation directory, web port, database port and attachment folder directory
    3 Installation options
  5. Review the default Installation settings then click Install
    4 Installation Settings
  6. The installer will starts extracting files
    5 Extract
  7. After the extracting process completes, you will have 2 options to deploy qTest Manager. Select the option Single instance to deploy qTest Manager with a Single Server Instance
    6 Single Instance
  8. Next, specify a few ports where you will access qTest Manager OnPremise through your web browser

    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
    • AJP port: 8009
    • HTTPS port: 8443

    However, you can freely define any of the server's available ports by selecting Use custom ports. Simply enter the port numbers for each of the 4 port types

    7 Web ports
  9. In the next screen, you will have an option to enable a secured connection (HTTPS) between users’ browsers and qTest Manager 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 the Browse button.

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

    8 Secured connection
  10. You may also change the default location to store attachments
    9 Data dir
  11. You are required to configure the connection to your database. Database host, port and the credentials are required. You can either create a new database schema or use an existing one

      IMPORTANT: database password must not include @ character

    10 Config DB
  12. Similarly, as the above step, configure the database connection for the integration database
  13. After you have input all required information and click Next, the wizard starts configuring the database and qTest Manager service
    12 Config
  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
    13 Complete
  15. 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

Configure qTest Manager

After qTest Manager has been installed successfully, you can access it via your browser using the address

  • If SSL is disabled: http://[server_ip]:[WEB_PORT]
  • If SSL is enabled: https://[server_ip]:[WEB_HTTPS_PORT]

You will need to configure your qTest Manager instance and import your licenses before it is ready for your users. Please follow this guide: Configure Manager.

Powered by Zendesk