AIX命令参考大全,卷 1,a - c - clsnmp 命令

[ 页的底部 | 上一页 | 下一页 | 目录 | 索引 | 法律条款 ]

AIX命令参考大全,卷 1,a - c

clsnmp 命令

用途

AIX clsnmp 命令从 AIX shell 提供 SNMP 管理器功能, 以对于 SNMP 代理程序查询网络管理信息。

语法

clsnmp [ -d DebugLevel ] [ -h TargetHost ] [ -c Community ] [ -t TimeOutValue ] [ -r RetryNumber ] [ -n NonRepeaters ] [ -m MaxRepetitions ] [ -p PortNumber ] [ -v ] [ -f ConfigurationFile ] [ -? ] Function [ MIBVariable [ VariableType ] [ Value ] [ ... ] ]

描述

使用 clsnmp 命令对代理程序发出 SNMP 请求并处理由代理程序返回的 SNMP 响应。AIX clsnmp 命令支持 SNMPv1、SNMPv2c 和 SNMPv3 请求的发出。

SNMP 请求类型

findname
发送请求,进行搜索以获取文本名称(对于给定的 MIBVariable 输入),其内部 ASN.1 值与输入 ASN.1 值最佳匹配。搜索首先检查 /etc/mib.defs 文件,如果找不到匹配的文本名称,则继续检查编译的 MIB。每个 clsnmp findname 调用只允许一个 MIBVariable
get
向 SNMP 代理程序发送请求,以获取特定的管理信息库(MIB)变量。然后 clsnmp 等待响应或超时。
getbulk
获取由 OID 或 MIB 变量名指定的 MIB 树中的变量值。单一的 getbulk 与使用 clsnmp 命令和 SNMP 代理程序之间进行少量数据交换的一系列 getnext 执行相同的功能。
getnext
向 SNMP 代理程序发送请求,以获取按词典排序的跟在指定的 MIBVariable 后的 MIB 变量。然后 clsnmp 等待响应或超时。
set
向 SNMP 代理程序发送请求以获取特定的 MIB 变量。然后 clsnmp 等待响应或超时。
trap
侦听 SNMP 陷阱,并在其出现时显示 trap 信息。使用缺省值,众所周知的端口 162 或 -p 选项指定的端口号。clsnmp trap 功能继续侦听陷阱,直到进程被杀死或取消。
walk
对指定的前缀发出 getnext 请求,然后只要有匹配指定的前缀的变量就继续发出 getnext 请求。前缀可以是完整的对象标识的前导部分。

用法

set 操作并非在所有 MIB 对象上受支持。 如果管理 MIB 对象的代理程序或子代理程序不支持 SET,则可能拒绝 set 操作。

getbulk 是一个 SNMPv2 功能。如果目标代理程序只支持 SNMPv1,则目标代理程序忽略您的请求。结果,请求超时。

功能关键字不区分大小写。标志、变量名和值区分大小写。

要同时侦听来自 NetView SNMP 和 AIX clsnmp 的陷阱,请使用 clsnmp 命令的 -p PortNumber 参数。在一个 IP 地址上一次只能有一个管理应用程序可以在一个端口上侦听。 在 clsnmp 陷阱命令上指定 -p 启用要使用的除众所周知的端口 162 以外的端口。这两个端口都必须配置为代理程序陷阱目的地。

未认证(通过使用可接受的共用名或用户名)的 clsnmp 命令将超时。

clsnmp 命令使用两个配置文件:/etc/mib.defsclsnmp.conf。样本文件在 /usr/samples/snmpdv3 目录中提供。

clsnmp 命令支持发送 SNMPv1、SNMPv2c 和 SNMPv3 请求。 clsnmp 用于确定它是否应该发送 SNMPv1、SNMPv2c 或 SNMPv3 请求的文件是 clsnmp.conf 文件。如果通过 -h 参数指定的目标匹配 clsnmp.conf 文件中的 winSNMP 名称,则 clsnmp 使用在条目上指定的参数发送请求。如果不指定 -h 参数,则该请求将作为 SNMPv1request 发送。

标志

