As root:

Install perl, if it isn't already installed.

If you are using PostgreSQL:

Install postgresql 7 (available from http://www.postgresql.org/) and
start postmaster: 

   # /etc/rc.d/init.d/postgresql start

Make sure postmaster will start on boot.  In RedHat Linux you can do
this by typing:

   # chkconfig --add postgresql

In order to install DBD::Pg, you must be able to test the creation of
databases as root, therefore:

If your root shell is bash:

   # export POSTGRES_INCLUDE=/usr/include/pgsql
   # export POSTGRES_LIB=/var/lib/pgsql  

If it is tcsh or csh:

   # setenv POSTGRES_INCLUDE /usr/include/pgsql
   # setenv POSTGRES_LIB /var/lib/pgsql

Then add root to the list of users who can create a postgresql database
(you should delete this as soon as the perl module is installed, as it
can be a security hole):

   # su - postgres
   $ createuser root
   $ exit

Install the Perl modules:

# perl -MCPAN -e shell
> install DBI
> install DBD::Pg
> install Net::Amazon
> install Business::ISBN
> install Getopt::Declare
> quit


Delete root from the list of users who can create a postgresql database
(older version of postgresql use deleteuser instead of dropuser)

   # su - postgresl
   $ dropuser root
   
To use thokbook, give the user you are going to run it as postgres
permissions to create a database:

    $ createuser $user
    $ exit


and as the real user, create a database called thokbook
    
    $ createdb thokbook



If you are using MySQL:

Get the mysql-client and mysql-devel packages from http://www.mysql.com/
and install them.

Make sure mysql will start on boot.  In RedHat Linux you can do this by
typing:

   # chkconfig --add mysql


Grant permissions to the user you will be running thokbook as.  Change
<user>@<host> to whatever your user and host really are:

# mysql -u root -h host
mysql> GRANT ALL PRIVILEGES ON *.* TO <user>@<host>;     
mysql> CREATE DATABASE thokbook;
mysql> \q


Install the perl modules:

# perl -MCPAN -e shell
> install DBI
> install Bundle::DBD::mysql
> install Net::Amazon
> install Business::ISBN
> install Getopt::Declare
> quit


If you do not want to use a database at all (flat files only):

Install the perl modules:

# perl -MCPAN -e shell
> install DBI
> install DBD::CSV
> install Net::Amazon
> install Business::ISBN
> install Getopt::Declare
> quit


If you want to be able to print out your own barcodes, you also have
to install GD::Barcode::EAN13.

Thokbook supports the Cuecat barcode scanner, if Barcode::Cuecat is
installed.

Install Thokbook.pm:

    # perl Makefile.PL
    # make
    # make test
    # make install

If you want to install the module in a directory other than the default:

       perl Makefile.PL PREFIX=/new/path/to/install

If you want to change the database information, re-run the install,
starting from perl Makefile.PL. Or, override the variables in a
.thokbookrc file in your home directory.  See sample-thokbookrc for an
example file.

Then run:

    thokbook init_db

and start adding books!

    thokbook add_book ISBN shelf

Run:
    thokbook --help
to get more information on the options.

If you want to delete the tables in your database and start again:

   thokbook destroy_db

If you want to delete the database itself:

   dropdb thokbook