Install Automation API Feature for Online Installations
In this guide, we'll run you through the installation steps of Automation API. Installing the Automation API with your on-premise QMetry installations will enable several automation API related features including faster automation result file imports into QMetry. Refer to https://qmetrysupport.atlassian.net/wiki/spaces/QTMSv815/pages/3414927197 for more details.
Automation API Installation Options
Option 1: If you want to use the same server on which the QTM Application is installed, then you can install Automation API on it.
Option 2 (Recommended): If you are going to make heavy usage of Automation API, then we strongly recommend you install Active MQ, Automation API, and Redis Caching on a separate server.
If you are opting for Option 2, the following are hardware requirements for Active MQ and Automation API Server.
Automation API Server Hardware Requirements
| Small Teams < 50 Users | Medium Teams < 500 Users | Large Teams 500+ Users | |||
| Min | Recommended | Min | Recommended | Min | Recommended |
Memory | 4 Gb | 8 Gb | 8 Gb | 16 Gb | 16 Gb | 32 Gb |
CPUs | 2 Core | 4 Core | 4 Core | 12 Core | 12 Core | 24 Core |
Installation Requirements
QMetry Application should be pre-installed.
Redis server configured with QTM Application.
Active MQ server configured with QTM Application
Pre-requisites for the Installation
QMetry Application should have been installed. Refer to the following document 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. Refer: https://qmetrysupport.atlassian.net/wiki/spaces/QTMSv815/pages/3414821251
All the servers should have the support of these commands: unzip, curl, and vim.
Internet access should be enabled on all the servers to install using docker.
Ensure Proxy Servers are not blocking downloads from the Internet.
Docker installation requires root user access.
Get the QMetryAutomationAPI.zip, QMetryActiveMQ.zip, and QMetryRedis.zip file from QMetry Support.
The following Ports should be open:
Installation | Ports that need to be enabled and should be available for use |
---|---|
Redis Caching Server | 6379 |
Active MQ Server | 8181 & 61616 |
Automation API Server | 8081 |
Step 1. Install Redis Caching Server
QMetry is supporting Redis from its version 7.0.10 onwards. Currently, the Docker will be installed with Redis version 7.0.10. |
Get the QMetryRedis.zip file from QMetry Support and copy it to the server for Automation API installation.
1.1 Copy the QMetryRedis.zip installation file received from QMetry Support to your server and unzip it. Navigate to the directory where these files are saved.
unzip QMetryRedis.zip
cd QMetryRedis
1.2 Execute the following commands.
sudo su
chmod +x qmetry.sh
sh qmetry.sh
The next question during the installation process will be as follows.
Options | Allowed Values | Default Value | Recommended Value |
---|---|---|---|
Do you want to make an online installation (Y/N)? | Y, y, N, n | Y | Y |
You will be asked for credentials. 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
The following message will be displayed.
1.3 After the above steps are completed, log into the QMetry application.
Go to "Admin" Profile and Edit the Profile.
Update QMetry Redis URL.
For more details on Redis, visit https://redis.io/.
Configure the Redis with QMetry Application as mentioned in 1.3. If you are facing any issues from the QMetry Application side after 1.3, then you may be required to restart the QMetry Application docker container after Step 1.3.
Step 2. Install Active MQ
Get the QMetryActiveMQ.zip file from QMetry Support and copy it to the server for Automation API installation.
2.1 Copy the QMetryActiveMQ.zip installation file received from QMetry Support to your server and unzip it. Navigate to the directory where these files are saved.
unzip QMetryActiveMQ.zip
2.2 Execute the following commands.
sudo su
chmod +x activemq-install.sh
sh activemq-install.sh
The next question during the installation process will be as follows.
Options | Allowed Values | Default Value | Recommended Value |
---|---|---|---|
Do you want to make an online installation (Y/N)? | Y, y, N, n | Y | Y |
You will be asked for credentials. Enter the docker credentials provided by the support team.
Users are required to enter the value of the following configuration parameters:
Options | Details | Default Values | Example |
---|---|---|---|
Enter activemq username | - | - | admin |
Enter activemq password | - | - | admin |
The installation may take a while.
Once the installation is complete, execute the following command.
docker ps
The following message will be displayed.
2.3 Configure the Active MQ in QMetry Application.
After the above steps are completed, log into the QMetry application.
Go to "Admin" Profile and Edit the Profile.
Update MQ URL, MQ Username, and MQ Password.
The ActiveMQ URL should be in the format of "ssl/dns:port".
For example, "tcp://<activeMQ-Host>:61616"
2.4 Restart the QMetry Application docker container.
Step 3: Install / Upgrade Automation API Server
3.1 Copy the QMetryAutomationAPI.zip installation file received from QMetry Support to your server and unzip it. Navigate to the directory where these files are saved.
unzip QMetryAutomationAPI.zip
3.2 Execute the following commands.
sudo su
chmod +x qmetry-automation-api-install-upgrade.sh
sh qmetry-automation-api-install-upgrade.sh
The next question during the installation process will be as follows.
Options | Allowed Values | Default Value | Recommended Value |
---|---|---|---|
Do you want to make an online installation (Y/N)? | Y, y, N, n | Y | Y |
You will be asked for credentials. Enter the docker credentials provided by the support team.
Users are required to enter the value of the following configuration parameters.
Options | Details | Default Value | Example |
Enter QMetry(QTM) database host (localhost) | Note: In case of AWS installation enter the private IP of the AWS instance where the QTM Application's database is installed. | localhost | QTM Application's database host |
Enter QMetry(QTM) database port (3306) | - | 3306 | 3306 |
Enter QMetry(QTM) database schema (qmetry) | - | qmetry | qmetry |
Enter QMetry(QTM) database user (root) | - | root | root |
Enter QMetry(QTM) database password | - | - | qmetry |
Enter QMetry(QTM) database min connection (32) | - | 32 | 32 |
Enter QMetry(QTM) database max connection (50) | - | 50 | 50 |
Enter min threads (2) | - | 2 | 2 |
Enter max threads (2) | - | 2 | 2 |
Enter Redis host (localhost) | Note: In case of AWS installation enter the private IP of the AWS instance where Redis is installed. | localhost | redis host |
Enter Redis port (6379) | - | 6379 | 6379 |
Enter MQ URL (tcp://localhost:61616): | Note: In case of AWS installation enter the private IP of the AWS instance where Redis is installed. EG: tcp://10.0.0.16:61616 | tcp://localhost:61616 | tcp://<activeMQ-Host>:61616 |
Enter MQ user (admin) | - | admin | admin |
Enter MQ password | - | - | - |
The installation may take a while.
Once the installation is complete, execute the following command.
docker ps
The following message will be displayed.
If you are facing any issues during the installation process, kindly generate a support ticket on Support Portal for assistance.