目  录

1 EAA

1.1 EAA简介

1.1.1 EAA框架

1.1.2 CLI监控策略简介

1.1.3 Tcl监控策略简介

1.1.4 EAA环境变量

1.2 配置EAA环境变量

1.3 配置CLI监控策略

1.3.1 配置指导和注意事项

1.3.2 配置步骤

1.4 配置Tcl监控策略

1.5 暂停运行监控策略

1.6 EAA显示和维护

1.7 EAA典型配置举例

1.7.1 配置Tcl监控策略

1.7.2 配置CLI监控策略

1.7.3 配置EAA和Track联动

1.7.4 配置CLI监控策略——环境变量

1 EAA

1.1  EAA简介

EAA（Embedded Automation Architecture，嵌入式自动化架构）是集成在系统软件中的一系列相关软件模块的总称。

使用EAA功能：

·     用户可以定制一系列监控策略，在策略中定义自己感兴趣的事件以及事件发生时的处理动作。监控策略被启用后，系统会实时监控设备的运行，当用户定制的事件发生时，就触发相应的监控策略并自动执行监控策略中的动作。

·     设备能够智能地监控多种事件，并做出灵活多变的响应，从而大大地提升系统的可维护性。

1.1.1  EAA框架

图1-1 EAA框架示意图

EAA框架如图1-1所示，它包括事件源、EM（Event Monitor，事件监控）模块、RTM（Real-Time Event Manager，实时事件管理）模块和EAA监控策略。

1. 事件源

事件源是系统中的软件或硬件模块，它们会触发事件。例如，CLI事件源能触发命令行事件，Syslog事件源能触发日志事件。

2. EM

EM根据用户配置对事件源中发生的事件进行过滤匹配，匹配成功则通知RTM执行相应监控策略。当用户配置了多个监控策略，系统会创建多个EM模块，每个EM组件监控一个事件。

3. RTM

RTM是EAA的核心部件，负责管理监控策略，包括监控策略的创建、状态变化和执行。

4. EAA监控策略

通过监控策略，用户可以定义自己感兴趣的事件以及事件发生时的处理动作。

监控策略有两种配置方式：一种是通过命令行来配置，一种是通过Tcl脚本来定义。通过命令行配置的监控策略称为基于CLI的监控策略，以下简称CLI监控策略；通过Tcl脚本定义的监控策略称为基于Tcl的监控策略，以下简称Tcl监控策略。

1.1.2  CLI监控策略简介

CLI监控策略通过如下命令行来定义：一条event命令、一条或多条（不超过232条）action命令、一条或多条（不超过64条）user-role命令、一条running-time命令以及一条commit命令。其中：

·     event命令用来定义监控策略的触发事件。目前，EAA能够监控的事件类型如表1-1所示。

表1-1 监控事件类型描述表

·     action命令用来定义事件发生时，监控策略将执行的动作。目前支持的动作有执行指定的命令行、生成一条指定内容的日志、主备倒换和重启。

·     user-role命令用来指定执行监控策略的用户角色。用户角色中定义了允许用户操作哪些系统功能以及资源对象，设备支持的每条命令都有缺省用户角色，如果监控策略中指定的用户角色权限比命令行的缺省用户角色的权限小，则不能执行该命令以及该命令后面的所有动作。如果指定的用户角色不存在，则监控策略不能执行。如果给某个监控策略配置了多个用户角色，则使用这些用户角色权限的并集去执行该策略。例如，给某策略配置了用户角色A和B，如果策略中的动作是角色A或者B允许执行的，则策略可以执行；如果策略中存在角色A和B都不能执行的命令，则该命令以及该命令后面的所有动作都不能执行。关于用户角色的详细描述请参见“基础配置指导”中的“RBAC”。

·     running-time命令用来指定监控策略的运行时间，运行时间达到时即使策略没有执行完毕，也会立即停止执行策略。该命令用于限制策略的运行时间，以免策略长时间运行占用系统资源。而策略是否会触发以及停止后是否会被再次触发则由event配置决定。

·     commit命令用来启用CLI监控策略。CLI监控策略创建和定义后，必须启用才能生效。

1.1.3  Tcl监控策略简介

Tcl监控策略通过Tcl脚本来定义。按内容Tcl脚本可以分为两大部分：首行和其它部分。首行用于定义事件、用户角色和运行时间；从第二行开始，定义监控事件发生时执行的动作脚本。

用户创建Tcl监控策略并绑定Tcl脚本后，设备会首先解析Tcl脚本首行，获取监控事件、用户角色、运行时间，并立即下发以上配置且生效。当事件发生后从第二行开始执行动作脚本。

Tcl脚本首行的格式为::comware::rtm::event_register eventname arg1 arg2 arg3 …user-role role-name1 | [ user-role role-name2 | [ ] ] [ running-time running-time ]。其中：