-c Community 指定用于访问目的地 SNMP 代理程序上的指定变量的共用名。如果不指定共用名,则缺省名为 public。当使用基于用户的安全模型时,不要求共用名。
注:
共用名区分大小写。
-d DebugLevel 指定调试级别。缺省级别为 0,意味着无调试。 调试级别越高,显示的消息数越大。 调试级别为 0-4。
-f ConfigurationFile 指定配置文件的全路径和文件名。
-h TargetHost 指定要向其发送请求的目标主机。它可以是因特网协议地址、主机名或 clsnmp.conf 配置文件中的 winSNMP。如果不指定主机,则缺省值为您的本地主机。
-m MaxRepetitions 只适用于 getbulk。如果功能请求不是 getbulk,则忽略它。 最大重复是要为每个变量绑定对(在第一个“-n 数字”后续作业后)返回的按字典排序的后续作业的数目。例如,以后续作业“-n 数字”+1 开头返回每个变量绑定对的后续作业的“-m 数字”。缺省值为 10。
-n NonRepeaters 只适用于 getbulk 请求。如果功能请求不是 getbulk,则忽略它。 NonRepeaters 是变量绑定对(名称/值)的数目,从第一个开始,只为此返回单一的后续作业。缺省值为 0。
-p PortNumber 指定侦听陷阱的端口号。如果不指定端口号,则 clsnmp trap 功能在众所周知的端口 162(clsnmp 陷阱的缺省端口)上侦听。
-r RetryNumber 指定如果超时要重新尝试命令的最大次数。缺省值为 2。
-t TimeOutValue 指定 clsnmp 命令等候来自 SNMP 代理程序的应答的时间量(以秒为单位)。缺省值为 3。
-v 指定来自请求的输出应该使用详细的输出显示,例如,使用文本名称替换 MIB 对象标识。
-? 显示帮助信息。

参数

