Difference between revisions of "Example Cartographer Agent Configuration"

Revision as of 11:37, 29 October 2012

What are the configuration files?

Cartographer agents are configured using several configuration files, all in XML format.

The configuration files are:

• xmpd.xml - Agent engine configuration settings
• cartographer.pem - Agent certificate authority keys
• appdata.xml - Cartographer plugin data file storing application data
• connectiondata.xml - Cartographer plugin data file storing connection data
• cartographer.xml - Cartographer plugin configuration settings
• cartographer-local.xml - Local, system-specific Cartographer-plugin configuration directives

Validating your configuration Files

An XML schema file defining Cartographer agent configuration files can be found here. To check the correctness of your config files, we suggest you use the xmllint utility included in the libxml2 software distribution.

% xmllint --noout --schema http://xmlns.krupczak.org/xsd/xmpdconfigs-1.0.xsd your-config.xml

xmpd.xml

Here is a basic xmpd.xml file that comes with the agent install.

<?xml version="1.0"?>

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

<xmpd_trace>0</xmpd_trace>
<xmpd_verbose>0</xmpd_verbose>
<xmpd_daemon>0</xmpd_daemon>
<xmpd_eventageoutinterval>300</xmpd_eventageoutinterval>
<xmpd_defaultmanager>system</xmpd_defaultmanager>
<xmpd_autoupgrade>true</xmpd_autoupgrade>

<xmpd_authenuser>
<user>changeit</user>
<protocol_ops>all</protocol_ops>
<mibs>cartographer,mib2,core</mibs>
</xmpd_authenuser>

<xmpd_authenuser>
<user>public</user>
<protocol_ops>Response GetRequest SelectTableRequest Trap Information</protocol_ops>
<mibs>all</mibs>
</xmpd_authenuser>

</xmpd_config>

cartographer.xml

cartographer-local.xml

• <cartographerLocal version="1"> </cartographerLocal> XML element identifies the configuration file and its version. Agents distribute and read newer versions. Version numbers should be monotonically increasing integers.

• The <system name="hostname"> </system> XML element delimits configuration directives for the specified system. You can place multiple system elements in the cartographer-local.xml configuration file. Hostname can be a FQDN or partial.

• • dependency -- you can add static dependencies via this configuration directive. This directive is helpful if you have a known dependency that Cartographer is not able to discover. Configuring dependencies this way ensures that they included in Cartographer's intelligence algorithms.

• • logfileDependency -- Cartographer can discover dependencies by scanning logfiles using regular expressions and adding dependencies when matches occur.

• • logfileMonitor -- Cartographer can scan logfiles for regular expressions and send XMP events when matches occur.

appdata.xml

connectiondata.xml