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

extension=yaz.so


4. Download the ABCD package for linux (.deb or .tar.gz) from this link "http://abcd.netcat.be/files/downloads.html"


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
        ServerName 127.0.0.1
        DocumentRoot /opt/ABCD/www/htdocs
        <Directory />
                Options FollowSymLinks
                AllowOverride None
        </Directory>
        <Directory /opt/ABCD/www/htdocs>
                Options Indexes FollowSymLinks MultiViews
                AllowOverride None
                Require all granted
        </Directory>

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
        </Directory>

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

        ErrorLog ${APACHE_LOG_DIR}/error.log

        # Possible values include: debug, info, notice, warn, error, crit,
        # alert, emerg.
        LogLevel warn
</VirtualHost>
#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.

extension=msql.so

        extension=php_mysqli.so

        extension=pdo_mysql.so

        extension=propro.so

        extension=raphf.so

        extension=yaz.so

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

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

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

14. To access the Central module:

http://Name.YourDomain/  e.g 127.0.0.1

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

Admin
Admin

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

View user profile http://abcdafrica.forumotion.org

Back to top Go down

Re: Installation Made it easy

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

Hello,
The manual is very helpful but it is not completed.

Thanks for sharing.

tadesse
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