EekBoek installeren vanaf source

Voorwaarden voor installatie

Ga na dat Perl geinstalleerd is:

which perl

of

perl -v

Dit laatste commando levert een versie nummer op, iets als het volgende:

This is perl, v5.8.9

EekBoek draait alleen op versie 5.8 of hoger.

Instructies

Open een terminal applicatie en ga naar de directory waarin EekBoek kan worden gedownload, bijvoorbeeld /usr/home of /usr/Downloads of simpelweg ~. Voer vervolgens de volgende commando's uit in de shell. Voor X.YY.ZZ gebruikt u uiteraard het versie nummer, bijvoorbeeld 2.00.01:

wget http://www.eekboek.nl/dl/EekBoek-X.YY.ZZ.tar.gz
tar xzvf EekBoek-X.YY.ZZ.tar.gz
cd EekBoek-X.YY.ZZ
perl Build.PL

Het uitvoeren van het laatste commando levert waarschijnlijk een lijst op van ontbrekende dependencies, software-pakketten die EekBoek nodig heeft en nog niet zijn geïnstalleerd op het systeem. Deze dependencies moeten daarom nu eerst worden geïnstalleerd volgens de bij deze pakketten behorende instructies (zie onder). Daarna keert u terug naar de directory waar EekBoek is uitgepakt en probeert u nogmaals:

perl Build.PL

Als het goed is worden geen meldingen meer gegeven over ontbrekende dependencies. U kunt nu verder gaan met:

./Build
./Build test

Als de test succesvol is verlopen, kan EekBoek worden geïnstalleerd. Daartoe moet het onderstaande commando als super user (root) worden uitgevoerd. In dit voorbeeld gebruiken we daarvoor het sudo commando:

sudo ./Build install

Als alles verder goed gaat zijn de EekBoek commando's ebshell en ebwxshell geïnstalleerd en klaar om uitgevoerd te worden.

Let op! De EekBoek programma's zijn weliswaar op het systeem geïnstalleerd maar alleen nog uitvoerbaar vanuit een terminal window. Het verdient daarom aanbeveling een desktop icon (starter) te maken voor het ebwxshell programma zodat u dit programma straks op een gemakkelijke manier kunt opstarten.

Installatie dependencies

Zoals hierboven aangegeven omvat de installatie vanaf source meer instructies dan hierboven aangegeven, omdat ook de dependencies moeten worden geinstalleerd. Typische voorbeelden van dependencies die moeten worden geinstalleerd zijn hieronder weergegeven. Deze dependencies kunnen alleen door een super user (root) worden geinstalleerd (sudo voor Linux, su voor FreeBSD):

perl -MCPAN -e "install DBI"
perl -MCPAN -e "install DBD::SQLite"
perl -MCPAN -e "install qw(Archive::Zip)"
perl -MCPAN -e "install HTML::Entities"
perl -MCPAN -e "install Term::ReadLine::Gnu"

Voor de goede orde, de bovenstaande commando's hoeven niet als script te worden uitgevoerd. Uitsluitend die regels moeten worden uitgevoerd, welke corresponderen met een niet-geinstalleerde dependency.