Adding users to the security file

The install_dir\dtx.security file defines the local SNMP engine and the users that are authorized to the SNMP Agent.
localEngineID
A hexadecimal string identifying the local SNMP engine.
localEngineBoots
The number of times the local engine will boot. The SNMP Agent uses this value to evaluate the timeliness of SNMP requests.
userEntry
The SNMPv3 local engine ID, user name, and optional security information. Include a userEntry keyword for each user that is authorized to the SNMP Agent.
The userEntry keyword can include the following variables:
localEngineID
A hexadecimal string identifying the local SNMP engine. This parameter is required.
user_name
An SNMPv3 user that is authorized to the SNMP Agent. SNMPv3 users are defined in the dtx.uacl file. This parameter is required.
security_name
A text string used to authenticate communication between the SNMP Agent and the SNMP manager. This parameter is optional.
authentication_algorithm
One of the following algorithms. This parameter is optional.
  • usmHMACMD5AuthProtocol
  • usmHMACSHAAuthProtocol
  • usmNoAuthProtocol
authentication_key
A text password or hexadecimal key that conforms to the requirements of the authentication algorithm. This parameter is optional.
privacy_algorithm
One of the following. This parameter is optional. If omitted, the default value is usmNoPrivProtocol.
  • usmDESPrivProtocol
  • usmNoPrivProtocol
privacy_key
A text password or hexadecimal key. If you provide a hexadecimal key, it must be a localized key.

For more information about generating the engine ID and the optional userEntry parameters, see the Java™ Dynamic Management Kit product documentation.

  1. In a text editor, open the install_dir\dtx.security file.
  2. Add the following and replace variables with actual values: 
    {
localEngineID = engine_ID
localEngineBoots = number_of_boots
userEntry = localEngineID,user_name,security_name,authentication_algorithm,
authentication_key,privacy_algorithm,privacy_key
}
  3. Save the file.