SNMP system commands

snmp

Syntax

snmp

Context

config>system

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context configure SNMP parameters.

engineID

Syntax

[no] engineID engine-id

Context

config>system>snmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command sets the SNMP engineID to uniquely identify the SNMPv3 node. By default, the engineID is generated using information from the system backplane.

If SNMP engine ID is changed in the config>system>snmp>engineID context, the current configuration must be saved and a reboot must be executed. If not, the previously configured SNMP communities and logger trap-target notify communities are not valid for the new engine ID.

Note:

In conformance with IETF standard RFC 2274, User-based Security Model (USM) for version 3 of the Simple Network Management Protocol (SNMPv3), hashing algorithms which generate SNMPv3 MD5 or SHA security digest keys use the engineID. Changing the SNMP engineID invalidates all SNMPv3 MD5 and SHA security digest keys and may render the node unmanageable.

When a chassis is replaced, use the engine ID of the first system and configure it in the new system to preserve SNMPv3 security keys. This allows management stations to use their existing authentication keys for the new system.

Ensure that the engine IDs are not used on multiple systems. A management domain can only have one instance of each engineID.

The no form of this command reverts to the default.

Default

the engine ID is system generated

Parameters

engine-id

Specifies an identifier from 10 to 64 hexadecimal digits (5 to 32 octet number), uniquely identifying this SNMPv3 node. This string is used to access this node from a remote host with SNMPv3.

general-port

Syntax

general-port port-number

no general-port

Context

config>system>snmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the port number used by this node to receive SNMP request messages and to send replies. SNMP notifications generated by the agent are sent from the port specified in the config log snmp-trap-group trap-target command.

The no form of this command reverts to the default value.

Default

161

Parameters

port-number

Specifies the port number used to send SNMP traffic other than traps.

Values

1 to 65535 (decimal)

packet-size

Syntax

packet-size bytes

no packet-size

Context

config>system>snmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the maximum SNMP packet size generated by this node. If the packet size exceeds the MTU size of the egress interface the packet is fragmented.

The no form of this command reverts to the default value.

Default

1500

Parameters

bytes

Specifies the SNMP packet size, in bytes.

Values

484 to 9216

shutdown

Syntax

[no] shutdown

Context

config>system>snmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command administratively disables SNMP agent operations. System management can then only be performed using the command line interface (CLI). Shutting down SNMP does not remove or change configuration parameters other than the administrative state. This command does not prevent the agent from sending SNMP notifications to any configured SNMP trap destinations. SNMP trap destinations are configured under the config>log>snmp-trap-group context.

This command is automatically invoked in the event of a reboot when the processing of the configuration file fails to complete or when an SNMP persistent index file fails while the bof persist on command is enabled.

The no form of this command administratively enables SNMP.

Default

no shutdown