30-SNMP-RMON Command

Download


Chapter 1  SNMP Configuration Commands

1.1  SNMP Configuration Commands

1.1.1  display snmp-agent

Syntax

display snmp-agent { local-engineid | remote-engineid }

View

Any view

Parameter

local-engineid: Displays a local engine ID.

remote-engineid: Displays a remote engine ID.

Description

Use the display snmp-agent command to view the engine ID of the current device.

An SNMP engine ID identifies an SNMP entity uniquely within an SNMP domain. As an indispensable part of an SNMP entity, an SNMP engine ID performs the function of sending, receiving and authenticating SNMP messages, extracting PDUs, packet encapsulation and the communication with SNMP applications.

Example

# Display the local engine ID of the current device.

<H3C> display snmp-agent local-engineid

SNMP local EngineID: 00000009020000000C025808

The SNMP local EngineID field in the above information represents the ID of the local SNMP engine.

1.1.2  display snmp-agent community

Syntax

display snmp-agent community [ read | write ]

View

Any view

Parameter

read: Displays the information about community names with read-only access right.

write: Displays the information about community names with write access right.

Description

Use the display snmp-agent community command to view the information about the currently configured community names for SNMPv1 or SNMPv2c.

Example

# Display the currently configured community names.

<H3C> display snmp-agent community

   Community name: public

       Group name: public

       Storage-type: nonVolatile

 

   Community name: private

       Group name: private

       Storage-type: nonVolatile

Table 1-1 Description on the fields of the display snmp-agent community command

Field

Description

Community name

Community name

Group name

Group name

Storage-type

Storage type, including volatile, nonVolatile, permanent, readOnly, and other.

 

1.1.3  display snmp-agent group

Syntax

display snmp-agent group [ group-name ]

View

Any view

Parameter

groupname: Name of the group whose SNMP information is to be displayed, ranging from 1 to 32 bytes.

Description

Use the display snmp-agent group command to view the group information on the current switch, including group name, security model, state of various views and storage models.

Example

# Display the information about the SNMP group named “hello”.

<H3C> display snmp-agent group

   Group name: hello

       Security model: v2c noAuthnoPriv

       Readview: ViewDefault

       Writeview: <no specified>

       Notifyview :<no specified>

       Storage-type: nonvolatile

The following table describes the output fields.

Table 1-2 Description on the fields of the display snmp-agent group command

Field

Description

Group name

SNMP group name

Security model

Security model of that group, including authorization and encryption (AuthPriv), authorization with no encryption (AuthnoPriv), no authorization and no encryption (noAuthnoPriv).

Readview

Read-only MIB view name corresponding to that group

Writeview

Write MIB view corresponding to that group

Notifyview

Notify MIB view corresponding to that group

Storage-type

Storage type, including volatile, nonVolatile, permanent, readOnly and other.

 

1.1.4  display snmp-agent mib-view

Syntax

display snmp-agent mib-view [ exclude | include | viewname view-name ]

View

Any view

Parameter

exclude: Displays the SNMP MIB views of the excluded attribute.

include: Displays the SNMP MIB views pf the included attribute.

viewname: Displays the SNMP MIBs according to the view name.

view-name: Name of the SNMP MIB view to be displayed. It is a character string, ranging from 1 to 32 characters.

Description

Use the display snmp-agent mib-view command to view the MIB view configuration information of the current Ethernet switch.

Example

# Display the information about the currently configured MIB views.

<H3C> display snmp-agent mib-view

   View name: system

       MIB Subtree:system

       Subtree mask:

       Storage-type: nonVolatile

       View Type:included

       View status:active

View name:ViewDefault

       MIB Subtree:iso

       Subtree mask:

       Storage-type: nonVolatile

       View Type:included

       View status:active

View name:ViewDefault

       MIB Subtree:snmpUsmMIB

       Subtree mask:

       Storage-type: nonVolatile

       View Type:excluded

       View status:active

View name:ViewDefault

       MIB Subtree:snmpVacmMIB

       Subtree mask:

       Storage-type: nonVolatile

       View Type:excluded

       View status:active

View name:ViewDefault

       MIB Subtree:snmpModules.18

       Subtree mask:

       Storage-type: nonVolatile

       View Type:excluded

       View status:active

Table 1-3 Description on the fields of the display snmp-agent mib-view command

