Document and explain DB migration issue (#1079)
* add explanation Signed-off-by: Stefan Klotz <stefan.klotz@bosch.io> * add hyperlinks Signed-off-by: Stefan Klotz <stefan.klotz@bosch.io> * rephrase Signed-off-by: Stefan Klotz <stefan.klotz@bosch.io> * rephrase Signed-off-by: Stefan Klotz <stefan.klotz@bosch.io>
This commit is contained in:
17
MIGRATION.md
17
MIGRATION.md
@@ -1,3 +1,4 @@
|
|||||||
|
|
||||||
# hawkBit Migration Guides
|
# hawkBit Migration Guides
|
||||||
## Release 0.2
|
## Release 0.2
|
||||||
### Configuration Property changes
|
### Configuration Property changes
|
||||||
@@ -22,3 +23,19 @@
|
|||||||
## Milestone 0.3.0M6
|
## Milestone 0.3.0M6
|
||||||
### Configuration Property changes
|
### Configuration Property changes
|
||||||
- hawkbit.server.security.dos.maxTargetsPerManualAssignment has changed to hawkbit.server.security.dos.maxTargetDistributionSetAssignmentsPerManualAssignment
|
- hawkbit.server.security.dos.maxTargetsPerManualAssignment has changed to hawkbit.server.security.dos.maxTargetDistributionSetAssignmentsPerManualAssignment
|
||||||
|
|
||||||
|
## Upgrade from Master Branch (after 0.3.0M6) to 0.3.0M7
|
||||||
|
Due to changes in the DB migration scripts within PR [#1017](https://github.com/eclipse/hawkbit/pull/1017) the Hawkbit will not start up if one of the following cases is true:
|
||||||
|
- DB2 database is used
|
||||||
|
- MSSQL database is used and the sp_action table is not empty
|
||||||
|
- PostgreSql database is used and the sp_action table is not empty
|
||||||
|
|
||||||
|
The script was fixed with PR [#1061](https://github.com/eclipse/hawkbit/pull/1061).
|
||||||
|
|
||||||
|
In case you upgrade from 0.3.0M6 to 0.3.0M7 there is no issue. But if you have built the Hawkbit from the master branch between PR [#1017](https://github.com/eclipse/hawkbit/pull/1017) and PR [#1061](https://github.com/eclipse/hawkbit/pull/1061), use PostgreSQL or MSSQL and upgrade to 0.3.0M7, it will fail at startup with the message: `Validate failed: Migration checksum mismatch for migration version 1.12.16`
|
||||||
|
|
||||||
|
This can be fixed by adapting the schema_version table of the database. The checksum field of the entry with the version 1.12.16 has to be changed (mind the minus):
|
||||||
|
- -1684307461 for MSSQL
|
||||||
|
- -596342656 for PostgreSql
|
||||||
|
|
||||||
|
Example for MSSQL: `UPDATE schema_version SET checksum=-1684307461 WHERE version='1.12.16'`
|
||||||
|
|||||||
Reference in New Issue
Block a user