Java CSS Other
Clone or download
laverman Fix javaDoc comment (#720)
Signed-off-by: Jeroen Laverman <jeroen.laverman@bosch-si.com>
Latest commit b255823 Aug 15, 2018
Permalink
Failed to load latest commit information.
.3rd-party Fix path of output files Jun 22, 2018
.circleci Add CircleCi 2.0 config file #663 (#714) Jul 30, 2018
.github GitHub config for HawkBit bot added. Jun 16, 2018
docs Add news article statically (#718) Aug 9, 2018
hawkbit-artifact-repository-filesystem Master now on 0.3 Jun 11, 2018
hawkbit-autoconfigure Master now on 0.3 Jun 11, 2018
hawkbit-core Management API supports sorting distributionset by "createdAt" and "l… Aug 7, 2018
hawkbit-dmf Hotfix for DMF UPDATE_ATTRIBUTES message Jul 31, 2018
hawkbit-http-security Master now on 0.3 Jun 11, 2018
hawkbit-repository Target attributes update: Allow null values Aug 1, 2018
hawkbit-rest Fix javaDoc comment (#720) Aug 15, 2018
hawkbit-runtime Support displaying a privacy notice (#717) Aug 15, 2018
hawkbit-security-core Change length of createdBy and lastModifiedBy property to 64 characte… Jun 29, 2018
hawkbit-security-integration Master now on 0.3 Jun 11, 2018
hawkbit-starters Master now on 0.3 Jun 11, 2018
hawkbit-test-report Master now on 0.3 Jun 11, 2018
hawkbit-ui Support displaying a privacy notice (#717) Aug 15, 2018
licenses Add more license headers and fix a missing depdency. (#634) Feb 14, 2018
.gitattributes Fix cancel action status (#429) Feb 7, 2017
.gitignore Introduce new, Hugo templates based, website (#713) Aug 1, 2018
CODE_OF_CONDUCT.md Migrate examples and extensions into extra repositories. (#596) Oct 25, 2017
CONTRIBUTING.md Sandbox uri and user includes DEMO hint (#692) Jun 6, 2018
LICENSE Initial commit Nov 9, 2015
MIGRATION.md Extend migration guide May 18, 2016
README.md Change sonarqube configuration (#712) Jul 25, 2018
deployHawkBitSandbox.sh Master now on 0.3 Jun 11, 2018
eclipse_codeformatter.xml Remove swagger and minor feature extensions and bug fixes Jan 21, 2016
hawkbit_logo.png add hawkbit logo to readme.md Jul 20, 2016
pom.xml Introduce new, Hugo templates based, website (#713) Aug 1, 2018

README.md

Eclipse hawkBit™ - Update Server

Eclipse hawkBit is an domain independent back end solution for rolling out software updates to constrained edge devices as well as more powerful controllers and gateways connected to IP based networking infrastructure.

Build: Circle CI Maven Central

Docker images: Docker Docker MYSQL

Documentation

see hawkBit Documentation

Contact us

  • Want to chat with the team behind hawkBit? Join the chat at https://gitter.im/eclipse/hawkbit
  • Having issues with hawkBit? Open a GitHub issue.
  • You can also check out our Project Homepage for further contact options.

Examples and Extensions

Next to the hawkBit core hosted here the project maintains as well examples and extension repositories.

hawkBit sandbox

We offer a sandbox installation that is free for everyone to try out hawkBit. However, keep in mind that the sandbox database will be reset from time to time. It is also not possible to upload any artifacts into the sandbox. But you can use it to try out the Management UI, Management API and DDI API. Keep in mind as well that you are not permitted to store any kind of personal data in the sandbox.

https://hawkbit-demo-sandbox.eu-gb.mybluemix.net/UI/

In addition the following vendors offer free trial accounts for their hawkBit compatible products:

Device Integration

hawkBit does not provide off the shelf clients for devices as part of the project. The long term goal is to provide an Eclipse hono integration which will provide connectivity through various IoT protocols and as a result allows a wide range of clients to connect to hawkBit. However, the hawkBit Direct Device Integration (API) API is HTTP/JSon based which should allow any update client to integrate quite easily.

There are clients outside of the Eclipse IoT eco system as well, e.g.:

  • SWupdate which is a Linux Update agent with focus on a efficient and safe way to update embedded systems.
  • rauc-hawkbit which is a python-based hawkBit client application and library for the RAUC update framework.

Runtime dependencies and support

Java Runtime Environment: 1.8

SQL database

Database H2 MySQL/MariaDB MS SQL Server IBM DB2
DDLs maintained by project
Test dependencies defined
Versions tested 1.4 MySQL 5.6/5.7, AWS Aurora MS SQL Server 2017 DB2 Server v11.1
Docker image with driver provided (Tag: "-mysql")
JDBC driver H2 1.4 MariaDB Connector/J 2.0 MSSQL-JDBC 6.4
Status Test, Dev, Trial Production grade Production grade Test, Dev

(Optional) RabbitMQ: 3.6,3.7

Getting Started

We are providing a Spring Boot based reference Update Server including embedded H2 DB for test and evaluation purposes. Run with docker:

docker run -d -p 8080:8080 hawkbit/hawkbit-update-server

Open the update server in your browser:

localhost:8080

See below for how to build and run the update server on your own. In addition we have a guide for setting up a complete landscape.

hawkBit (Spring boot) starters

Next to the Update Server we are also providing a set of Spring Boot Starters to quick start your own Spring Boot based application.

Clone, build and run hawkBit

Build and start hawkBit Update Server

git clone https://github.com/eclipse/hawkbit.git
cd hawkbit
mvn clean install
java -jar ./hawkbit-runtime/hawkbit-update-server/target/hawkbit-update-server-#version#.jar

Start hawkBit Device Simulator (optional)

git clone https://github.com/eclipse/hawkbit-examples.git
cd hawkbit-examples
mvn clean install
java -jar ./hawkbit-device-simulator/target/hawkbit-device-simulator-#version#.jar

Generate getting started data with the Management API example (optional)

java -jar ./hawkbit-example-mgmt-simulator/target/hawkbit-example-mgmt-simulator-#version#-exec.jar

Status and API stability

hawkBit is currently in '0.X' semantic version. That is due to the need that there is still content in hawkBit that is in need for refactoring. That includes the maven module structure, Spring Boot Properties, Spring Boot auto configuration as well as internal Java APIs (e.g. the repository API ).

However, the device facing DDI API is on major version 'v1' and will be kept stable.

Server facing and DMF API are Management API are on v1 as well. However, we cannot fully guarantee the same stability during hawkBit's 0.X development but we will try as best we can.