Horizontal Navigation

Tuesday 20 June 2017

Install Vufind for Library Discovery Service in Ubuntu 16.04

1. Install Apache HTTP Server

The following lines accomplish three things: the first line installs Apache, the second line turns on the URL rewriting module required by VuFind, and the third line restarts the server to activate the newly-installed module.
(i) Install the Apache web server for communication between VuFind and web browsers.
Use following command:
sudo apt-get install apache2
(ii)rewriting module required by VuFind. Use following command:
sudo a2enmod rewrite
(iii)Restart the Apache server to activate the newly-installed module. 
Use following command:
sudo /etc/init.d/apache2 restart

2. Install MySQL

VuFind uses the MySQL database for storing user comments, tags and other information. To install MySQL Server, use the following command:
sudo apt-get install mysql-server
Note: During installation, you will be prompted for a MySQL root password. Remember this password

3. Install PHP

Use the following command:
sudo apt-get install libapache2-mod-php php-mbstring php-pear php php-dev php-gd php-intl php-json php-ldap php-mcrypt php-mysql php-xml

4. Install the Java JDK

Then install JDK (the Java Development Kit) on the server – VuFind's searching back-end and MARC indexing tools rely on Java.
sudo apt-get install default-jdk

5. Download VuFind:

Use the following command:
(i) cd /tmp
(ii) wget http://downloads.sourceforge.net/vufind/vufind-3.1.3.tar.gz?use_mirror=osdn -O vufind-3.1.3.tar.gz
(iv) tar xzvf vufind-3.1.3.tar.gz
(iv) sudo mv vufind-3.1.3 /usr/local/vufind

6. Install VuFind

Use the following command for installing VuFind:
(i) cd /usr/local/vufind
(ii) php install.php

You should also set some permissions to allow Apache to write configuration and cache files to disk:
(iii) sudo chown -R www-data:www-data /usr/local/vufind/local/cache
(iv) sudo chown -R www-data:www-data /usr/local/vufind/local/config
If you plan to use VuFind's command line tools, you also need a separate cache for that:
(v) mkdir /usr/local/vufind/local/cache/cli
(vi) sudo chmod 777 /usr/local/vufind/local/cache/cli

Apache needs to have some extra VuFind settings loaded. Run this command to make Apache aware of VuFind's configuration file:
(i) sudo ln -s /usr/local/vufind/local/httpd-vufind.conf /etc/apache2/conf-enabled/vufind.conf
Apache needs to be restarted so the changes can take effect:
(ii) sudo /etc/init.d/apache2 reload

8. Set Up Environment Variables

Run the following commands in terminal for setting up Environment Variables:
sudo sh -c 'echo export JAVA_HOME=\"/usr/lib/jvm/default-java\" > /etc/profile.d/vufind.sh'
sudo sh -c 'echo export VUFIND_HOME=\"/usr/local/vufind\"  >> /etc/profile.d/vufind.sh'
sudo sh -c 'echo export VUFIND_LOCAL_DIR=\"/usr/local/vufind/local\"  >> /etc/profile.d/vufind.sh'
Then to make it executable/effect, run the following command:
source /etc/profile.d/vufind.sh

9. Final Configuration

(i) Start Sol: To start VuFind's Solr index, use the following command:
cd /usr/local/vufind/
./solr.sh start

(ii) Configure VuFind: 

Open a web browser, and browse to this URL: 

http://localhost/vufind/Install/Home

Then Enjoy Discovery Service using VuFind.

Reference:
https://vufind.org/wiki/installation:ubuntu

Koha Installation in Ubuntu 16.04 Desktop/Server

Installation of Koha on Ubuntu 16.04

Koha can install on Ubuntu/Xubuntu/Kubuntu/Lubuntu. Use the following steps for the installation of Koha on Ubuntu 16.04 LTS
Step 1: Install Ubuntu 16.04 LTS
Open Terminal by: Applications -> Accessories -> Terminal
   
Step 2: Update the system (Ubuntu 16.04 LTS) using following commands:

(i)  sudo su (Enter Sudo Password)
(ii) apt-get update
(iii)apt-get upgrade

Step 3: Add Koha community repository and Add Koha software channel into Ubuntu.

 (i)
echo deb http://debian.koha-community.org/koha stable main | sudo tee /etc/apt/sources.list.d/koha.list
 
(ii) wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

(iii)apt-get update
Step 4: Install Koha
Use the following command for the installation of latest release of Koha.

sudo apt-get install koha-common
The command will start to download Koha and required packages.
On the way, the process will ask to enter mail of system. Accept the default values.
Step 5: Server configuration
Now you need to edit the network information like domain name and port numbers. Use the following command

sudo gedit /etc/koha/koha-sites.conf

Here I change port number of Koha staff client to 8000. Find following line in the file and make changes.     

INTRAPORT="8000"

Step 6: Install MySQL/MariaDB server
Apply following command to install MySQL server.

sudo apt-get install mariadb-server 
OR,
sudo apt-get install mysql-server (If installed this, then follow Step 9 to make it useful)

Give a new password for root user while installation.

Step 7: Koha instance creation
 
Apply following commands to create Apache configuration files.

(i)   sudo a2enmod rewrite
(ii)  sudo a2enmod cgi
(iii) sudo service apache2 restart


Step 8: Create a Koha instance with the name library.

sudo koha-create --create-db library


Step 9: Change MySQL Configuration file (*If you installed MySQL server):
Insert the following lines of code in your /etc/mysql/mysql.conf.d/mysqld.cnf in the [mysqld] section: 
(i) Use following command to open the file:
sudo gedit /etc/mysql/mysql.conf.d/mysqld.cnf
(ii) Add the following line of code in the [mysqld] section:
sql_mode=IGNORE_SPACE,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,
NO_ENGINE_SUBSTITUTION
Then save and close the file.
(iv)Restart MySQL Server by using the following command in terminal:
/etc/init.d/mysql restart

Step 10: Adding ports
I have assigned 8000 port for Koha staff client and 80 for OPAC.
Open following file and add new port.

(i) sudo gedit /etc/apache2/ports.conf

(ii) Then copy & paste following line below Listen 80

Listen 8000

(iii) Restart Apache server by using following command

sudo service apache2 restart

Step 11: Enable modules and sites by using following commands

(i)  sudo a2dissite 000-default
(ii) sudo a2enmod deflate
(iii)sudo a2ensite library
(iv) sudo service apache2 restart


Step 12: Change Koha default master password. Please follow two sub-steps.
 
Sub-step 1: First change the password of koha_library database.
(i) sudo su
         
[enter the Linux Root password]

(ii) mysql -uroot -p  
           [enter the MySQL Root password]

(iii) use mysql;
(iv)  SET PASSWORD FOR 'koha_library'@'localhost' = PASSWORD('koha123');
(v) flush privileges;
(vi) quit;

Sub-step 2: Then put new password in /etc/koha/sites/library/koha-conf.xml file. To open the said file, use the command given below.

(i) sudo gedit /etc/koha/sites/library/koha-conf.xml 
(ii)  Then find the line using ctrl+f and  see by replacing default password with koha123. Please see: " <pass>koha123</pass>"

Step 13: Now start Koha by opening the following links in browser

Start the Apache server by using the following command:
sudo service apache2 restart
 

Then Open browser and use the following URL:
http://localhost:8000 (Staff client). Then complete web installer steps.
http://localhost:80 (Online Public Access Catalogue)