QMetry and Reports Installation on AWS (using RDS & ECR)

By default, docker is managing storage under “/var/lib/” directory on the host machine. Installer will ask you to set up a storage location for QMetry application files related data during the installation of QMetry. Hence, make sure that both the directories have required disk space available as per usage requirement of QMetry application.

After installation, QMetry Application and the Reports tool must both be configured to use the same protocol — either http or https consistently.

Both the QMetry Application Server and the QMetry Reports Server must have appropriate IAM roles assigned to communicate with AWS services such as AWS ECR and AWS RDS.

Obtain the following files from QMetry Support before beginning the installation:

Execute the following command and enter the Docker credentials provided with your installation package when prompted.

docker login

Pull the three required images from the docker repository:

docker pull docker.io/qmetry/qmetry:latest 
docker pull docker.io/qmetry/qmetry:cdc_latest 
docker pull docker.io/qmetry/qmetry:sync_latest

Replace <ECR_Repo_Url> with your actual ECR repository URL:

docker tag docker.io/qmetry/qmetry:latest <ECR_Repo_Url>/qmetryapp:latest 
docker tag docker.io/qmetry/qmetry:cdc_latest <ECR_Repo_Url>/qmetryreport:cdc_latest
docker tag docker.io/qmetry/qmetry:sync_latest <ECR_Repo_Url>/qmetryreport:sync_latest

If you have already configured the AWS Credentials Helper utility on your EC2 servers, skip this step and proceed to Step 5.

Login with AWS ECR.

If you have ECR credentials, then log in with ECR using it.

docker login <ECR_Repo_Url>

Authenticate using the AWS CLI (if AWS CLI is installed and configured):

aws ecr get-login-password --region <regionID> | docker login --username AWS --password-

Push all three tagged images to ECR:

docker push <ECR_Repo_Url>/qmetryapp:latest 
docker push <ECR_Repo_Url>/qmetryreport:cdc_latest 
docker push <ECR_Repo_Url>/qmetryreport:sync_latest

You need to create two separate DB parameter groups: one for the QMetry Application RDS and one for the QMetry Reports RDS.

Select Parameter Groups from the left panel and choose the App parameter group created in Step 1. Edit its parameters with the following values:

Select the Report parameter group created in Step 1. Edit its parameters with the following values:

Save the following details for use during QMetry Application installation:

Save the following details for use during QMetry Reports installation:

The installer will prompt for the following directory paths:

Once the script has completed extracting files, it will prompt for the following configuration parameters. Have your RDS details from Section 4 ready.

The installation may take several minutes to complete. Upon successful completion, you will see the message:

QMetry Application installation is complete.

Enter 0 to exit the installation menu.

Evaluation License:

If you are evaluating QMetry, an evaluation license valid for 30 days should have been included with your installation package.

Commercial License:

To generate a commercial license, QMetry Support requires your server's domain name and MAC address. Follow these steps:

Access the QMetry application in your web browser using the following URL:

http://<your-IP-Address-or-Domain-Name>

Use the following default credentials to log in for the first time:

After logging in as admin, complete the following configuration:

QMetry is installed with default minimum and maximum heap memory settings. These can be modified based on your hardware configuration. Refer to the Additional Configuration documentation for details.

Copy the `QMetry_Linux_Installer_ECR.zip` file received from QMetry Support to your Reports server. Navigate to the directory containing the file and execute the following commands:

sudo su - 
unzip QMetry_Linux_Installer_ECR.zip
cd QMetry_Linux_Installer_ECR

Execute the installation script:

chmod +x install.sh 
./install.sh

The installer will prompt you with the following question:

You will then be prompted for credentials. Enter the Docker credentials provided with your installation package.

When the installer displays the component selection menu, enter 2 to install the QMetry Reports container.

The installer will then prompt for the following configuration parameters. Have your RDS details for both databases ready.

Upon successful completion, you will see the message & 2 containers installed as below:

Enter 0 to exit the installation menu.

After installation, configure the database connection from within the QMetry Application:

1. Log in to QMetry Application with admin credentials.

2. Navigate to Customizations > Insight Configuration > Database Configuration tab.

3. Enter the following connection details:

   • Host: Enter the Report Database Host URL

   • Port: 3306

   • Username: <Report database username>

   • Password: <Report database password>

   • Database Name: <Report DB schema name specified during installation>

4. Click Test to verify the connection. Upon a successful test, click Test & Save to save the configuration.

Under the Sync Data tab within Insight Configuration, configure the Report Data Sync from your Reports server to QMetry Reporting:

1. In the Report Server URL field, enter your Reports server domain URL followed by port 8081. For example: http://<reports-server-domain>:8081

2. Click Test to verify the connection, then click Test & Save.

QMetry supports Redis Caching to improve overall application performance and scalability. This step is optional and can be performed at any time after the base installation.