lingwei.kong/hawkbit
1
0
Fork 0
Code Issues Pull Requests Actions 3 Packages Projects Releases Wiki Activity
Files
39ccf65f2e0ea2113cf98cd1308e80de92ffe87f
hawkbit/MIGRATION.md

42 lines
2.6 KiB
Markdown
Raw Normal View History

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>
2021-02-10 17:06:50 +01:00
Completed migration to ConfigurationProperties annotation. Added boot metadata generation to build.
2016-02-25 17:59:46 +01:00
# hawkBit Migration Guides
## Release 0.2
### Configuration Property changes
- hawkbit.server.controller._ have changed to hawkbit.server.ddi._
- info.build._ have changed to hawkbit.server.build._
- hawkbit.server.demo._ have changed to hawkbit.server.ui.demo._
- hawkbit.server.email.support has changed to hawkbit.server.ui.links.support
- hawkbit.server.email.request.account has changed to hawkbit.server.ui.links.requestAccount
- hawkbit.server.im.login.url has changed to hawkbit.server.ui.links.userManagement
Remove REST API boilerplate Was used in the past for Swagger generation.
2016-03-23 16:12:56 +01:00
### REST API model changes for clients
- ENTITYPagedList classes have been removed; generic PagedList used instead (e.g. PagedList<TargetRest> instead of TargetPagedList).
- ENTITYsrest classes have been removed; List<ENTITYrest> used instead (e.g. List<TargetRest> instead of TargetsRest)
Extend migration guide Signed-off-by: SirWayne <dennis.melzer@bosch-si.com>
2016-05-18 15:24:28 +02:00
### Renamed api annotations
Assign multiple distribution sets to a target via mgmt api (#886) * Add multiassignment to mgmt api target endpoint * Remove single assignment ds to targets offline * Fix tests * Add quota for maxResultingActionsPerManualAssignment * Fix assignment with same target or distribution set multiple times in one request * Log UI error * Add tests * Enable single assignment requests with multiple DSs and types * Remove redundant target to DS assignment methods * Add tests, fix assignment * Fix possible nullpointer during target assignment request * Update api docu * Clean up deployment management code * Enforce MaxActions quota for offline assignment * Fix review findings * Rename property, add migration into * Add builder for DeploymentRequest * Change offline assignment method to accept an assignment list, like online assignment * Fix PR findings Signed-off-by: Stefan Klotz <stefan.klotz@bosch-si.com>
2019-09-17 14:20:26 +02:00
- Annotation `org.eclipse.hawkbit.rest.resource.EnableRestResources` has changed to `org.eclipse.hawkbit.mgmt.annotation.EnableMgmtApi`
- Annotation `org.eclipse.hawkbit.ddi.resource.EnableDirectDeviceApi` has changed to `org.eclipse.hawkbit.ddi.annotation.EnableDdiApi`
Extend migration guide Signed-off-by: SirWayne <dennis.melzer@bosch-si.com>
2016-05-18 15:24:28 +02:00
### Renamed maven modules
Assign multiple distribution sets to a target via mgmt api (#886) * Add multiassignment to mgmt api target endpoint * Remove single assignment ds to targets offline * Fix tests * Add quota for maxResultingActionsPerManualAssignment * Fix assignment with same target or distribution set multiple times in one request * Log UI error * Add tests * Enable single assignment requests with multiple DSs and types * Remove redundant target to DS assignment methods * Add tests, fix assignment * Fix possible nullpointer during target assignment request * Update api docu * Clean up deployment management code * Enforce MaxActions quota for offline assignment * Fix review findings * Rename property, add migration into * Add builder for DeploymentRequest * Change offline assignment method to accept an assignment list, like online assignment * Fix PR findings Signed-off-by: Stefan Klotz <stefan.klotz@bosch-si.com>
2019-09-17 14:20:26 +02:00
- Module hawkbit-mgmt-api-client has changed to hawkbit-example-mgmt-simulator
## Milestone 0.3.0M6
### Configuration Property changes
- hawkbit.server.security.dos.maxTargetsPerManualAssignment has changed to hawkbit.server.security.dos.maxTargetDistributionSetAssignmentsPerManualAssignment
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>
2021-02-10 17:06:50 +01:00
## 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 Copy Permalink