Welcome to the Clara-Collector Wiki!

In this Wiki we'll demonstrate how to use the new modified collector from snowplow, our main goal is to add some features such as :

• Enabling an in-Box SSL support.
• Enabling a local id-matching by asking any maping plateform.
• Encapsulate all in a configuration file.

A new folder is added to the project "CollectorLaunch" , it contains scripts to configure automaticly the collector.

• conf_iptables : to put some rules on iptables (port opening,forwarding ..) specially for EC2 instances that are protected by default firewall layers.
• get_ip.sh: this script allows to put the right ip adress to the configuration file. this adress is used (with a port) to bind correctly a listener on this interface:port adress.
• ssl_script.sh : this script reads the configuration file, extract ssl-related values, and access SslConfiguration Class to make some initializations.
• collectorLauncher : Is the main and the launcher script.

Getting started

First off, we need to extract the content of "CollectorLaunch" folder in the root folder -(Scala Sream Collector main entry). Then, we must indicate some values in the configuration file :

###Any redirection for id Maping ? redirect{ # Boolean value (true/false) allow-redirect = false path-to-redirect = "" redirect-id = "" }

###If we enabled the ssl-encryption option, we must provide a certificate in the JKS format, with its passwords

certificate{
    file-password = ""
    path-to-certificate = ""
    keystore-password = ""
}

The ssl-encryption option is located at the end of the configuration file, at the spray.can.server section

  ssl-encryption = off