📚 课程目录第4章 EcoStruxure边缘软件栈安装

4. EcoStruxure边缘软件栈安装

EcoStruxure边缘软件栈并不是一个单一安装包，而是由多个职责不同的组件构成的运行环境。理解它们之间的依赖关系，是避免“装完却跑不起来”的关键。本节围绕三类核心组件展开：Edge Control负责边缘侧控制运行时与容器化应用托管；Edge Advisor负责数据采集、边缘分析与云端协同；EcoStruxure Automation Expert（下称EAE）负责基于IEC 61499的分布式自动化工程组态与运行。三者共享同一台边缘主机（常见为Harmony Edge或工业PC），但安装顺序、授权对象和网络要求各不相同。

一、安装前的环境确认

在开始部署前，需要先确认边缘主机的硬件与系统基线。以典型的Harmony Edge Box为例，建议配置为：4核CPU、8 GB内存、128 GB SSD，操作系统为厂商预装的Linux或Windows IoT版本。需要重点核对三项：

虚拟化支持：Edge Control依赖容器运行时，需在BIOS中启用VT-x/AMD-V；
时间同步：边缘主机必须与NTP服务器同步，否则授权证书和云端连接会因时间偏差失败；
网络端口：Edge Control默认使用443/8443，Edge Advisor使用8883（MQTT over TLS），EAE运行时使用61499端口，需在防火墙中放行。

建议在安装前记录主机的MAC地址和序列号，后续授权绑定会用到这两个标识。若使用虚拟机，需确保MAC地址固定，避免重启后变化导致授权失效。

二、组件部署顺序与依赖关系

三个组件并非完全独立，推荐按“Edge Control → EAE → Edge Advisor”的顺序部署。原因是Edge Control提供容器编排和运行时基础，EAE的运行时可以作为容器化应用部署在Edge Control之上，而Edge Advisor则依赖前两者产生的数据接口。

三、Edge Control的安装与授权

Edge Control的安装通常通过厂商提供的安装脚本或镜像完成。以Linux环境为例，典型流程如下：

# 1. 导入安装包并校验
sudo ./edge-control-installer.run --check

# 2. 执行安装，指定数据目录
sudo ./edge-control-installer.run --install --data-dir /opt/edge/data

# 3. 启动服务并检查状态
sudo systemctl start edge-control
sudo systemctl status edge-control

# 4. 获取主机指纹（用于授权绑定）
edge-control-cli license fingerprint

执行第4步后，终端会输出一串由MAC地址和主机序列号生成的指纹字符串，例如 EC-7A3F-9B21-C4D8。将该指纹提交到Schneider License Manager，选择对应的授权类型（如Edge Control Standard或Advanced），系统会生成一个 .lic 许可证文件。将文件放置到 /opt/edge/license/ 目录后，重启服务即可激活。

授权文件与主机指纹一一对应，更换硬件或重装系统后指纹会变化，需要重新申请。建议在部署前确认授权数量，避免现场无法激活。

四、EcoStruxure Automation Expert的部署

EAE的部署分为两部分：工程组态环境（通常安装在工程师站）和运行时（部署在边缘主机）。工程环境通过EAE IDE完成，运行时则以容器方式运行在Edge Control之上。部署运行时的关键步骤是：

在EAE IDE中创建项目，选择目标设备类型为“Edge Runtime”；
配置通信参数，包括边缘主机IP、61499端口和证书；
将项目编译为运行时包（.eae-runtime）；
通过Edge Control的应用管理界面上传并启动该运行时包。

EAE的授权分为工程授权和运行时授权。工程授权绑定工程师站的License Manager，运行时授权则绑定边缘主机。一个常见的误区是只激活了工程授权就认为可以运行，实际上运行时授权需要单独申请。在EAE IDE的“License”面板中，可以查看当前工程授权状态和可用的运行时授权数量。

五、Edge Advisor的安装与云连接

Edge Advisor的安装相对独立，但需要Edge Control已正常运行。安装命令示例如下：

# 安装 Edge Advisor
sudo ./edge-advisor-installer.run --install

# 配置云连接参数
edge-advisor-cli config set cloud.endpoint "mqtts://cloud.ecostruxure.com:8883"
edge-advisor-cli config set cloud.client-id "edge-site-01"
edge-advisor-cli config set cloud.cert "/opt/edge/certs/device.pem"

# 启动并验证连接
sudo systemctl start edge-advisor
edge-advisor-cli status

执行 status 后，若输出中 cloud.connection 显示为 connected，说明MQTT/TLS连接成功。若显示 disconnected，优先检查证书是否过期、端口8883是否被防火墙拦截，以及主机时间是否与NTP同步。Edge Advisor的授权通常采用订阅制，与云端账户绑定，本地只需配置正确的设备证书即可。

六、部署后的验证清单

检查项	验证方法	预期结果
Edge Control服务	`systemctl status edge-control`	active (running)
Edge Control授权	`edge-control-cli license status`	Licensed, 有效期正常
EAE运行时	Edge Control应用列表	运行时容器状态为Running
EAE授权	EAE IDE License面板	工程与运行时授权均有效
Edge Advisor连接	`edge-advisor-cli status`	cloud.connection: connected
数据上行	云端设备影子/数据面板	能看到边缘侧上报的测点值

完成以上验证后，边缘软件栈即具备运行条件。实际项目中，建议将上述命令和检查项整理为部署脚本或检查表，每次现场部署时逐项确认，可以显著减少因授权或网络配置遗漏导致的返工。