Editing Example Cartographer Agent Configuration (section)

== cartographer.xml ==

Here is a basic ''cartographer.xml'' that is included in the Cartographer agent distribution.

<pre>
<?xml version="1.0"?>

<cartographerConfig version="4"
   xmlns="http://xmlns.krupczak.org/xsd/xmpdconfigs-1.0">

<dependencyAgeOutInterval>600</dependencyAgeOutInterval>

<peerAgeOutInterval>1800</peerAgeOutInterval>

<dependencyScanInterval>120</dependencyScanInterval>

<xmpAuthenUser>changeit</xmpAuthenUser>

</cartographerConfig>
</pre>

The configuration file version is 4.  This number should be monotonically increasing.  Cartographer agents will distribute and update this file amongst each other.  To deploy a new configuration file, simply edit a new one and place in the Cartographer home directory (e.g. ''/opt/cartographer'' or ''c:\program files\cartographer'').  The cartographer agent and plugins will periodically stat their config files and re-read them if they have changed and if the version number is greater than the one they previously read and parsed.

The ''<dependencyAgeOutInterval>'' XML element tells Cartographer how long dependencies should remain in its tables, before pruning, if it has not been re-discovered or re-validated.

The ''<peerAgeOutInterval>'' XML element tells Cartographer how long a peer agent should remain in its peer table, before pruning, if it has not been re-discovered or re-validated.

The ''<dependencyScanInterval>'' XML element tells Cartographer how often, in seconds, to wait before searching for dependencies.  120 means to wait two minutes before scanning for dependencies again.  This number represents a tradeoff between CPU utilization and dependency discovery granularity.  The smaller the number, the more often dependencies are searched for but the more CPU the agent consumes.

The ''<xmpAuthenUser>'' XML elements tells the Cartographer agent which XMP authenticated user to use when communicating with other XMP agents.  This value should be specified in the ''xmpd.xml'' configuration file with appropriate permissions.  The Cartographer plugin needs ''GetRequest'', ''SelectTableRequest'', ''Trap'', and ''Information'' protocol operations permission for the ''cartographer'', ''mib2'', and ''core'' MIBs.