🗒️DB Version Mis-Match

Please take note of db-version before moving to older releases of handshake python-build

Let's Think of a Scenario:

1. Update handshake (py package)

2. Which might migrate your DB to a newer version, when you start a test run

3. now you find the newer version is not stable enough or other reasons

4. So, you would now be using old handshake py-build with the latest db version

5. But the DB Version will not be reverted

6. So, whenever you run scripts, it fails to mention that it failed to migrate to reach this version.

Error Message and Resolution

2024-07-05 00:08:20.622 | ERROR | handshake.services.DBService.migrator:migration:98 - Found a version v9. but we can migrate till v8. Please check the python build version and accordingly execute: "handshake step-back [COLLECTION_PATH]"

Resolution

In this case, manual intervention is required, we need to note the current version of db and the expected version to know that you can execute handshake migrate [TestResults]

Please take back up if you are doing this through handshake zip-results [TestResults]

if the Version you have is v9 but required is v7, you would need to execute handshake step-back [TestResults] twice.

To Summarize:

1. Take backup of the TestResults [Optional but safe]

2. handshake migrate TestResults

3. --Same error message--

4. handshake step-back TestResults

5. --Same error message--

6. Repeat from step 1 if no error message, you can start your test run