Installation of VuFind on Ubuntu 14.04

VuFind is an Open Source Discovery software. You can connect various resources (ILS, databases, Digital Library) to VuFind and facilitate single interface for users to search among resources.

1. Update Ubuntu 14.04

sudo apt-get update
sudo apt-get upgrade
apt-get install leafpad

2. Install Apache server

sudo apt-get install apache2
sudo a2enmod rewrite
sudo /etc/init.d/apache2 restart

3. Install MySQL server

apt-get install mysql-server

Give a password for MySQL root user. Note down the password.

4. Install PHP
VuFind written using PHP programming language. Install PHP and necessary components.

sudo apt-get install php5 php5-dev php-pear php5-json php5-ldap php5-mcrypt php5-mysql php5-xsl php5-intl php5-gd

5. Install JAVA JDK

sudo apt-get install default-jdk

6. Download VuFind
Go to https://sourceforge.net/projects/vufind/ and download latest version of VuFind (e.g. vufind-3.0.2.tar.gz.

Unzip the package (Right click on the package and select "Extract here". Otherwise apply following command in a terminal. Notice the version number; it will change when new version release.


e.g. tar xzvf vufind-3.0.2.tar.gz

Move the folder to /usr/local/vufind (Notice the version number in following command)

sudo mv vufind-3.0.2 /usr/local/vufind

7. Install VuFind

cd /usr/local/vufind
php install.php

8. Permission to Apache to write configuration files

sudo chown -R www-data:www-data /usr/local/vufind/local/cache
sudo chown -R www-data:www-data /usr/local/vufind/local/config

9. Create cache for command line tools

mkdir /usr/local/vufind/local/cache/cli
sudo chmod 777 /usr/local/vufind/local/cache/cli

10. Link VuFind to Apache

sudo ln -s /usr/local/vufind/local/httpd-vufind.conf /etc/apache2/conf-enabled/vufind.conf

sudo /etc/init.d/apache2 restart

11. Setup 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'

12. Load the environment manually

source /etc/profile.d/vufind.sh

13. Start Solr

VuFind using Solr search engine.

cd /usr/local/vufind/
./solr.sh start

14. Enable mcrypt

sudo php5enmod mcrypt
sudo service apache2 restart


15. Autostart Solr
Users have to start Solr manually every time system on. Enable Solr auto start to avoid it.

Open Applications > Accessories > Terminal and open a new file;

sudo leafpad /etc/init.d/vufind

Copy paste the following lines to the file.

#!/bin/sh
### BEGIN INIT INFO
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Description: VuFind init script
### END INIT INFO
export VUFIND_HOME=/usr/local/vufind
cd /usr/local/vufind
./solr.sh $*

Make the script executable

chmod +x /etc/init.d/vufind

Add the script to the Ubuntu startup

update-rc.d vufind defaults

You can start and stop the Solr using the following commands;

service vufind start
service vufind stop
service vufind restart
service vufind check


If you find that VuFind search not working, restart Solr using the command, service vufind start

16. VuFind post installation configuration

http://127.0.1.1/vufind/Install/Home

The screen will show various items. Some items may show "“Failed” with “Fix”. Click on fix button. You will get directions about how to fix the problems.

After fixing all problems, you can open VuFind at http://127.0.1.1/vufind


References
https://vufind.org/wiki/installation:ubuntu
https://vufind.org/wiki/administration:starting_and_stopping_solr

5 comments:

  1. You just created a room and forgot to leave a space for the door to enter in..!

    ReplyDelete
  2. A server running Ubuntu 14.04
    Solr required following steps to properly install

    Step 1 — Installing the Dependencies

    Before we download and install Composer, we need to make sure our server has all dependencies installed.

    First, update the package manager cache by running:
    sudo apt-get install curl php5-cli git

    curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

    To test your installation, run:
    composer

    ReplyDelete