·     eventname用来指定事件的类型，Tcl监控策略中支持的事件类型同CLI监控策略，详情请参见表1-1。

·     arg用来指定事件的匹配规则，具体定义与相应event命令中的参数规格一致，请参考EAA命令手册。当arg内容中包含空格时，请在arg内容的两端添加英文格式的双引号，形如"a b c"。

·     user-role用来指定执行脚本的用户角色，参数含义和配置要求同CLI监控策略。

·     running-time用来指定动作执行的最大时间，参数含义和配置要求同CLI监控策略。

Tcl监控策略支持如下三类动作：

·     Tcl语言标准命令。

·     EAA模块的专属Tcl命令。

·     设备支持的其它命令行。

1.1.4  EAA环境变量

EAA环境变量指的是专用于监控策略的环境变量。环境变量由<环境变量名、环境变量值>字对组成。在配置监控策略的动作时，我们可以在应该输入参数的地方输入“$环境变量名”，表示此处需要引用环境变量值。系统在运行监控策略的时候，会自动用环境变量值去替代“$环境变量名”。如果要修改监控参数的值，只需在系统视图下，修改环境变量值即可，而无需进入监控策略视图，修改监控策略下的具体配置。因此，定义和使用环境变量可以简化监控策略的配置，提高监控策略的灵活性和易用性。

目前，EAA支持的环境变量包括内部环境变量和用户自定义环境变量。

(1)     内部环境变量

设备缺省支持的环境变量，用户不能创建、删除和修改。内部环境变量名均以“_”开头，内部环境变量的值由系统决定。内部环境变量又包括两类：一类是公共环境变量，另一类是非公共环境变量。

·     公共环境变量可用于所有类型的事件：其中_event_id、_event_type、_event_type_string在系统启动时生成，关联的事件类型不同，其值不同，其值一旦确定不能更改；_event_time、_event_severity在运行时产生。

·     非公共环境变量只能用于对应的事件，其值在事件触发时获得，它标示当前事件的部分信息。例如，HOTPLUG事件对应的内部环境变量为“_slot”和“_subslot”，当1号成员设备加入或离开的时候，环境变量“_slot”的值为1；当2号成员设备加入或离开的时候，环境变量“_slot”的值为2。

目前EAA支持内部环境变量如表1-2所示。

(2)     用户自定义环境变量

用户定义环境变量名可包含数字、字符或者“_”，但不能以“_”开头。用户自定义环境变量可用于所有类型的事件，其值由用户配置决定。用户定义环境变量可修改、删除。

表1-2 内部环境变量描述表

1.2  配置EAA环境变量

使用本特性，用户可以自定义EAA环境变量的名称和值，以便定义监控策略时可以引用。引用环境变量时，环境变量名前面必须加“$”符号，表示引用，如定义了名称为“hostname”的环境变量，引用时需写成“$hostname”。

表1-3 配置EAA环境变量

1.3  配置CLI监控策略

1.3.1  配置指导和注意事项

·     如果监控策略中要用到系统内部环境变量，请先了解相应环境变量的值；如果监控策略中要用到的环境变量不是系统缺省支持的，请先定义，具体配置请参见“1.2  配置EAA环境变量”。

·     同一设备上可创建多个CLI监控策略且其数量没有限制。请确保同时启用的策略间动作不要冲突，因为当系统同时执行多个策略，且不同策略间动作有冲突时，执行结果是随机的。

·     给CLI监控策略配置事件、动作、用户角色和运行时间后，必须执行commit命令，该策略才会启用，该策略下的配置才会生效。

·     同一个策略下，只能配置一个触发事件和运行时间。当多次执行event或者running-time命令时，最后一次配置并且commit的生效。

·     同一个策略下，最多可配置232个动作。当条件满足，策略被触发时，系统会按照动作的编号由小到大顺序执行该策略下的所有动作。

·     如果新配置的动作的编号和已有动作的编号相同，最后一次配置并且commit的生效。

·     同一监控策略下可配置多个用户角色，最多可以配置64个有效用户角色，超过该上限后，新配置的用户角色即便commit也不会生效。

1.3.2  配置步骤

表1-4 配置CLI监控策略

1.4  配置Tcl监控策略

请参照以下步骤来配置Tcl监控策略：

(1)     如果监控策略中要用到系统内部环境变量，请先了解相应环境变量的值；如果监控策略中要用到的环境变量不是系统缺省支持的，请先定义，具体配置请参见“1.2  配置EAA环境变量”。

(2)     使用Tcl脚本编辑工具或者普通文档编辑工具，编辑格式符合要求的Tcl脚本。目前支持的Tcl版本为8.5.8。

