Skip to content

Open Edge Device Kit – Getting Started - Docker Version

{!./resources/openedge-devicekit/text-modules/prerequisites.txt!} - Network settings must allow access to https://hub.docker.com

Installation Instructions

Setting up Docker and Docker Compose

  1. Install Docker version 18 or higher and Docker Compose version 1.23 or higher from https://docs.docker.com/compose/install/. The following commands perform the installation on Debian-based operating systems:

    ```cmd tab="Docker" curl -fsSL get.docker.com -o get-docker.sh && sh get-docker.sh sudo usermod -aG docker $USER

    ```cmd tab="Docker Compose"
    apt install -y python python-pip
    pip install docker-compose
    

  2. Change the execution rights for Docker Compose for all users with the following command:

    sudo chmod +x /usr/local/bin/docker-compose
    
  3. If you are behind a proxy, add the proxy information in the Docker file:

    FROM openjdk:8u131-jre-alpine
    ENV HTTP_PROXY= http://{proxy_ip}:{proxy_port}
    RUN apk add --no-cache bash
    RUN  mkdir -p /opt/siemens/ipc
    COPY ipc /opt/siemens/ipc
    CMD ./opt/siemens/ipc/bin/MindEdgeRuntimeSystem -c /opt/siemens/ipc/cfg/oedk_config.json
    
  4. Restart the device.

Downloading the Open Edge Device Kit

Download the Open Edge Device Kit from the Siemens Industry Online Support (SIOS) Portal. Extract the tarball file with the option tar -xvf.

The docker version consists of the following files:

  • Config file for the Open Edge Device Kit: {extract_path}/ipc/cfg/oedk_config.json
  • Docker file: {extract_path}/dockerfile
  • Docker Compose file: {extract_path}/docker-compose.yml
  • Open Edge Device Kit executables

{!./resources/openedge-devicekit/text-modules/settings.txt!}

Starting the Open Edge Device Kit

Run the following commands in the {extract_path} directory:

< /dev/urandom tr -dc _A-Z-a-z-0-9 | head -c20 >  rand.dat
docker-compose build
docker-compose up  (-d for running in the background)

This starts two docker containers, the Device_Kit runs the Open Edge Device Kit and the Mqtt_Broker runs Eclipse Mosquitto.

Eclipse Mosquitto Connection Information

The Eclipse Mosquitto broker is available at:

IP Address: 172.30.0.7
Port : 1883 (default port)

Any questions left?

Ask the community


Except where otherwise noted, content on this site is licensed under the MindSphere Development License Agreement.


Last update: December 4, 2019