Install/Upgrade Automation API Feature for Offline Installations

1. Log in to the Docker Registry.

   docker login

   Enter the Docker credentials when prompted. Contact QMetry Support if you do not have them.

2. Pull, verify, save, and transfer the Redis image:

   docker pull qmetry/qmetry:redis741
   docker images
   docker save -o /opt/qtm/qmetryredis.tar
   qmetry/qmetry:redis741
   

3. Pull, verify, save, and transfer the ActiveMQ image.

   docker pull docker.io/qmetry/qmetry:activemq_latest
   docker images
   docker save -o /opt/qmetryactivemq.tar docker.io/qmetry/qmetry:activemq_latest
   

4. Pull, verify, save, and transfer the Automation API Image:

   docker pull qmetry/qmetry:automation_latest
   docker images
   docker save -o /opt/qtm/qmetryautomation.tar qmetry/qmetry:automation_latest
   

   Then transfer qmetryautomation.tar to the QMetry Automation API server.

1. On the QMetry Redis server, go to the directory holding the .tar file and load it, then verify:

   sudo docker load -i qmetryredis.tar
   sudo docker images    

2. Extract the installer

   unzip QMetry_Linux_Installer.zip
   cd QMetry_Linux_Installer

3. Run the installer

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

4. Enter response for installation Prompt

   Options	Enter Value
   Do you want to make an online installation (Y/N)?	N

5. Enter docker credentials and select 4 in the QMetry Installation Menu.

   

   The installation may take a while.

6. Verify the containers

   docker ps

7. Configure Redis in QMetry

   Log into the QMetry application, perform the following steps:

   • Go to "Admin" Profile and Edit the Profile.

   • Update QMetry Redis URL

   For more details on Redis, visit https://redis.io/.

1. On the ActiveMQ server, load and verify the transferred image:

   sudo docker load -i qmetryactivemq.tar
   sudo docker images

2. Extract the installer

   unzip QMetry_Linux_Installer.zip
   cd QMetry_Linux_Installer
   

3. Run the installer

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

4. Enter your response to the prompt

   Options	Enter Value
   Do you want to make an online installation (Y/N)?	N

5. Enter the Docker credentials. At the QMetry Installation Menu, select 7.

   

   In case of upgrade, value for parameters won't be asked.

6. Configure the parameters

   Options	Example
   Enter activemq username	admin
   Enter activemq password	admin
   .tar file directory path	For offline upgrade, the directory holding the image .tar, e.g. /opt/qtm

7. Verify the containers

   docker ps

8. Configure ActiveMQ in QMetry

   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 protocol://<host>:port

   For example, "tcp://<activeMQ-Host>:61616"

9. Restart the QMetry Application docker container to apply the change.

The installation may take a while.

1. On the Automation API server, load and verify the transferred image:

   sudo docker load -i qmetryautomation.tar
   sudo docker images

2. Extract the installer

   unzip QMetry_Linux_Installer.zip

3. Run the Installer

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

4. Enter your response

   Options	Enter Value
   Do you want to make an online installation (Y/N)?	N

5. Enter the Docker credentials. At the QMetry Installation Menu, select 7 (QMetry Automation API).

   

6. Enter configuration parameters

   Options	Details	Default Value	Example
   Enter QMetry database host (localhost)	For AWS, use the private IP of the instance hosting the QTM database	localhost	QTM Application's database host
   Enter QMetry (QTM) database port (3306)	3306	3306	3306
   Enter QMetry (QTM) database schema (qmetry)	qmetry	qmetry	qmetry
   Enter QMetry (QTM) database user (root)	root	root	root
   Enter QMetry (QTM) database password	-	qmetry	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)	-	Match your ActiveMQ password	admin
   Enter MQ password	-	-	-
   .tar file directory path	-	-	For offline upgrade, the directory holding the image .tar, e.g. /opt/qtm

7. Verify the container

   docker ps

   Confirm the automation container appears in the list. Installation is complete once it is running.