Digital Factory Demo v3.3

11 min

Digital Factory Demo 3.3 - Installation

Overview

Digital Factory Demo (DFD) 3.3 installs from a single self-installing container. You load one image and run it; it brings up the full stack inside Litmus Edge (simulation_servers, mssql, mysql, grafana, template-applyer), and template-applyer configures Litmus Edge automatically: devices, tags, flows, digital twins, integrations, and SQL connectors. There is no separate template file to upload.

There are two installers:

Online (demo_install): small download; pulls the stack images from litmusedge.azurecr.io at run time.

Offline (demo_install_offline): bundles every image; no registry access needed at deploy time.

A short post-install step is still required to enter the database credentials inside the flow nodes (these are not carried by the template).

Prerequisites

Litmus Edge 3.16.x or later

A valid Litmus Edge license

About 5 GB free disk and 3 GB RAM headroom

Docker access on the Litmus Edge host

Online install

1. Download

From the Litmus central portal (Digital Factory Demo solution), download the file marked "online": Files_For_ONLINE_Installation_v3.3.zip. Unzip it to get demo_install.tar.gz.

2. Log in to the registry

The host needs to pull the stack images:

docker login litmusedge.azurecr.io

3. Load and run the installer

docker load -i demo_install.tar.gz

docker run -d --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e EDGE_API_TOKEN=init \
  -e EDGE_URL=172.172.0.1:8443 \
  litmus/demo_install:latest

EDGE_API_TOKEN=init auto-generates a token on first login. Allow 3 to 5 minutes for images to pull and the stack to start.

Offline install

1. Download

From the central portal, download the file marked "offline": Files_For_OFFLINE_Installation_v3.3.zip (about 1 GB). Unzip it to get demo_install_offline.tar.gz.

2. Load and run the installer

docker load -i demo_install_offline.tar.gz

docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e EDGE_API_TOKEN=init \
  -e EDGE_URL=172.172.0.1:8443 \
  litmus/demo_install_offline:latest

The installer loads all bundled images into Litmus Edge, so no pull happens. Allow a few minutes for the stack to start.

Post-install configuration

After the stack is up and the installer has exited, complete these steps in the Litmus Edge UI.

1. Enter database credentials in flows

Go to Flows and open the production, maintenance, and energy-monitoring flows. In the Global Code Matrix tab, open each database node (the query and insert-record nodes) and enter the SQL credentials (sa / Demo1234). Deploy the flows after editing.

2. Add the InfluxDB database user

Go to DataHub > DB Users and add a user to the internal Litmus Edge database (tsdata) so the InfluxDB node can write time-series data.

3. Enable the device data store

Go to DeviceHub > Devices, enable Data Store, and set retention to 24 hours. Click Update Device for each device.

Access

Service	Address	Credentials
Grafana	http://<le-ip>:3000	admin / admin (change on first login)
Simulator Control Center	http://<le-ip>:3300	none
Litmus Edge	https://<le-ip>:8443	your LE login
MSSQL	<le-ip>:1433	sa / Demo1234
MySQL	<le-ip>:3306	sa / Demo1234

Tear down

Offline:

docker run --rm -v /var/run/docker.sock:/var/run/docker.sock \
  -e COMPOSE_COMMAND=DOWN litmus/demo_install_offline:latest