Latest topics
Installation Made it easy
2 posters
Page 1 of 1
Installation Made it easy
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
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
Re: Installation Made it easy
Hello,
The manual is very helpful but it is not completed.
Thanks for sharing.
The manual is very helpful but it is not completed.
Thanks for sharing.
tadesse- Fresh Spawn
- Posts : 1
Points : 1
Join date : 2015-11-17
Page 1 of 1
Permissions in this forum:
You cannot reply to topics in this forum
|
|
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