EekBoek installeren vanaf source

Voorwaarden voor installatie

Ga na dat Perl geinstalleerd is:

which perl

of

perl -v

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.

Installatie script voor FreeBSD

Op FreeBSD is het alleen mogelijk om de EekBoek installatie vanaf source uit te voeren, waarvoor hieronder een kort script. In dit script worden alle bovenstaande basisstappen gecombineerd en wel voor EekBoek versie 2.00.02:

fetch http://www.eekboek.nl/dl/EekBoek-2.00.02.tar.gz
tar xzf EekBoek-2.00.02.tar.gz
cd EekBoek-2.00.02

pkg_add -r p5-DBI
pkg_add -r p5-DBD-SQLite
pkg_add -r p5-Archive-Zip
pkg_add -r p5-HTML-Parser
pkg_add -r p5-ReadLine-Gnu

perl Build.PL
./Build
./Build test
./Build install

Troubleshooting

• Als de installatie van de dependencies niet wil lukken, controleer dan of de laatste versie van FreeBSD gebruikt wordt: "uname -a" moet een versie van 7.0 of hoger opleveren.
• Commando "ebshell" leidt tot "Command not found": voer bovenstaande stappen nog een keer uit beginnend vanaf "perl Build.PL"; de stap "./Build test" kan hierbij worden overgeslagen.