INSTALLATION
============

Using CPAN Interactive shell
----------------------------

    % perl -MCPAN -e shell
    cpan> install CGI::Session

Using Makefile.PL
--------------------

    % perl Makefile.PL
    % make
    % make test
    % make install

If you don't have proper permissions to perform system-wide 
installations you can install CGI::Session to your private 
PERL5LIB folder:

    % perl Makefile.PL LIB=~/perllib
    % make
    % make test
    % make install

Above set of commands install CGI::Session to your ~/perllib folder.

TESTING
========

You are encouraged to run tests for the backend you will be using. 
The database backends that need a customized connection string won't 
run by default. To run them, some environment variables must be set.

The simplest method is to use the standard "DBI_DSN" environment variable 
to define a DBI connection string. Otherwise, you can set these variables 
as well:

For PostgreSQL:
    CGISESS_PGSQL_DSN
    CGISESS_PGSQL_USER
    CGISESS_PGSQL_PASSWORD

For MySQL:
    CGISESS_MYSQL_DSN
    CGISESS_MYSQL_USER
    CGISESS_MYSQL_PASSWORD
    CGISESS_MYSQL_SOCKET