Field

Description

View name

View name

MIB Subtree

MIB subtree

Subtree mask

Subtree mask

Storage-type

Storage type

View Type

Includes or excludes access to an MIB object

View status: active/inactive

Indicates the MIB view status: active or inactive

 

  Caution:

For the above commands, when an SNMP agent is disabled, the system gives the prompt “SNMP agent disabled”.

 

1.1.5  display snmp-agent statistics

Syntax

display snmp-agent statistics

View

Any view

Parameter

None

Description

Use the display snmp-agent statistics command to view the statistics on SNMP packets.

This command provides statistics for SNMP operations.

Example

# Display the statistics on SNMP packets.

<H3C> display snmp-agent statistics

  9232 Messages delivered to the SNMP entity

  0 Messages which were for an unsupported version

  0 Messages which used a SNMP community name not known

  0 Messages which represented an illegal operation for the community supplied

  0 ASN.1 or BER errors in the process of decoding

  9266 Messages passed from the SNMP entity

  0 SNMP PDUs which had badValue error-status

  0 SNMP PDUs which had genErr error-status

  11 SNMP PDUs which had noSuchName error-status

  0 SNMP PDUs which had tooBig error-status (Maximum packet size 2000)

  33029 MIB objects retrieved successfully

  26 MIB objects altered successfully

  714 GetRequest-PDU accepted and processed

  8514 GetNextRequest-PDU accepted and processed

  10 GetBulkRequest-PDU accepted and processed

  9230 GetResponse-PDU accepted and processed

  1 SetRequest-PDU accepted and processed

  34 Trap PDUs accepted and processed

1.1.6  display snmp-agent sys-info

Syntax

display snmp-agent sys-info [ contact | location | version ]*

View

Any view

Parameter

contact: Displays the contact information of the current device.

location: Displays the physical location of the current device.

version: Displays the version information of the SNMP running in the system.

Description

Use the display snmp-agent sys-info command to view the system contact (sysContact) string, physical location string, and the current SNMP version.

This command displays all information if you choose no parameter.

Example

# Display the sysContact string.

<H3C> display snmp-agent sys-info contact

   The contact person for this managed node:

           R&D Hangzhou, H3C Technology. Co.,Ltd.

The above information indicates that the contact of this device is R&D Hangzhou, H3C Technology. Co.,Ltd.

# Display the physical location string.

<H3C> display snmp-agent sys-info location

   The physical location of this node:

           Hangzhou China

The above information indicates that the device location is Hangzhou China.

# Display the current SNMP version.

<H3C> display snmp-agent sys-info version

   SNMP version running in the system:

           SNMPv3

The above information indicates that the current SNMP version is SNMPv3.

1.1.7  display snmp-agent usm-user

Syntax

display snmp-agent usm-user [ engineid engineid | username user-name | group group-name ]*

View

Any view

Parameter

engineid: SNMPv3 user information of the specified engine ID, which is of 10 to 64 hexadecimal numerals.

username: Information about the specified SNMPv3 user, which is of 1 to 32 characters.

groupname: Information about users in the specified group, whose name is of 1 to 32 characters.

Description

Use the display snmp-agent usm-user command to view SNMP user information.

If you do not specify any parameter, all the information will be displayed.

Example

# Display all user information.

<H3C> display snmp-agent usm-user engineid 1234567890

User name: userv3aaaa

Group name: managev3group

Engine ID: 1234567890

Storage-type: nonVolatile

UserStatus: active

Table 1-4 describes the output fields.

Table 1-4 Description on the fields of the display snmp-agent usm-user command

Field

Description

User name

SNMP user name

Group name

Name of the group the SNMP user belongs to

Engine ID

Character string identifying the SNMP device

Storage-type

Storage type of SNMP information, including volatile, nonVolatile, permanent, readOnly and other.

UserStatus

SNMP user status

 

1.1.8  enable snmp trap updown

Syntax

enable snmp trap updown

undo enable snmp trap updown

View

Ethernet port view/interface view

Parameter

None

Description

Use the enable snmp trap updown command to enable the sending of port/interface linkUp and linkDown trap messages.

Use the undo enable snmp trap updown command to disable the sending of linkUp and linkDown trap messages.

By default, the sending of port/interface linkUp and linkDown trap messages is enabled.

