Installatie Eekboek Boekhoudpakket (command line versie)
========================================================

Let op: Dit document gebruikt de ISO-8859.1 (Latin1) tekenset.
Niet-ASCII tekens worden alleen juist getoond indien je programma op
deze tekenset is ingesteld.

Benodigdheden
-------------

Perl5.8.x met DBI (zit standaard in Perl)
PostgreSQL (zit standaard in de meeste Linux systemen)

Perl modules (zelf te installeren):
       DBD::Pg 1.41 of later
       Config::IniFiles
       (Text::CSV_XS voor de Exact importprogramma's)

De volgende Perl modules zijn optioneel, maar worden sterk aangeraden
vanwege de extra functionaliteit:

       Term::ReadLine::Gnu
       HTML::Entities 1.32

Installeren (RPM systemen)
--------------------------

Installeer, indien nodig, de GPG key:

  $ sudo rpm --import http://www.eekboek.nl/fedora/RPM-PGP-KEY-EekBoek

Download de EekBoek-x.yy-z.noarch.rpm.
Verifieer de kit:

  $ rpm -K EekBoek-x.yy-z.noarch.rpm

Let op dat alle verificaties, inclusief gpg, OK zijn.
Installeer:

  $ sudo rpm -Uvh EekBoek-x.yy-z.noarch.rpm

Installeren (Debian systemen)
-----------------------------

Download de EekBoek-x.yy-z.noarch.rpm.

Installeer alien, indien nodig:

  $ sudo apt-get install alien

Dan:

  $ sudo alien -di EekBoek-x.yy-z.noarch.rpm

De -d staat voor "maak een deb aan".
De -i staat voor "installeer hem en verwijder de deb".

Installeren (Windows systemen)
------------------------------

Zie README.WINDOWS.

Bouwen, verifiren en installeren vanaf source
----------------------------------------------

Voor het bouwen en installeren wordt gebruik gemaakt van het
Module::Build framework. Deze wordt vooralsnog met de kit meegeleverd
en hoeft niet afzonderlijk te worden genstalleerd.
BOUW NOOIT ALS ROOT!

Pak de kit uit en cd naar de uitpakdirectory.

  $ tar -zxf EekBoek-x.yy.tar.gz
  $ cd EekBoek-x.yy
  $ perl Build.PL
  $ perl Build

Het verifiren vereist generieke toegang tot een draaiende PostgreSQL
database server, alsmede de mogelijkheid om een database met de naam
'eekboek_sample' aan te maken of te gebruiken. Indien nodig kunnen
daartoe de environment variabelen PGHOST PGPORT en PGUSER worden
toegepast; zie de PostgreSQL documentatie.

  $ perl Build test

Als het niet mogelijk is de database server te benaderen, gebruik dan

  $ Build test --skipdbtests

Zonder een succesvolle afronding van de testprocedure inclusief
database tests heeft het echter weinig zin om verder te gaan.
Raadpleeg in dat geval de .log files en eventueel de mailing list (zie
verderop).

Het is niet nodig om EekBoek te installeren om het te kunnen
gebruiken. Het is dan wel noodzakelijk om de environment variabelen
PERL5LIB en PATH op de juiste wijze op te zetten:

  $ PERL5LIB=<eekboekdir>/blib/lib:$PERL5LIB; export PERL5LIB
  $ PATH=<eekboekdir>/blib/script:$PATH; export PATH

Hierin is <eekboekdir> de plaats waar eerder de make all en make test
is uitgevoerd.

Wil je installeren:

   $ sudo perl Build install

Installatie verwijderen:

   Zoek uit waar de spullen zijn neergezet onder /usr/lib/perl5.
   De gehele directory EB kun je weghalen, evenals EekBoek.pm, EB.pm
   en het programma /usr/bin/ebshell.

Aantekeningen
-------------

* Liefhebbers van RPM kunnen de meeegeleverde EekBoek.spec file
  gebruiken, of een .src.rpm downloaden van de SourceForge site,
  http://sourceforge.net/project/showfiles.php?group_id=154512 .

  Bij het bouwen vanuit de RPM worden de database tests standaard niet
  uitgevoerd. Om ze toch uit te voeren, gebruik

    $ rpmbuild ... --with dbtests ...

* Om EekBoek te kunnen gebruiken moet je de beschikking hebben over
  een PostgreSQL database server en een database. EekBoek kan deze
  database voor je aanmaken, maar dan moet je daartoe bevoegd zijn.
  Dat kun je bereiken met (veronderstel dat je user 'piet' bent):

   $ su 
   # su - postgres
   # createuser -d piet
   # exit
   $ exit

  Raadpleeg anders je systeembeheerder.

  Als je die bevoegdheid niet hebt, vraag dan de systeembeheerder om
  een database voor je aan te maken. De naam van de database moet
  beginnen met "eekboek_", bv. "eekboek_myadmin".

* Voor het uitwisselen van ervaringen, vragen om ondersteuning en zo:
  gebruik de mailing list
  http://lists.sourceforge.net/lists/listinfo/eekboek-users .

ZIE OOK DE ON-LINE DOCUMENTATIE http://www.eekboek.nl/docs/ . 

----------------------------------------------------------------------------
Johan Vromans                                           jvromans@squirrel.nl
Squirrel Consultancy                                  Exloo, the Netherlands
http://www.squirrel.nl                              http://johan.vromans.org
PGP Key 1024D/1298C2B4                  http://johan.vromans.org/pgpkey.html
----------------------- "Arms are made for hugging" ------------------------
