-=( How to install Buscador )=-

It's a slightly involved process at the moment. This will change.

1) Download the tar ball

from

http://cvs.simon-cozens.org/viewcvs.cgi/buscador/?cvsroot=Email

and unpack it in a web accessible directory.

2) Install the prerequisites.

You can check by running

% perl Makefile.PL

Consider making a Bundle::Buscador for us. Or a PAR archive or something.

There are quite a lot.

Part of the problem, and the reason why you'll get bizarre requests to install GD, Graphviz, XML::Writer and Spreadsheet::ParseExcel is because Email::Store uses Class::DBI::DATA::Schema which uses SQL::Translator which has insane dependencies. Complain to the authors of SQL::Translator not us.

http://rt.cpan.org/NoAuth/Bug.html?id=7004

Some users have said they've had test errors from

Class::DBI::AsForm
Apache::Request
Mail::ListDetector
Email::MIME

we're harassing authors where appropriate as we speak.

3) Add in the Apache Config

I added this into my virtual host config

<Location /buscador> 

        PerlSetEnv PERL5LIB /virtual/thegestalt.org/www/html/buscador/demo
        PerlHandler Buscador
        #PerlInitHandler Apache::StatINC

</Location>

StatINC allows me to develop without restarting Apache every time.

4) Initialise the directory

Change to

/virtual/thegestalt.org/www/html/buscador/demo

(or wherever you put in step 3) and run

% buscador -init

Which will copy a load of template files and create a buscador.config file.

5) Edit the config file

Mine looks like

uri = http://thegestalt.org/buscador/demo image_uri = http://thegestalt.org/buscador/images dsn = dbi:SQLite2:email.db

I keep my image files in a seperate place because it's faster.

6) Set up the DB

Simply be in your Buscador directory and do

% buscador -setup

the buscador command line tool will automatically pick up the details from your buscador.config file.

7) Import mails

Again, be in your buscador directory and do

% buscador <folder[s]>

and it will import. You can also cat a single mail into it which is useful for setting up as an alias.

8) Restart apache

Err, that should be it.