-
-
Notifications
You must be signed in to change notification settings - Fork 75
Configuration
This section provides guidance to configure Captagent and its core modules on your system.
Understanding of CaptAgent 6 configuration Paths and Structure is key. The following are the default file locations, unless otherwise specified during configuration:
- Configuration:
/usr/local/etc/captagent
- Capture Plans:
/usr/local/etc/captagent/captureplans
- Modules:
/usr/local/lib/captagent/modules
The default directory should contains the following using default settings:
captagent.xml
captureplans/
protocol_rtcp.xml
protocol_sip.xml
socket_pcap.xml
socket_raw.xml
socket_rtcpxr.xml
transport_hep.xml
transport_json.xml
To begin, edit and validate the configuration and the module paths in /usr/local/etc/captagent/captagent.xml
to match your actual captagent config/lib path:
<configuration name="core.conf" description="CORE Settings" serial="2014024212">
<settings>
<param name="debug" value="3"/>
<param name="version" value="2"/>
<param name="serial" value="2014056501"/>
<param name="uuid" value="00781a4a-5b69-11e4-9522-bb79a8fcf0f3"/>
<param name="daemon" value="false"/>
<param name="syslog" value="false"/>
<param name="pid_file" value="/var/run/captagent.pid"/>
<param name="module_path" value="/usr/local/lib/captagent/modules"/>
<param name="config_path" value="/usr/local/etc/captagent"/>
<param name="capture_plans_path" value="/usr/local/etc/captagent/captureplans"/>
<param name="backup" value="/usr/local/etc/captagent/backup"/>
<param name="chroot" value="/var/lib/captagent"/>
</settings>
</configuration>
Transport modules are used by captagent to send packets and reports to collectors using different methods and protocols. By default, the HEP method is activated.
The HEP module is used to define a HEP collector for captured packets, such as HOMER.
The critical parameters are:
- capture-host: defines the IP/hostname of the collector
- capture-port: defines the PORT to deliver HEP packets at the collector
- capture-proto: defines the transport protocol for HEP packets [udp/tcp]
- capture-id: defines a unique delivery HEP-ID to be used for filtering
NOTE: Parameters such as capt-password
and payload-compression
are currently only used in advanced deployments and can be ignored for standard setups.
<?xml version="1.0"?>
<document type="captagent_module/xml">
<module name="transport_hep" description="HEP Protocol" serial="2014010402">
<profile name="hepsocket" description="Transport HEP" enable="true" serial="2014010402">
<settings>
<param name="version" value="3"/>
<param name="capture-host" value="your.homer.ip"/>
<param name="capture-port" value="9060"/>
<param name="capture-proto" value="udp"/>
<param name="capture-id" value="2016"/>
<param name="capture-password" value="myHep"/>
<param name="payload-compression" value="false"/>
</settings>
</profile>
</module>
</document>