diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 2f5f62533..3834bd2cb 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -58,7 +58,6 @@ Examples for hawkBit components: * Management API * Direct Device Integration API * Device Management Federation API -* Management UI * Repository * Security diff --git a/hawkbit-runtime/.sandbox/README.md b/hawkbit-runtime/.sandbox/README.md index f7b76c1c6..e31c02363 100644 --- a/hawkbit-runtime/.sandbox/README.md +++ b/hawkbit-runtime/.sandbox/README.md @@ -3,7 +3,6 @@ hawkBit Sandbox ## Try out the update server in our hawkBit sandbox -- try out Management UI https://hawkbit.eclipseprojects.io (username: demo, passwd: demo) - try out Management API https://hawkbit.eclipseprojects.io/rest/v1/targets (don't forget basic auth header; username: demo, passwd: demo) - try out DDI API https://hawkbit.eclipseprojects.io/DEFAULT/controller/v1/MYTESTDEVICE diff --git a/hawkbit-runtime/hawkbit-update-server/README.md b/hawkbit-runtime/hawkbit-update-server/README.md index 59fb7600c..12453a1f5 100644 --- a/hawkbit-runtime/hawkbit-update-server/README.md +++ b/hawkbit-runtime/hawkbit-update-server/README.md @@ -20,7 +20,6 @@ run org.eclipse.hawkbit.doc.Start ### Usage -The Management UI can be accessed via http://localhost:8080/UI The Management API can be accessed via http://localhost:8080/rest/v1 ## Enable Clustering (experimental) diff --git a/hawkbit-starters/hawkbit-boot-starter/README.MD b/hawkbit-starters/hawkbit-boot-starter/README.MD index e208fba09..aa57f584a 100644 --- a/hawkbit-starters/hawkbit-boot-starter/README.MD +++ b/hawkbit-starters/hawkbit-boot-starter/README.MD @@ -1,6 +1,5 @@ [Spring Boot Starter](http://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/#using-boot-starter) including all four interfaces: -* [Management UI](https://www.eclipse.org/hawkbit/documentation/interfaces/management-ui.html) * [Management API](https://www.eclipse.org/hawkbit/documentation/interfaces/management-api.html) * [Direct Device Integration API](https://www.eclipse.org/hawkbit/documentation/interfaces/ddi-api.html) * [Device Management Federation API (AMQP 0.9)](https://www.eclipse.org/hawkbit/documentation/interfaces/dmf-api.html) \ No newline at end of file diff --git a/site/config.toml b/site/config.toml index 78e0e5b94..8b7303789 100755 --- a/site/config.toml +++ b/site/config.toml @@ -89,11 +89,6 @@ canonifyurls = false url = "/architecture/" weight = 60 -[[menu.main]] - name = "Management UI" - url = "/ui/" - weight = 70 - [[menu.main]] name = "APIs" url = "/apis/" diff --git a/site/content/concepts/authentication.md b/site/content/concepts/authentication.md index f64f0cbdd..5ca952b72 100644 --- a/site/content/concepts/authentication.md +++ b/site/content/concepts/authentication.md @@ -9,7 +9,6 @@ A hawkBit update server can be accessed in four different ways: - _Direct Device Integration (DDI) API_ by **targets**. - _Management API_ by 3rd party **applications**. - _Device Management Federation (DMF) API_ by 3rd party **applications** through AMQP. -- _Management UI_ by **users**. @@ -261,8 +260,3 @@ Authentication is provided by _RabbitMQ_ [vhost and user credentials](https://ww ## Management API - Basic Auth - -## Management UI -- Login Dialog -- OpenID Connect - diff --git a/site/content/features.md b/site/content/features.md index d00186c55..94c75bcce 100644 --- a/site/content/features.md +++ b/site/content/features.md @@ -11,23 +11,11 @@ weight: 40 - Support for pre-commission devices in the repository and plug and play, i.e. device is created if it is authenticated for the first time. ## Update Management -- Directly deploy a defined software distribution to a device (by Management UI or API). +- Directly deploy a defined software distribution to a device (by Management API). - Update handling is independent of the device type, integration approach or connectivity. - Optional user consent flow, download and install updates only after respective end user has confirmed it. - Mass cancel the distribution of an update by invalidating the distribution set. -- Use action status codes for easier analysis. - -## Management UI -- Create/Read/Update/Delete operations for provisioning targets (i.e. devices) and repository content (i.e. software). -- Manage and monitor software update operations. -- Optimized for professional users, e.g. administrators, developers and 2nd/3rd level support staff. -- Ease of use drag-and-drop paradigm. -- Flexible grouping of data. -- Flexible filters for data browsing. -- Responsive to resolution. -- Lazy loading of data. -- All information on one page. -- Deep-linking for Targets to improve navigation. +- Use action status codes for easier analysis. ## Artifact Content Delivery - Partial downloads supported. diff --git a/site/content/guides/runhawkbit.md b/site/content/guides/runhawkbit.md index b3352fbbf..ecb0eac1e 100644 --- a/site/content/guides/runhawkbit.md +++ b/site/content/guides/runhawkbit.md @@ -93,7 +93,7 @@ see [update server](https://github.com/eclipse-hawkbit/hawkbit/tree/master/hawkb ### Compile & Run example scenario [creation script](https://github.com/eclipse-hawkbit/hawkbit-examples/tree/master/hawkbit-example-mgmt-simulator) (optional) -This has to be done before the device simulator is started. hawkBit creates the mandatory tenant metadata with first login into either _Management UI_ or API (which is done by this client). +This has to be done before the device simulator is started. hawkBit creates the mandatory tenant metadata with first login into either Management API (which is done by this client). However, this is not done by _DMF_ which is in fact used by the device simulator, i.e. without calling _Management API_ first hawkBit would drop all _DMF_ messages as the tenant is unknown. @@ -102,5 +102,3 @@ However, this is not done by _DMF_ which is in fact used by the device simulator see [device simulator](https://github.com/eclipse-hawkbit/hawkbit-examples/tree/master/hawkbit-device-simulator) # Enjoy hawkBit with a real database, artifact storage and all [interfaces](../../apis/) available - -![](../../images/hawkbit_ui.png) diff --git a/site/content/release-notes.md b/site/content/release-notes.md index 5f527a546..2971b25aa 100755 --- a/site/content/release-notes.md +++ b/site/content/release-notes.md @@ -121,7 +121,6 @@ First Eclipse hawkBit release including: * **Core features:** * Device and Software Repository - * Update Management Management UI/Console * Artifact Content Delivery * Rollout/Campaign Management diff --git a/site/content/ui.md b/site/content/ui.md deleted file mode 100644 index 7ab53d10e..000000000 --- a/site/content/ui.md +++ /dev/null @@ -1,165 +0,0 @@ ---- -title: Management UI -weight: 70 ---- - -The hawkBit Management UI provides several views for the different use cases: - -- _Deployment Management_ view for target administration and manual deployment. -- _Distribution Management_ view software repository metadata management. -- _Artifact Management_ view to manage the artifacts. -- _Target Filter Management_ view to manage target filters that can be used both in Deployment and Rollout Management views. -- _Rollout Management_ for large scale rollout orchestration. - -## Deployment Management - -### Purpose - -Target status overview, target management and manual deployments. - -### Feature explained -- Target Status: check status of all targets. -- Target list allows filters based on: - - Assigned/installed _DistributionSet_ (drag and drop a set on the filter icon on the top of the list) - - Target update status: click 1-X status to reduce the list of targets that have one of them. - - Target tag: click 1-X tags to reduce the list to targets that have one of them. - - Name, description: use search button on the top of the list. - - Target type: open Type Filter section to show targets of a specific type - -- _DistributionSet_ list allows filters based on: - - _DistributionSet_ tag: click 1-X tags to reduce the list of sets that have one of them. - - Name, description: use search button on the top of the list. - -- Start roll out by drag and drop targets on a DS. -- Target list supports CTRL-A for "select all". -- Select _Target_ to see _Action_ History. -- Bulk target upload: create bulk targets by upload. -- DS invalidation allows to mark broken updates and avoid the distribution of such - -Hints for bulk upload: - -- Expected file type : csv. -- Expected file format : Each line with two values (ControllerID,Target Name). ControllerID is mandatory. -- Example: -``` -Controller_id_1,targetName1 -Controller_id_2,targetName2 -``` - -![Deployment Management view](../images/ui/deployment_mgmt.png) - -### Distribution set invalidation - -It is possible to mark broken updates and avoid the distribution of such by invalidating the corresponding distribution -set in the Distributions list of the Deployment view. - -Invalidating a distribution set removes all auto-assignments that reference this distribution set. Optionally, all -rollouts that reference the distribution set can be stopped and existing update actions are removed, either by a -soft-cancel or a forced-cancel. - -Invalidated distribution sets cannot be valid again, but remain invalid. They cannot be assigned to targets, neither -through a rollout, auto-assignment nor a single assignment. - -![Distribution set invalidation](../images/ui/deployment_ds_invalidation.png) - -## Distribution Management - -### Purpose - -Distribution Set view to manage software repository metadata, i.e. Distribution Sets, their Software Modules and the respective types. - -### Features explained -- Browse, create, delete and update Distribution Sets. -- Browse, create, delete and update Distribution Set Types. -- Browse, create, delete and update Software Modules. -- Browse, create, delete and update Software Module Types. -- Assign Software Modules to Distribution Sets. - -![Distribution Management view](../images/ui/distribution_mgmt.png) - -## Artifact Management - -### Purpose -Software artifact management, both metadata (i.e. Software Modules) and artifacts themselves. - -### Features explained -- Browse, create, delete and update Software Modules. -- Browse, create, delete and update Software Module Types. -- Upload and delete software artifacts for a module. - -![Artifact Management view](../images/ui/artifact_mgmt.png) - -## Rollout Management - -### Purpose -Software rollout in large scale, rollout status overview and rollout management. - -### Features explained -- Create, update, copy and delete of rollouts. -- Start, pause and resume of rollouts. -- Progress monitoring for the entire rollout and the individual groups. -- Drill down to see the groups in a rollout and targets in each group. -- Rollout attributes: - - Selection of targets as input for the rollout based on _target filter_ - - Selection of _distribution set_ - - Auto-splitting of the input target list based on _group number_ defined - - _Trigger threshold_ to define the percentage of installation to be completed , to trigger the start of next group - - _Error threshold_ defines the percentage of error tolerance of a group before calling for an emergency shutdown of a rollout - -![Rollout Management view](../images/ui/rollout_mgmt.png) - -![Rollout Management view](../images/ui/rollout_groups.png) - -{{% note %}} -Deletion of targets which are in a rollout, changes the rollout statistics. -{{% /note %}} - -## Target Filter Management - -### Purpose -Custom target filter overview and filter management. - -### Features explained -- Custom target filter allows user to filter targets by defining custom query. -- Displays custom target filter list and user can search any particular filter. -- Create, update and delete features are supported for target filters. -- Auto assignment of a distribution set to filtered targets. - -### How to Filter -The basic syntax to filter is: `fieldvalue fieldvalue <...>` - -- `field`: is the name of the resource field. -- `value`: is the expected value of the target field. - - Use `*` for wildcard matches. -- ``: Are operators to do simple queries. Supported basic operators are: - - `==` : equal - - `!=` : not equal - - Use `=IN=` for 'in' parameter.(Example: name=IN=(target1,target2). -- ``: Are operators to join simple queries: Supported composite operators are: - - `and` - - `or` - -### Examples - -| Custom query | Description | -|--------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------| -| updatestatus==error | Gives all targets in ‘error’ state. | -| controllerId!=192.168.2.42 | Gives all targets that do not have the controllerId 192.168.2.42. | -| name==\*CCU\* | Gives all targets which contain the term ‘CCU’ in there name. | -| name==\*CCU\* or description==\*CCU\* | Gives all targets that either have the term ‘CCU’ in their name or their description. | -| name==\*SHC\* and description==\*SHC\* | Gives all targets that have the term SHC in their name and their description. | -| name==CCU* and updatestatus==pending | Gives all targets with their name starting with ‘CCU’ and which are in ‘pending’ state. | -| (assignedds.name==‘ECU-DS’ and description==test) or updatestatus!=error | Gives all targets which are either assigned to ‘ECU-DS’ and have description equals to ‘test’ or which are not in error status. | -| (updatestatus!=In\_sync or updatestatus!=error) and name==\*SHC1\* | Gives all targets that do not have the update status In\_sync or error and that contains the term SHC1 in their name. | -| (updatestatus!=error or updatestatus!=pending) and (name==\*CCU\* or description==\*CCU\*) | Gives all targets that either have the term ‘CCU’ in their name or their description and that either have the _update status_ not in state error or pending. | - -![Target Filter Management view](../images/ui/target_filter.png) - -### Auto assignment -It is possible to assign some distribution set with different action types (_forced_, _soft_, or _download only_) to all targets that belong to the corresponding custom target filter, including the ones, that are registered later on. - -In order to activate the auto-assignment, one should first click on _Auto assignment_ cell in Custom Filters table, and then check the corresponding checkbox. After that, the action type and distribution set for auto-assignment should be selected and confirmed. - -As long as the auto-assignment stays active, the scheduler will try to assign selected distribution set to corresponding custom filter targets, that have never seen it before. - -![Auto assignment](../images/ui/target_filter_auto_assignment.png) diff --git a/site/static/images/hawkbit_ui.png b/site/static/images/hawkbit_ui.png deleted file mode 100644 index 728216b89..000000000 Binary files a/site/static/images/hawkbit_ui.png and /dev/null differ