Prepare a software update

images/inline/877f8a7806f1c0b1dbd18053e117fbae2749cca8.png

Once the device has been registered, you can prepare an update and describe what you need to install on it via Bosch IoT Rollouts.

In this section we will demonstrate how to deploy a bundle on Bosch IoT Edge via Bosch IoT Rollouts.

Table of contents:

Search a device which will get a software update

Verify your setup from the Bosch IoT Rollouts' perspective, by using the service's user interface.

Starting at the Bosch IoT Suite Console opened, click the Rollouts entry in the left navigation.

In case it is not there, use the search, and click the star icon to pin it to your navigation bar.

Bosch IoT Rollouts UI opens in a new browser tab, as it is not fully integrated in Bosch IoT Suite Console.

images/confluence/download/attachments/1634789707/rollouts-pin.png

In the Deployment Management view, as part of the Targets list panel you should see the device that you previously registered.

Bosch IoT Rollouts lists only gateways/devices which have the SoftwareUpdatable feature. See SoftwareUpdatable feature detailed specification and integration guide.

The screenshot shows edge-agent-01:edge:containers, the Edge Services' containers management virtual device, and its bundles management virtual device edge-agent-01:edge:bundles.

images/confluence/download/attachments/1634789707/getStarted-prepareSoftwareUpdate-deploymentManagement.png

In case of multiple entries (at a later point in time) use the search function in Targets.
The list will then filter the view and show only targets (=your devices) which contain the given sub-string.

The namespace, which is part of your device ID is not displayed here in order to save space in the column.

Distributions view

Go to the Distribution Set Management view from the navigation bar.

As you will deploy a bundle to you device, create a new Distribution type and Software module type.

Create a new distribution type

  1. Click the gear icon in the left side of the screen as seen in the screenshot under 1.

  2. Fill in the required fields:

    1. A user-friendly name for the type.

    2. The needed key, found under the softwareModuleType of the specific thing's SoftwareUpdatable feature.

  3. Click Save.

images/confluence/download/attachments/1634789707/getStarted-createDistributionType.png

Create a new software module type

  1. Click the gear icon in the right side of the screen.

  2. Fill in the required fields:

    1. A user-friendly name for the type.

    2. The needed key, found under the softwareModuleType of the specific thing's SoftwareUpdatable feature. In our case osgi:bundle.

    3. Select Software (SW).

  3. Click Save.

images/confluence/download/attachments/1634789707/getStarted-createNewSoftwareModuleType.png

Upload view

Navigate to the Upload Management view.

Add an artifact to a Software Module

  1. Click the + icon at the top-right of your Software Module list to add your first Software Module of type "Bundle".

    images/confluence/download/attachments/1634789707/getStarted-prepareSoftwareUpdate-uploadManagement1.png
  2. Fill in the mandatory fields and click Save.

    images/confluence/download/attachments/1634789707/getStarted-prepareSoftwareUpdate-createNewSoftwareModuleBundle.png
  3. Upload your bundle file, using the Drop Files to upload section in the lower right corner.

  4. The uploaded artifact will appear automatically in the Artifact Details list upon successful upload.

Distributions view

Return to the Distributions Management view.

Add a Software Module to a Distribution Set

Now you need to define a Distribution Set to package your Software Module, both of them based on the Bundles types that we already created.

  1. Click the + icon on the top right of your Distributions list to create a new Distribution of your recently created type.

    images/confluence/download/attachments/1634789707/getStarted-prepareSoftwareUpdate-distributionsManagement.png
  2. Fill in the mandatory fields and click Save.

    images/confluence/download/attachments/1634789707/getStarted-prepareSoftwareUpdate-createNewDistribution.png

  3. Drag&drop the Software Module to your Distribution Set to create an assignment between both entities.

    images/confluence/download/attachments/1634789707/getStarted-prepareSoftwareUpdate-assignModuleToDistribution.png
  4. To check the correct assignment click your Distribution Set and the assigned Software Module(s) will be highlighted with the color of the Software Module Type.

Once the software update has been prepared it is time to assign the distribution to your registered device and trigger the update.