QMetry BDD Installation Guide (Online using Docker)

This guide walks you through the installation process of QMetry BDD.
Setting up QMetry BDD with your on-premise QMetry Test Management (QTM) installation enable seamless integration of behavior-driven development practices into your testing workflow. With QMetry BDD, you can manage feature files, automate test executions, and streamline collaboration between business and technical teams.

QMetry BDD Installation Options

You can install QMetry BDD on the same server where the QTM Application is installed.

Pre-requisites for the Installation

Before installing QMetry BDD, ensure the following:

QMetry Application should be pre-installed. Refer to QMetry and Reports Installation on Linux - 2 Tier to install the QMetry Application. Follow Steps 1 to 7 (up to Enter Base URL) mentioned in the Install QMetry Application section. Please note that Step 7 is mandatory.
Active MQ server is configured with QTM Application.
All the servers must support the commands: unzip, curl, vim.
Internet access is enabled on all servers to install using docker.
Ensure Proxy servers are not blocking downloads.
Docker installation requires root user access.
Get the QMetryBDD.zip file from QMetry Support.

Required Ports

Installation	Ports that need to be enabled and should be available for use

Installation	Ports that need to be enabled and should be available for use
Active MQ Server	8181 & 61616

Installing QMetry BDD Server

Copy the QMetryBDD.zip installation file received from QMetry Support to your server and unzip it. Navigate to the directory where these files are saved.

unzip QMetryBDD.zip
cd QMetryBDD

Run the following commands.

sudo su
chmod +x bdd.sh
./bdd.sh

Select Installation Type: Online or Offline

Options	Allowed Values	Default Value	Recommended Value

Options	Allowed Values	Default Value	Recommended Value
Do you want to make an online installation (Y/N)?	Y, y, N, n	Y	Y

Enter configuration parameters as requested:

Prompt	Description	Example

Prompt	Description	Example
Enter QMetry Database Host IP/DNS Name:	Host address where QMetry database is running. Note: In case of AWS installation enter the private IP of the AWS instance where the QTM Application's database is installed.	`QTM Application's database host`
Enter QMetry Database Port (3306)	Database port number.	`3306`
Enter QMetry Database Schema (qmetry)	Schema name to be used by QMetry BDD.	`qmetry`
Enter QMetry Database UserName (root)	Database user with necessary rights.	`root`
Enter QMetry Database Password	Password for the above database user.	`qmetry`
Enter ActiveMQ Host URL	Host URL of ActiveMQ messaging service.	`localhost:61616`
Enter ActiveMQ UserName	Username for ActiveMQ authentication.	`admin`
Enter ActiveMQ Password:	Password for ActiveMQ user.	`-`

Enter the docker credentials provided by the support team.

The installation may take a while.

Once the installation is complete, execute the following command.

docker ps

Check for confirmation message - QMetry BDD Installation has been completed successfully.

If you are facing any issues during the installation process, kindly generate a support ticket on Support Portal for assistance.