Menu

Launch 1.0 Single Server Installation Guide for Linux (Non Docker)

To request installation assistance or to obtain the links to self-install, please click here to fill out the New Install Form.

In this guide, we will walk you through step by step to install qTest Launch 1.0 on a CentOS/Ubuntu (Non Docker) machine. This guide covers below deployment models:

  • Install qTest Launch on a separate CentOS/Ubuntu machine and connect to qTest Manager on another machine
  • OR install qTest Launch in the same machine with other qTest application(s) 

Before you begin

Install and Configure qTest Launch 

Most of the installation steps are performed on Terminal. It is highly recommended that you copy and paste the command/scripts to your Terminal and execute it.

1. Download qtestctl

Note: 

  • qTest Launch, as well other qTest applications, are bundled in one OnPremise installation package. If you haven't downloaded the package, follow below step to download it, otherwise, jump to step #2
  • To learn more about qtestctl, refer to this article qTest OnPremise - Technical detail about qtestctl

1.1 Request the files through the form at the top of the page.

1.2 Once the form is filled out, a download link will be sent.

1.3 Access to your server and log in as ROOT user on the command shell and change to /usr/local directory, and start to download qtestctl

sudo su
# cd /usr/local
 # wget <ENTER DOWNLOAD LINK HERE>

1.4 Extract qtestctl package and navigate to the extracted folder

 # tar -xzf <DOWNLOADED PACKAGE FILE NAME>
# cd qtestctl

2. Install and Configure qTest Launch

2.1 Navigate to the extracted folder /usr/local then open qtest.config file in your favorite text editor to configure qTest Launch.

2.2 Configure applications:

2.2.1 If you are installing qTest Launch on a separate server, make sure there is 'launch' in apps list

 apps = ['launch']

2.2.2 If you are installing qTest Launch on the same server with other qTest application(s), e.g. qTest Manager, append launch to the app list.

2.2.2 If you are installing qTest Launch on the same server with other qTest application(s), e.g. qTest Manager, append launch to the app list.

 apps = ['manager', 'launch']

2.3 Configure qTest Launch

2.3.1 Configure 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.

Navigate to postgres section in qtest.config file as shown below then 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]'
...
} }

2.3.2 Configure SSL

If you want to deploy qTest Launch with SSL, navigate to section common in qtest.config file as shown below then replace blue text with actual values. Only information listed out here needs to be updated, other information should remain unchanged.

  • enable: set to true to enable secured connection (HTTPS) between user browser and the server. 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
}
}

2.3.3 Configure qTest Launch application 

In qtest.config file, navigate to manager section as shown below and 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 */
  ...
}

Next, navigate to launch section as shown below and replace 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]"
  ...
}

Press ESC and save the configuration with following command 

 :wq 

2.3.2 Make sure qtestctl has 'execute' permission by enter following command

sudo chmod +x qtestctl

2.3.3 Next, execute this command to start qTest Launch as following command:

 # ./qtestctl --offline start 

2018-01-25_1325.png

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

 3. Install qTest Launch as a Linux Daemon

To enable qTest Launch to automatically starts when Linux starts, we need to install it as a Linux daemon.

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 commands 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.

Open a Terminal if you haven't done so, and navigate to the folder 'qtestctl’

Execute below command in your command prompt:

 # sudo su
# ./install # systemctl status qtest.service

 2018-01-24_1907.png 

4. Configure qTest Manager to connect to qTest Launch 

4.1 Login to your qTest Manager using a Site Administrator account.

4.2 Click into the Site Administration page then click on the tab SYSTEM CONFIGURATIONS.

4.3 In MISCELLANEOUS section, enter URL of 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

 

4.4 In LAUNCH section, input 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]:[HTTP_port] if you installed qTest Launch with SSL certificate.

NOTE: Please make sure that you have done the configuration SSL for qTest Manager as well when you want to install qTest Launch with SSL protocol.

4.5 Click Test Connection and wait for qTest Manager to show a message "Connected to server successfully" then click Save to save the configuration.

5. Access to qTest Launch

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

From qTest Manager's top navigation, access to qTest Launch from nine box

launch-in-9box.png

You have successfully installed qTest Launch on Linux.

Next Steps

Powered by Zendesk