snmp-server engineid local

Modifies the default SNMPv3 engine ID.
Syntax
snmp-server engineid local engineid-string
no snmp-server engineid local engineid-string
Command Default

A default engine ID is generated during system startup.

Parameters
engineid-string
Specifies the engine ID as a hexidecimal character string with an even number of characters.
Modes

Global configuration mode

Usage Guidelines

The default engine ID guarantees the uniqueness of the engine ID for SNMP version 3. A default engine ID is generated during system startup. To determine the default engine ID of the device, enter the show snmp engineid command. Use the snmp-server engineid local command to change the default engine ID.

Each user localized key depends on the SNMP server engine ID, so all users must be reconfigured whenever the SNMP server engine ID changes.

Note: Because the current implementation of SNMP version 3 does not support Notification, remote engine IDs cannot be configured at this time.

The engineid-string variable consists of 11 octets, entered as hexadecimal values. There are two hexadecimal characters in each octet. There must be an even number of hexadecimal characters in an engine ID.

The default engine ID has a maximum of 11 octets:

  • Octets 1 through 4 represent the agent's SNMP management private enterprise number as assigned by the Internet Assigned Numbers Authority (IANA). The most significant bit of Octet 1 is "1". For example, "000007c7" is the ID for RUCKUS in hexadecimal. With Octet 1 always equal to "1", the first four octets in the default engine ID is always "800007c7" (which is 1991 in decimal).
  • Octet 5 is always 03 in hexadecimal and indicates that the next set of values represents a MAC address.
  • Octets 6 through 11 form the MAC address of the lowest port in the management module.

The engine ID must be a unique number among the various SNMP engines in the management domain.

The no form of the command sets the engine ID to the default.

Examples

The following example shows how to change the default engine ID.

device# configure terminal
device(config)# snmp-server engineid local 800007c70300e05290ab60