(3)     使用FTP或者TFTP功能将Tcl脚本下载到设备上，FTP及TFTP具体配置请参见“基础配置指导”中的“FTP和TFTP”。

(4)     创建Tcl监控策略。

表1-5 配置Tcl监控策略

1.5  暂停运行监控策略

使用本特性可以暂停运行所有的监控策略。如果要将暂停运行的所有策略恢复运行，请使用undo rtm scheduler suspend命令。

表1-6 配置Tcl监控策略

1.6  EAA显示和维护

在完成上述配置后，在任意视图下执行display命令可以显示配置后EAA的运行情况，通过查看显示信息验证配置的效果。

表1-7 EAA显示和维护

1.7  EAA典型配置举例

1.7.1  配置Tcl监控策略

1. 组网需求

配置一个Tcl监控策略，当设备执行包含字符串display this的命令时，让系统自动发送日志信息rtm_tcl_test is running。

2. 组网图

图1-2 配置Tcl监控策略

3. 配置步骤

# 在PC上使用写字板或者word编辑Tcl策略脚本rtm_tcl_test.tcl，内容如下：

::comware::rtm::event_register cli sync mode execute pattern display this user-role network-admin

::comware::rtm::action syslog priority 1 facility local4 msg rtm_tcl_test is running

以上脚本的含义为：当设备执行包含字符串display this的命令时，让系统自动发送日志信息rtm_tcl_test is running。

# 通过TFTP将rtm_tcl_test.tcl下载到设备上。

<Sysname> tftp 1.2.1.1 get rtm_tcl_test.tcl

# 创建并启用Tcl监控策略，并将它和Tcl脚本rtm_tcl_test.tcl绑定。

<Sysname> system-view

[Sysname] rtm tcl-policy test rtm_tcl_test.tcl

[Sysname] quit

4. 验证配置

·     通过display rtm policy registered命令可以看到存在策略名为test，策略类型为Tcl的策略。

<Sysname> display rtm policy registered

Total number: 1

Type  Event      TimeRegistered       PolicyName

TCL   CLI        Jan 01 09:47:12 2019 test

·     打开允许日志输出的开关，执行display this命令，有rtm_tcl_test is running日志输出，同时有策略运行成功的日志输出。

<Sysname> terminal monitor

The current terminal is enabled to display logs.

<Sysname> system-view

[Sysname] info-center enable

Information center is enabled.

[Sysname] quit

<Sysname> display this

%Jun  4 15:02:30:354 2013 Sysname RTM/1/RTM_ACTION: rtm_tcl_test is running

%Jun  4 15:02:30:382 2013 Sysname RTM/6/RTM_POLICY: TCL policy test is running successfully.

#

return

1.7.2  配置CLI监控策略

1. 组网需求

配置一个CLI监控策略，当设备执行包含数字、字母（大小写均可）的命令行的帮助操作时，让系统自动发送日志信息hello world，并创建一个VLAN。

2. 配置步骤

# 创建CLI监控策略，名称为test。

<Sysname> system-view

[Sysname] rtm cli-policy test

# 配置监控事件：监控包含数字、字母（大小写均可）的命令行的帮助。

[Sysname-rtm-test] event cli async mode help pattern [a-zA-Z0-9]

# 事件发生时，发送优先级为4，日志记录工具为local3，信息为hello world的日志。

[Sysname-rtm-test] action 0 syslog priority 4 facility local3 msg “hello world”

# 事件发生时，进入系统视图。

[Sysname-rtm-test] action 2 cli system-view

# 事件发生时，创建VLAN 2。

[Sysname-rtm-test] action 3 cli vlan 2

# 配置CLI监控策略执行动作的持续时间为2000秒。

[Sysname-rtm-test] running-time 2000

# 配置用户角色network-admin具有执行该策略的权限。

[Sysname-rtm-test] user-role network-admin

# 确认执行该策略。

[Sysname-rtm-test] commit

3. 验证配置

·     通过display rtm policy registered查看，可以看到策略名为test，策略类型为CLI的策略。

[Sysname-rtm-test] display rtm policy registered

Total number: 1

Type  Event      TimeRegistered       PolicyName

CLI   CLI       Jan  1 14:56:50 2019 test

·     打开允许日志输出的开关，并对包含字母d的命令进行帮助，可以看到有信息为“hello world”的日志输出，同时有策略运行成功的日志输出。

[Sysname-rtm-test] return

<Sysname> terminal monitor

The current terminal is enabled to display logs.

<Sysname> system-view

[Sysname] info-center enable

Information center is enabled.

[Sysname] quit

<Sysname> d?

  debugging

  delete

  diagnostic-logfile

  dir

  display

<Sysname>d%Jan  1 14:57:20:218 2019 Sysname RTM/4/RTM_ACTION: "hello world"

