< Home

snmp-agent local-engineid

Function

The snmp-agent local-engineid command sets an engine ID for the local SNMP agent.

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

By default, the device uses an internal algorithm to automatically generate an engine ID for a device. The engine ID consists of the enterprise number and the device information.

Format

snmp-agent local-engineid engineid

undo snmp-agent local-engineid

Parameters

Parameter Description Value

engineid

Specifies the engine ID of the local SNMP agent.

The value is string of 10 to 64 hexadecimal digits. It cannot be all 0s or all Fs.

Views

System view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

You can run the snmp-agent local-engineid command to set an engine ID for the local SNMP agent for identification.

The SNMP engine ID uniquely identifies an SNMP agent in a management domain. The SNMP engine ID is an important component of the SNMP agent. It schedules and processes SNMP messages, and implements security authentication and access control. You can use the display snmp-agent local-engineid command to check the engine ID of the local SNMP entity.

When setting an engine ID, you need to comply with the following rules:

  • The length of the octet strings varies. The first four octets are set to the binary equivalent of the agent, which is SNMP management private enterprise number and is assigned by the Internet Assigned Numbers Authority (IANA). The engine ID of Huawei devices is 2011 in decimal notation. The first digit is in binary format, and has a fixed value 1. Therefore, the engine ID in hexadecimal format is 800007DB.

  • The device information can be configured manually. It is recommended that the IP address or MAC address of the device be used as the device information to uniquely identify the device.

Precautions

  • After the SNMP agent function is enabled using the snmp-agent command, the system automatically adopts the default engine ID for the local SNMP agent.
  • If the local engine ID is set or changed, the existing SNMPv3 user with this engine ID is deleted.

Example

# Set the engine ID of the local SNMP agent to 800007DB03360102101100.

<HUAWEI> system-view
[HUAWEI] snmp-agent local-engineid 800007DB03360102101100   
Copyright © Huawei Technologies Co., Ltd.
Copyright © Huawei Technologies Co., Ltd.
< Previous topic Next topic >