Management UI

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

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 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.

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.

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

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: field<basic_operator>value <composite_operator> field<basic_operator>value <...>

• field: is the name of the resource field.
• value: is the expected value of the target field.
  • Use * for wildcard matches.
• <basic_operator>: Are operators to do simple queries. Supported basic operators are:
  • == : equal
  • != : not equal
  • Use =IN= for ‘in’ parameter.(Example: name=IN=(target1,target2).
• <composite_operator>: 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.

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.