PowerChute

事件配置

事件配置屏幕列出了可能发生的事件并将其分为三类 — 严重、警告和提示。您无法更改事件的类别。

默认情况下，提示事件为隐藏状态，请单击提示旁边的 + 图标将其显示出来。此外，您还可以单击 - 符号分别隐藏三个类别。

您可以配置事件以引发在不同列中命名的特定操作：

• 日志记录：在勾选复选框的情况下，将事件记录在事件日志中。

您可以禁用所有日志记录，请参阅日志设置。

• 电子邮件：事件发生时，向用户和管理员发送电子邮件消息。必须勾选该复选框才能启用。电子邮件必须在 PowerChute 中配置，请参阅电子邮件设置。

• 关闭：在勾选复选框的情况下，启动操作系统关闭顺序以响应事件。请参阅关闭。

重要事项：更改事件的关机和命令文件选项对您在关机设置页面上指定的配置存在直接影响。请参阅停电配置和事件关机配置。

• 命令文件：事件发生时运行用户指定的命令文件。

命令文件通常用于关闭打开的应用程序，从而避免数据丢失。必须将其置于此文件夹中：

<安装文件夹>\APC\PowerChute Serial Shutdown\agent\cmdfiles

例如，默认情况下，该安装文件夹在 Windows 上的路径为：
C:\Program Files (x86)\APC\PowerChute Serial Shutdown\agent\cmdfiles

单击“命令文件”图标来启用该文件，选择运行的文件和持续时间。

支持所有命令文件类型。

执行指令文件前，PowerChute 不检查其内容。

针对某一事件启用命令文件时，图标颜色将从灰色

变为绿色

。

另请参阅停电配置和事件关机配置。

某些事件无法通过配置来触发某些操作，且未提供该操作的复选框。例如，大多数提示事件都不会导致关机，因此这些事件的“关机”列中没有复选框。

事件说明

如需了解单个事件的说明，请参阅：

• 严重事件

• 警告事件

• 提示事件

显示的事件取决于您的 UPS，您的 UPS 可能不会显示下文描述的某些事件。

严重事件可导致 UPS 停止向其支持的设备供电。这些事件需要您立即引起注意。

事件名称	说明
电池电量不足	采用电池供电运行的 UPS 已达到低运行时间阈值 — UPS 报告的剩余运行时间小于关机设置屏幕上的运行时间限制值。或者，UPS 管理附件（如 UPS 接口扩展器 2 卡）已触发“电池电量不足”事件，以请求关机。

警告事件会提醒您注意应监控的状况

事件名称	说明
电池模式	UPS 因停电或电能质量差而切换到电池供电状态。
已超出电池供电时间阈值	采用电池供电的 UPS 已达到通过“关机设置”>“停电配置”>“UPS 处于电池模式下之后”配置的秒数。
配置文件无效	pcssconfig.ini 文件的内容无效。使用文本编辑器（例如 Notepad）打开 pcssconfig.ini 文件浏览并解决错误。
用户登录无效	用户尝试登录 PowerChute 用户界面未成功。注意：PowerChute 将在三次登录尝试失败（用户名和/或密码错误）之后自动“锁定” 2 分钟，以防止暴力破解密码。

提示事件报告有关 UPS 设备操作的数据。

事件名称	说明
不再采用电池模式	交流市电已恢复；UPS 不再采用电池供电。此事件按照电池模式来执行。
开始关机正在关机	关机程序各个阶段。
通讯已建立	PowerChute 已与 UPS 建立了通信。
监控已开始监控已停止	PowerChute 已开始或停止监控 UPS。
配置文件已更改	pcssconfig.ini 文件已被直接编辑。
用户已登录	用户已成功登录 PowerChute 用户界面。
用户已注销	用户已成功退出 PowerChute 用户界面或 PowerChute 会话已过期。默认情况下，PowerChute 会话将在 15 分钟不活动后超时，用户将自动退出 PowerChute 用户界面。

电子邮件设置

电子邮件设置屏幕列出了配置为在事件发生时发出通知的用户电子邮件地址。为了在事件发生时接收电子邮件通知，必须在此处设置电子邮件地址。请参阅事件配置，了解有关配置事件以在事件发生时发送电子邮件的信息。