The enable snmp trap updown command must be used in conjunction with the snmp-agent trap enable, snmp-agent target-host commands. You can use the snmp-agent target-host command to specify the hosts that can receive trap packets. To send trap packets, you must configure at least one snmp-agent target-host command.

Example

# Enable Ethernet 6/0/1 to send linkUp and linkDown SNMP trap messages to community name “public” on the NMS whose IP address is 10.1.1.1.

<H3C>system-view

System View: return to User View with Ctrl+Z.

[H3C] snmp-agent trap enable

[H3C] snmp-agent target-host trap address udp-domain 10.1.1.1 params securityname public

[H3C] interface ethernet6/0/1

[H3C-Ethernet6/0/1] enable snmp trap updown

1.1.9  snmp-agent

Syntax

snmp-agent

undo snmp-agent

View

System view

Parameter

None

Description

Use the snmp-agent command to enable SNMP agents.

Use the undo snmp-agent command to disable SNMP agents.

By default, SNMP agents are disabled.

Example

# Disable running SNMP agents.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] undo snmp-agent

1.1.10  snmp-agent community

Syntax

snmp-agent community { read | write } community-name [ [ acl acl-number | mib-view view-name ]*

undo snmp-agent community community-name

View

System view

Parameter

read: Indicates that MIB objects can only be read. Read-only communities can only query device information.

write: Indicates that MIB objects can be read and written. Read-write communities can configure the device.

community-name: Community name, a character string of 1 to 32 characters.

view-name: MIB view name, a character string of 1 to 32 characters.

acl-number: Basic access control list (ACL) number specified by a community name, ranging from 2000 to 2999.

Description

Use the snmp-agent community command to configure community name and enable the access to SNMP.

Use the undo snmp-agent community command to cancel the community name settings.

Example

# Configure the community name as comaccess and permit read-only access by this community name.

<H3C>system-view

System View: return to User View with Ctrl+Z.

[H3C] snmp-agent community read comaccess

# Configure community name as mgr and permit read-write access.

[H3C] snmp-agent community write mgr

# Remove the community name comaccess.

[H3C] undo snmp-agent community comaccess

1.1.11  snmp-agent group

Syntax

1)         For SNMPv1 and SNMPv2c

snmp-agent group { v1 | v2c } group-name [ read-view read-view ] [ write-view write-view ] [ notify-view notify-view ] [ acl acl-number ]

undo snmp-agent group { v1 | v2c } group-name

2)         For SNMPv3

snmp-agent group v3 group-name [ authentication | privacy ] [ read-view read-view ] [ write-view write-view ] [notify-view notify-view ] [ acl acl-number ]

undo snmp-agent group v3 group-name [ authentication | privacy ]

View

System view

Parameter

v1: Specifies SNMPv1.

v2c: Specifies SNMPv2c.

v3: Specifies SNMPv3.

groupname: Group name, ranging from 1 to 32 bytes.

authentication: Configures to authenticate packets without encrypting them.

privacy: Configures to authenticate and encrypt packets.

read-view: Sets read-only view.

read-view: Read-only view name, ranging from 1 to 32 bytes.

write-view: Sets read-write view.

write-view: Read-write view name, ranging from 1 to 32 bytes.

notify-view: Sets notify view.

notify-view: Notification view name, ranging from 1 to 32 bytes.

acl: Sets an ACL.

acl-number: ACL number, ranging from 2000 to 2099.

Description

Use the snmp-agent group command to configure a new SNMP group, that is, to map SNMP users to an SNMP view.

Use the undo snmp-agent group command to remove a specified SNMP group.

By default, an SNMP group configured using the snmp-agent group v3 command does not authenticate or encrypt packets.

Related command: snmp-agent mib-view, snmp-agent usm-user.

Example

# Create SNMPv3 group named hello.

<H3C>system-view

System View: return to User View with Ctrl+Z.

[H3C] snmp-agent group v3 hello

1.1.12  snmp-agent local-engineid

Syntax

snmp-agent local-engineid engineid

undo snmp-agent local-engineid

View

System view

Parameter

engineid: Engine ID, a character string of 10 to 64 hexadecimal numbers. Two hexadecimal characters form an octet.

Description

Use the snmp-agent local-engineid command to set the engine ID of the local SNMP entity.

Use the undo snmp-agent local-engineid command to restore the default settings.

