84f0180ad1
* 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>
42 lines
2.6 KiB
Markdown
42 lines
2.6 KiB
Markdown
|
|
# 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
|
|
|
|
### 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)
|
|
|
|
### Renamed api annotations
|
|
- 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`
|
|
|
|
### Renamed maven modules
|
|
- 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
|
|
|
|
## 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'`
|