-=( 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.