发现代理程序定义文件关键字

在线编辑

发现代理程序定义文件关键字用于定义发现代理程序的操作。

DiscoAgentClass

DiscoAgentClass 关键字指定代理程序的基本类型。 下表标识了最常用的值:

值 描述
0 指定 IP 类型代理程序。
1 指定交换机类型代理程序。
2 指定中心类型代理程序。
3 指定 ATM 设备类型代理程序。
4 指定 FDDI 类型代理程序。
5 指定 PVC 类型代理程序。
6 指定帧中继类型代理程序。
8 指定 NAT 网关代理程序。

以下示例显示了设置为帧中继类型代理程序的 DiscoAgentClass 关键字。 帧中继类型代理程序通常在包含特定网络设备 (例如， CISCO 设备) 的帧中继网络上发现两个点之间的帧中继接口和连接。

DiscoCompiledAgent
{
.
.
.
DiscoAgentClass( 6 );
.
.
.
}

DiscoAgentClassEnabledByDefault

DiscoAgentClassEnabledByDefault 关键字指定缺省情况下是否为完全发现启用代理程序。 请指定下列其中一个值：

值 描述
0 指定缺省情况下未针对完全发现启用代理程序。
1 指定缺省情况下为完全发现启用代理程序。

以下示例显示了 DiscoAgentClassEnabledByDefault 关键字集，缺省情况下，此关键字集用于对完全发现启用帧中继类型代理程序。

DiscoCompiledAgent
{
.
.
.
DiscoAgentClass( 6 );
.
.
.
DiscoAgentEnabledByDefault( 1 );
}

DiscoAgentClassEnabledByDefaultOnPartial

DiscoAgentClassEnabledByDefaultOnPartial 关键字指定缺省情况下是否对部分发现启用代理程序。 请指定下列其中一个值：

值 描述
0 指定缺省情况下未对部分发现启用代理程序。
1 指定缺省情况下对部分发现启用代理程序。

以下示例显示了 DiscoAgentClassEnabledByDefaultOnPartial 关键字集，缺省情况下，此关键字集用于对部分发现启用帧中继类型代理程序。

DiscoCompiledAgent
{
.
.
.
DiscoAgentClass( 6 );
.
.
.
DiscoAgentEnabledByDefaultOnPartial( 1 );
DiscoAgentEnabledByDefault( 1 );
}

DiscoAgentIsIndirect

直接代理程序返回有关它在其处理的层上直接连接到的对象的关系数据。 间接代理程序返回有关其间接连接到的对象的关系数据。 最常见的间接代理程序是交换机代理程序。 间接代理程序的远程邻居记录与可以从特定端口 (而不是从它们直接连接到的设备) 访问的设备相关。 需要来自间接代理程序的关系数据来确定在设备更改时需要重新发现设备的哪些远程邻居记录。

DiscoAgentIsIndirect 关键字指定代理程序是否为间接代理程序，该代理程序返回有关其间接连接到的对象的关系数据。 请指定下列其中一个值：

值 描述
0 指定代理程序是直接代理程序。
1 指定代理程序是间接代理程序。

以下示例显示了用于指定帧中继类型代理是直接代理的 DiscoAgentIsIndirect 关键字集。

DiscoCompiledAgent
{
.
.
.
DiscoAgentGUILocked( 0 );
DiscoAgentClass( 6 );
DiscoAgentIsIndirect( 0 );
.
.
.
DiscoAgentEnabledByDefaultOnPartial( 1 );
DiscoAgentEnabledByDefault( 1 );
}

DiscoAgentCompanionAgents

DiscoAgentCompanionAgents 关键字用于在 GUI 中显示应与此代理程序一起执行的一个或多个代理程序。

以下示例显示了一个 DiscoAgentCompanionAgents 关键字，该关键字在 GUI 中显示应与 Centillion Networks 代理程序一起执行的代理程序 (ArpCache.agnt)。

DiscoCompiledAgent
{
.
.
.
-- This agent examines all devices originally made by Centillion
-- Networks (enterprise OID 1.3.6.1.4.1.930), to see if it can
-- discover them.
.
.
.

DiscoAgentCompanionAgents( "ArpCache" );
.
.
.
}

DiscoAgentCompletionPhase

DiscoAgentCompletionPhase 关键字指定指定的代理程序应该在哪些发现阶段完成执行。 请指定下列其中一个值：

值 描述
1 指定代理程序应在发现阶段 1 期间完成执行。
2 指定代理程序应在发现阶段 2 期间完成执行。
3 指定代理程序应在发现阶段 3 期间完成执行。

以下示例显示 DiscoAgentCompletionPhase 关键字集以允许帧中继类型代理程序在发现阶段期间完成执行 1。

DiscoCompiledAgent
{
.
.
.
DiscoAgentCompletionPhase( 1 );
.
.
.
DiscoAgentEnabledByDefaultOnPartial( 1 );
DiscoAgentEnabledByDefault( 1 );
}

DiscoAgentConflictingAgents

DiscoAgentConflictingAgents 关键字用于在 GUI 中显示不应与此代理程序一起执行的一个或多个代理程序。

以下示例显示了 DiscoAgentConflictingAgents 关键字，该关键字在 GUI 中显示不应与 IP 备份路由代理一起执行的代理程序 (IpRoutingTable.agnt 和 IpForwardingTable.agnt)。

