VuFind Installation on Ubuntu and Koha integration

VuFind

     VuFind is a library resource portal designed and developed for libraries by libraries. The goal of VuFind is to enable your users to search and browse through all of your library's resources by replacing the traditional OPAC.

It is assumed that koha is already installed in your  system. Otherwise you need to follow some more steps.

 

 

I. Install php

   sudo apt-get -y install libapache2-mod-php php-mbstring php-pear php php-dev php-gd php-intl php-json php-ldap php-mysql php-xml php-soap 

II. Installation of Vufind

a. Download vufind

sudo su

 cd /tmp

wget https://github.com/vufind-org/vufind/releases/download/v7.0.1/vufind_7.0.1.deb

sudo dpkg -i vufind_7.0.1.deb

sudo mv vufind-7.0.1 /usr/local/vufind 

b. Install vufind

cd /usr/local/vufind

php install.php

##set some permissions to allow Apache to write configuration and cache files to disk: 

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

Note: (not mandatory) If you plan to use VuFind's command line tools, you also need a separate cache for that

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

c. Linking with Apache and setting up environment variables

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

sudo /etc/init.d/apache2 reload 

##Settingup environment variable

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' 

d. final configuration

##After creating the file, you must load it manually for the changes to take effect without forcing you to log out and back in again:

source /etc/profile.d/vufind.sh 

III.Configuring and Starting VuFind

a. Start Solr

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

b. Open a web browser, and browse

http://your-server-name/vufind/Install/Home

Note: If you don't want to have to manually start and stop Solr every time you
 turn on or shut down your server, you can set it up to run 
automatically. 

edit the file

sudo gedit /etc/init.d/vufind 

 copy and paste the following line 

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

then, Make the script executable

chmod +x /etc/init.d/vufind

Add the script to the Ubuntu startup

update-rc.d vufind defaults

Solr commands

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

 

IV. Connecting koha with vufind

a. Indexing Koha with VuFind

Copy your marc_local.properties

cp /usr/local/vufind/import/marc_local.properties /usr/local/vufind/local/import/ 

b. Add following line in the file,

        id = 999c, first

$ sudo gedit /usr/local/vufind/local/import/marc_local.properties

      #collection = "collection"
       institution = "My University"
      #building = "Library A"
       id = 999c, first 

 
c. set driver for koha

$sudo gedit /usr/local/vufind/local/config/vufind/config.ini 

Make sure that following lines in the file, 

 [Catalog]

driver = "Koha" 

d. change koha connection set up

$sudo gedit /usr/local/vufind/local/config/vufind/Koha.ini

[Catalog]
host        = localhost
port        = 3306
username    = mysqluser
password    = mysqlpass
database    = koha_database
url         = http://library.myuniversity.edu/
[Location_Codes]
AV          = "Audio Visual"
CART        = "Book Cart"
CHILD       = "Children's Area"
DISPLAY     = "On Display"
FIC         = "Fiction"
GEN         = "General Stacks" 

Note:The Koha username may not be the MySQL root user.  It is safest to have 
an alternate user for such things.  This MySQL user needs to have access
 to the Koha database.
The MySQL password should be the MySQL password that corresponds to the 
MySQL username.  If you want to test this, from the command line you can
 run: 

$mysql -u [mysqluser] -p [kohadatabase] 
 

e. Export MARC record

Open Koha Go to Tool > Export Data 
koha.mrc will be downloaded

Import into VuFind

cd /usr/local/vufind
./import-marc.sh koha.mrc 

 

f. Restart solr

cd /usr/local/vufind/

./solr.sh status