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.
##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.propertiescp /usr/local/vufind/import/marc_local.properties /usr/local/vufind/local/import/
b.Add following line in the file,
id = 999c, first
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 VuFindcd /usr/local/vufind
./import-marc.sh koha.mrc
Installation of prerequisite applications 1. Java Development Kit (JDK)
2. PostgreSQL Database
3. DSpace Software
4. Apache Ant (Pure Java Build Tool)
5. Apache Maven (Apache Build Automation Tool for Java Projects)
6. Apache Tomcat (Web Server for hosting Dspace)
Open Applications > Accessories > Terminal and execute following commands.sudo su apt-get update apt-get upgrade apt-get install openjdk-8-jdk postgresql ant maven
Create the database user
sudo su postgres
createuser -U postgres -d -A -P dspace
Enter password for new role: [Enter a password e.g. dspace]
Shall the new role be allowed to create more new roles? (y/n) n
[Enter n and press enter button]
Type exit
Allow the database user (dspace) to connect to the database
[If the following command not open, check the postgresql version number and apply in the command]
sudo gedit /etc/postgresql/12/main/pg_hba.conf
Add this line to the configuration file at the end:
local all dspace md5 save and close the file
Restart PostgreSQL : sudo su /etc/init.d/postgresql restart
Create Dspace user
sudo useradd -m dspace sudo passwd dspace[enter a password for the new user dspace] sudo mkdir /dspace sudo chown dspace /dspace Create the PostgreSQL 'dspace' database sudo -u dspace createdb -U dspace -E UNICODE dspace
Login to the database as a superuser, and enable the pgcrypto
extension on this database
sudo su postgres psql --username=postgres dspace -c "CREATE EXTENSION pgcrypto;"
exit
sudo /etc/init.d/postgresql restart Create Dspace directory sudo mkdir /build sudo chmod -R 777 /build cd /build Download Dsapce to /build directory Copy paste following line in the terminal, wget https://github.com/DSpace/DSpace/releases/download/dspace-6.3/dspace-6.3-src-release.tar.gz You can find latest version from this pageand copy the link to download latest version. Extracting Dspace package tar -zxf dspace-6.3-src-release.tar.gz cd /build/dspace-6.3-src-release
Open the pom.xml file and remove the following code
Rename folder "apache-tomcat-8.0.37" to "tomcat" mv apache-tomcat-8.0.37 tomcat Delete the package file from/optfolder
rm apache-tomcat-8.0.37.tar.gz Open following file,
gedit /etc/profile
Setup environment variables
Environment variables to find JAVA. Add following lines at the bottom of the file, export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64 export CATALINA_HOME=/opt/tomcat Copy Dspace webapps files to Tomcat folder
sudo cp -r /dspace/webapps/* /opt/tomcat/webapps
Running Tomcat automatically You can set up to start the Tomcat server start automatically at the time of system turn on.
Open following file in a Terminal,
gedit/etc/init.d/tomcat
Add following lines in the file,
#!/bin/bash ### BEGIN INIT INFO # Provides: tomcat7 # Required-Start: $network # Required-Stop: $network # Default-Start: 2 3 4 5 # Default-Stop: 0 1 6 # Short-Description: Start/Stop Tomcat server ### END INIT INFO
PATH=/sbin:/bin:/usr/sbin:/usr/bin
start() { sh /opt/tomcat/bin/startup.sh }
stop() { sh /opt/tomcat/bin/shutdown.sh }
case $1 in start|stop) $1;; restart) stop; start;; *) echo "Run as $0 <start|stop|restart>"; exit 1;; esac
Start Tomcat server, service tomcat start Now you can start and stop Tomcat server using following commands; service tomcat start service tomcat stop service tomcat restart Make an initial administrator account (an e-person) in DSpace: Apply following command in a terminal, sudo /dspace/bin/dspace create-administrator
It will ask to enter email address for user login. Enter an email address (e.g. dspace@localhost). Enter First name and surename (e.g. dspace) Enter a password.
Inorder to avoid buil error during maven package running please follow
may be the version of java will be openjdk-11.. you may pls change it. by executing following command.
update-alternatives --config javaand select openjdk-8 as default.probably 2nd one will be openjdk-8 then re-run maven. will be successful.
Now we have to copy the inout directory into OPAC htdocs directory. Open the terminal into
Home directory and apply the following commands.
sudo su sudo mv /home/inout /usr/share/koha/opac/htdocs cd /usr/share/koha/opac/htdocs chmod 777 -R inout
Setup the database:
Open the terminal and apply the following commands. sudo su mysql -uroot -p [Enter MySQL Root password] create database lib; grant all privileges on lib.* to 'root'@'localhost' identified by 'kohalib'; flush privileges;
Quit;
Replace your password in the file dbconn.php located in ‘inout’ directory at the line number 3.
copy the database inout.sql (/inout/DB/inout.sql) to the lib.sql
Sudo mysql -uroot -p lib < usr/share/koha/opac/htdocs/inout/DB/inout.sql
You have to change default session time in php.ini file.
To Open the file.
sudo nano /etc/php/5.6/apache2/php.ini
[Enter password]
A text editor will open. To find variable session.gc_maxlifetime Press Ctrl + W and paste this variable then press ENTER.
It'll find the session.gc_maxlifetime.In front of that the default value is 1440 second that is 24 Minutes.
Change this value to 7200 that is 2 hours.
After changing values Press Ctrl + O then ENTER. It'll save the file. Then exit by Pressing Ctrl + X.
PDF is not working on some systems
In the LAN pdf generator is not working. PDF generator are using the
directory "cache" present in the "inout" directory. This directory
should have full access/permission. Follow the steps to give permission.
Open terminal in inout directory and type following commands.