By default, the engine ID is "Enterprise number + device information". Device information is determined by products. It can be an IP address, MAC address or user-defined string in hexadecimal format.

Related command: snmp-agent usm-user.

Example

# Configure the local device name as 1234512345.

<H3C>system-view

System View: return to User View with Ctrl+Z.

[H3C] snmp-agent local-engineid 1234512345

1.1.13  snmp-agent mib-view

Syntax

snmp-agent mib-view { included | excluded } view-name oid-tree

undo snmp-agent mib-view view-name

View

System view

Parameter

included: Includes the MIB subtree.

excluded: Excludes the MIB subtree.

view-name: View name, a character string of 1 to 32 characters.

oid-tree: OID MIB subtree of the MIB object subtree. It is a character string of 1 to 255 characters. It can be a character string of the variable OID (such as 1.4.5.3.1), or a variable name (such as system). The character string can include wildcards (such as 1.4.5.*.*.1).

Description

Use snmp-agent mib-view command to create or update MIB view information, in order to limit the MIB objects to be accessed by the NMS.

Use the undo snmp-agent mib-view command to cancel the current setting.

By default, the view name is ViewDefault and OID is 1.

Related command: snmp-agent group.

Example

# Create an SNMP MIB view containing all the objects of MIB-II.

<H3C>system-view

System View: return to User View with Ctrl+Z.

[H3C] snmp-agent mib-view included mib2 1.3.6.1.2.1

1.1.14  snmp-agent packet max-size

Syntax

snmp-agent packet max-size byte-count

undo snmp-agent packet max-size

View

System view

Parameter

byte-count: Maximum size of the SNMP packet (in bytes) that the agent can send/receive, ranging from 484 to 17,940.

Description

Use the snmp-agent packet max-size command to set the maximum size of the SNMP packet that the agent can send/receive.

Use undo snmp-agent packet max-size command to restore the default size of SNMP packets.

The maximum size of the SNMP packet that the agent can send/receive vary with networking conditions.

Example

# Set the maximum size of the SNMP packet that the agent can send/receive to 1,042 bytes.

<H3C>system-view

System View: return to User View with Ctrl+Z.

[H3C] snmp-agent packet max-size 1042

1.1.15  snmp-agent sys-info

Syntax

snmp-agent sys-info { contact sys-contact | location sys-location | version { { v1 | v2c | v3 }* | all } }

undo snmp-agent sys-info { { contact | location }* | version { { v1 | v2c | v3 }* | all } }

View

System view

Parameter

contact: Sets the contact for system maintenance.

sysContact: Character string describing contact information for system maintenance.

location: Sets the geographical location of the device.

sys-location: Geographical location of the device.

version: Specifies version of the running SNMP.

v1: Specifies SNMPv1.

v2c: Specifies SNMPv2c.

v3: Specifies SNMPv3.

all: Specifies all SNMP versions, including SNMPv1, SNMPv2c, SNMPv3.

Description

Use the snmp-agent sys-info command to set system information, including geographical location of the device, contact information for system maintenance and version information of running SNMP.

Use the undo snmp-agent sys-info location command to remove the current configuration.

If the device fails, the device maintainer can use contact information to contact the manufacturer.

By default, the contact information is "R&D Hangzhou, H3C Technology. Co.,Ltd.", the physical location is "Hangzhou China", the SNMP version is SNMPv3.

Related command: display snmp-agent sys-info.

Example

# Set contact information for system maintenance as Dial System Operator # 1234.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] snmp-agent sys-info contact Dial System Operator # 1234

1.1.16  snmp-agent target-host

Syntax

snmp-agent target-host trap address udp-domain { ip-address } [ udp-port port-number ] params securityname security-string [ v1 | v2c | v3 [authentication | privacy ] ]

undo snmp-agent target-host ip-address securityname security-string

View

System view

Parameter

trap: Specifies the host to be a Trap host.

address: Specifies the address of the destination host for transmitting SNMP messages.

udp-domain: Specifies to transmit trap messages to the target host through UDP.

ip-address: IPv4 address of the host receiving trap messages.

port-number: Number of the port receiving trap messages, ranging from 0 to 65,535 characters.

params: Specifies SNMP target host information , which is to be used in SNMP message generation.