必须定义以下五个字段才能使 PowerChute 在事件发生时发送电子邮件消息。（这包括接收电子邮件的呼叫器的消息）。

• SMTP 服务器（主机名、IPv4 或 Ipv6）通过以下三种方法之一来识别 SMTP 服务器：名称、IPv4 地址或 IPv6 地址。示例主机名为 mail.server.com。

• 来自电子邮件地址指定收件人从中获取邮件的电子邮件。这是用于发送通知的电子邮件帐户。

• 端口指定通过 SMTP 发送电子邮件的端口号。端口号最多包含五位数字，可设置为 25、465、587 或 5000 至 32768 之间的任意数字。如果未输入端口号，则使用默认值 25。

• 使用 SSL/TLS定义发送电子邮件时将使用的电子邮件加密协议。有三个选项供选：

– 未选择— 如果身份验证被禁用，则不会使用电子邮件加密协议，电子邮件将以未加密的方式发送。如果启用了身份验证，电子邮件将采用 SMTPS 协议进行加密。

– SSL— 电子邮件将采用 SSL 加密协议进行加密。您必须选择端口 465 或您的电子邮件管理员为 SSL 通信分配的端口。

– TLS— 电子邮件将采用 TLS 加密协议进行加密。您必须选择端口 587 或您的电子邮件管理员为 TLS 通信分配的端口。

“启用服务器身份检查”复选框（如果选中）后，系统将验证提供的 SMTP 服务器是否具有有效的证书，以确保连接到正确的服务器。此设置可降低中间人攻击的风险，并且如果选择了 SSL/TLS，则应选择此设置。

单击“测试”按钮，可向已配置的所有收件人发送测试电子邮件。仅在提供有效的电子邮件设置和电子邮件收件人时，才会启用此按钮。如果未收到测试电子邮件，请检查 pcss.log 文件是否存在错误。未收到测试电子邮件的常见原因包括凭据不正确、服务器标识不匹配、代理问题、SMTP 服务器无法访问或所选协议不受支持。

另请参阅：身份验证电子邮件。

如果您使用的是 SSL/TLS 且 SMTP 服务器采用自签名证书，则必须将证书添加到绑定的 Java JRE 的可信任证书库中。

在 Windows 上：

1 . 通过服务控制台PowerChute Serial Shutdown或输入命令行net stop APCPBEAgent以停止PowerChute 服务。

2 . 将 server.crt (或server.cer)复制到已安装的 PowerChute 目录中的security目录
（例如， C:\Program Files\APC\PowerChute Serial Shutdown\jre\lib\security）。

3 . 使用管理员权限打开命令提示符并导航至此security目录。

4 . 执行以下命令把email邮件证书导入到JRE受信任证书商店：

..\..\bin\keytool –import –alias mailserv –file server.crt –keystore cacerts –storepass changeit

5 . 根据提示符提示接受证书。

6 . 通过服务控制台PowerChute Serial Shutdown入命令行net start APCPBEAgent开始PowerChute 服务。

在 Unix/Linux 上：

1 . 使用以下命令之一停止 PowerChute 服务： service pbeagent stop，或 systemctl stop PBEAgent.service，或 /etc/init.d/PBEAgent stop

2 . 将 server.crt（或 server.cer）复制到已安装的 PowerChute 目录中的安全目录（例如，opt/APC/PowerChuteSerialShutdown/jre/lib/security）

3 . 使用管理员权限打开终端并导航至此安全目录。

4 . 执行以下命令，将电子邮件证书导入到 JRE 可信任证书库中：

../../bin/keytool -import –alias mailserv –file server.crt –keystore cacerts –storepass changeit

5 . 根据提示接受证书。

6 . 使用以下命令之一启动 PowerChute 服务： service pbeagent start，或 systemctl start PBEAgent.service，或 /etc/init.d/PBEAgent start

注：在以上示例中，mailserv 是证书文件中使用的邮件服务器的别名，server.crt 是邮件服务器的自签名 SSL 证书。.cer 后缀文件也可被接受。

有关更多信息，请参阅“替换默认的 PowerChute SSL 证书”。

• 发送至电子邮件地址：请参阅添加和删除电子邮件收件人。

