Product page: https://www.omnect.io/home
This module implements a web frontend and backend to provide omnect specific features in a local environment, where the device might not be connected to the azure cloud. In that case the device cannot be remotely controlled by omnect-portal and omnect-ui might be the alternative.
Since omnect-os is designed as generic OS, all specific or optional applications must be provided as docker images. There are two options to install omnect-ui on a target:
- azure iotedge deployment:
- deployment of omnect-ui docker image via omnect-portal to a device in field
- device must be online (at least once) in order to receive the deployment
- after a factory reset omnect-ui must be deployed again what requires a connection to azure cloud
- in-factory installation (check meta-omnect for partition layout):
- inject omnect-ui docker image into factory partition
- omnect-os takes care of installation while first boot and after factory reset
In case it is agreed, the omnect team takes care of providing omnect-ui as application in omnect-portal. Get into contact with [email protected] if interested.
If omnect-ui must be part of the omnect-os image, several configuration files have to be injected into an omnect-os firmware image:
- in all files in config/ folder replace all occurrences of %% *** %% with reasonable values:
- it might be appropriate to adapt other default config values to your needs
- inject config files via omnect-cli into omnect-os image
# download and copy omnect-ui docker image
omnect-cli docker inject -d omnect/omnect-ui:latest -e /oci_images/omnect-ui.tar.gz -i my-omnect-os-image.wic
# copy config files
omnect-cli file copy-to-image \
-f omnect-device-service.env,factory:/etc/omnect/omnect-device-service.env \
-f omnect-ui.env,factory:/etc/omnect/omnect-ui.env \
-f publish_endpoints.json,factory:/etc/omnect/publish_endpoints.json \
-f omnect-ui.service,factory:/etc/systemd/system/omnect-ui.service \
-f create-fs-links.txt,factory:/etc/omnect/create-fs-links.txt \
-i my-omnect-os-image.wic
# copy certificates
# only in case not already done (e.g. device provisioned by tpm)
# devices provisioned by x509 usually already have certs injected
omnect-cli identity set-device-certificate \
-d "my-device-id" \
-c my-omnect-int-ca-fullchain.pem \
-k my-omnect-int-ca.key -D 365 \
-i my-omnect-os-image.wic
omnect-ui can be reached at https://DeviceHostnameOrIp:1977
Login with the configured credentials
Watch device status
Licensed under either of
- Apache License, Version 2.0, (./LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (./LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
copyright (c) 2024 conplement AG
Content published under the Apache License Version 2.0 or MIT license, are marked as such. They may be used in accordance with the stated license conditions.