4. 事件框架的安装与配置准备

事件框架（Event Framework）并不是一个单独安装的软件，而是由 PI AF Server、PI Event Frames、PI Analysis Service 以及底层 PI Data Archive 共同组成的一套协同运行环境。理解这一点非常关键：很多“事件框架装不上”或“事件帧不触发”的问题，根源并不在 Event Frames 本身，而在于前置组件缺失、服务账户权限不足或连接配置错误。因此在正式创建事件帧之前，必须先把这套运行底座准备好。

一、四个核心组件各自承担什么角色

PI AF Server 是事件框架的“骨架与容器”。它承载 AF 数据库、元素（Element）、属性（Attribute）和模板，事件帧本身也是以 AF 元素和属性的形式存储的。没有可用的 AF Server，Event Frames 就无处落地。

PI Event Frames 是 AF Server 上的一项功能组件，负责定义事件帧的触发条件、捕获逻辑、持续时间计算和引用属性。它依赖 AF 模型中的属性作为输入，因此 AF 模型必须先建好。

PI Analysis Service 是事件框架的“计算引擎”。它负责执行分析表达式、计算触发条件、判断事件开始与结束，并把结果写回 AF。事件帧的自动触发几乎都依赖 Analysis Service 的持续运行。

PI Data Archive 则是数据的源头，为 AF 属性提供实时值和历史值。事件帧判断“某温度是否超过阈值”，最终读取的就是 Data Archive 中的 PI Point 数据。

二、安装顺序与版本兼容性

推荐的安装顺序是：先装 PI Data Archive，再装 PI AF Server，然后安装 PI Analysis Service，最后在客户端安装 PI System Explorer 用于建模和配置。Event Frames 随 AF Server 一起提供，不需要单独安装包，但需要在 AF Server 上确认该功能已启用。

版本兼容性是最容易被忽视的坑。AF Server 版本必须与 Data Archive 版本匹配，Analysis Service 版本必须与 AF Server 版本匹配。例如 AF Server 2018 搭配 Analysis Service 2018 是稳妥组合，若 Analysis Service 版本高于 AF Server，可能出现分析无法部署或事件帧不触发的情况。安装前应查阅 AVEVA（原 OSIsoft）官方兼容性矩阵，确认三者版本一致或处于受支持区间。

三、服务账户与权限模型

PI Analysis Service 以 Windows 服务方式运行，必须指定一个服务登录账户。这个账户需要满足三层权限：

• Windows 层：账户需对 AF Server 所在机器具有网络访问权限，若使用域账户则最省事。
• AF 层：账户需被加入 AF Server 的相应安全角色，至少具备对目标 AF 数据库的读写权限，否则分析结果无法写回。
• PI 层：账户需映射到 PI Data Archive 的 PI Identity，并具备读取相关 PI Point 的权限。

实践中常见的错误是：Analysis Service 服务账户在 AF 中有权限，但没有映射到 PI Identity，导致分析读取 PI Point 时被拒绝，事件帧始终不触发。排查时应先看 Analysis Service 日志中的连接与权限报错，再逐层核对。

四、连接配置与验证

安装完成后，需要在 PI System Explorer 中确认 AF Server 连接正常，并在 Analysis Service 配置中确认其已注册到目标 AF Server。一个可用的验证方法是：在 AF 中新建一个测试属性，引用一个已知的 PI Point，然后创建一个简单分析，例如“当该属性值大于 80 时触发事件帧”，观察 Analysis Service 是否正常计算并生成事件帧。

下面给出一个配置准备检查清单，可作为安装后的逐项核对依据：

完成以上准备后，事件框架的运行底座就具备了：AF Server 提供模型容器，Event Frames 提供事件定义能力，Analysis Service 提供计算与触发能力，权限模型保证各组件之间能够安全通信。接下来才可以进入事件帧的实际建模与配置阶段。