Open Edge Device Kit – 入门指南 - 可执行程序版本¶

使用 Open Edge Device Kit 的先决条件¶

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

4 GB 免费磁盘空间
1 GB 可用 RAM
1 核心 CPU, 600 MHz
基于 Linux 的操作系统
根特权
JRE 8
一个 MQTT 代理，推荐 Eclipse Mosquitto (https://mosquitto.org/) - 必须在 Open Edge Device Kit 启动前运行。

信息

确保使用高可用性的 MQTT 代理。

安装介绍¶

下载 Open Edge Device Kit¶

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

安装可执行文件¶

使用以下命令触发安装：

./install.sh

默认的，安装脚本安装 Open Edge Device Kit 到目录 /opt/siemens/。使用目录参数 -d {installation_directory} 以实现自定义安装目录。

帮助

安装脚本打开内置帮助通过:

./install.sh -h

改变设置(可选)¶

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¶

使用以下命令启动 Open Edge Device Kit：

{installation_directory}/bin/MindEdgeRuntimeSystem -c {installation_directory}/cfg/oedk_config.json

Last update: November 16, 2021