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

退出打印视图

更新时间: 2014 年 7 月
 
 

asradm(1M)

名称

asradm - 自动服务请求注册实用程序

用法概要

asradm list
asradm send [-n] [activate|audit|deactivate|fault|heartbeat|test]
asradm register -u username [-p password-file] [-e endpoint_URL]
asradm set-proxy [-i] | [-h host[:port]] [-u username]
     [-p password-file]
asradm unregister
asradm authenticate -u username -p password-file [-n]
     [-e endpoint_URL]

描述

asradm 实用程序由特权系统管理员使用来注册主机,以便在 Oracle Sun 系统的 Oracle 自动服务请求 (Auto Service Request, ASR) 中进行注册。使用自动用例生成功能可提高系统的可用性并在发生特定硬件故障时加速诊断过程。

使用有效的 My Oracle Support (MOS) 帐户对系统注册 smf(5) 服务后,asr-notify 将开始发送 HTTPS/XML 遥测,可以直接发送到已配置的端点,也可以通过可选的 HTTP 代理发送。

asradm 实用程序还可以列出从已注册服务器中看到的当前注册状态。这只能确认消息正在发送到 Oracle ASR 服务,并不表示系统正在被有效监视。用户必须登录到他们的 MOS 帐户,并对系统激活此服务。注册后,应该会向用户发送电子邮件,介绍完成注册所需的具体详细信息。

可以使用 send 子命令手动发送 ASR 消息。也可以在不实际发送 ASR 消息的情况下查看这些消息的内容。即使系统尚未注册,也可以生成消息。

还可以从 ASR 服务取消注册系统,这将取消对系统的监视,还将禁用系统发送的所有遥测。

选项

支持以下选项:

–e endpoint_URL

设置用于注册和所有消息遥测的端点 URL。缺省值为 transport.sun.com,将所有遥测直接发送到 Oracle 服务。可以使用不同的 URL 来支持 ASR 管理器解决方案的本地实例。可以使用本地 ASR 管理器来聚合来自许多主机实例的遥测。

–h host[:port]

设置用于连接到 Internet 的 HTTPS 代理主机和可选端口号。如果未指定端口,则将使用缺省端口值 80

–i

将 HTTPS 连接设置为直接 Internet 连接,因此不使用任何代理主机。该选项将清除先前设置的任何 HTTPS 代理信息。

–n

模拟运行事件发送,这将显示要发送到 stdout 的消息数据。

–u username

register 子命令结合使用时,此选项将指定要与该系统上的产品注册相关的 MOS 用户名。与 set-proxy 子命令结合使用时,此选项将指定用于消息传输的 HTTPS 代理用户名。

–p password-file

这应该为包含口令值的单行文件。可以在运行此命令后立即删除该文件。与 register 子命令结合使用时,此选项将指定与 MOS 用户名关联的口令。与 set-proxy 子命令结合使用时,此选项将指定与用于连接到 Internet 的 HTTPS 代理关联的口令。如果未输入 –p 选项但设置了 –u 选项,则系统将提示用户输入口令。

子命令

asradm 子命令如下所述。

authenticate(验证)

通过 Oracle ASR 服务验证 MOS 凭证,并输出可以与自动化安装程序组合使用的 sysconfig 属性,这些属性用来填充 asr-notify 服务以便可以自动向 Oracle ASR 服务注册该服务。

此命令需要 –u 用户和 –p 选项,而且还接受可选的端点参数来定义 ASR 管理器端点位置。

如果提供了 –n 选项,则不会建立网络连接,而且将输出以后验证所必需的属性。

register

使用提供的验证凭证向 MOS 注册系统。MOS 口令将仅用于初始注册,以获取可供将来的所有遥测使用的令牌,该口令不会存储在系统的任何位置。

如果主机系统位于防火墙之后,则在注册系统之前必须使用 set-proxy 命令设置 HTTP 代理设置。

注册后,将会发送一条 ASR 激活消息,请求对自动支持调用生成的支持。随后,将向已注册用户发送电子邮件,以提供服务请求的状态。

list

显示当前已验证的 MOS 用户名以及与 MOS 进行 HTTPS 通信所需的网络连接信息。如果尚未进行注册(通过 register 命令),则将显示 Unregistered 状态。

set-proxy

设置要用于发送所有 ASR 消息的 HTTPS 连接信息。可以进行直接连接,也可以定义 HTTPS 代理。

unregister

发送 ASR 取消激活事件并删除所有已配置的注册信息。将不会进一步发送遥测,Oracle ASR 服务将不再生成任何自动支持调用。

send

手动将指定的 ASR 消息发送到 Oracle ASR 服务,或者通过模拟运行选项 (–n) 显示 ASR 消息。

示例

示例 1 设置 Internet 连接以使用 HTTPS 代理

以下命令将通过 HTTPS 代理主机 webproxy.example.com 在端口 8080 上路由所有消息。

# asradm set-proxy -h webproxy.example.com:8080
示例 2 注册 MOS ID

以下命令用于使用给定的 MOS ID 以交互方式验证和注册此系统,以用于 ASR。此后,系统将提示您提供支持用户名和口令。

# asradm register
示例 3 以非交互方式进行验证

这与上述的 set—proxy 示例类似。不同之处在于 MOS 用户名和口令是通过命令行指定的。

# asradm register -u joe.admin@example.com -p mypassword
示例 4 查看审计消息的内容

下面的命令将显示审计消息,但不发送事件。即使 ASR 服务尚未注册,这也将奏效。

# asradm send -n audit

退出状态

将返回以下退出值:

0

命令已完成,未出现任何错误。

1

由于系统错误,命令没有完成。

2

命令行用法不正确。

3

连接配置无效。

4

验证错误。

5

网络连接错误。

属性

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

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

另请参见

svcs(1)asr-notify(1M)svcadm(1M)svccfg(1M)syslogd(1M)attributes(5)smf(5)