Install Automation API Feature (RHEL8 & Podman)
This documentation is for the installation of Automation API only on RHEL8 OS.
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/QTMSv816/pages/3541119143 for more details.
- 1 Automation API Installation Options
- 2 Automation API Server Hardware Requirements
- 3 Installation Requirements
- 4 Before you proceed with the installation
- 5 In case of rootless installation
- 6 Pre-requisites for the Installation
- 7 Step 1. Install Redis Caching Server
- 8 Step 2. Install Active MQ
- 9 Step 3: Install / Upgrade Automation API Server
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
Before you proceed with the installation
In case of offline installation
Step 1. Install podman and podman-compose tools. You can follow steps mentioned in the Podman and Podman-Compose Installation section to install the tools. However, it is not mandatory to follow these specific guidelines for the installation of the tools.
Step 2. Download podman images of QMetry products.
Refer to https://qmetrysupport.atlassian.net/wiki/spaces/QTMSv816/pages/3541047115. Follow these steps on a machine where the internet is accessible so that the podman images can be downloaded on it.
Step 3. Restore the podman images of QMetry products on specific machine where the installation is to be carried out.
Refer to Restore Container Images of QMetry Products.
In case of rootless installation
Note: It is mandatory to follow the steps mentioned for Podman and Podman-Compose Installation.
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/QTMSv816/pages/3541043820
All the servers should have the support of these commands: unzip, curl, and vim.
Get the QMetryAutomationAPI.zip, QMetryActiveMQ.zip, and QMetryRedis.zip file from QMetry Support.
Internet access should be enabled on both servers to install using podman, in case of online installation.
5. Ensure Proxy Servers are not blocking downloads from the Internet.
6. Podman and podman-compose utilities should be installed using the root user.
7. 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 podman 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 podman credentials provided by the support team.
The installation may take a while. Once the installation is complete, execute the following command.
podman 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 .
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 podman container after Step 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 podman 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.
podman 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 podman 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 podman 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.
podman 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.