Getting Started with qTest OnPremise 9.7.1
This article is for the Release of qTest 9.7.1 OnPremise. You will find information for Supported Operating Systems and Browsers, Prerequisite Applications, Installation/Upgrade Guides, Deployment Models, along with Hardware Requirements and Supported Versions.
Exciting News!
qTest Manager 9.7.1 is now compatible with the newly releasedTricentis Analytics 1.3.1,which requiresa separate serverin addition to the standard qTest deployment hardware.
Important Announcement
qTest Manager SSO Service Provider (SP) uses an x509 certificate to sign authentication requests and decrypt SAML assertions. As part of qTest Manager's security process, we update our SP certificate every 3 years in August.
If you are using SSO to login to qTest, you must update the SSL certificate in each Manager server before September 9, 2019 as well as, update the SP metadata in your configured IdP. If you do not complete these steps, your users will not be able to login to qtest Manager after the date above.
-
Replace Signed Certificate File for qTest SSO Integration
-
Update qTest Manager SSO Service Provider Certificate on SSO IdP
In the event, you are unable to update your IdP before September 9, 2019, follow these instructions to bulk update your users to authenticate via qTest internal (username/password) from your current SSO authentication.
New Enhancements
-
In the 9.7.1 OnPremise release, qtestctl 6.4 package, we moved from Oracle Jdk 1.8.0_144 to Open JDK 1.8.0_212.
Release Notes
Below are the Release Notes for each qTest application associated with the 9.7.1 OnPremise release.
Hardware Requirements
Based on your team size and the applications included in your subscription plan determine the right hardware requirements before the installation. Please see this article: Server Sizing Guide
Deployment Models
qTest components (and prerequisites applications) communicate with each other via TCP and HTTP, so they can be installed on different systems, as long as they can connect via specific ports. Files that may need to be shared among services can be supported by a distributed file system like NFS or SMB. In theTricentis qTest production cloud deployment, each application has a dedicated server to ensure the best control, but that may not be necessary for an OnPremise deployment.
For best practices, please see the examples provided in this article: Selecting your OS and Deployment Model
Supported Systems
Operating Systems
qTest installation packages are offered for these 3 types of environment:
-
Docker on Linux (CentOS 7.2-7.3) or (Ubuntu 16.04-16.10) 64-bit
-
Linux native (CentOS 7.2-7.3) or (Ubuntu 16.04-16.10) 64-bit
-
Windows native (2008 R2, 2012 R2, 2016)
Browsers
qTest works best on the latest stable versions of:
-
Chrome
-
Firefox
-
Safari
-
IE11
Prerequisite Applications
Based on the OS environment, please see the list of prerequisites below:
Docker
-
Must have access to the outside internet (cannot be used in closed network)
-
Docker Host v17.03-ce - v17.12-ce See: Instructions to install Docker
-
Kernel must be at least 3.10
-
Once you have Docker installed, you'll automatically have access to the prerequisite applications
-
If you're using CentOS, See: Change Docker storage driver to avoid Overlay issue
Windows or Linux (non-Docker)
The table below shows the required versions of prerequisite applications. These must be installed and running before deploying qTest applications.
Here are some basic instructions for installing these prerequisites. If you need more detailed instructions to install these prerequisites, click on the hyperlinks in the table below.
PREREQUISITE APPS | DESCRIPTION | SUBSCRIPTION PLAN | ||
---|---|---|---|---|
Sessions + Explorer | Premium | Elite | ||
PostgreSQL 9.5.4 - 10 NOTE:
|
Database Server for Manager, Sessions. Insights. Parameters. Launch. Pulse and Scenario. | |||
Elasticsearch 6.3 - 6.8 |
Database Server for Manager | |||
An NFS directory NOTE:
|
To store attachments | (optional) | (optional) | (optional) |
Tricentis Analytics 1.3.1
For information on prerequisite material for the Tricentis Analytics 1.3.1 install, please refer to this article.
qTest Products
Each product in the qTest platform delivers a tailored experience for its users. Below is a list of the products that you should install for each subscription plan:
PRODUCT | DESCRIPTION | SUBSCRIPTION PLAN | ||
---|---|---|---|---|
Sessions + Explorer | Premium | Elite | ||
Manager | Test Case Management | * | ||
Sessions | Screen Capture and Recording | |||
Parameters | Reusable Test Input Data | |||
Insights | Testing Metrics and Analytics | |||
Launch | Centralized Test Automation | |||
Scenario | JIRA Plugin for BDD | |||
Pulse | Agile and DevOps Workflows |
*qTest Manager component for Sessions + Explorer package is simply for Administration purposes and does not contain test case management features.
Install and Upgrade Guides
Below are links to our master Install and Upgrade Guides for the qTest Product Suite.
Ports
Please note, that you must open the ports below prior to any self/assisted installation or upgrade. You should only open the HTTPS ports if you plan to serve SSL from the application.
PREREQUISITE APPLICATIONS
Product | Port |
---|---|
Postgres | 5432 |
ElasticSearch | 9200 |
Network Drive | 2049 |
LINUX DOCKER
Product | HTTP Port | HTTPS Port |
---|---|---|
Manager | 80 | 443 |
Sessions | 8080 | 8443 |
qMap | 7080 | 7443 |
Scenario | 6080 | 6443 |
Insights | 9080 | 9443 |
Parameters | 10080 | 10443 |
Pulse | 4080 | 4443 |
Launch | 3080 | 3443 |
LINUX NON-DOCKER AND WINDOWS
Product | HTTP Port | TTPS Port |
---|---|---|
Manager | 8080 | 8443 |
Sessions | 9080 | 9443 |
Scenario | 6080 | 4443 |
Insights | 10080 | 10443 |
Parameters | 5080 | 5443 |
Pulse | 4080 | 4080 |
Launch | 3080 | 3443 |
Supported Versions
As outlined in the Terms of Use (Appendix A - Support Services), Tricentis qTest OnPremise support expires for any software version more than 12 months after any superseding update. Therefore, we recommend that customers keep up with the latest updates and upgrade their software. For information on OnPremise software versions and their support status, refer to this article.