security-string: Community name for SNMPv1 and SNMPv2c, or SNMPv3 user name, ranging from 1 to 32 characters.

v1: Specifies SNMPv1.

v2c: Specifies SNMPv2c.

v3: Specifies SNMPv3.

authentication: Configures to authenticate the packets without encrypting them.

privacy: Configures to authenticate and encrypt the packets.

Description

Use snmp-agent target-host command to configure the destination of SNMP trap messages.

Use undo snmp-agent target-host command to cancel the current setting.

The snmp-agent target-host command must be in conjunction with the snmp-agent trap enable command or the enable snmp trap updown command on the device to enable the device to send trap messages.

1)         Use the snmp-agent trap enable command or the enable snmp trap updown command to define trap messages allowed to be sent (all trap messages can be sent by default).

2)         Use the snmp-agent target-host command to set the address of the destination host receiving SNMP trap messages.

Related command: snmp-agent trap enable, snmp-agent trap source, and snmp-agent trap life.

Example

# Enable sending SNMP trap messages to the community name public on 10.1.1.1.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] snmp-agent trap enable standard

[H3C] snmp-agent target-host trap address udp-domain 10.1.1.1 params securityname public

1.1.17  snmp-agent trap enable

Syntax

snmp-agent trap enable [ bgp [ backwardtransition | established ]* | configuration | flash | ospf [ process-id ] [ ospf-trap-list ] | standard [ authentication | coldstart | linkdown | linkup | warmstart ]* | system | vrrp [ authfailure | newmaster ] ]

undo snmp-agent trap enable [ bgp [ backwardtransition | established ]* | configuration | flash | ospf [ process-id ] [ ospf-trap-list ] | standard [ authentication | coldstart | linkdown | linkup | warmstart ]* | system | vrrp [ authfailure | newmaster ] ]

View

System view

Parameter

bgp [ backwardtransition | established ]*: Configures to send trap messages about BGP.

configuration: Configures to send trap messages about configurations.

flash: Configures to send trap messages about Flash.

ospf [ process-id ] [ ospf-trap-list ]: Configures to send trap messages about the OSPF protocol. The process-id argument represents a process ID. The ospf-trap-list argument represents a list of trap messages allowed to be sent.

standard [ authentication ] [ coldstart ] [ linkdown ] [ linkup ] [ warmstart ]: Configures to send SNMP standard notifications or trap messages.

authentication: Configures to send trap messages about SNMP authentication when authentication fails.

coldstart: Configures to send trap messages about cold restart when the switch restarts.

linkdown: Configures to send trap messages about SNMP linkdown when a port is down.

linkup: Configures to send trap messages about SNMP linkup when a port is up.

warmstart: Configures to send trap messages about SNMP warmstart when SNMP is rebooted.

system: Configures to send trap messages about H3C-SYS-MAN-MIB (a private MIB).

vrrp [ authfailure | newmaster ]: Configures to send trap messages about VRRP.

Description

Use the snmp-agent trap enable command to enable the device to send trap messages.

Use the undo snmp-agent trap enable command to disable the device from sending trap messages.

By default, the device does not send trap messages.

The snmp-agent trap enable command must be used in conjunction with the snmp-agent target-host command. The snmp-agent target-host command specifies which hosts can receive Trap messages. However, to send trap messages, you must use the snmp-agent target-host command for once at least.

Example

# Enable to send the trap messages about SNMP authentication failure to community name public on 10.1.1.1.

<H3C>system-view

System View: return to User View with Ctrl+Z.

[H3C] snmp-agent trap enable standard authentication

[H3C] snmp-agent target-host trap address udp-domain 10.1.1.1 params securityname public

1.1.18  snmp-agent trap life

Syntax

snmp-agent trap life seconds

undo snmp-agent trap life

View

System view

Parameter

seconds: Aging time, in seconds, ranging from 1 to 2,592,000.

Description

Use the snmp-agent trap life command to set aging time for trap messages. The trap messages beyond the aging time are discarded.

Use the undo snmp-agent trap life command to restore the default aging time for trap messages.

By default, the aging time of SNMP trap messages is 120 seconds.

After the specified aging time has elapsed, the system drops the trap message.

Related command: snmp-agent trap enable, and snmp-agent target-host.

Example

# Set the aging time for trap messages as 60 seconds.

<H3C>system-view