添加和删除电子邮件收件人

如需添加电子邮件，在添加/删除电子邮件收件人部分，输入一个电子邮件地址，然后单击“应用”按钮。

如需删除电子邮件，请勾选该地址右侧的复选框，然后单击“应用”。

可选择是否在联系信息下方填入联系人姓名和系统位置。如果有，信息将包含在电子邮件中。该姓名旨在代表负责 UPS 维护的人员。该位置是托管 PowerChute 代理的服务器的物理位置。

另请参阅身份验证电子邮件。

我们建议您在完成配置后对电子邮件设置进行测试。您可以通过事件配置勾选事件的电子邮件复选框以完成此操作，然后创建该事件。

身份验证电子邮件

身份验证电子邮件是可选的。您可以通过勾选身份验证的基本电子邮件复选框来启用此功能。如果您不确定身份验证，请联系您的电子邮件管理员。

如果您要使用身份验证，可在各字段中指定服务器用户名和密码，但您无需执行此操作。如果您不指定服务器用户名和密码，PowerChute 将使用 SMTP 服务器（主机名、IPv4 或 Ipv6）来获取允许发送经过身份验证的电子邮件的 IP 地址列表。

SNMP 设置

PowerChute Serial Shutdown可配置为通过简单网络管理协议 (SNMP) 进行通信，也可采用网络管理系统 (NMS) 通过 SNMP 搜索到。使用 SNMP 和 PowerNet MIB，您可查询和配置 PowerChute 设置，并生成 SNMP 陷阱，从而自动通知您 UPS 关机事件和通讯中断事件。

PowerNet MIB 位于 PowerChute 安装目录中的 etc 目录下。最新版本也在 APC 网站上提供，请从按软件筛选/固件下拉框中选择固件升级 - MIB。

SNMPv1 和 SNMPv3 由 PowerChute Serial Shutdown提供支持，并通过代理 Web 界面来启用。SNMP 代理无法通过 SNMP 来搜索，直到启用 SNMPv1 或 SNMPv3，并配置了一个用户配置文件。

SNMPv1 的安全性不及 SNMPv3。SNMPv1 不提供加密或身份验证，且社群名称通过网络以纯文本格式发送。如需使用 SNMP 进行加密和身份验证，请配置 SNMPv3 设置。

请参阅：

• SNMP v1 配置

• SNMP v3 配置

• SNMP 陷阱配置

• SNMP 数据点

SNMP v1 配置

选择启用 SNMPv1 访问权限以配置通过 SNMPv1 进行通信所需的用户配置文件。选择添加配置文件或编辑默认配置文件 (PCSSUser)并配置：

1 . 团体名称：团体名称随每个 SNMP 请求发送，旨在获取设备访问权限。最大长度为 15 个 ASCII 字符。

2 . NMS IP/主机名称：网络管理系统 (NMS) 的 IP 地址、主机名或完全合格域名。NMS 是一款用于管理网络中软件和硬件组件的软件。发出 SNMP GET 和 SET 命令后，它可通过 SNMP 来管理 PowerChute。默认值 0.0.0.0 允许来自任何 NMS 的访问。

3 . 访问权限类型：

– 禁用：未通过 SNMP GET 或 SET 请求。

– 读：仅通过 SNMP GET 请求。

– 读/写：通过了 SNMP GET 和 SET 请求。

如需编辑现有的 SNMPv1 用户配置文件，请单击

按钮。如需删除 SNMPv1 用户配置文件，请单击

按钮。

单击应用以保存 SNMPv1 配置。

某些网络管理系统要求 SNMP 引擎 ID 通过 SNMP 进行通信。SNMP 引擎 ID 显示在“SNMP 设置”页面的“其他”部分下方。

另请参阅： SNMP 数据点

SNMP v3 配置

选择启用 SNMPv3 访问以配置 SNMPv3 设置。选择添加配置文件并配置：

1 . 用户名：在 SNMPv3 中，所有 GET 和 SET 请求以及 SNMP 陷阱均通过用户名与用户配置文件实现匹配。输入长度小于或等于 32 个 ASCII 字符的用户名。

2 . 身份验证协议：选择 MD5、SHA-1 或 SHA-2（SHA256 或 SHA512）协议。如果 NMS 支持，建议采用 SHA-2 协议。

