Menu

Launch 1.0 Single Server Installation Guide for Windows

Overview

In this article, we provide step-by-step instructions to install qTest Launch 1.0 on:

  • on a separate Windows machine and connect to qTest Manager on another machine.
  • OR install qTest Launch on the same machine with other qTest application(s.)

Please read the instructions thoroughly before starting your installations.

To request assistance with installation or obtain the self-upgrade links, complete the OnPremise New Install Form.

Before You Begin

Read the following:

Download qtestctl

Note: qTest Launch, as well other qTest applications, are bundled into one OnPremise installation package. If you have not downloaded the package, follow the steps below to download. If you have already downloaded the package, skip this step and move to installing and configuring qTest Launch.

  1. Complete the OnPremise New Install Form to request the package files.
  2. Once the form is filled out, a download link will be emailed to you by our Implementation Team.
  3. Download the qTest OnPremise installation package.
  4. Extract the zip file to a folder on your disk. Example: C:\qtestctl 

Configure qTest Launch

  1. Navigate to the extracted folder C:\qtestctl\.
  2. Open the qtest.config file in your favorite text editor to configure qTest Launch.

Configure Applications

  • If you are installing qTest Launch on a separate server, make sure there is 'launch' in the apps list.
    apps = ['launch']
  • If you are installing qTest Launch on the same server with other qTest application(s.)
    Example: qTest Manager, append launch to the app list.
    apps = ['manager', 'launch']

Configure the Database

IMPORTANT: qTest Launch uses qTest Manager's database. In other words, the database are shared between qTest Manager and qTest Launch. If you plan to install qTest Launch in the same server with qTest Manager and have already setup qTest Manager database in postgres section, you can skip this step.

  1. Navigate to the postgres section in qtest.config file as shown below.
  2. Replace blue text with actual values. Only information listed out here needs to be updated. Other information should remain unchanged. 
...
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 as you have created]'
...
} }

Configure SSL

  1. To deploy qTest Launch with SSL, navigate to the section common in qtest.config file as shown below.
  2. Replace the blue text with actual values. Only information listed out here in blue needs to be updated, other information should remain unchanged.
  • enable: set to true to enable a secured connection (HTTPS) between the user browser and the server. The default value is false.
  • cert: absolute path to the certificate file on this server. Please use \\ or / in the path. It is mandatory if enable is set to true.
  • key: absolute path to the private key file on this server. Please use \\ or / in the path. It is mandatory if enable is set to true.
  • pass: passphrase of your certificate. This field is optional (default value is empty).
  • strict: set this to false to allow self-signed SSL certificate.
common {
ssl {
enabled = false
cert = "${path}/server.crt"
key = "${path}/server.key"
pass = ""
strict = false
}
}

Configure the qTest Launch Application 

  1. In the qtest.config file, navigate to the manager section as shown below.
  2. Replace blue text with actual values. Note: if you plan to install qTest Launch in the same server with Manager, you have probably performed this configuration and if so, skip to next step. Only information listed out here needs to be updated, other information should remain unchanged.
    ...
    /* application configurations */
    manager {
      ...
      url = '[http or https]://[qTest Manager server's IP or hostname]:[HTTP port as specified above]' /* use https if SSL is enabled */
      ...
    }
  3. Next, navigate to the launch section as shown below and replace the blue text with actual values. Only information listed out here needs to be updated, other information should remain unchanged.
    ...
    launch {
      port = [HTTP or HTTPS port which will be used for accessing qTest Launch through a web browser]
      url = "[http or https]://[qTest Launch server's IP or hostname]:[HTTP or HTTPS port as specified above]" /* use https if SSL is enabled */
      log = "[Enter path include filename launch.log. Please use \\ or / in the path]"
      ...
    }
  4. Open the console on your machine (run as Administrator role), change the current path to qtestctl directory. Start qTest Launch with the following command:
    C:\qtestctl>qtestctl.bat --offline start
    2018-01-19_1453.png
  5. The command will take control of the terminal. Keep it running. Open your web browser, access to qTest Launch using the URL specified above in qtest.config to validate if it has started successfully.
    2018-01-25_1328.png

 

Install qTest Launch as a Windows Service

To enable qTest Launch to automatically start when Windows starts, you need to install it as a Windows service.

Note: If you install qTest Launch in the same machine with other qTest application(s), e.g. qTest Manager, you only need to execute below command once and only once when you finished installing all the applications on this server. Refer to this article to learn more about installing qtest service.

  1. Open a Command Prompt if you haven't done so, and navigate to the folder 'qtestctl’
  2. Execute the command below in your command prompt:
C:\qtestctl>install.bat

 2018-01-19_1456.png 

Configure qTest Manager to Connect to qTest Launch 

  1. Login to your qTest Manager using a Site Administrator account.
  2. Select Administration from drop-down that appears when you hover over your username.
  3. Select the System Configurations tab.
  4. In the Miscellaneous section, enter the URL for qTest Manager.
    • http://[qTest_Manager_IPAddress]:[Port] if you installed qTest Manager without SSL certificate
    • Or https://[qTest_Manager_IPAddress]:[Port] if you installed qTest Manager with SSL certificate.
      mceclip1.png
  5. In the Launch section, enter the URL of your qTest Launch server.
    • http://[qTest_Launch_IP_Address]:[HTTP_Port] if you installed qTest Launch without SSL certificate
    • Or https://[qTest_Launch_IP_Address]:[HTTPS_Port] if you installed qTest Launch with SSL certificate.
      NOTE: Please make sure that you have completed the SSL configuration for qTest Manager if you want to install qTest Launch with SSL protocol.
  6. Select Test Connection and wait for qTest Manager to show the message "Connected to server successfully." then Save.

Access qTest Launch

Follow these steps to validate that qTest Launch was installed and configured successfully.

  1. In Manager, access qTest Launch from the nine box icon 9_box.png .
  2. qTest Launch will open in a separate browser window.

Next Steps:

Parameters 2.1 Single Server Install Guide for Windows

 

Subscribe To Our Blog
Powered by Zendesk