System View: return to User View with Ctrl+Z.

[H3C] snmp-agent trap life 60

1.1.19  snmp-agent trap queue-size

Syntax

snmp-agent trap queue-size size

undo snmp-agent trap queue-size

View

System view

Parameter

size: Length of the queue of trap messages, ranging from 1 to 1,000.

Description

Use the snmp-agent trap queue-size command to configure the length of the queue of Trap messages sent to the destination host.

Use the undo snmp-agent trap queue-size command to restore the default value.

By default, the queue length is 100, that is, the queue can hold up to 100 trap messages sent to the destination host.

Related command: snmp-agent trap enable, snmp-agent target-host, and snmp-agent trap life.

Example

# Configure the queue length to 200.

<H3C>system-view

System View: return to User View with Ctrl+Z.

[H3C] snmp-agent trap queue-size 200

1.1.20  snmp-agent trap source

Syntax

snmp-agent trap source { interface-type interface-number }

undo snmp-agent trap source

View

System view

Parameter

interface-type: Interface type.

interface-number: Interface number.

Description

Use the snmp-agent trap source command to configure the source address for sending trap message.

Use the undo snmp-agent trap source command to cancel the source address for sending trap message.

The SNMP trap message sent from a server has a source IP address no matter which interface the trap message is sent from.

By default, SNMP chooses an outgoing interface.

You can configure this command to trace a specific event using the source address of a trap message.

 

&  Note:

Before setting the IP address of an interface as the source address of the sent Trap messages, you must configure an IP address for the interface.

 

Related command: snmp-agent trap enable, and snmp-agent target-host.

Example

# Configure the IP address of VLAN interface 1 as the source address for sending trap messages.

<H3C>system-view

System View: return to User View with Ctrl+Z.

[H3C] snmp-agent trap source Vlan-interface 1

1.1.21  snmp-agent usm-user

Syntax

1)         For SNMPv1 and SNMPv2c

snmp-agent usm-user { v1 | v2c } user-name group-name [ acl acl-number ]

undo snmp-agent usm-user { v1 | v2c } user-name group-name

2)         For SNMPv3

snmp-agent usm-user v3 user-name group-name [ authentication-mode { md5 | sha } auth-password [ privacy-mode des56 priv-password ] ] [ acl acl-number ]

undo snmp-agent usm-user v3 user-name group-name { local | engineid engineid-string }

View

System view

Parameter

v1: Configures to use SNMPv1 security model.

v2c: Configures to use SNMPv2c security model.

v3: Configures to use SNMPv3 security model.

user-name: User name, ranging from 1 to 32 bytes.

group-name: Group name corresponding to that user, ranging from 1 to 32 characters.

authentication-mode: Specifies that authentication is required in the security level. Absence of this parameter indicates that neither authentication nor encryption is performed.

md5: Specifies the authentication protocol as HMAC MD5 algorithm.

sha: Specifies the authentication protocol as HMAC SHA algorithm.

auth-password: Authentication password, a character string of 1 to 64 characters.

privacy-mode: Specifies that encryption is required in the security level.

des56: Specifies the encryption protocol as DES.

priv-password: Encryption password, a character string of 1 to 64 characters.

acl-number: Basic ACL number, ranging from 2000 to 2999.

local: Represents a local entity user.

engineid-string: Engine ID related to the user, ranging from 10 to 64 hexadecimal numerals.

Description

Use the snmp-agent usm-user command to add a new user to an SNMP group.

Use the undo snmp-agent usm-user command to remove a user from the SNMP group.

While using SNMPv3, SNMP engineID is required for authentication when you configure a remote user for an agent. If you change engineID after configuring a user, the user corresponding to the original engineID is not effective.

For SNMPv1 and SNMPv2c, this command will add a new community name. For SNMPv3, it will add a new user to an SNMP group.

Related command: snmp-agent group, snmp-agent community, and snmp-agent local-engineid.

Example

# Add a user named John to the SNMPv3 group Johngroup. Specify that authentication is required and configure to authenticate using HMAC-MD5 algorithm with authentication password being hello.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] snmp-agent group v3 Johngroup

[H3C] snmp-agent usm-user v3 John Johngroup authentication-mode md5 hello

 


Chapter 2  RMON Configuration Commands

2.1  RMON Configuration Commands

2.1.1  display rmon alarm