3 . 身份验证密码：为所需的协议输入一个包含 8-32 个 ASCII 字符的身份验证密码。

4 . 隐私协议：选择 AES-128、AES-192、AES-192 Ex†、AES-256、AES-256 Ex† 或 DES。如果 NMS 和 PowerChute JRE 支持，建议采用 AES-256 协议：

†注：针对 192 位和 256 位密钥长度，某些 SNMP 网络管理系统采用非标准 AES 密钥扩展算法。这种非标准实施或“密钥扩展算法”由 IETF 指定。

如果您的 NMS 需要使用密钥扩展算法，请选择隐私协议选项 AES-192 Ex 或 AES-256 Ex。

5 . 隐私密码：为所选的加密协议输入一个包含 8-32 个 ASCII 字符的隐私密码。

6 . 访问权限类型：

– 禁用：未通过 SNMP GET 或 SET 请求。

– 读：仅通过 SNMP GET 请求。

– 读/写：通过了 SNMP GET 和 SET 请求。

如需编辑现有的 SNMPv3 用户配置文件，请单击

按钮。如需删除 SNMPv3 用户配置文件，请单击

按钮。

单击应用以保存 SNMPv3 配置。

某些网络管理系统要求 SNMP 引擎 ID 通过 SNMP 进行通信。SNMP 引擎 ID 显示在“SNMP 设置”页面的“其他”部分下方。

另请参阅： SNMP 数据点

SNMP 陷阱配置

可针对 UPS 严重事件和通讯中断事件，指定接收由 PowerChute 生成的 SNMP 陷阱的设备。
如需配置陷阱接收器，请选择添加陷阱接收器并配置：

1 . 启用：勾选复选框以启用陷阱接收器。

2 . NMS IP/主机名称：NMS 的 IP 地址、主机名或完全合格域名。

3 . 端口：NMS 将监听传入陷阱的端口。默认端口号为 162。

4 . SNMPv1：如果希望通过 SNMPv1 发送陷阱，请选择此项。

– 团体名称：输入在将 SNMPv1 陷阱发送到此接收器时用作标识符的 SNMPv1 用户配置文件的团体名称。

5 . SNMPv3：如果希望通过 SNMPv3 发送陷阱，请选择此项。

– 用户名：选择在将 SNMPv3 陷阱发送到此接收器时用作标识符的 SNMPv3 用户配置文件的用户名。

单击 SNMP 陷阱接收器测试向配置的陷阱接收器发送测试陷阱。检查陷阱接收器以确保接收到测试陷阱。

如需编辑现有的 SNMP 陷阱接收器，请单击

按钮。如需删除 SNMP 陷阱接收器，请单击

按钮。

发生以下事件时，PowerChute 将向配置的陷阱接收器发送 SNMP 陷阱：

• 出现 PowerChute 关闭事件

发生关闭事件并实际触发关机时，PowerChute 会向配置的陷阱接收器发送 SNMP 陷阱，详细说明事件名称。

• 解决 PowerChute 关闭事件

如果启用”条件清除时发送陷阱”选项，触发关机的关闭事件一旦解决，PowerChute 会向配置的 NMS 发送 SNMP 陷阱。

通讯中断事件发生时，PowerChute 将向配置的陷阱接收器发送 SNMP 陷阱。

如果启用了状况清除后发送陷阱的选项，通讯中断事件解决后，系统将发送通讯已建立陷阱。

当 PowerChute 自动更新功能检测到有新的可用更新时；陷阱将被发送到配置的陷阱接收器。

配置陷阱接收器时，可发送测试陷阱来确定陷阱接收器是否正在接收陷阱。请参阅SNMP 陷阱配置。

如需配置 UPS 严重事件或通讯中断陷阱的设置：

1 . 转到 SNMP 设置 > SNMP 陷阱

2 . 单击 UPS 严重事件或通讯中断事件旁边的图标

3 . 勾选启用复选框，为这些事件启用陷阱。

4 . 延迟：指定发送陷阱之前事件必须持续的时间长度。如果事件在此时间之前被清除，则不会发送陷阱。

