/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,即事件 MIB。Oracle Solaris Cluster SNMP 事件 MIB 可实时向 SNMP 管理器通知群集事件。一经启用,Oracle Solaris Cluster 事件 MIB 就会自动向 clsnmphost 命令定义的所有主机发送陷阱通知。Oracle Solaris Cluster 事件 MIB 在端口 11162 上发送陷阱通知。可在端口 11161 上查看 SNMP 树。
可以使用 clsnmpmib set 子命令指定 min_severity 或 log_number 值。由于群集会生成大量事件通知,因此只有严重程度为 min_severity 或更高的事件才作为陷阱通知发送。默认情况下,min_severity 值设置为 NOTICE。log_number 值指定在停止使用较旧的条目之前要在 MIB 表中记录的事件的数量。MIB 可维护一个只读表,其中包含最近发生的已作为陷阱发送的事件。事件数受 log_number 值限制。系统重新引导后此信息将不再存在。
仅可以在全局区域中使用此命令。
支持以下子命令:
在指定节点禁用一个或多个群集 MIB。
仅可以在全局区域中运行该子命令。
如果没有指定 –n 选项,则仅禁用当前节点上的 MIB。禁用 MIB 时,无法访问 MIB 表,并且 MIB 不会发送任何陷阱通知。
超级用户以外的用户需要具有 solaris.cluster.modify 基于角色的访问控制 (Role-Based Access Control, RBAC) 授权才能使用该子命令。请参见 rbac(5) 手册页。
在指定节点启用一个或多个群集 MIB。
仅可以在全局区域中运行该子命令。
如果没有指定 –n 选项,则仅启用当前节点上的 MIB。要限制启用的 MIB,请使用 mib 操作数。
启用 MIB 时,也就启用了它的所有功能。但是,要使所有 MIB 功能完全发挥作用,可能有必要进行一些进一步的配置。例如,如果未配置任何主机,MIB 将无法发送陷阱通知。有关配置 SNMP 主机的信息,请参见 clsnmphost(1CL) 手册页。
超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
导出群集 MIB 配置信息。
仅可以在全局区域中运行该子命令。
使用 –n 选项可指定一个或多个要从中导出 MIB 配置信息的节点。如果在不带 –n 选项的情况下使用 export,则该子命令仅从当前节点导出 MIB 配置信息。默认情况下,该子命令导出当前节点上所有 MIB 的配置信息。要进一步完善输出,请指定您需要其配置信息的一个或多个 MIB 的名称。
有关 export 子命令的输出格式的更多信息,请参见 clconfiguration(5CL) 手册页。默认情况下,所有输出都会发送到标准输出。使用 –o 选项后跟文件名可将输出重定向到该文件。
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
显示指定节点上的群集 MIB 列表。
仅可以在全局区域中运行该子命令。
使用 –n 选项可指定要列出的群集 MIB 的节点。如果在不带 –n 选项的情况使用 list 子命令,则该子命令仅列出当前节点上的 MIB。要限制列出的 MIB,请指定要列出的一个或多个 MIB 的名称。
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
更改指定节点上的一个或多个 MIB 使用的 SNMP 协议 min_severity 或 log_number 设置。
仅可以在全局区域中运行该子命令。
默认情况下,该子命令会更改节点上的所有 MIB。如果没有指定节点,则仅修改当前节点上 MIB 的 SNMP 属性。必须通过使用 –p 选项指定 SNMP 属性。所有 MIB 都使用以下默认属性值:protocol:SNMPv2, min_severity:NOTICE, log_number:100。除非使用 mib 操作数指定 MIB 名称,否则 set 子命令会更改所有 MIB 的协议、min_severity 或 log_number 设置。
超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
显示指定节点上 MIB 的信息。
仅可以在全局区域中运行该子命令。
show 子命令显示 MIB 的名称、其 SNMP 协议版本、min_severity 值或 log_number 值。默认情况下,该子命令会显示节点上所有 MIB 的信息。
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
支持以下选项:
显示帮助信息。
指定此选项时,子命令可有可无。
如果在不带子命令的情况下使用此选项,将会显示可用子命令的列表。
如果将该选项与子命令结合使用,将会显示该子命令的用法选项。
使用该选项时,不会执行任何其他处理。
指定一个节点或一系列节点。可以使用节点名称或节点 ID 指定每个节点。clsnmpmib 命令的所有格式都接受此选项。可以使用 –n 选项指定要在其上执行操作的节点。如果不使用 –n 选项,则该命令会采用当前节点。
指定要写入群集 MIB 配置信息的位置。此位置可以是文件,也可以是标准输出。要指定标准输出,请指定减号 (-) 而不是文件名。如果指定标准输出,将会抑制该命令的其他所有标准输出。如果没有指定 –o 选项,输出将发送到标准输出。此选项仅可以与 export 子命令一同指定。
配置信息是采用 clconfiguration(5CL) 手册页中定义的格式写入的。
指定 MIB 将使用的 SNMP 协议的版本。Oracle Solaris Cluster 支持 SNMPv2 和 SNMPv3 协议版本。
指定最低严重程度值。只有其值等于或大于 min_severity 值的事件才会记录在 MIB 表中,对于这些事件,将向配置的主机发送陷阱。
指定在停止使用较旧的条目之前要在 MIB 表中记录的事件的数量。
允许使用多个 –p name= value 实例。
可以使用该选项设置以下属性:
指定 MIB 将使用的 SNMP 协议的版本。您可以按如下方式指定 value:
version=SNMPv2
version=snmpv2
version=2
version=SNMPv3
version=snmpv3
version=3
指定要用于 MIB 的最低严重性级别值。您可以按如下方式指定值:
min_severity=NOTICE
min_severity=WARNING
min_severity=ERROR
min_severity=CRITICAL
min_severity=FATAL
允许使用大写或小写的值。
指定在停止使用较旧的条目之前要在 MIB 表中记录的事件的数量。默认值为 100。值范围为 100 到 500。您可以按如下方式指定value:
log_number=number
显示该命令的版本。
不要将该选项与子命令、操作数或其他选项一起指定,因为子命令、操作数或其他选项会被忽略。–V 选项只显示命令的版本。不会执行任何其他操作。
将详细信息显示到标准输出。
可以将该选项与命令的任何格式一同指定,尽管一些子命令可能不会生成扩展输出。例如,指定详细选项时 export 子命令不会生成扩展输出。
支持以下操作数:
指定要应用子命令的一个或多个 MIB 的名称。如果您没有指定此操作数,该子命令将使用默认的加号 (+),这意味着所有 MIB。如果使用 mib 操作数,请在空格分隔列表中所有其他命令行选项之后指定 MIB。
所有群集 MIB。
如果命令对于所有指定的操作数均成功执行,则返回零 (CL_NOERR)。如果某个操作数出错,命令会继续处理操作数列表中的下一个操作数。返回的退出代码始终反映最先发生的错误。
此命令返回下列退出状态代码:
没有错误
您发出的命令已成功完成。
交换空间不足
某个群集节点耗尽了交换内存或其他操作系统资源。
参数无效
您键入的命令不正确,或者使用 –i 选项提供的群集配置信息语法不正确。
权限被拒绝
指定的对象不可访问。要发出命令,可能需要拥有超级用户或 RBAC 访问权限。有关更多信息,请参见 su(1M) 和 rbac(5) 手册页。
遇到内部错误
内部错误表示软件缺陷或其他缺陷。
I/O 错误
发生了物理输入/输出错误。
没有这样的对象
由于以下某个原因,找不到您所指定的对象:
该对象不存在。
您尝试使用 –o 选项创建的配置文件路径中的某个目录不存在。
您尝试使用 –i 选项访问的配置文件包含错误。
以下命令可列出群集节点上的所有 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-1 和 phys-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):
|
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 授权。请参见下表。
|