qTest Controller - Applying 9.8.3-2 application patch for qTest Manager

Read the associated Release Notes here to understand the changes applied to the qTest Manager 9.8.3-2 patch. 

Verify your qTest Manager version

1. Make sure your qTest Controller (qTest Docker) is working properly and that the qTest Manager web app is accessible via the web browser.
2. Using a web browser go to <QTEST_MANAGER_URL>/version, and capture the current JSON value. 
   Example:

Apply patch for qTest Controller Windows/Linux

1. Stop the qtest service, and make sure no process is left running from the qtestctl folder.
   

   • Windows: net stop qtest

   • Linux: systemctl stop qtest

2. Download the provided patch and place it into "qtestctl/.gradle/libs". Make sure to keep the original file name.
   • ".gradle" is a hidden folder on Linux (because there is a dot "." in its name).
   • You don't need to delete the existing WAR file because you will tell qtestctl exactly which one to use in the later step.
     
3. Use a text editor and open "qtestctl/app.config"
4. Find the version configuration for qTest Manager. 
   Example: 
   
5. Change it to the new version, which should be found in the patch name.
   Example: 
   
6. Keep everything else the same and restart the qtest service.
7. Wait for the web application to be available and double-check the /version resource to make sure the new version has been applied.

Apply patch for qTest Docker

1. Stop the qtest service, and make sure no container belonging to qTest is left running. Shutdown the qtest application with the following command:

    ./shutdown

2. Download the provided patch and place it into "docker-deployment-x.x/dist/qtest/<PATCH-VERSION>/qtest-<PATCH-VERSION>.war". The patch version should be in the original name of the patch package that you have downloaded.
   Example:
   
   
3. Use a text editor and open "docker-deployment-x.x/app.config.in"
4. Find the version configuration for qTest Manager (named "qtest_version") and change it to the new version, which should match with the "PATCH-VERSION" defined in step 2.
   • qTest Docker has yet to support version range and it uses the exact string compare to find the patch package.
     
5. Locate the "cachedir" of your qTest Docker by reading "docker-deployment-x.x/profiles/default.in"
   • The default value for the "cachedir" if you didn't override it during qTest Docker setup is "/var/cache/qasymphony"
     
6. Clean up everything inside the cache directory of qTest Manager, which is "<cachedir>/qtest/"
7. Keep everything else the same and restart qtest service
8. Wait for the web application to be available and double-check the /version resource to make sure the new version has been applied.