Oracle® Solaris Cluster 参考手册

退出打印视图

更新时间: 2014 年 7 月,E51743-01
 
 

clmib(1CL)

名称

clsnmpmib, clmib - 管理 Oracle Solaris Cluster SNMP MIB

用法概要

/usr/cluster/bin/clsnmpmib -V
/usr/cluster/bin/clsnmpmibsubcommand [] -?
/usr/cluster/bin/clsnmpmib [subcommand] [options] -v [mib]
/usr/cluster/bin/clsnmpmib disable [-n node[,…]] {+ | mib …}
/usr/cluster/bin/clsnmpmib enable [-n node[,…]] {+ | mib …}
/usr/cluster/bin/clsnmpmib export [-n node[,…]] 
     [-o {- | clconfigfile}] [+ | mib …]
/usr/cluster/bin/clsnmpmib list [-n node[,…]] [+ | mib …]
/usr/cluster/bin/clsnmpmib set [-p name=value] […] 
     [-n node[,…] {+ | mib …}
/usr/cluster/bin/clsnmpmib show [-n node[,…]] [+ | mib …]

描述

clsnmpmib 命令可管理当前节点上的现有 Oracle Solaris Cluster 简单网络管理协议 (Simple Network Management Protocol, SNMP) 管理信息库 (Management Information Base, MIB)。要创建可以管理 MIB 的 SNMP 主机,请参见 clsnmphost(1CL) 手册页。要定义可以使用 SNMP 版本 3 (SNMP Version 3, SNMPv3) 协议访问 MIB 的 SNMPv3 用户,请参见 clsnmpuser(1CL) 手册页。

此命令的一般格式如下所示:

clsnmpmib [subcommand] [options] [operands]

仅当 options 指定选项 –?–V 时,才可以省略 subcommand

此命令的每个选项都有长格式和简短格式两种格式。在“选项”部分给出了每个选项的两种格式,以及对该选项的描述。

有关更多信息,请参见 Intro(1CL) 手册页。

Oracle Solaris Cluster MIB

Oracle Solaris Cluster 当前支持一个 MIB,即事件 MIB。Oracle Solaris Cluster SNMP 事件 MIB 可实时向 SNMP 管理器通知群集事件。一经启用,Oracle Solaris Cluster 事件 MIB 就会自动向 clsnmphost 命令定义的所有主机发送陷阱通知。Oracle Solaris Cluster 事件 MIB 在端口 11162 上发送陷阱通知。可在端口 11161 上查看 SNMP 树。

可以使用 clsnmpmib set 子命令指定 min_severitylog_number 值。由于群集会生成大量事件通知,因此只有严重程度为 min_severity 或更高的事件才作为陷阱通知发送。默认情况下,min_severity 值设置为 NOTICElog_number 值指定在停止使用较旧的条目之前要在 MIB 表中记录的事件的数量。MIB 可维护一个只读表,其中包含最近发生的已作为陷阱发送的事件。事件数受 log_number 值限制。系统重新引导后此信息将不再存在。

仅可以在全局区域中使用此命令。

子命令

支持以下子命令:

disable

在指定节点禁用一个或多个群集 MIB。

仅可以在全局区域中运行该子命令。

如果没有指定 –n 选项,则仅禁用当前节点上的 MIB。禁用 MIB 时,无法访问 MIB 表,并且 MIB 不会发送任何陷阱通知。

超级用户以外的用户需要具有 solaris.cluster.modify 基于角色的访问控制 (Role-Based Access Control, RBAC) 授权才能使用该子命令。请参见 rbac(5) 手册页。

enable

在指定节点启用一个或多个群集 MIB。

仅可以在全局区域中运行该子命令。

如果没有指定 –n 选项,则仅启用当前节点上的 MIB。要限制启用的 MIB,请使用 mib 操作数。

启用 MIB 时,也就启用了它的所有功能。但是,要使所有 MIB 功能完全发挥作用,可能有必要进行一些进一步的配置。例如,如果未配置任何主机,MIB 将无法发送陷阱通知。有关配置 SNMP 主机的信息,请参见 clsnmphost(1CL) 手册页。

超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。

export

导出群集 MIB 配置信息。

仅可以在全局区域中运行该子命令。

使用 –n 选项可指定一个或多个要从中导出 MIB 配置信息的节点。如果在不带 –n 选项的情况下使用 export,则该子命令仅从当前节点导出 MIB 配置信息。默认情况下,该子命令导出当前节点上所有 MIB 的配置信息。要进一步完善输出,请指定您需要其配置信息的一个或多个 MIB 的名称。

有关 export 子命令的输出格式的更多信息,请参见 clconfiguration(5CL) 手册页。默认情况下,所有输出都会发送到标准输出。使用 –o 选项后跟文件名可将输出重定向到该文件。

超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。

list

显示指定节点上的群集 MIB 列表。

仅可以在全局区域中运行该子命令。

使用 –n 选项可指定要列出的群集 MIB 的节点。如果在不带 –n 选项的情况使用 list 子命令,则该子命令仅列出当前节点上的 MIB。要限制列出的 MIB,请指定要列出的一个或多个 MIB 的名称。

超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。

set

更改指定节点上的一个或多个 MIB 使用的 SNMP 协议 min_severitylog_number 设置。

仅可以在全局区域中运行该子命令。

默认情况下,该子命令会更改节点上的所有 MIB。如果没有指定节点,则仅修改当前节点上 MIB 的 SNMP 属性。必须通过使用 –p 选项指定 SNMP 属性。所有 MIB 都使用以下默认属性值:protocol:SNMPv2, min_severity:NOTICE, log_number:100。除非使用 mib 操作数指定 MIB 名称,否则 set 子命令会更改所有 MIB 的协议、min_severitylog_number 设置。

超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。

show

显示指定节点上 MIB 的信息。

仅可以在全局区域中运行该子命令。

show 子命令显示 MIB 的名称、其 SNMP 协议版本、min_severity 值或 log_number 值。默认情况下,该子命令会显示节点上所有 MIB 的信息。

超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。

选项

支持以下选项:

–?
–-help

显示帮助信息。

指定此选项时,子命令可有可无。

  • 如果在不带子命令的情况下使用此选项,将会显示可用子命令的列表。

  • 如果将该选项与子命令结合使用,将会显示该子命令的用法选项。

使用该选项时,不会执行任何其他处理。

–n node[,…]
–-node[s] node[,…]

指定一个节点或一系列节点。可以使用节点名称或节点 ID 指定每个节点。clsnmpmib 命令的所有格式都接受此选项。可以使用 –n 选项指定要在其上执行操作的节点。如果不使用 –n 选项,则该命令会采用当前节点。

–o {- | clconfigfile}
–-output {- | clconfigfile}

指定要写入群集 MIB 配置信息的位置。此位置可以是文件,也可以是标准输出。要指定标准输出,请指定减号 (-) 而不是文件名。如果指定标准输出,将会抑制该命令的其他所有标准输出。如果没有指定 –o 选项,输出将发送到标准输出。此选项仅可以与 export 子命令一同指定。

配置信息是采用 clconfiguration(5CL) 手册页中定义的格式写入的。

–p name= value
-–property=name =value
-–property name=value
version

指定 MIB 将使用的 SNMP 协议的版本。Oracle Solaris Cluster 支持 SNMPv2 和 SNMPv3 协议版本。

min_severity

指定最低严重程度值。只有其值等于或大于 min_severity 值的事件才会记录在 MIB 表中,对于这些事件,将向配置的主机发送陷阱。

log_number

指定在停止使用较旧的条目之前要在 MIB 表中记录的事件的数量。

允许使用多个 –p name= value 实例。

可以使用该选项设置以下属性:

version

指定 MIB 将使用的 SNMP 协议的版本。您可以按如下方式指定 value

  • version=SNMPv2

  • version=snmpv2

  • version=2

  • version=SNMPv3

  • version=snmpv3

  • version=3

min_severity

指定要用于 MIB 的最低严重性级别值。您可以按如下方式指定值:

  • min_severity=NOTICE

  • min_severity=WARNING

  • min_severity=ERROR

  • min_severity=CRITICAL

  • min_severity=FATAL

允许使用大写或小写的值。

log_number

指定在停止使用较旧的条目之前要在 MIB 表中记录的事件的数量。默认值为 100。值范围为 100 到 500。您可以按如下方式指定value:

  • log_number=number

–V
–-version

显示该命令的版本。

不要将该选项与子命令、操作数或其他选项一起指定,因为子命令、操作数或其他选项会被忽略。–V 选项只显示命令的版本。不会执行任何其他操作。

–v
–-verbose

将详细信息显示到标准输出。

可以将该选项与命令的任何格式一同指定,尽管一些子命令可能不会生成扩展输出。例如,指定详细选项时 export 子命令不会生成扩展输出。

操作数

支持以下操作数:

mib

指定要应用子命令的一个或多个 MIB 的名称。如果您没有指定此操作数,该子命令将使用默认的加号 (+),这意味着所有 MIB。如果使用 mib 操作数,请在空格分隔列表中所有其他命令行选项之后指定 MIB。

+

所有群集 MIB。

退出状态

如果命令对于所有指定的操作数均成功执行,则返回零 (CL_NOERR)。如果某个操作数出错,命令会继续处理操作数列表中的下一个操作数。返回的退出代码始终反映最先发生的错误。

此命令返回下列退出状态代码:

0 CL_NOERR

没有错误

您发出的命令已成功完成。

1 CL_ENOMEM

交换空间不足

某个群集节点耗尽了交换内存或其他操作系统资源。

3 CL_EINVAL

参数无效

您键入的命令不正确,或者使用 –i 选项提供的群集配置信息语法不正确。

6 CL_EACCESS

权限被拒绝

指定的对象不可访问。要发出命令,可能需要拥有超级用户或 RBAC 访问权限。有关更多信息,请参见 su(1M)rbac(5) 手册页。

18 CL_EINTERNAL

遇到内部错误

内部错误表示软件缺陷或其他缺陷。

35 CL_EIO

I/O 错误

发生了物理输入/输出错误。

36 CL_ENOENT

没有这样的对象

由于以下某个原因,找不到您所指定的对象:

  • 该对象不存在。

  • 您尝试使用 –o 选项创建的配置文件路径中的某个目录不存在。

  • 您尝试使用 –i 选项访问的配置文件包含错误。

示例

示例 1 列出 MIB

以下命令可列出群集节点上的所有 MIB。

# clsnmpmib list
Event
示例 2 启用 MIB

以下命令可启用当前节点上的事件 MIB。

# clsnmpmib enable event

群集 MIB 的名称不区分大小写。

示例 3 更改协议

以下命令可将 phys-cluster-2 群集节点上 Event(事件)MIB 的协议更改为 SNMPv3

# clsnmpmib set -n phys-cluster-2 -p version=SNMPv3 Event

如果使用 –n 选项,也可以使用节点 ID 代替节点名称。

示例 4 显示配置

以下命令可显示群集节点 phys-cluster-1phys-cluster-2 上的配置信息。

# clsnmpmib show -n phys-cluster-1,phys-cluster-2
--- SNMP MIB Configuration on myhost ---

SNMP MIB Name:                 phys-cluster-1
  State:                         Event
  Enabled:                       yes
  Protocol:                      SNMPv3
  min_severity:                  1
  log_number:                    100
SNMP MIB Name:                 phys-cluster-2
  State:                         Event
  Enabled:                       yes
  Protocol:                      SNMPv3
  min_severity:                  3
  log_number:                    250
示例 5 更改 Min Severity

以下命令可将 phys-cluster-2 群集节点上事件 MIB 的 min_severity 更改为 WARNING。

# clsnmpmib set -n phys-cluster-2 -p min_severity=WARNING Event

如果使用 –n 选项,也可以使用节点 ID 代替节点名称。

示例 6 更改 Log_Number

以下命令可将 phys-cluster-2 群集节点上事件 MIB 的 log_number 更改为 250。

# clsnmpmib set -n phys-cluster-2 -p log_number=250 Event

如果使用 –n 选项,也可以使用节点 ID 代替节点名称。

属性

有关以下属性的描述,请参见 attributes(5)

属性类型
属性值
可用性
ha-cluster/system/core
接口稳定性
Evolving(发展中)

文件

/usr/cluster/lib/mib/sun-cluster-event-mib.mib

Oracle Solaris Cluster SNMP 事件 MIB 定义文件

另请参见

clsnmphost(1CL)clsnmpuser(1CL)Intro(1CL)cluster(1CL)sceventmib(1M)scha_calls(3HA)attributes(5)rbac(5)clconfiguration(5CL)

附注

超级用户可以运行此命令的所有格式。

所有用户都可以运行带有 –?(帮助)或 –V(版本)选项的此命令。

要运行带有其他子命令的 clsnmpmib 命令,超级用户以外的用户需要具有 RBAC 授权。请参见下表。

子命令
RBAC 授权
disable
solaris.cluster.modify
enable
solaris.cluster.modify
export
solaris.cluster.read
list
solaris.cluster.read
set
solaris.cluster.modify
show
solaris.cluster.read