<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html xmlns:fn="http://www.w3.org/2005/02/xpath-functions">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" href="../../../../doc/otp_doc.css" type="text/css">
<title>Erlang -- Definition of Agent Configuration Files</title>
</head>
<body bgcolor="white" text="#000000" link="#0000ff" vlink="#ff00ff" alink="#ff0000"><div id="container">
<script id="js" type="text/javascript" language="JavaScript" src="../../../../doc/js/flipmenu/flipmenu.js"></script><script id="js2" type="text/javascript" src="../../../../doc/js/erlresolvelinks.js"></script><script language="JavaScript" type="text/javascript">
<!--
function getWinHeight() {
var myHeight = 0;
if( typeof( window.innerHeight ) == 'number' ) {
//Non-IE
myHeight = window.innerHeight;
} else if( document.documentElement && ( document.documentElement.clientWidth ||
document.documentElement.clientHeight ) ) {
//IE 6+ in 'standards compliant mode'
myHeight = document.documentElement.clientHeight;
} else if( document.body && ( document.body.clientWidth || document.body.clientHeight ) ) {
//IE 4 compatible
myHeight = document.body.clientHeight;
}
return myHeight;
}
function setscrollpos() {
var objf=document.getElementById('loadscrollpos');
document.getElementById("leftnav").scrollTop = objf.offsetTop - getWinHeight()/2;
}
function addEvent(obj, evType, fn){
if (obj.addEventListener){
obj.addEventListener(evType, fn, true);
return true;
} else if (obj.attachEvent){
var r = obj.attachEvent("on"+evType, fn);
return r;
} else {
return false;
}
}
addEvent(window, 'load', setscrollpos);
//--></script><div id="leftnav"><div class="innertube">
<img alt="Erlang logo" src="../../../../doc/erlang-logo.png"><br><small><a href="users_guide.html">User's Guide</a><br><a href="index.html">Reference Manual</a><br><a href="release_notes.html">Release Notes</a><br><a href="../pdf/snmp-4.22.1.pdf">PDF</a><br><a href="../../../../doc/index.html">Top</a></small><p><strong>Simple Network Management Protocol (SNMP)</strong><br><strong>User's Guide</strong><br><small>Version 4.22.1</small></p>
<br><a href="javascript:openAllFlips()">Expand All</a><br><a href="javascript:closeAllFlips()">Contract All</a><p><small><strong>Chapters</strong></small></p>
<ul class="flipMenu" imagepath="../../../../doc/js/flipmenu">
<li id="no" title="SNMP Introduction" expanded="false">SNMP Introduction<ul>
<li><a href="snmp_intro.html">
Top of chapter
</a></li>
<li title="Scope and Purpose"><a href="snmp_intro.html#id73205">Scope and Purpose</a></li>
<li title="Prerequisites"><a href="snmp_intro.html#id63280">Prerequisites</a></li>
<li title="Definitions"><a href="snmp_intro.html#id61217">Definitions</a></li>
<li title="About This Manual"><a href="snmp_intro.html#id66265">About This Manual</a></li>
<li title="Where to Find More Information"><a href="snmp_intro.html#id65242">Where to Find More Information</a></li>
</ul>
</li>
<li id="no" title="Agent Functional Description" expanded="false">Agent Functional Description<ul>
<li><a href="snmp_agent_funct_descr.html">
Top of chapter
</a></li>
<li title="Features"><a href="snmp_agent_funct_descr.html#id70043">Features</a></li>
<li title="SNMPv1, SNMPv2 and SNMPv3"><a href="snmp_agent_funct_descr.html#id69677">SNMPv1, SNMPv2 and SNMPv3</a></li>
<li title="Operation"><a href="snmp_agent_funct_descr.html#id71220">Operation</a></li>
<li title="Sub-agents and MIB Loading"><a href="snmp_agent_funct_descr.html#id75292">Sub-agents and MIB Loading</a></li>
<li title="Contexts and Communities"><a href="snmp_agent_funct_descr.html#id74241">Contexts and Communities</a></li>
<li title="Management of the Agent"><a href="snmp_agent_funct_descr.html#id74376">Management of the Agent</a></li>
<li title="Notifications"><a href="snmp_agent_funct_descr.html#id73838">Notifications</a></li>
<li title="Discovery"><a href="snmp_agent_funct_descr.html#id75718">Discovery</a></li>
</ul>
</li>
<li id="no" title="Manager Functional Description" expanded="false">Manager Functional Description<ul>
<li><a href="snmp_manager_funct_descr.html">
Top of chapter
</a></li>
<li title="Features"><a href="snmp_manager_funct_descr.html#id75862">Features</a></li>
<li title="Operation"><a href="snmp_manager_funct_descr.html#id76012">Operation</a></li>
<li title="MIB loading"><a href="snmp_manager_funct_descr.html#id76080">MIB loading</a></li>
</ul>
</li>
<li id="no" title="The MIB Compiler" expanded="false">The MIB Compiler<ul>
<li><a href="snmp_mib_compiler.html">
Top of chapter
</a></li>
<li title="Operation"><a href="snmp_mib_compiler.html#id76200">Operation</a></li>
<li title="Importing MIBs"><a href="snmp_mib_compiler.html#id76263">Importing MIBs</a></li>
<li title="MIB Consistency Checking"><a href="snmp_mib_compiler.html#id76334">MIB Consistency Checking</a></li>
<li title=".hrl File Generation"><a href="snmp_mib_compiler.html#id76371">.hrl File Generation</a></li>
<li title="Emacs Integration"><a href="snmp_mib_compiler.html#id76421">Emacs Integration</a></li>
<li title="Compiling from a Shell or a Makefile"><a href="snmp_mib_compiler.html#id76467">Compiling from a Shell or a Makefile</a></li>
<li title="Deviations from the Standard"><a href="snmp_mib_compiler.html#id76521">Deviations from the Standard</a></li>
</ul>
</li>
<li id="no" title="Running the application" expanded="false">Running the application<ul>
<li><a href="snmp_config.html">
Top of chapter
</a></li>
<li title="Configuring the application"><a href="snmp_config.html#id76778">Configuring the application</a></li>
<li title="Modifying the Configuration Files"><a href="snmp_config.html#id79236">Modifying the Configuration Files</a></li>
<li title="Starting the application"><a href="snmp_config.html#id79327">Starting the application</a></li>
<li title="Debugging the application"><a href="snmp_config.html#id79377">Debugging the application</a></li>
</ul>
</li>
<li id="loadscrollpos" title="Definition of Agent Configuration Files" expanded="true">Definition of Agent Configuration Files<ul>
<li><a href="snmp_agent_config_files.html">
Top of chapter
</a></li>
<li title="Agent Information"><a href="snmp_agent_config_files.html#id79867">Agent Information</a></li>
<li title="Contexts"><a href="snmp_agent_config_files.html#id79944">Contexts</a></li>
<li title="System Information"><a href="snmp_agent_config_files.html#id79997">System Information</a></li>
<li title="Communities"><a href="snmp_agent_config_files.html#id80066">Communities</a></li>
<li title="MIB Views for VACM"><a href="snmp_agent_config_files.html#id80148">MIB Views for VACM</a></li>
<li title="Security data for USM"><a href="snmp_agent_config_files.html#id80387">Security data for USM</a></li>
<li title="Notify Definitions"><a href="snmp_agent_config_files.html#id80603">Notify Definitions</a></li>
<li title="Target Address Definitions"><a href="snmp_agent_config_files.html#id80684">Target Address Definitions</a></li>
<li title="Target Parameters Definitions"><a href="snmp_agent_config_files.html#id80890">Target Parameters Definitions</a></li>
</ul>
</li>
<li id="no" title="Definition of Manager Configuration Files" expanded="false">Definition of Manager Configuration Files<ul>
<li><a href="snmp_manager_config_files.html">
Top of chapter
</a></li>
<li title="Manager Information"><a href="snmp_manager_config_files.html#id81118">Manager Information</a></li>
<li title="Users"><a href="snmp_manager_config_files.html#id81260">Users</a></li>
<li title="Agents"><a href="snmp_manager_config_files.html#id81361">Agents</a></li>
<li title="Security data for USM"><a href="snmp_manager_config_files.html#id81544">Security data for USM</a></li>
</ul>
</li>
<li id="no" title="Agent Implementation Example" expanded="false">Agent Implementation Example<ul>
<li><a href="snmp_impl_example_agent.html">
Top of chapter
</a></li>
<li title="MIB"><a href="snmp_impl_example_agent.html#id81793">MIB</a></li>
<li title="Default Implementation"><a href="snmp_impl_example_agent.html#id81833">Default Implementation</a></li>
<li title="Manual Implementation"><a href="snmp_impl_example_agent.html#id81912">Manual Implementation</a></li>
</ul>
</li>
<li id="no" title="Manager Implementation Example" expanded="false">Manager Implementation Example<ul>
<li><a href="snmp_impl_example_manager.html">
Top of chapter
</a></li>
<li title="The example manager"><a href="snmp_impl_example_manager.html#id82242">The example manager</a></li>
<li title="A simple standard test"><a href="snmp_impl_example_manager.html#id82333">A simple standard test</a></li>
</ul>
</li>
<li id="no" title="Instrumentation Functions" expanded="false">Instrumentation Functions<ul>
<li><a href="snmp_instr_functions.html">
Top of chapter
</a></li>
<li title="Instrumentation Functions"><a href="snmp_instr_functions.html#id82473">Instrumentation Functions</a></li>
<li title="Using the ExtraArgument"><a href="snmp_instr_functions.html#id83088">Using the ExtraArgument</a></li>
<li title="Default Instrumentation"><a href="snmp_instr_functions.html#id83196">Default Instrumentation</a></li>
<li title="Atomic Set"><a href="snmp_instr_functions.html#id83301">Atomic Set</a></li>
</ul>
</li>
<li id="no" title="Definition of Instrumentation Functions" expanded="false">Definition of Instrumentation Functions<ul>
<li><a href="snmp_def_instr_functions.html">
Top of chapter
</a></li>
<li title="Variable Instrumentation"><a href="snmp_def_instr_functions.html#id83474">Variable Instrumentation</a></li>
<li title="Table Instrumentation"><a href="snmp_def_instr_functions.html#id83849">Table Instrumentation</a></li>
</ul>
</li>
<li id="no" title="Definition of Agent Net if" expanded="false">Definition of Agent Net if<ul>
<li><a href="snmp_agent_netif.html">
Top of chapter
</a></li>
<li title="Mandatory Functions"><a href="snmp_agent_netif.html#id84750">Mandatory Functions</a></li>
<li title="Messages"><a href="snmp_agent_netif.html#id84772">Messages</a></li>
</ul>
</li>
<li id="no" title="Definition of Manager Net if" expanded="false">Definition of Manager Net if<ul>
<li><a href="snmp_manager_netif.html">
Top of chapter
</a></li>
<li title="Mandatory Functions"><a href="snmp_manager_netif.html#id85574">Mandatory Functions</a></li>
<li title="Messages"><a href="snmp_manager_netif.html#id85591">Messages</a></li>
</ul>
</li>
<li id="no" title="Audit Trail Log" expanded="false">Audit Trail Log<ul>
<li><a href="snmp_audit_trail_log.html">
Top of chapter
</a></li>
<li title="Agent Logging"><a href="snmp_audit_trail_log.html#id85997">Agent Logging</a></li>
<li title="Manager Logging"><a href="snmp_audit_trail_log.html#id86040">Manager Logging</a></li>
</ul>
</li>
<li id="no" title="Advanced Agent Topics" expanded="false">Advanced Agent Topics<ul>
<li><a href="snmp_advanced_agent.html">
Top of chapter
</a></li>
<li title="When to use a Sub-agent"><a href="snmp_advanced_agent.html#id86186">When to use a Sub-agent</a></li>
<li title="Agent Semantics"><a href="snmp_advanced_agent.html#id86296">Agent Semantics</a></li>
<li title="Sub-agents and Dependencies "><a href="snmp_advanced_agent.html#id86360">Sub-agents and Dependencies </a></li>
<li title="Distributed Tables"><a href="snmp_advanced_agent.html#id86378">Distributed Tables</a></li>
<li title="Fault Tolerance"><a href="snmp_advanced_agent.html#id86434">Fault Tolerance</a></li>
<li title="Using Mnesia Tables as SNMP Tables"><a href="snmp_advanced_agent.html#id86508">Using Mnesia Tables as SNMP Tables</a></li>
<li title="Deviations from the Standard"><a href="snmp_advanced_agent.html#id86786">Deviations from the Standard</a></li>
</ul>
</li>
<li id="no" title="SNMP Appendix A" expanded="false">SNMP Appendix A<ul>
<li><a href="snmp_app_a.html">
Top of chapter
</a></li>
<li title="Appendix A"><a href="snmp_app_a.html#id86932">Appendix A</a></li>
</ul>
</li>
<li id="no" title="SNMP Appendix B" expanded="false">SNMP Appendix B<ul>
<li><a href="snmp_app_b.html">
Top of chapter
</a></li>
<li title="Appendix B"><a href="snmp_app_b.html#id87320">Appendix B</a></li>
</ul>
</li>
</ul>
</div></div>
<div id="content">
<div class="innertube">
<h1>6 Definition of Agent Configuration Files</h1>
<p>All configuration data must be included in configuration files
that are located in the configuration directory. The name of this
directory is given in the <span class="code">config_dir</span> configuration
parameter. These files are read at start-up, and are used to
initialize the SNMPv2-MIB or STANDARD-MIB, SNMP-FRAMEWORK-MIB,
SNMP-MPD-MIB, SNMP-VIEW-BASED-ACM-MIB, SNMP-COMMUNITY-MIB,
SNMP-USER-BASED-SM-MIB, SNMP-TARGET-MIB and SNMP-NOTIFICATION-MIB
(refer to the <span class="bold_code"><a href="snmp_agent_funct_descr.html#management">Management of the Agent</a></span> for a description of the MIBs). </p>
<p>The files are: </p>
<ul>
<li>
<p><span class="code">agent.conf</span>: see
<span class="bold_code"><a href="#agent_information">Agent Information</a></span></p>
</li>
<li>
<p><span class="code">standard.conf</span>: see
<span class="bold_code"><a href="#system_information">System Information</a></span></p>
</li>
<li>
<p><span class="code">context.conf</span>: see
<span class="bold_code"><a href="#context">Contexts</a></span></p>
</li>
<li>
<p><span class="code">community.conf</span>: see
<span class="bold_code"><a href="#community">Communities</a></span></p>
</li>
<li>
<p><span class="code">target_addr.conf</span>: see
<span class="bold_code"><a href="#target_addr">Target Address Definitions</a></span></p>
</li>
<li>
<p><span class="code">target_params.conf</span>: see
<span class="bold_code"><a href="#target_params">Target Parameters Definitions</a></span></p>
</li>
<li>
<p><span class="code">vacm.conf</span>: see
<span class="bold_code"><a href="#vacm">MIB Views for VACM</a></span></p>
</li>
<li>
<p><span class="code">usm.conf</span>: see
<span class="bold_code"><a href="#usm">Security data for USM</a></span></p>
</li>
<li>
<p><span class="code">notify.conf</span>: see
<span class="bold_code"><a href="#notify">Notify Definitions</a></span></p>
</li>
</ul>
<p>The directory where the configuration files are found is given as
a parameter to the agent. </p>
<p>The entry format in all files are Erlang terms, separated by a
'<strong>.</strong>' and a <strong>newline</strong>. In the following sections, the
formats of these terms are described. Comments may be specified as
ordinary Erlang comments. </p>
<p>Syntax errors in these files are discovered and reported with the
function <span class="code">config_err/2</span> of the error report module at start-up. </p>
<h3><a name="id79867">6.1
Agent Information</a></h3>
<a name="agent_information"></a>
<p>The agent information should be stored in a file called
<span class="code">agent.conf</span>.
</p>
<p>Each entry is a tuple of size two:
</p>
<p><span class="code">{AgentVariable, Value}.</span></p>
<ul>
<li>
<span class="code">AgentVariable</span> is one of the variables is
SNMP-FRAMEWORK-MIB or one of the internal variables
<span class="code">intAgentUDPPort</span>, which defines which UDP port the agent
listens to, or <span class="code">intAgentIpAddress</span>, which defines the IP
address of the agent.
</li>
<li>
<span class="code">Value</span> is the value for the variable.
</li>
</ul>
<p>The following example shows a <span class="code">agent.conf</span> file:
</p>
<div class="example"><pre>
{intAgentUDPPort, 4000}.
{intAgentIpAddress,[141,213,11,24]}.
{snmpEngineID, "mbj's engine"}.
{snmpEngineMaxPacketSize, 484}.
</pre></div>
<p>The value of <span class="code">snmpEngineID</span> is a string, which for a
deployed agent should have a very specific structure. See
RFC 2271/2571 for details.
</p>
<h3><a name="id79944">6.2
Contexts</a></h3>
<a name="context"></a>
<p>The context information should be stored in a file called
<span class="code">context.conf</span>. The default context <span class="code">""</span>
need not be present.
</p>
<p>Each row defines a context in the agent. This information is
used in the table <span class="code">vacmContextTable</span> in the
SNMP-VIEW-BASED-ACM-MIB.
</p>
<p>Each entry is a term:
</p>
<p><span class="code">ContextName.</span></p>
<ul>
<li>
<span class="code">ContextName</span> is a string.
</li>
</ul>
<h3><a name="id79997">6.3
System Information</a></h3>
<a name="system_information"></a>
<p>The system information should be stored in a file called
<span class="code">standard.conf</span>.
</p>
<p>Each entry is a tuple of size two:
</p>
<p><span class="code">{SystemVariable, Value}.</span></p>
<ul>
<li>
<span class="code">SystemVariable</span> is one of the variables in the
system group, or <span class="code">snmpEnableAuthenTraps</span>.
</li>
<li>
<span class="code">Value</span> is the value for the variable.
</li>
</ul>
<p>The following example shows a valid <span class="code">standard.conf</span> file:
</p>
<div class="example"><pre>
{sysDescr, "Erlang SNMP agent"}.
{sysObjectID, [1,2,3]}.
{sysContact, "(mbj,eklas)@erlang.ericsson.se"}.
{sysName, "test"}.
{sysServices, 72}.
{snmpEnableAuthenTraps, enabled}.
</pre></div>
<p>A value must be provided for all variables, which lack default
values in the MIB.
</p>
<h3><a name="id80066">6.4
Communities</a></h3>
<a name="community"></a>
<p>The community information should be stored in a file called
<span class="code">community.conf</span>. It must be present if the agent is
configured for SNMPv1 or SNMPv2c.
</p>
<p>An SNMP <strong>community</strong> is a relationship between an SNMP
agent and a set of SNMP managers that defines authentication, access
control and proxy characteristics. </p>
<p>The corresponding table is <span class="code">snmpCommunityTable</span> in the
SNMP-COMMUNITY-MIB. </p>
<p>Each entry is a term: </p>
<p><span class="code">{CommunityIndex, CommunityName, SecurityName, ContextName, TransportTag}.</span></p>
<ul>
<li>
<span class="code">CommunityIndex</span> is a non-empty string.
</li>
<li>
<span class="code">CommunityName</span> is a string.
</li>
<li>
<span class="code">SecurityName</span> is a string.
</li>
<li>
<span class="code">ContextName</span> is a string.
</li>
<li>
<span class="code">TransportTag</span> is a string.
</li>
</ul>
<h3><a name="id80148">6.5
MIB Views for VACM</a></h3>
<a name="vacm"></a>
<p>The information about MIB Views for VACM should be stored in a
file called
<span class="code">vacm.conf</span>.
</p>
<p>The corresponding tables are <span class="code">vacmSecurityToGroupTable</span>,
<span class="code">vacmAccessTable</span> and <span class="code">vacmViewTreeFamilyTable</span> in the
SNMP-VIEW-BASED-ACM-MIB.
</p>
<p>Each entry is one of the terms, one entry corresponds to one
row in one of the tables.
</p>
<p><span class="code">{vacmSecurityToGroup, SecModel, SecName, GroupName}.</span></p>
<p><span class="code">{vacmAccess, GroupName, Prefix, SecModel, SecLevel, Match, ReadView, WriteView, NotifyView}.</span></p>
<p><span class="code">{vacmViewTreeFamily, ViewIndex, ViewSubtree, ViewStatus, ViewMask}.</span></p>
<ul>
<li>
<p><span class="code">SecModel</span> is <span class="code">any</span>, <span class="code">v1</span>, <span class="code">v2c</span>, or
<span class="code">usm</span>.</p>
</li>
<li>
<p><span class="code">SecName</span> is a string.</p>
</li>
<li>
<p><span class="code">GroupName</span> is a string.</p>
</li>
<li>
<p><span class="code">Prefix</span> is a string.</p>
</li>
<li>
<p><span class="code">SecLevel</span> is <span class="code">noAuthNoPriv</span>, <span class="code">authNoPriv</span>,
or <span class="code">authPriv</span></p>
</li>
<li>
<p><span class="code">Match</span> is <span class="code">prefix</span> or <span class="code">exact</span>.</p>
</li>
<li>
<p><span class="code">ReadView</span> is a string.</p>
</li>
<li>
<p><span class="code">WriteView</span> is a string.</p>
</li>
<li>
<p><span class="code">NotifyView</span> is a string.
</p>
</li>
<li>
<p><span class="code">ViewIndex</span> is an integer.</p>
</li>
<li>
<p><span class="code">ViewSubtree</span> is a list of integer.</p>
</li>
<li>
<p><span class="code">ViewStatus</span> is either <span class="code">included</span> or <span class="code">excluded</span></p>
</li>
<li>
<p><span class="code">ViewMask</span> is either <span class="code">null</span> or a list of ones and
zeros. Ones nominate that an exact match is used for this
sub-identifier. Zeros are wild-cards which match any
sub-identifier. If the mask is shorter than the sub-tree, the
tail is regarded as all ones. <span class="code">null</span> is shorthand for a
mask with all ones.</p>
</li>
</ul>
<h3><a name="id80387">6.6
Security data for USM</a></h3>
<a name="usm"></a>
<p>The information about Security data for USM should be stored in a
file called
<span class="code">usm.conf</span>, which must be present if the agent is configured
for SNMPv3.
</p>
<p>The corresponding table is <span class="code">usmUserTable</span> in the
SNMP-USER-BASED-SM-MIB.
</p>
<p>Each entry is a term:
</p>
<p><span class="code">{EngineID, UserName, SecName, Clone, AuthP, AuthKeyC, OwnAuthKeyC, PrivP, PrivKeyC, OwnPrivKeyC, Public, AuthKey, PrivKey}.</span></p>
<ul>
<li>
<p><span class="code">EngineID</span> is a string.
</p>
</li>
<li>
<p><span class="code">UserName</span> is a string.</p>
</li>
<li>
<p><span class="code">SecName</span> is a string.</p>
</li>
<li>
<p><span class="code">Clone</span> is <span class="code">zeroDotZero</span> or a list of integers.</p>
</li>
<li>
<p><span class="code">AuthP</span> is a <span class="code">usmNoAuthProtocol</span>,
<span class="code">usmHMACMD5AuthProtocol</span>, or <span class="code">usmHMACSHAAuthProtocol</span>.</p>
</li>
<li>
<p><span class="code">AuthKeyC</span> is a string.</p>
</li>
<li>
<p><span class="code">OwnAuthKeyC</span> is a string.</p>
</li>
<li>
<p><span class="code">PrivP</span> is a <span class="code">usmNoPrivProtocol</span>,
<span class="code">usmDESPrivProtocol</span> or <span class="code">usmAesCfb128Protocol</span>.</p>
</li>
<li>
<p><span class="code">PrivKeyC</span> is a string.</p>
</li>
<li>
<p><span class="code">OwnPrivKeyC</span> is a string.</p>
</li>
<li>
<p><span class="code">Public</span> is a string.</p>
</li>
<li>
<p><span class="code">AuthKey</span> is a list (of integer). This is the User's secret
localized authentication key. It is not visible in the MIB. The length
of this key needs to be 16 if <span class="code">usmHMACMD5AuthProtocol</span> is used, and
20 if <span class="code">usmHMACSHAAuthProtocol</span> is used.</p>
</li>
<li>
<p><span class="code">PrivKey</span> is a list (of integer). This is the User's secret
localized encryption key. It is not visible in the MIB. The length
of this key needs to be 16 if <span class="code">usmDESPrivProtocol</span> or
<span class="code">usmAesCfb128Protocol</span> is used.
</p>
</li>
</ul>
<h3><a name="id80603">6.7
Notify Definitions</a></h3>
<a name="notify"></a>
<p>The information about Notify Definitions should be stored in a
file called
<span class="code">notify.conf</span>.
</p>
<p>The corresponding table is <span class="code">snmpNotifyTable</span> in the
SNMP-NOTIFICATION-MIB.
</p>
<p>Each entry is a term:
</p>
<p><span class="code">{NotifyName, Tag, Type}.</span></p>
<ul>
<li>
<p><span class="code">NotifyName</span> is a unique non-empty string.
</p>
</li>
<li>
<p><span class="code">Tag</span> is a string.
</p>
</li>
<li>
<p><span class="code">Type</span> is <span class="code">trap</span> or <span class="code">inform</span>.
</p>
</li>
</ul>
<h3><a name="id80684">6.8
Target Address Definitions</a></h3>
<a name="target_addr"></a>
<p>The information about Target Address Definitions should be
stored in a file called <span class="code">target_addr.conf</span>. </p>
<p>The corresponding tables are <span class="code">snmpTargetAddrTable</span> in the
SNMP-TARGET-MIB and <span class="code">snmpTargetAddrExtTable</span> in the
SNMP-COMMUNITY-MIB. </p>
<p>Each entry is a term: </p>
<p><span class="code">{TargetName, Ip, Udp, Timeout, RetryCount, TagList, ParamsName, EngineId}.</span> <br> or <br>
<span class="code">{TargetName, Ip, Udp, Timeout, RetryCount, TagList, ParamsName, EngineId, TMask, MaxMessageSize}.</span> <br> or <br>
<span class="code">{TargetName, Domain, Ip, Udp, Timeout, RetryCount, TagList, ParamsName, EngineId, TMask, MaxMessageSize}.</span></p>
<ul>
<li>
<p><span class="code">TargetName</span> is a unique non-empty string.
</p>
</li>
<li>
<p><span class="code">Domain</span> is one of the atoms:
<span class="code">transportDomainUdpIpv4</span> | <span class="code">transportDomainUdpIpv6</span>. </p>
</li>
<li>
<p><span class="code">Ip</span> is a list of four or eight integers. </p>
</li>
<li>
<p><span class="code">Udp</span> is an integer. </p>
</li>
<li>
<p><span class="code">Timeout</span> is an integer. </p>
</li>
<li>
<p><span class="code">RetryCount</span> is an integer. </p>
</li>
<li>
<p><span class="code">TagList</span> is a string. </p>
</li>
<li>
<p><span class="code">ParamsName</span> is a string. </p>
</li>
<li>
<p><span class="code">EngineId</span> is a string or the atom <span class="code">discovery</span>. </p>
</li>
<li>
<p><span class="code">TMask</span> is a list of integer() of size 0,
size 6 or size 10 (default: []). </p>
</li>
<li>
<p><span class="code">MaxMessageSize</span> is an integer (default: 2048). </p>
</li>
</ul>
<p>Note that if <span class="code">EngineId</span> has the value <span class="code">discovery</span>,
the agent cannot send
<span class="code">inform</span> messages to that manager until it has performed the
<strong>discovery</strong> process with that manager. </p>
<h3><a name="id80890">6.9
Target Parameters Definitions</a></h3>
<a name="target_params"></a>
<p>The information about Target Parameters Definitions should be
stored in a file called <span class="code">target_params.conf</span>. </p>
<p>The corresponding table is <span class="code">snmpTargetParamsTable</span> in the
SNMP-TARGET-MIB. </p>
<p>Each entry is a term: </p>
<p><span class="code">{ParamsName, MPModel, SecurityModel, SecurityName, SecurityLevel}.</span></p>
<ul>
<li>
<p><span class="code">ParamsName</span> is a unique non-empty string.
</p>
</li>
<li>
<p><span class="code">MPModel</span> is <span class="code">v1</span>, <span class="code">v2c</span> or <span class="code">v3</span></p>
</li>
<li>
<p><span class="code">SecurityModel</span> is <span class="code">v1</span>, <span class="code">v2c</span>, or <span class="code">usm</span>.
</p>
</li>
<li>
<p><span class="code">SecurityName</span> is a string.
</p>
</li>
<li>
<p><span class="code">SecurityLevel</span> is <span class="code">noAuthNoPriv</span>, <span class="code">authNoPriv</span>
or <span class="code">authPriv</span>.
</p>
</li>
</ul>
</div>
<div class="footer">
<hr>
<p>Copyright © 1997-2012 Ericsson AB. All Rights Reserved.</p>
</div>
</div>
</div></body>
</html>
