show
snmp
These commands control access to this switch from Simple Network Management
Protocol (SNMP) management stations, as well as the error types sent to trap
managers.
Use this command to check the status of SNMP communications.
Default Setting
None
Command Mode
Normal Exec, Privileged Exec
Command Usage
This command provides counter information for SNMP operations.
Example
#show snmp
SNMP traps:
Authentication: enable
Link-up-down: enableSNMP communities:
1. private, and the privilege is read-write
2. public, and the privilege is read-only0 SNMP packets input
0 Bad SNMP version errors
0 Unknown community name
0 Illegal operation for community name supplied
0 Encoding errors
0 Number of requested variables
0 Number of altered variables
0 Get-request PDUs
0 Get-next PDUs
0 Set-request PDUs
0 SNMP packets output
0 Too big errors
0 No such name errors
0 Bad values errors
0 General errors
0 Response PDUs
0 Trap PDUsConsole#SNMP logging: disabled
#
Use this command to define the community access string for the Simple Network Management Protocol. Use the no form to remove the specified community string.
Syntax
snmp-server community string [ro|rw]
no snmp-server community string
- string - Community string that acts like a password and permits access to the SNMP protocol. (Maximum length: 32 characters, case sensitive)
- ro - Specifies read-only access. Authorized management stations are only able to retrieve MIB objects.
- rw - Specifies read-write access. Authorized management stations are able to both retrieve and modify MIB objects.
Default Setting
public - read-only access. Authorized management stations are only able to retrieve MIB objects.
Command Mode
Global Configuration
Command Usage
The first snmp-server community command you enter enables SNMP (SNMPv1).
Example
(config)#snmp-server community private rw
(config)#
Use this command to set the system contact string. Use the no form to
remove the system contact information.
Syntax
snmp-server contact string
no snmp-server contactstring - String that describes the system contact information. (Maximum length: 255 characters)
Default Setting
None
Command Mode
Global Configuration
Example
(config)#snmp-server contact Paul
(config)#
Related Commands
Use this command to set the system location string. Use the no form
to remove the location string.
Syntax
snmp-server location text
no snmp-server location
text - String that describes the system location. (Maximum length: 255 characters)
Default Setting
None
Command Mode
Global Configuration
Example
(config)#snmp-server location WC-19
(config)#
Related Commands
Use this command to specify the recipient of a SNMP notification operation.
Use the no form to remove the specified host.
Syntax
snmp-server host host-addr community-string
no snmp-server host host-addr
- host-addr - Name or Internet address of the host (the targeted recipient).
- community-string - Password-like community string sent with the notification operation. Though you can set this string using the snmp-server host command by itself, we recommend you define this string using the snmp-server community command prior to using the snmp-server host command. (Maximum length: 32 characters, case sensitive)
Default Setting
None
Command Mode
Global Configuration
Command Usage
If you do not enter an snmp-server host command, no notifications are sent. In order to configure the switch to send SNMP notifications, you must enter at least one snmp-server host command. In order to enable multiple hosts, you must issue a separate snmp-server host command for each host
The snmp-server host command is used in conjunction with the snmp-server enable traps command. Use the snmp-server enable traps command to specify which SNMP notifications are sent globally. For a host to receive notifications, at least one snmp-server enable traps command and the snmp-server host command for that host must be enabled.
However, some notification types cannot be controlled with the snmp-server enable traps command. For example, some notification types are always enabled.
Example
(config)#snmp-server host 10.1.19.23 batman
(config)#
Related Commands
Use this command to enable the switch to send SNMP traps or informs (SNMP notifications).
Use the no form to disable SNMP notifications.
Syntax
snmp-server enable traps [authentication | link-up-down]
no snmp-server enable traps [authentication | link-up-down]
- authentication - Keyword to issue authentication failure traps.
- link-up-down - Keyword to issue link-up or link-down traps.
NOTE: The link-up-down trap can only be enabled/disabled via the CLI.
Default Setting
Issue all traps.
Command Mode
Global Configuration
Command Usage
If you do not enter an snmp-server enable traps command, no notifications controlled by this command are sent. In order to configure this device to send SNMP notifications, you must enter at least one snmp-server enable traps command. If you enter the command with no keywords, all notification types are enabled. If you enter the command with a keyword, only the notification type related to that keyword is enabled.
The snmp-server enable traps command is used in conjunction with the snmp-server host command. Use the snmp-server host command to specify which host or hosts receive SNMP notifications. In order to send notifications, you must configure at least one snmp-server host command.
The notification types used in this command all have an associated MIB object that allows them to be globally enabled or disabled. Not all of the notification types have notificationEnable MIB objects, so some of these cannot be controlled using the snmp-server enable traps command.
Example
(config)#snmp-server enable traps link-up-down
(config)#
Related Commands