Syntax

display rmon alarm [entry-number ]

View

Any view

Parameter

entry-number: Alarm entry index, ranging from 1 to 65535. If you do not specify this argument, the configuration information of all alarm entries is displayed.

Description

Use the display rmon alarm command to display the configuration information of a specified alarm entry or all the alarm entries.

Related command: rmon alarm.

Example

# Display the configuration information of all the alarm entries.

<H3C> display rmon alarm

Alarm table 1 owned by abc is VALID.

Samples type          : delta

Variable formula      : 1.3.6.1.2.1.2.2.1.11.67111554<ifInUcastPkts.67111554>

Sampling interval     : 10(sec)

Rising threshold      : 100(linked with event 7)

Falling threshold     : 10(linked with event 8)

  When startup enables  : risingOrFallingAlarm

  Latest value          : 0

Table 2-1 Description on the fields of the display rmon alarm command

Field

Description

Alarm table

Alarm entry

abc

Entry owner

VALID

Alarm entries corresponding to the index are valid.

Samples type

Sample type: delta value or absolute value

Variable formula

Variable formula of the sampled node

Sampling interval

Sampling interval

Rising threshold is 100

Rising threshold is 100

Falling threshold is 10

Falling threshold is 10

When startup enables

Alarm startup type:

risingOrFallingAlarm (an alarm is triggered when the rising or falling threshold is reached)

risingAlarm (an alarm is triggered when the rising threshold is reached)

FallingAlarm (an alarm is triggered when the falling threshold is reached)

Latest value

Latest sampled value

 

2.1.2  display rmon event

Syntax

display rmon event [event-entry ]

View

Any view

Parameter

event-entry: Event entry index, in the range of 1 to 65535. If you do not specify this argument, the configuration information of all the event entries is displayed.

Description

Use the display rmon event command to display the configuration information of a specified RMON event entry or all the RMON event entries.

The displayed information includes: event entry index, event entry owner, event description, the action triggered by the event (log or alarm messages), and the time (in seconds) when the latest event is triggered (in terms of the time elapsed since the system is started/initialized).

Related command: rmon event.

Example

# Display the configuration information of all the event entries.

<H3C> display rmon event

Event table 1 owned by abc is VALID.

  Description: null.

  Will cause log-trap when triggered, last triggered at 0days 00h:02m:27s.

Table 2-2 Description on the fields of the display rmon event command

Field

Description

Event table

Event entries

abc

Entry owner

VALID

The entry corresponding to the index is valid

Description

Event description

Will cause log-trap when triggered

The event triggers logs logging and trap alarms

last triggered at 0days 00h:02m:27s

Time the latest event is triggered

 

2.1.3  display rmon eventlog

Syntax

display rmon eventlog [event-entry ]

View

Any view

Parameter

event-entry: Event entry index, in the range of 1 to 65535. If you do not specify this argument, the log of all the event entries is displayed.

Description

Use the display rmon eventlog command to display the log of a specified event entry or all the event entries.

The displayed RMON event log information includes: the indexes and status of the event entries in the event table, the time (in seconds) when an event log is generated (in terms of the time elapsed since the system is started or initialized), and the event description.

Example

# Display the log generated by the event entry numbered 1.

<H3C> display rmon eventlog 1

Event table 1 owned by abc is VALID.

Generates eventLog 1.1 at 0days 00h:01m:39s.

Description: The 1.3.6.1.2.1.16.1.1.1.4.1 defined in alarm table 1,

less than(or =) 100 with alarm value 0. Alarm sample type is absolute.

Generates eventLog 1.2 at 0days 00h:02m:27s.

Description: The alarm formula defined in private alarm table 1,

less than(or =) 100 with alarm value 0. Alarm sample type is absolute.

Table 2-3 Description on the fields of the display rmon eventlog command

Field

Description

Event table

Event entries

abc

Entry owner

VALID

The status of the line corresponding to the index is valid.

Generates eventLog 1.1 at 0days 00h:01m:39s

Time when the event is triggered. The event may be triggered for several times. 1.1 indicates the time when event 1 is firstly triggered.

Description

Description on an event log

 

2.1.4  display rmon history

Syntax

display rmon history [ interface-type interface-number ]

View

Any view

Parameter

interface-type: Interface type.

interface-number: Interface number.

Description

Use the displ