Open Edge Device Kit – 入门指南 - Docker 版本

使用 Open Edge Device Kit 的先决条件

Open Edge Device Kit是一个可以在用户设备上运行的软件组件。该模块用Java编写，可以在对Java友好环境中执行。

• 4 GB 免费磁盘空间
• 1 GB 可用 RAM
• 1 核心 CPU, 600 MHz
• 基于 Linux 的操作系统
• 根特权
• 网络设置必须允许访问 https://hub.docker.com

安装介绍

建立 Docker 和 Docker Compose

1. 从 https://docs.docker.com/compose/install/ 安装 Docker 版本18 或更高版本，和 Docker Compose 版本1.23或更高版本。以下命令在基于 Debian 操作系统中执行安装：

   ```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. 使用以下命令更改 Docker Compose 对所有用户的执行权限：

   sudo chmod +x /usr/local/bin/docker-compose
   

3. 如果您在代理之后，请在 Docker 文件中添加代理信息：

   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. 重新启动设备。

下载 Open Edge Device Kit

从 Siemens Industry Online Support (SIOS) Portal 中下载 Open Edge Device Kit。使用选项 tar -xvf 提取 tarball 文件。

Docker version 包含以下文件：

• Open Edge Device Kit 的配置文件： {extract_path}/ipc/cfg/oedk_config.json
• Docker 文件： {extract_path}/dockerfile
• Docker Compose 文件： {extract_path}/docker-compose.yml
• Open Edge Device Kit 可执行文件

改变设置(可选)

Open Edge Device Kit在启动时使用一个名为oedk_config.json并位于ipc/cfg目录的设置文件。

{
  "installation": {
    "autoStart": 1,
    "agentRoot": "/persistent_massdata/appData/"
  },
  "logging": {
    "active_log_directory": "/persistent_massdata/log/",
    "upload_log_directory": "/persistent_massdata/tmp/logsToUpload/",
    "archived_log_directory": "/persistent_massdata/tmp/archive/",
    "logLevel": "INFO",
    "size_mb": 20,
    "size_cap_mb": 200,
    "log_history_days": 8,
    "upload_cycle_sec": 120
  },
  "offlineCache": {
    "directory": "offlineCache/",
    "size": 500000000
  },
  "controllerInterface": {
    "mqttPort": 1883,
    "mqttHostname": "172.30.0.7"
  },
  "communication": {
    "keyStorePath": "keyStore/"
  },
  "eventObserver": {
    "initialDelay": 0,
    "executionPeriod": 10
  },
  "notification": {
    "notificationTimeout": 600
  }
}

下表列出了设置文件的配置参数。表中未列出的参数建议不要更改。

参数	默认	描述
offlineCache > size (byte)	500.000.000	当设备离线时时间序列数据的最大存储空间。 建议值：100.000.000 – 2.000.000.000
controllerInterface > mqttPort	1883	MQTT 代理的端口
controllerInterface > mqttHostname	Docker: "172.30.0.7” Script: "127.0.0.1"	MQTT 代理的 IP 地址
EventObserver > initialDelay (seconds)	0	定义在 Open Edge Device Kit 开始轮询 MindSphere 中作业之前的初始延迟(例如配置更新)。不建议更改此值。
EventObserver > executionPeriod (seconds)	10	定义 MindSphere 中轮询作业(例如:配置更新)的周期。值大于30 秒可以帮助减少流量，但会导致这些作业的执行延迟。推荐值：10 – 120
Notification > notificationTimeout (seconds)	600	通知的超时值，例如：上线状态。如果操作耗时较长，则会失败，并生成一条日志消息 notification could not be processed。 推荐值取决于 CPU： - 多核 x86-x64 CPUs: 60 - 单核，低频或移动 CPUs: 600 – 1000
Logging > level	INFO	Open Edge Device Kit 的日志等级。启动 DEBUG 将显著降低性能。 推荐值：ERROR 或 INFO。
Logging > sizeMB	20	日志记录文件的最大文件大小。不建议更改此值。
Logging > uploadCycleSec	120	发送日志文件到 MindSphere 的上传间隔。 推荐值：120 - 18000
Logging > size_cap_mb (MB)	200	设备上日志文件占用的最大存储空间。 推荐值：200

启动 Open Edge Device Kit

在 {extract_path} 目录中运行以下命令：

< /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)

IP Address: 172.30.0.7
Port : 1883 (default port)

还有问题?

向社区提问

除非另行声明，该网站内容遵循MindSphere开发许可协议.