HowTo  

Introduction

This HowTo will help you to set FluidRecords, and search your bandersnatch logged messages.

Details

Assumed

We assume that you got a Debian System, a server with MySQL with the logged messages by bandersnatch, and server with LDAP.

At this point you need to identified this settings:

AUTHORIZED_USERS	List of user that can authenticate at FluidRecords
LDAP_HOST	Hostname or ip of the ldap server
LDAP_BASE	Base dn to search user for authentication
LDAP_ATTR	Attribute that has the identification of the user (Ex. uid, cn)
MYSQL_HOST	Hostname or ip of the db server in which bandersnatch log the jabber messagges
MYSQL_DBNAME	Database name where the messages are logged
MYSQL_USER	Username with right permissions at MYSQL_DBNAME
MYSQL_PASSWD	Password of MYSQL_USER

And the minimal settings needed for django, like:

dbengine	'postgresql_psycopg2', 'postgresql', 'mysql', 'sqlite3' or 'ado_mssql'.
dbname	Or path to database file if using sqlite3.
dbuser	Not used with sqlite3.
dbpassword	Not used with sqlite3.
dbhost	Set to empty string for localhost. Not used with sqlite3.
dbport	Set to empty string for default. Not used with sqlite3.

1. First download and install the fluidrecords package:

dpkg -i fluidrecords_0.2-_amd64.deb It would ask for some dependences.

2. Then edit /etc/fluidrecords/config. You can leave the django section, it will use sqlite as default.

3. run fluidrecords-manage syncdb This run the django manage.py. It will ask for root user, answer no.

4. You can test the application running fluidrecords-manage runserver and open some browser and search for: http://localhost:8000/viewer/.

5. If you want to run it with apache, in /usr/share/doc/fluidrecords/examples/apache2 it's a file with the settings, put this file in sites-availabel and try it. Read the apache2 documentation.