Bosch IoT Rollouts

Manage a distribution set

View distribution set details

Once you have created a distribution set, you can view its details by selecting it on the list.

images/confluence/download/attachments/2762973756/distribution-set-details-version-1-modificationdate-1716308554000-api-v2.png

This will open the Distribution set blade view as well as the Assigned software modules blade view.

The Distribution set blade view contains useful distribution set-related information such as created and last modified timestamp, the user who created or modified it last, whether it requires a migration step and will inform you if the distribution set is locked.

The Assigned software modules blade view will contain a list of all assigned software modules.

To learn how to assign a software module to a distribution set, refer to Assign a software module to a distribution set.

Distribution set actions

The distribution set actions images/confluence/download/thumbnails/2762973756/wrench-version-1-modificationdate-1681289128000-api-v2.png icon opens a dialog which provides the following management actions:

  • Edit - Edit the description of the distribution set.

  • Lock/Unlock - P revent or permit the assignment or unassignment of additional software modules to the distribution set.

  • Invalidate - The distribution set cannot be assigned to targets anymore and it is going to be removed from all auto assignments. The user can choose to cancel all rollouts and (force) cancel all actions connected to this distribution set.

  • Delete - Delete the distribution set.

The Invalidate action is irreversible and the distribution set cannot be used any more after invalidating


images/confluence/download/attachments/2762973756/distribution-set-actions-version-1-modificationdate-1716310411000-api-v2.png


Edit distribution set

You are only allowed to edit the optional fields of the distribution set.

images/confluence/download/attachments/2762973756/edit-distribution-set-version-1-modificationdate-1716317343000-api-v2.png

Locking and Unlocking a distribution set

The distribution set has a management action to manually lock or unlock it, controlling whether new software modules can be assigned or unassigned.

Locking a distribution set can be done manually and automatically.

Manual Locking

  • You can choose to lock the distribution set manually by the Lockimages/confluence/download/thumbnails/2762973756/lock_icon-version-1-modificationdate-1716311473000-api-v2.png distribution set action.

  • Once locked, no additional software modules can be assigned or unassigned to and from the distribution set until an explicit manual Unlock images/confluence/download/thumbnails/2762973756/unlock-version-1-modificationdate-1716314123000-api-v2.png distribution set action is performed.

Automatic (Implicit) Locking

  • When a distribution set is assigned, it will automatically lock to prevent users from assigning or unassigning software modules from an already assigned distribution set.

  • Once a distribution set is assigned and locked, it ensures that the set remains stable without any changes until an explicit manual Unlock images/confluence/download/thumbnails/2762973756/unlock-version-1-modificationdate-1716314123000-api-v2.png distribution set action is performed.

  • Automatic lock can be enabled and disabled by the Implicit lock toggle configuration . Refer to Configuration.

  • Even with automatic locking enabled, manual overrides provide flexibility to accommodate specific client needs.

For Automatic locking you should make sure the user that is performing the distribution set assignment has Repository Update permission. Permission can be updated from the Access control feature.


Locking a distribution set will result in:

  1. Lockedimages/confluence/download/thumbnails/2762973756/lock_icon-version-1-modificationdate-1716311473000-api-v2.png icon in front of the distribution set name from the distribution set list. (given the Locked icon column in the distribution set list is enabled via images/confluence/download/thumbnails/2762973756/gear-version-1-modificationdate-1716311344000-api-v2.png )

  2. The Locked information flag in the Distribution set blade view will be shown as Yes.

  3. The Assign images/confluence/download/thumbnails/2762973756/assign_icon-version-1-modificationdate-1716311832000-api-v2.png button to assign additional software modules to the distribution set will be disabled.

  4. The Unassign images/confluence/download/thumbnails/2762973756/unassign_icon-version-1-modificationdate-1716315423000-api-v2.png button to unassign software modules from the distribution set will be disabled.

images/confluence/download/attachments/2762973756/distribution-set-lock-action-version-1-modificationdate-1716315847000-api-v2.png

Invalidate distribution set

Invalidated distribution sets can no longer be used in any rollout and auto assignment. Invalidation cannot be undone.

After clicking the Invalidate distribution set action a new Invalidate distribution set blade view will be shown.

In the new blade view you will be able to:

  1. View all affected rollouts , actions and auto assignments .

  2. Decide to stop all active rollouts of this distribution set.

  3. Decide to c ancel all existing actions of this distribution set.

images/confluence/download/attachments/2762973756/invalidate-version-1-modificationdate-1716316753000-api-v2.png

Delete distribution set

You will be asked for confirmation to delete a distribution set.

images/confluence/download/attachments/2762973756/delete-version-1-modificationdate-1716316997000-api-v2.png

Distribution set metadata

At the bottom of the Distribution set blade view, you will see the Metadata section.

The Metadata section displays a list of all the key:value pair metadata entries which have been added to the selected distribution set and provides metadata management actions.

Create a metadata entry

Click the + icon on the right of the Metadata section.

images/confluence/download/attachments/2762973756/metadata-version-3-modificationdate-1716317790000-api-v2.png

Type in the desired Key and Value in the Add metadata pop up.
images/confluence/download/attachments/2762973756/metadata_add-version-1-modificationdate-1716318002000-api-v2.png

Click Add.

The new metadata entry will be then added to the list. It is possible to delete or edit the value of each metadata entry through the respective icons on the right.
images/confluence/download/attachments/2762973756/metadata_browse-version-1-modificationdate-1716318196000-api-v2.png

Tag distribution set

You can assign a tag to one or multiple distribution sets by:

  1. Select the desired distribution sets from the list.

  2. Click the Assign tagimages/confluence/download/thumbnails/2762973756/label-version-1-modificationdate-1695720482000-api-v2.png icon.

  3. Type in the name of a tag. If the tag doesn't exist a new tag with the same name will be created automatically.

  4. Click Assign.

images/confluence/download/attachments/2762973756/tag-distribution-set-version-1-modificationdate-1716354065000-api-v2.png

To see all the tag a distribution set is tagged with. Click on the desired distribution set and expand the Tags section of the Distribution set blade view.

images/confluence/download/attachments/2762973756/tag-section-version-1-modificationdate-1716354403000-api-v2.png

To untag a distribution set simply click the X button next to the tag in the Tags section of the Distribution set blade view.

To learn how to manage distribution set tags, refer to Create and view distribution set tags.