功能 指定要执行的 SNMP 功能/操作为以下项之一:getgetnextgetbulksetwalktrapfindname
MIBVariable 指定管理信息库(MIB)对象(使用其对象描述符:文本名称)、ASN.1 表示法的对象描述符或二者的组合。当与 walk 一起使用时,这是 MIB 对象前缀。前缀可以是完整的对象标识的前导部分。当与 findname 一起使用时,这是 ASN.1 表示法的对象标识。
Value 指定要由 SET 功能设置的值。如果值中需要空白,则必须使用双引号(")将该值引起来。如果想要将变量设置为既是类型又是值,则必须指定类型。
VariableType 指定正在设置的值的类型。要完成 SNMP SET 请求,则必须知道 SMI_type。如果不指定类型,则 clsnmp 首先搜索 /etc/mib.defs 文件,然后搜索编译的 MIB 以确定类型。如果未查找到变量,则返回错误。如果指定了 VariableType,则 VariableType 优先于可能在 MIB 中分配的任何类型。VariableType 和值必须兼容。例如,如果指定“number”类型和“foo”值,则由于“foo”不是数字而返回错误。VariableType 不区分大小写。有效的变量类型是:
  • bitstring
  • counter
  • counter32
  • counter64
  • display 或 displaystring
  • gauge
  • gauge32
  • integer
  • integer32
  • ipaddress
  • nsapaddress
  • null
  • objectidentifier 或 OID
  • octetstring
  • opaque
  • opaqueascii
  • timeticks
  • uinteger

示例

  1. 获取 MIB 变量。
    1. 以下请求 MIB 对象 sysName.0:
      clsnmp get sysName.0
      此命令的输出看起来类似于:
      1.3.6.1.2.1.1.5.0 = hostname.austin.ibm.com
    2. 以下请求 MIB 对象 myName.0,其中 myName 在 /etc/mib.defs 文件中定义,它是由 sysName.0 标识的同一个对象:
      clsnmp get myName.0
      此命令的输出看起来类似于:
      1.3.6.1.2.1.1.5.0 = myhostname.austin.ibm.com
  2. 获取下一个 MIB 变量。
    1. 以下请求下一个逻辑 MIB 对象:
      clsnmp getnext udp
      此命令的输出看起来类似于:
      1.3.6.1.2.1.7.1.0 = 653
    2. 以下请求下一个逻辑对象,使用 -v 选项显示具有文本名(代替对象标识)的值:
      clsnmp -v getnext udp
      此命令的输出看起来类似于:
      udpInDatagrams.0 = 653
  3. 设置 MIB 变量。
    1. 以下将 MIB 对象 sysName.0 设置为值‘hostname.austin.ibm.com’:
      clsnmp set sysName.0  "hostname.austin.ibm.com"
      此命令产生类似于以下的输出:
      1.3.6.1.2.1.1.5.0 = hostname.austin.ibm.com
    2. MIB 对象 sysName.0 的值还可以使用 VariableType 参数设置以指定正在设置的值的类型,如以下示例中所示:
      clsnmp set sysName.0 displayname "hostname.austin.ibm.com"
      此命令产生类似于以下的输出:
      1.3.6.1.2.1.1.5.0 = hostname.austin.ibm.com
  4. 遍历 MIB 树。

    以下按名称返回所有以相同的对象标识前缀开头的对象,但具有较少的要在 clsnmp 命令和 SNMP 代理程序之间交换的数据包:

    clsnmp -h loopback -v -m 10 bulkwalk udp

    此命令的输出看起来类似于以下内容:

    clsnmp -v walk udp 
    udpInDatagrams.0 = 653 
    udpNoPorts.0 = 22 
    udpInErrors.0 = 0 
    udpOutDatagrams.0 = 678 
    udpLocalAddress.0.0.0.0.7 = 0.0.0.0 
    udpLocalAddress.0.0.0.0.9 = 0.0.0.0 
    udpLocalAddress.0.0.0.0.13 = 0.0.0.0 
    udpLocalAddress.0.0.0.0.19 = 0.0.0.0 
    udpLocalAddress.0.0.0.0.37 = 0.0.0.0 
    udpLocalAddress.0.0.0.0.161 = 0.0.0.0 
    udpLocalAddress.0.0.0.0.5020 = 0.0.0.0 
    udpLocalPort.0.0.0.0.7 = 7 
    udpLocalPort.0.0.0.0.9 = 9 
    udpLocalPort.0.0.0.0.13 = 13 
    udpLocalPort.0.0.0.0.19 = 19 
    udpLocalPort.0.0.0.0.37 = 37 
    udpLocalPort.0.0.0.0.161 = 161 
    udpLocalPort.0.0.0.0.5020 = 5020
  5. 获取多个 MIB 变量。

    以下使用 getbulk 请求类型请求多个 MIB 对象。getbulk 请求类型返回在命令上列出的一个或多个 MIB 对象的下一个逻辑对象。在以下示例中,-n 选项指示仅对前两个变量(sysLocation 和 ifTable)请求下一个逻辑对象。对于列表中的所有其它对象(tcp、udp 和 icmp),-m 选项指示请求 5 个副本。

    注:
    getbulk 请求类型为 SNMPv2 功能。-h 参数指示主机、回送,在 clsnmp.conf 文件中定义为支持 SNMPv2 或 SNMPv3 的代理程序。
    clsnmp -h loopback -v -n 2 -m 5 getbulk sysLocation ifTable tcp udp icmp

    此命令产生类似于以下的输出:

    sysLocation.0 = Research Triangle Park, NC 
    ifIndex.1 = 1 
    tcpRtoAlgorithm.0 = 4 
    udpInDatagrams.0 = 782 
    icmpInMsgs.0 = 22 
    tcpRtoMin.0 = 0 
    udpNoPorts.0 = 22 
    icmpInErrors.0 = 0 
    tcpRtoMax.0 = 120 
    udpInErrors.0 = 0 
    icmpInDestUnreachs.0 = 22 
    tcpMaxConn.0 = -1 
    udpOutDatagrams.0 = 807 
    icmpInTimeExcds.0 = 0 
    tcpActiveOpens.0 = 1 
    udpLocalAddress.0.0.0.0.7 = 0.0.0.0 
    icmpInParmProbs.0 = 0
  6. 查找 ASN.1 变量的名称。

    以下发送请求进行搜索以获取给定 MIBVariable 输入的文本名称,其内部的 ASN.1 值与输入 ASN.1 值最佳匹配。搜索从 /etc/mib.defs 文件开始,如果没有查找到,则继续搜索编译的 MIB。每个 clsnmp findname 调用只允许一个 MIBVariable。例如,这可以使用类似于以下的命令完成:

    clsnmp findname 1.3.6.1.2.1.6.13.1.2

    此命令产生类似于以下的输出:

    1.3.6.1.2.1.6.13.1.2 found as: tcpConnLocalAddress

    类似的示例是:

    clsnmp findname 1.3.6.1.2.1.6.13.1.2.0

    此命令产生类似于以下的输出:

    1.3.6.1.2.1.6.13.1.2.0 found as: tcpConnLocalAddress.0

    另一个类似的示例是:

    clsnmp findname 1.3.6.1.2.

    此命令产生类似于以下的输出:

    1.3.6.1.2. found as: mgmt
  7. 发出 SNMPv3 请求。
    1. 如果 winSnmpName 条目使用类似于以下(所有都在一行上)的条目在管理器主机上的 /etc/clsnmp.conf 文件中配置:
      target1   9.3.149.26 snmpv3 u1 -          - AuthNoPriv   HMAC-SHA
      76784e5935acd6033a855df1fac42acb187aa867 -   -
      并且在 snmpd 代理程序机器 9.3.149.26 上,用户 u1 正确配置,则我们可以在管理器主机上发出命令:
      clsnmp -v -h target1 get sysName.0
      此命令将产生类似于以下的输出:
      sysName.0 = somehostname.austin.ibm.com
    2. 发出陷阱命令很简单,如下所示:
      clsnmp trap
      注:
      如果陷阱的安全性模型接收到的是 SNMPv3,确保侦听该陷阱的管理站正确配置了 /etc/clsnmp.conf 文件,以接收该陷阱。

文件

/etc/clsnmp.conf clsnmp 命令的配置文件。
/etc/mib.defs 定义 SNMP 代理程序和管理器应该识别和处理的管理信息库(MIB)变量。

相关信息

pwchange 命令、pwtokey 命令和 snmpdv3 守护进程。

/etc/clsnmp.conf 文件和 /etc/snmpdv3.conf 文件。

[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 | 法律条款 ]