%Jan  1 14:58:11:170 2019 Sysname RTM/6/RTM_POLICY: CLI policy test is running successfully.

1.7.3  配置EAA和Track联动

1. 组网需求

Device A和Device D、Device E已经建立BGP会话，正常情况下，Device D、Device E发往外网的流量通过Device A转发。现要求通过对Device A进行配置实现：当Device A连接Device C的接口GigabitEthernet1/0/1状态变为Down之后，Device A能够自动感知，并禁止和Device D、Device E建立BGP会话，这样，Device D、Device E发往外网的流量可通过Device B转发。

2. 组网图

图1-3 EAA和Track联动配置组网图

‌

3. 配置步骤

# 查看当前的BGP对等体的状态和统计信息。

<DeviceA> display bgp peer ipv4

 BGP local router ID: 1.1.1.1

 Local AS number: 100

 Total number of peers: 3                  Peers in established state: 3

  * - Dynamically created peer

  Peer                    AS  MsgRcvd  MsgSent OutQ PrefRcv Up/Down  State

  10.2.1.2                200       13       16    0       0 00:16:12 Established

  10.3.1.2                300       13       16    0       0 00:10:34 Established

  10.3.2.2                300       13       16    0       0 00:10:38 Established

# 配置Track项监控接口GigabitEthernet1/0/1的状态。

<DeviceA> system-view

[DeviceA] track 1 interface gigabitethernet 1/0/1

# 配置Tcl监控策略，当GigabitEthernet1/0/1状态变为Down之后，Device A能够自动感知，并禁止和Device D、Device E建立BGP会话。

[DeviceA] rtm cli-policy test

[DeviceA-rtm-test] event track 1 state negative

[DeviceA-rtm-test] action 0 cli system-view

[DeviceA-rtm-test] action 1 cli bgp 100

[DeviceA-rtm-test] action 2 cli peer 10.3.1.2 ignore

[DeviceA-rtm-test] action 3 cli peer 10.3.2.2 ignore

[DeviceA-rtm-test] user-role network-admin

[DeviceA-rtm-test] commit

[DeviceA-rtm-test] quit

4. 验证配置

# 将GigabitEthernet1/0/1关闭。

[DeviceA] interface gigabitethernet 1/0/1

[DeviceA-GigabitEthernet1/0/1] shutdown

# 在DeviceA上使用display bgp peer ipv4命令查看BGP对等体的状态和统计信息，无显示信息，表示BGP对等体数量为0。

1.7.4  配置CLI监控策略——环境变量

1. 组网需求

配置一个CLI监控策略，用于实现：当用户执行带有字符串loopback0的命令时，

·     系统会自动创建LoopBack0接口。

·     将该接口的IP地址配置为1.1.1.1/24。

·     将匹配到的命令行通过日志打印输出。

2. 配置步骤

# 创建环境变量loopback0IP，将其值配置为1.1.1.1。

<Sysname> system-view

[Sysname] rtm environment loopback0IP 1.1.1.1

# 创建CLI监控策略，名称为test。

[Sysname] rtm cli-policy test

# 配置监控事件：用户执行带有字符串loopback0的命令。

[Sysname-rtm-test] event cli async mode execute pattern loopback0

# 事件发生时，系统会自动创建LoopBack0接口，将该接口的IP地址配置为1.1.1.1/24，并将匹配到的命令行通过日志打印输出。

[Sysname-rtm-test] action 0 cli system-view

[Sysname-rtm-test] action 1 cli interface loopback 0

[Sysname-rtm-test] action 2 cli ip address $loopback0IP 24

[Sysname-rtm-test] action 3 syslog priority 7 facility local7 msg $_cmd

[Sysname-rtm-test] user-role network-admin

[Sysname-rtm-test] commit

[Sysname-rtm-test] return

<Sysname>

3. 验证配置

·     打开允许日志输出的开关，当用户执行带有字符串loopback0的命令时，系统会将匹配到的命令行通过日志打印输出，同时有策略运行成功的日志输出。

<Sysname> terminal monitor

The current terminal is enabled to display logs.

<Sysname> terminal log level debugging

<Sysname> system-view

[Sysname] info-center enable

Information center is enabled.

[Sysname] interface loopback0

[Sysname-LoopBack0]

%Jan  3 09:46:10:592 2019 Sysname RTM/7/RTM_ACTION: interface loopback0

%Jan  3 09:46:10:613 2019 Sysname RTM/6/RTM_POLICY: CLI policy test is running successfully.

·     显示接口信息，发现已存在LoopBack0接口，IP地址为1.1.1.1。

[Sysname-LoopBack0] display interface loopback brief

Brief information on interfaces in route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface            Link Protocol Primary IP         Description

Loop0                UP   UP(s)    1.1.1.1

[Sysname-LoopBack0]