snmp-agent local-engineid

Function

The snmp-agent local-engineid command sets the engine ID of a local SNMP entity.

The undo snmp-agent local-engineid command restores the default engine ID of a local SNMP entity.

Format

snmp-agent local-engineid engineid

undo snmp-agent local-engineid

Parameters

Parameter	Description	Value
engineid	Specifies the character string of engine ID.	The value is a string of 10 to 64 hexadecimal digits and cannot be all zeros or all Fs.

Views

System view

Default Level

3: Management level

Usage Guidelines

By default, the device adopts an internal algorithm to generate an engine ID which is in the format of enterprise number + device information. The device adopts the MAC address of the management interface on the MPU as the device information about the engine ID.

Usage Scenario

Each device managed by the NMS needs only one engine ID to identify an SNMP agent. By default, each device has one engine ID. The network administrator needs to ensure that every engine ID in a domain is unique. Communication between the NMS and SNMP agent can be authenticated and encrypted using this engine ID.

The snmp-agent local-engineid command configures the engine ID of a local SNMP entity. The algorithm for generating the engine ID obeys the following rules:

The first four bytes are hexadecimal private device number that is allocated by Internet Assigned Number Authority (IANA). The device number of Huawei is 2011, being 800007DB in hexadecimal notation. Do not change this number.
The device information is user-defined. It is recommended that the IP or MAC address of a device be used as the device information to uniquely identify the device.

Precautions

The default engine ID is saved in the configuration file. Restarting the device or changing the MPU will not change the engine ID.
If you have set an engine ID using the snmp-agent local-engineid command, the ID is used as the engine ID of the local device.

Example

# Set the engine ID of the local device to 4C1FCCA011E0.

[sysname] snmp-agent local-engineid 4C1FCCA011E0
Warning: All SNMP users will be reset. Continue? [Y/N]:y