配置插件

在“通讯”选项卡中,可以添加 REST 插件实例、配置参数,并可以直接在用户界面中启动和停止插件。

如果启用 RESTful API 和内置 web 应用程序,它们仅在插件运行时可用。

MERLIC RTE Setup 中启用配置

要在 MERLIC RTE Setup 的“通讯”选项卡中启用插件的配置,首先必须启动 MERLIC RTE 并执行以下步骤:

  1. 打开 MERLIC RTE Setup 并转到“通讯”选项卡。如果 MERLIC RTE 未运行,您可以从“通讯”选项卡直接启动它。
  2. REST 插件添加到左侧的插件实例列表。

  3. 确保插件当前未在运行。否则,参数将不可用于配置。可以通过插件实例列表中的相应状态图标查看插件的当前状态。如果状态显示 图标,表示插件正在运行。在这种情况下,必须通过单击 MERLIC RTE Setup 底部的“ 停止插件”按钮停止它。如果状态显示 图标,表示插件当前未在运行。在以下示例图像中,REST 插件的选定实例当前未在运行,因此可以进行配置。

  4. 选择左侧的 REST 插件,以显示其参数并开始配置。

选定 REST 插件的参数将显示在“通讯”选项卡的右侧。

Plug-in Parameters

此类型参数代表通讯插件中无法在“通讯”选项卡的配置区域中调整的一般参数。它们可显示插件的版本号、日志等级的当前参数值、插件的访问等级,以及插件配置的验证设置。这些值需要在不同的位置或通过不同的方法分别进行设置。

Version

此参数显示在插件实现期间定义的版本号。它由主要版本、次要版本和维护版本组成。添加新插件实例时也会显示此版本号。版本是可选的。因此,在实现过程中可能并未定义版本号。

Log level

此参数显示插件实例的日志等级。默认情况下,该日志等级会设置为在 MERLIC RTE Setup 中添加插件实例时的相应 MERLIC RTE 进程的日志等级。

Access level

此参数显示为插件设置的访问等级。对于 REST 插件,访问等级默认设置为“monitor and control”。这表示插件可以接收“事件”并发送“操作”。访问等级与插件实现中定义的功能相关。无法在 MERLIC RTE Setup 中调整访问等级。

Supports rapid validation

该参数显示插件是否支持立即验证当前的插件配置。对于这个插件,勾选复选框表示支持“快速验证”。这意味着,每次在 MERLIC RTE Setup 的“通讯”选项卡中修改任何可编辑参数时,都会验证插件的配置。如果插件不支持“快速验证”,则只有在保存配置时才会验证插件的配置。

User Parameters

User parameters”代表可为插件配置的参数集。它们显示在可以展开或关闭的不同类别中。

以下部分介绍每个类别的参数。

HTTP Server

此类别中的参数定义 HTTP 服务器的设置。

下图概述了参数以及相应的默认设置。图下有参数的详细说明。

IP address

此参数定义服务器监听连接所在的网络接口的互联网协议地址(IP 地址)。此参数支持互联网协议版本 4 (IPv4) 和版本 6 (IPv6) 地址。

默认情况下,它设置为“127.0.0.1”,这意味着只能从本地计算机访问 RESTful API 和内置 web 应用程序。如果要从同一网络中的另一个设备访问它们,则必须指定该网络中本地计算机的相应 IP 地址。

Port

此参数定义服务器监听新连接所在的端口。默认情况下设置为“8040”。

Serve built-in web app

此参数定义内置 web 应用程序是否在上面指定的系统中运行。默认情况下,此选项处于启用状态,当插件以默认设置运行时,您可以在网页浏览器中通过 http://127.0.0.1:8040 查看 web 应用程序。

In-Memory Database

此类别中的参数定义事件、结果和错误的缓冲区容量设置。操作和工作的容量设置为 1 MB 且无法更改。

下图概述了参数以及相应的默认设置。图下有参数的详细说明。

Event store capacity

此参数定义用于存储事件的缓冲区大小。默认情况下设置为 64 MB

Result store capacity

此参数定义用于存储结果的缓冲区大小。默认情况下设置为 128 MB

Error store capacity

此参数定义用于存储错误信息的缓冲区大小。默认情况下设置为 16 MB

Data retention rate

此参数定义由于达到相应缓冲区的容量而回收内存时,缓冲区中保留的内存的百分比。默认情况下设置为 70%。这意味着 30% 的内存将被回收,70% 的内存将被保留。

指定的保留率适用于数据库中所有数据类型的缓冲区,包括容量正好为 1 MB 的操作和工作。