ABCD African Forums
Please Login
Latest topics
» Installation Made it easy
Tue Dec 08, 2015 5:27 am by tadesse

» Localizing ABCD Library management system to Kiswahili!
Fri Jul 10, 2015 3:53 pm by Admin

» ABCD New Version, Whats new?
Wed Jul 01, 2015 3:25 pm by k-swayx

» ABCD Library Information Management System Training Workshop
Wed Jul 01, 2015 12:52 pm by Admin

» ABCD Backup!
Wed Jul 01, 2015 12:50 pm by Admin

» Getting started with ABCD Installation Linux
Wed Jul 01, 2015 12:14 pm by Admin

» All you need to know about ABCD Library management System
Wed Jul 01, 2015 11:56 am by k-swayx

Installation Made it easy

View previous topic View next topic Go down

Installation Made it easy

Post by Admin on Sun Nov 01, 2015 9:53 pm

This manual were written by on of our member from SUA (Sokoine University of Agriculture)

INSTALLATION OF ABCD IN LINUX (Empweb installation not included)

## Prepared by Stephano John - Sokoine National Agricultural Library, with consultation from other ABCD manuals. 

## This file should be opened in Text editor
## Copy and paste will always mean "Copy the command and paste into your computer terminal"

This simplified installation manual of ABCD in Linux, assumes you have a little knowledge on linux, how to open a file, how to create a new file, how to save and how to run a command on a terminal. I also assume you have a computer which is running linux operating system. You can spend few minutes to learn this very basic knowledge from youtube.

1. Install dependencies
#Copy and paste

apt-get install apache2 libapache2-mod-php5 libxml2-dev libapache2-mod-proxy-html libpng12-dev libjpeg62-dev zlib1g-dev libtidy-dev libxslt1-dev curl php5-dev php-pear libyaz-dev php5-gd php5-xmlrpc php5-xsl

2. Installing the Yaz PHP plugin and dependencies. This is for copy cataloguing, if you do not prefer to use Z39.50 facility, then you can skip step 2 and 3, proceed to step 4.

#Copy and paste

a) apt-get install yaz libyaz4-dev php5-dev php-pear php5-xsl make

b) pecl install yaz     (press enter to accept the defaulty option)

3. Create /etc/php5/apache2/conf.d/yaz.ini    (yaz.ini does not exist so you have to create it) and inside it put this content

4. Download the ABCD package for linux (.deb or .tar.gz) from this link ""

Change permissions of the package:
For 32 bits:
chmod 777 abcd_2.0b_i386.deb

For 64 bits:
chmod 777 ABCD_2.0b_amd64.deb

5. Install ABCD

dpkg -i ABCD_2.0b_amd64.deb

6. ABCD Configuration
Configure the virtual host ABCD adding the file with the following contents (change in every case your own specifications):
nano /etc/apache2/sites-available/abcd.conf

#Copy and paste the following content into the file abcd.conf
<VirtualHost *:80>   
#if you have another service running on port 80, then use 9090 inplace of :80
        ServerAdmin webmaster@localhost
        DocumentRoot /opt/ABCD/www/htdocs
        <Directory />
                Options FollowSymLinks
                AllowOverride None
        <Directory /opt/ABCD/www/htdocs>
                Options Indexes FollowSymLinks MultiViews
                AllowOverride None
                Require all granted

ScriptAlias /cgi-bin/ /opt/ABCD/www/cgi-bin/
        <Directory "/opt/ABCD/www/cgi-bin">
                SetHandler cgi-script
                Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
                AddHandler cgi-script .cgi
                AddHandler cgi-script .exe
                Require all granted

        Alias /docs/ "/var/opt/ABCD/bases/"
        <Directory "/var/opt/ABCD/bases/">
                Options Indexes FollowSymLinks MultiViews
                AllowOverride None
                Require all granted

        ErrorLog ${APACHE_LOG_DIR}/error.log

        # Possible values include: debug, info, notice, warn, error, crit,
        # alert, emerg.
        LogLevel warn
#End of VirtualHost

NOTE: Remember to delete the 000-default.conf or disable it on /etc/apache2/sites-available/ also in /etc/apache2/sites-enabled/

7. Create a symbolic link to the public:

#Copy and paste

ln -s /etc/apache2/sites-available/abcd.conf /etc/apache2/sites-enabled/

8.Create a symbolic link of bases while in the directory "/opt/ABCD/www"

#Copy and paste
ln -s /var/opt/ABCD/bases . (note a dot at the end)

9. Make sure that your htdocs-directory has the access rights of '775' (full access except writing to non-members of the owner group) and the bases-directory (/var/opt/ABCD and /opt/ABCD/www/bases_examples) the rights of '777' (full access to everybody).

sudo chmod -R 775 htdocs

sudo chmod -R 777 bases

10. The 'ownership' of the files has to be put to the name under which your Apache is operating, mostly 'www-data', with a command like :

chown -R www-data:www-data ABCD

11. PHP settings and php.ini
ABCD uses PHP throughout with some additional PHP modules make sure your php.ini (/etc/php5/apache2/php.ini) has the extensions mentioned here commented out. If there not there then add them under Linux section.

12. localhost/site or – showing an error
This is an error with file php.ini in /etc/php5/apache2/php.ini 
This error is solved by changing the default short_open_tag=Off

short_open_tag=On  (save and exit), then 

Enable cgi module 

a2enmod cgi (in a terminal)

Then run

$sudo service apache2 restart

13. Change the configuration file ABCD Central module (you may use the IP number intead of the name but only will work if this is a ABCD dedicated server with no more virtual host):

nano /opt/ABCD/www/htdocs/central/config.php

$empwebservicequerylocation = "http://localhost:9090/ewengine/services/EmpwebQueryService";
$empwebservicequerylocation = "http://Name.YourDomain/ewengine/services/EmpwebQueryService";

$empwebservicetranslocation = "http://localhost:9090/ewengine/services/EmpwebTransactionService";
$empwebservicetranslocation = "http://Name.YourDomain/ewengine/services/EmpwebTransactionService";

14. To access the Central module:

http://Name.YourDomain/  e.g

Username: abcd   Password: adm

For Empwerb you are required to install java and MySQL

15. Install java 
apt-get install openjdk-7-jre or apt-get install openjdk-7-jdk

16. Install MySQL 

sudo apt-get install mysql-server
sudo apt-get install mysql-client


Posts : 9
Points : 20
Join date : 2015-06-30

View user profile

Back to top Go down

Re: Installation Made it easy

Post by tadesse on Tue Dec 08, 2015 5:27 am

The manual is very helpful but it is not completed.

Thanks for sharing.

Fresh Spawn
Fresh Spawn

Posts : 1
Points : 1
Join date : 2015-11-17

View user profile

Back to top Go down

View previous topic View next topic Back to top

- Similar topics

Permissions in this forum:
You cannot reply to topics in this forum