DiscoCompiledAgent
{
.
.
.
-- This agent examines every device with SNMP access to see if it
-- can discover it.
.
.

DiscoAgentConflictingAgents( "IpRoutingTable","IpForwardingTable" );
.
.
.
}

DiscoAgentDescription

DiscoAgentDescription 关键字指定 GUI 中显示的代理程序的描述。

以下示例显示了 DiscoAgentDescription 关键字，该关键字指定要在 GUI 中显示的帧中继类型代理程序的描述。 描述使用 HTML 编码。

DiscoCompiledAgent
{
.
.
.
DiscoAgentDescription("
<b>Agent Name :</b>  CiscoFrameRelay<br>
<br>
<b>Agent Type :</b> Layer 3<br>
<br>
<b>Agent Prerequisites :</b>  SNMP helper configuration for associated devices.<br>
<br>
<b>Operation :</b><br>
Discovers Frame Relay interfaces and connections between two points on Frame Relay
networks that incorporate Cisco devices. If you need to add DLCI information to the
interfaces of Frame Relay devices, then run Frame Relay agents in conjunction with
the IP layer agents.<br>
<br>
	");
.
.
.
}

DiscoAgentMinCertifiedDeviceOS

DiscoAgentMinCertifiedDeviceOS 关键字指定特定于设备操作系统的过滤器。 可以将此过滤器配置为针对设备操作系统的特定发行版运行指定的代理程序。

以下示例显示了 DiscoAgentMinCertifiedDeviceOS 关键字，该关键字为发现来自 CISCO 路由器的 MPLS VRF ， VPN 和标签切换信息的代理程序指定特定于设备操作系统的过滤器。 此特定于设备操作的过滤器将代理程序配置为针对以下 CISCO 设备和关联的操作系统发行版运行:

  • m_ObjectId -指定代理程序尝试发现的 CISCO 设备 (OID 1.3.6.1.4.1.9)。
  • m_OSVersion -指定 CISCO 设备操作系统过滤器，该过滤器将代理程序配置为针对以下设备操作系统版本运行:
    • 非试验性 12.0(27) 或更高版本的 12.0 发行版
    • 12.2(19) 或更高版本的 12.2 发行版不是试验性发行版
    • 非试验性的 12.3 发行版 12.3(18) 或更高版本
    • 12.4 发行版
DiscoCompiledAgent
{
.
.
.
DiscoAgentMinCertifiedDeviceOS
    (
      "(
          m_ObjectId LIKE '1\.3\.6\.1\.4\.1\.9\.',
          m_OSVersion >= '12.0(27)' AND m_OSVersion < '12.1' AND m_OSVersion 
                         NOT LIKE '.*Experimental.*',
          m_MibVar = 'sysDescr.0'
        ),
        (
          m_ObjectId LIKE '1\.3\.6\.1\.4\.1\.9\.',
          m_OSVersion >= '12.2(19)' AND m_OSVersion < '12.3' AND m_OSVersion 
                         NOT LIKE '.*Experimental.*',
          m_MibVar = 'sysDescr.0'
        ),
      (
          m_ObjectId LIKE '1\.3\.6\.1\.4\.1\.9\.',
          m_OSVersion >= '12.3(18)' AND m_OSVersion < '12.4' AND m_OSVersion 
                         NOT LIKE '.*Experimental.*',
          m_MibVar = 'sysDescr.0'
       ),
      (
          m_ObjectId LIKE '1\.3\.6\.1\.4\.1\.9\.',
          m_OSVersion >= '12.4',
          m_MibVar = 'sysDescr.0'
        )"
    );
.
.
.
}

DiscoAgentPrecedence

DiscoAgentPrecedence 关键字指定当来自两个代理程序的数据有冲突时，哪个代理程序优先。 指定大于或等于 0 (零) 的值。 建议的值范围从 1 到 100 ，其中数字越大，优先顺序越高。 优先顺序越高，代理程序数据越正确。 例如，如果给定来自优先顺序 2 代理程序和优先顺序 3 代理程序的冲突数据，那么将使用优先顺序 3 代理程序数据。

以下示例显示了设置为优先顺序 2 的帧中继类型代理程序的 DiscoAgentPrecedence 关键字。

DiscoCompiledAgent
{
.
.
.
DiscoAgentGUILocked( 0 );
DiscoAgentClass( 6 );
DiscoAgentIsIndirect( 0 );
DiscoAgentPrecedence( 2 );
.
.
.
DiscoAgentEnabledByDefaultOnPartial( 1 );
DiscoAgentEnabledByDefault( 1 );
}

DiscoPerlAgent

DiscoPerlAgent 关键字指定此 .agnt 文件是否引用 Perl 代理程序。

以下示例显示为基于 Perl 的代理程序指定的 DiscoPerlAgent 关键字，该代理程序抽取有关在设备上运行的操作系统的信息。

DiscoPerlAgent
{
.
.
.
DiscoAgentGUILocked( 0 );
	DiscoAgentClass( 0 );
	DiscoAgentIsIndirect( 0 );
	DiscoAgentPrecedence( 2 );
	DiscoAgentEnabledByDefaultOnPartial( 0 );
	DiscoAgentEnabledByDefault( 0 );
}