5 . 重复间隔：指定重新发送陷阱的时间间隔（单位：秒）。

6 . 选择：

– 重复直至状况清除如果希望以重复间隔发送陷阱，直到状况清除。

– 重复 X 次以指定事件发生时发送陷阱的次数。

7 . 选择状况清除后发送陷阱，在清除事件后收到通知。

注：如果 PowerChute Serial Shutdown代理因 UPS 严重事件而关闭，则不会向 NMS 发送清除陷阱。

另请参阅： SNMP 数据点 > SNMP 陷阱

SNMP 数据点

下表列出了 PowerChute Serial Shutdown 支持的 SNMP 对象标识符 (OID)。

注：您的 UPS 可能不支持列出的所有 SNMP OID。

请参阅 APC 网站上提供的 PowerNet MIB，了解每个 OID 的详细说明，包括 SET 和 GET 操作参数。

SNMP OID 名称	访问权限	说明
upsBasicBatteryStatus	只读	UPS 电池的状态。
upsBasicOutputStatus	只读	UPS 的当前状态（例如，联机、电池供电等）。
upsAdvConfigAllowed SetTable	只读	读取此 OID，获取您使用 SNMP SET 为其设置值的 UPS 数据点。查询此表将返回以下 OID： • upsAdvConfigRatedOutputVoltage • upsAdvConfigHighTransferVolt • upsAdvConfigLowTransferVolt • upsAdvConfigLowBatteryRunTime 此查询还将返回可为每个 OID 设置的值的可接受范围。如果您的 UPS 不支持 OID，查询将返回 null。
upsAdvControlBypass Switch	读写	写入此 OID 以控制 UPS 旁路模式。
upsAdvTestDiagnostics	读写	写入此 OID 以命令 UPS 执行诊断自检。
upsAdvTestDiagnostics Results	读写	上一次诊断 UPS 自检的结果。
upsAdvTestRuntime Calibration	读写	写入此 OID 提供执行运行时间校准测试的选项。
upsAdvTestCalibration Results	读写	上一次运行时间校准测试的结果。
upsCommStatus	读写	SNMP Agent 与 UPS 通信的状态。

SNMP OID 名称	访问权限	说明
pcbehostname	只读	PowerChute Serial Shutdown 代理的主机名。
pcbeVersion	只读	PowerChute Serial Shutdown 版本号，格式为 x.x.x.x.
pcbeOS	只读	安装 PowerChute Serial Shutdown 操作系统和版本。
pcbeJavaVersion	只读	随 PowerChute Serial Shutdown 安装的 Java 版本。
pcbeUIProtocol	只读	用于连接 PowerChute 代理 Web 界面 (http/https) 的协议。
pcbeHttpsPort	只读	用于 PowerChute https web 界面的端口。

SNMP OID 名称	访问权限	说明
pcbeCriticalFlag	只读	此 OID 表示 PowerChute Serial Shutdown 已开始正常关闭主机。
pcbeCriticalCause	只读	此 OID 提供了 PowerChute Serial Shutdown 已开始正常关闭主机的原因。
pcbeComsLostFlag	只读	此 OID 表示 PowerChute 无法与 UPS 通信。
pcbeUpdateAvailableFlag	只读	此 OID 表示 PowerChute 的新版本可用。
pcbeUpdateDesc	只读	此 OID 提供可用新版 PowerChute 的说明。

下表详细介绍了 PowerChute 针对严重事件和通讯中断事件发送的 SNMP 陷阱的 OID 名称。

UPS 严重事件

SNMP OID 名称	级别	说明
pcbeCriticalEventActive	严重	由于发生严重事件，PowerChute Serial Shutdown 已经开始正常关闭主机。
pcbeCriticalEventResolved	通知	PowerChute 严重事件已解决，主机正常关机继续进行。

通讯事件中断

SNMP OID 名称	级别	说明
pcbeComsLost	严重	PowerChute 无法与 UPS 通信。
pcbeComsLostResolved	通知	PowerChute 重新建立了与 UPS 的通信。

其他事件

SNMP OID 名称	级别	说明
pcbeTest	通知	PowerChute 已向 NMS 发送了测试陷阱。
pcbeUpdateAvailable	通知	PowerChute 检测到有可用更新。