手册页部分 1M: 系统管理命令

退出打印视图

更新时间: 2014 年 7 月
 
 

asr-notify(1M)

名称

asr-notify - 用于故障管理事件的自动服务请求通知守护进程

用法概要

/usr/lib/fm/notify/asr-notify [- ]

描述

asr-notify 是一个守护进程,用于订阅故障管理生命周期事件并根据存储在 SMF 服务配置系统信息库中的一组通知首选项生成 HTTPS/XML 通知。

使用 asradm(1M) 命令或通过设置 SMF 自动注册属性注册了服务之后,会向 Oracle Auto Service Request (ASR) 服务发送消息。如果设置了自动注册属性,服务将尝试在启动或刷新时注册。如果注册失败,服务将进入维护模式。如果注册成功,将删除 SMF 自动注册属性。

asr-notify 由服务管理工具 smf(5) 管理,其服务 FMRI 为:

svc:/system/fm/asr-notify:default

可以使用 svcadm(1M) 来对此服务执行管理操作(如启用、禁用或请求重新启动)。可以使用 svcs(1) 命令来查询服务的状态。

ASR 通知首选项是使用 svccfg(1M) 设置的。

属性

可以设置以下服务属性:

config/rootdir

这是缺省值为 / 的一个 astring 属性。设置了此属性时,将为 asr-notify 评估的所有路径名使用指定的根目录。

config/http_timeout

这是一个整数属性,用于设置在生成错误之前等待 HTTP 连接的秒数。

config/endpoint

这是一个 astring 属性,用于设置注册和所有消息遥测使用的端点 URL。可以将端点 URL 设置为聚合来自多个主机实例的遥测的本地 ASR 管理器。如果不设置该属性,会将所有遥测直接发送到 Oracle Auto Service Request 服务。

autoreg/user

这是一个 astring 属性,用于设置自动注册使用的 My Oracle Support 用户名。

autoreg/password

这是一个 astring 属性,可用来设置用于进行自动注册的 My Oracle Support 口令。

autoreg/proxy-host

这是一个 astring 属性,用于设置 HTTP 代理 hostname:port,仅当使用 HTTP 代理连接 Internet 时才需要设置该属性。

autoreg/proxy-user

这是一个 astring 属性,用于设置 HTTP 代理用户名,仅当 HTTP 代理需要凭证时才需要设置该属性。

autoreg/proxy-password

这是一个用于设置 HTTP 代理口令的 astring 属性,仅当 HTTP 代理需要凭证时才需要设置该属性。

消息

服务将发送以下类型的消息:

  • 发生 FMA 故障时的故障消息

  • 表示系统仍处于活动状态的每日心跳消息

  • 提供运行组件的完整清单的运行审计消息和每周审计消息

每条消息的内容都是遵循 ASR 消息 XML 模式的 XML 文档。每条消息都以通用消息标头开始,后跟事件特定内容。

ASR 事件标头信息:

XML Element     Description
------------    -----------
site-id         the serial number of the host sending
                the event
host-id         the hostname(1) of the system that the
                message is about
message-uuid    a unique id generated for each message
message-time    local time on the system that generated
                the message
system-id       the serial number of the system that the
                message is about
asset-id        the registered service tag for the system
product-id      the unique product identifier for the system
product-name    the name of the product for the system
event           element containing fault specific event
                information

事件中的故障特定内容将包含在 primary-event-information XML 元素中。

XML Element     Description
-----------     -----------
message-id      the knowledge article message ID
event-uuid      the FMA event UUID
event-time      the time that the FMA event was generated
severity        the severity of the FMA event
component       element containing list of suspects
summary         a short summary of the event
description     event description
payload         the raw FMA event contents

对于与故障事件关联的每个可疑 FRU,都会在组件中包含一个 hardware-component 元素。

XML Element              Description
-----------              -----------
name                     the component path name of the FRU
serial                   the FRU serial number
part                     the FRU part number
revision                 the FRU revision level
additional-information   a list of additional properties
                         containing values such as FRU
                         manufacturer and FRU model

某些故障可能与软件问题关联而不是与硬件问题关联。在这种情况下,故障事件的组件列表中将包含 software-module 元素。

XML Element              Description
-----------              -----------
name                     the name or FMRI of the software
                         module in error
description              a description of the software
                         module error

心跳事件不包含任何其他数据,审计事件包含系统可用的所有 hardware-component、software-package 以及 software-module 元素的列表。

属性

有关下列属性的说明,请参见 attributes(5)

属性类型
属性值
可用性
system/fault-management/asr-notify
接口稳定性
Uncommitted(未确定)

另请参见

svcs(1)asradm(1M)svcadm(1M)svccfg(1M)syslogd(1M)attributes(5)smf(5)