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
- Make sure your qTest Controller (qTest Docker) is working properly and that the qTest Manager web app is accessible via the web browser.
- Using a web browser go to <QTEST_MANAGER_URL>/version, and capture the current JSON value.
Example:
Apply patch for qTest Controller Windows/Linux
- Stop the qtest service, and make sure no process is left running from the qtestctl folder.
-
Windows: net stop qtest
-
Linux: systemctl stop qtest
-
- 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.
- Use a text editor and open "qtestctl/app.config"
- Find the version configuration for qTest Manager.
Example: - Change it to the new version, which should be found in the patch name.
Example: - Keep everything else the same and restart the qtest service.
- 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
- Stop the qtest service, and make sure no container belonging to qTest is left running. Shutdown the qtest application with the following command:
./shutdown
- 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: - Use a text editor and open "docker-deployment-x.x/app.config.in"
- 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.
- qTest Docker has yet to support version range and it uses the exact string compare to find the patch package.
- 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"
- The default value for the "cachedir" if you didn't override it during qTest Docker setup is "/var/cache/qasymphony"
- Clean up everything inside the cache directory of qTest Manager, which is "<cachedir>/qtest/"
- Keep everything else the same and restart qtest service
- Wait for the web application to be available and double-check the /version resource to make sure the new version has been applied.