Device Configuration

Device Configurations are versioned blueprints that describe what a device should run and how it should behave. It lets you prepare, review, and reuse setups before they reach devices. A configuration can include:

  • Modules - containerized building blocks.

  • Applications - larger solution components containing modules and configuration.

  • Asset hierarchy - the structure of your production site, data collection and processing, including the required modules to execute it.

  • Settings and defaults - for example, management and data upload paths.

A device configuration only becomes active on a device when you deploy it.


Versioning

Device configurations are versioned, which means that every time you save, a new version number is generated. Older versions remain intact. This has the following advantages:

  • Traceability & audit – see what changed, when, and by whom.

  • Safe rollback – If a change causes issues, you can return devices to a working version quickly.

  • Compliance & approvals – Version numbers and change notes make reviews and sign-offs straightforward.

Deployments always reference a specific version, so a device keeps running that version until you deploy another.


UI Overview

When selecting a device in the Devices list, the latest saved version of the device configuration appears in the details pane.

Device Configuration for the device "sesam-device-silkeborg" in version 20.

The device configuration UI consists of the following tings:


Buttons

Deploy

Deploys the currently selected device configuration version to the selected device.

Using the content defined on the Overview, Modules, Applications, Asset Hierarchy, and Settings tabs to generate a manifest, it applies the manifest to the device.

Deployment options, that allows the user to schedule the deployment for later.

When clicking Deploy, a pop-up provides the option to either deploy now, or to schedule the configuration to be deployed automatically later. Clicking "Schedule deployment" enables the schedule time selection:

Scheduling the device configuration for a automated deployment that runs at a specified time.

A deployment does not edit your device configuration. It just applies the selected version to the device.

Reset

The Reset button resets all configuration on the device, by removing all assigned modules, applications and asset hierarchy. This will create a new version of the device configuration.

When clicking Reset, the following pop-up will show:

Pop-up when resetting device configuration.

If the option "Do you want to deploy to device after reset?" is enabled, the new reset device configuration will automatically be deployed to the device. This effectively removes all functionality (modules) running on the device.

View Manifest

Opens a read-only view of the generated deployment manifest for the selected version of the device configuration. The manifest is shown as JSON formatted text.

Secrets, like keys and passwords, are not visible in the manifest. It is hidden behind placeholders.

Viewing the manifests might be a useful way to do quick auditing before a deploy, or to perform troubleshooting, in the event of issues. The manifest is also used when sharing details with support.

Save / Discard Changes

When a device configuration has been changed by the user, the Save button appears. The changes can either be saved by clicking the Save button, and thereby generating a new version of the device configuration, or discarded by clicking the Discard Changes button.

Save / Discard Changes buttons appear on the device configuration when there are changes.

Last updated

Was this helpful?