Install alerttail

Alerttail is distributed in two ways:

* Binary ubuntu deb i386 package.
* Source gz.

Click here for Alerttail execution info.


Binary Installation:

Debian/Ubuntu:

* Install dependencies:

sudo apt-get install libboost-regex1.34.1

(Enable Universe repositories on /etc/apt/sources.list)
(Note: libboost-regex1.33.1 is supported with source dist not debs )

* Install alerttail:

download alerttail-versionNumber-deb.tar.gz
extract it and then install it and it’s dependencies:

tar zxvf alertTail-versionNumber-deb.tar.gz
cd alertTail-versionNumber-deb
sudo dpkg -i *.deb

Alerttail is now a modular application.
You can add actions as plugins.

If you want  GTK Notify Popup download alerttail-plugin-gnotify_version.deb and type :

sudo apt-get install libnotify1
sudo dpkg -i  alerttail-plugin-gnotify_version.deb

If you want  GeoIp localization download alerttail-plugin-geoip_version.deb and type :

sudo apt-get install libgeoip1
sudo dpkg -i  alerttail-plugin-geoip_version.deb

If modules are not installed you will not  be able to include them as action into alerttail.

* Uninstall alerttail:

sudo dpkg -r alerttail alerttail-plugin-geoip alerttail-plugin-gnotify

Alerttail deb will install:

/usr/local/bin/alertTail which is the executable
/usr/local/etc/alertTail-0.3-example.cfg which is a sample configuration file.


Source Installation:

Alerttail needs the following lib Dependencies:
Core Madatory:

* boost 1_33_1   (or 1_34_1) (smart_ptr, regex) http://www.boost.org/
* libconfig 1.2 (shipped with sources under libs dir)

Optional:

* libnotify 0.4.4 http://www.galago-project.org notification
* geoip 1.3.17 http://www.maxmind.com/app/c

Debian/Ubuntu:

Install a C/C++ compiler
Alerttail has been tested with gcc 4.1.2, on Ubuntu install it with

sudo apt-get install g++
build-essential

* Install dependencies:

Core Libs: (boost)

sudo apt-get install libboost-regex-dev libboost-dev

(Enable Universe repositories)

If you don’t have ubuntu you can download and install manually all the dependencies from the links above.

* Install alerttail:

unpack it with

tar zxvf alerttail-versionNumber.tar.gz
cd to alerttail directory

install libconfig under alertTail libs directory:

cd to alertTail-version/libs
tar zxvf libconfig-1.2.tar.gz
cd
libconfig-1.2 && ./configure && make && make install

Than install alerttail. Go to alertTail-version/ and

./configure && make && sudo make install

alertTail will be installed in /usr/local/bin

*Install GTK Notification popup plugin

Download alertTail_plugin_gnotify-version.tar.gz and extract it.
Then install dependencies:
sudo apt-get install libnotify-dev libgtk2.0-dev
Go to unpacked dir and then install it:

export CXXFLAGS="$CXXFLAGS `pkg-config --cflags gtk+-2.0` `pkg-config --cflags glib-2.0`"

./configure && make && sudo make install
*Install GeoIP localization plugin

Download alertTail_plugin_geoip-version.tar.gz and extract it.
Then install dependencies:
sudo apt-get install libgeoip-dev
Go to unpacked dir and then install it:
./configure && make && sudo make install

Then you have to update shared libraries system cache by typing:

sudo ldconfig
(also check that /etc/ld.so.conf has /usr/local/lib if not add it and then type sudo ldconfig)

Go to alerttail source dir than uninstall it by typing:

sudo make uninstall

Back to top.

Execution:

To execute Alerttail after installing type:
alertTail -c configuration File where -c (or --config) means alerttail configuration file location.type alertTail -h (or --help) to know all command line options.
type man alertTail for man pages
example:
by defaults alerttail will install a sample config file and to /usr/local/etc
Execution will be like: alertTail -c /usr/local/etc/alertTail.cfg
Remember to configure alertTail.cfg before executing it (use alerttailGui!).