ABCD African Forums
Please Login

Join the forum, it's quick and easy

ABCD African Forums
Please Login
ABCD African Forums
Would you like to react to this message? Create an account in a few clicks or log in to continue.
Latest topics
» Installation Made it easy
Installation Made it easy  EmptyTue Dec 08, 2015 5:27 am by tadesse

» Localizing ABCD Library management system to Kiswahili!
Installation Made it easy  EmptyFri Jul 10, 2015 3:53 pm by Admin

» ABCD New Version, Whats new?
Installation Made it easy  EmptyWed Jul 01, 2015 3:25 pm by k-swayx

» ABCD Library Information Management System Training Workshop
Installation Made it easy  EmptyWed Jul 01, 2015 12:52 pm by Admin

» ABCD Backup!
Installation Made it easy  EmptyWed Jul 01, 2015 12:50 pm by Admin

» Getting started with ABCD Installation Linux
Installation Made it easy  EmptyWed Jul 01, 2015 12:14 pm by Admin

» All you need to know about ABCD Library management System
Installation Made it easy  EmptyWed Jul 01, 2015 11:56 am by k-swayx


Installation Made it easy

2 posters

Go down

Installation Made it easy  Empty Installation Made it easy

Post by Admin 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

https://abcdafrica.board-directory.net

Back to top Go down

Installation Made it easy  Empty Re: Installation Made it easy

Post by tadesse 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

Back to top Go down

Back to top

- Similar topics

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