Installation

This will be migrated to the Trac Wiki

This installation document is setup for a Linux server. It has only been tested on Linux but should work on Windows.

I. Requirements

Apache HTTP Server 2.2 or later
PHP 5.1.0 or later
MySQL 4.1 or later
Java J2SE JDK 1.4 or later
YAZ 3.0 or later
GNU Aspell Library (

II. Installation Procedure

1. Install Apache HTTP Server
http://httpd.apache.org/docs/2.2/install.html
Ensure that mod_rewrite is included in the build

  • You will need to add the web directory as an accessible directory by the web server.
  • The web/interface/cache and web/interface/compile directories will also need to be owned by the web server.

2. Install MySQL

Most Linux distributions already have MySQL as a part of the distribution, but if you do not have it installed you can easily download from the following url:


http://mysql.org/downloads/mysql/5.0.html#downloads

3. Install PHP with following requirements:
--with-pear
--with-ldap
--with-mysql
--with-xsl
--with-pspell
--with-pdo-oci=instantclient,/path/to/oci,10.2.0.2 *

The --with-pdo-oci is at this point only used for Voyager libraries.
The --with-pspell is used for spelling correction and can be optional.
The --with-ldap is used for ldap authenitication. If you do not use LDAP, this can be ignored.

4. Install the Java JDK
http://java.sun.com/javase/downloads/

5. Install the YAZ library
http://www.indexdata.dk/yaz/

6. Create a user that will run vufind and define the JAVA_HOME
environment variable for that user.

7. Run the install script

The install script will attempt to setup the mysql database and install necessary libraries.

%> ./install

8. Edit configuration files

The web/conf/config.ini should be modified to match your system settings.
The web/.htaccess only requires the change of the RewriteBase field.

9. Start the VuFind Server

You can run the VuFind server by 2 methods. You can either start the server by running the startup script: 

    %> ./vufind.sh start
You can also run the server as a daemon. To do so just create a symbolic link into your /etc/init.d directory. You will then need to add the script to your init scripts. 
    On Redhat: chkconfig --add vufind
    On Debian: update-rc.d vufind defaults


10. Import BIB records into SOLR using the import script

The data directory defined in the config.ini file should be owned by the user that is running the import script.
The import script will create files in this directory.

By using the YAZ Marcdump utility, create a marcxml file from your bib records:
%> yaz-marcdump -f MARC-8 -t UTF-8 -o marcxml records.marc > catalog.xml

Copy the MarcXML file into the import directory and make sure it is named catalog.xml.
Then simply run the import/import-solr.php script from the command line:
%> php import-solr.php

11. Configure HTML Templates

For more information on customizing the UI of VuFind - visit the Customization Page.

* Steps to install PHP with PDO-OCI support:

  1. Download the Basic.zip and SDK.zip from the Oracle Instant Client web site
  2. Unzip the 2 zip files in the same directory
  3. Move the instantclient directory to somewhere on your server (/usr/local/lib is generally the place to put it)
  4. Create a symbolic link from the libclntsh.so.11.1 (or whatever version you have) to libclntsh.so as well as the same for libocci.so..
  5. Configure PHP with the option '--with-pdo-oci=instantclient,/usr/local/lib/instantclient,11.1.0.1'
    You may need to change the configure option to match the path that you have installed the instantclient to as well as the version that you downloaded

Releases

Downloads
Visit the download page for the latest version of VuFind.
History
For a chronology of VuFind releases and features, see the change log.
Getting Started
Our documentation will help you get started with installation and upgrading from previous versions.
Help!
Need help? Have a general question? You'll find answers in several forms on the support page.
Falvey Memorial Library


VuFind is developed and maintained by Villanova University's Falvey Memorial Library.

News

VuFind 2.0RC1 Released
April 26, 2013 - The first release candidate of VuFind 2.0 has just been released. This release provides a preview of the functionality and architecture that will be seen in the full 2.0 release, due later this summer.

The new release includes several significant enhancements: Significant security improvements, including more secure password storage and protection against spammer abuse; A “MultiBackend” driver which allows VuFind to interact with multiple integrated library systems at once; A new and flexible search system with more modular, reusable code; 2.0 versions of all new features introduced in the 1.4 release, including support for hierarchical records and the Clickatell SMS service; and several bug fixes and minor improvements.

The new release can be downloaded at http://vufind.org .
VuFind 1.4 Released
January 28, 2013 - The final major release in the VuFind 1.x line is now available. VuFind 1.4 includes several significant enhancements: support for hierarchical collections of records, allowing better integration of archival materials and digital repositories; built-in support for running without an Integrated Library System, making VuFind more convenient for non-library uses and offering smarter behavior during temporary ILS outages; the ability to provide custom recommendations to the user when no search results are found; an improved and expanded mobile interface; new index fields allowing VuFind to be used as an article index; optional Clickatell support for text messaging; and several new interface translations: Basque, Catalan, Czech and Russian. Additionally, several bug fixes and minor improvements have been incorporated. The new release can be downloaded at http://vufind.org .
2.0beta Preview Available
October 01, 2012 - A new preview version of VuFind 2.0 is now available. 2.0beta features all of the same functionality as 2.0alpha, but it has been upgraded to use the newly released Zend Framework 2.0. Additionally, the installation process and configuration options have been made more powerful and flexible, and online documentation has been significantly expanded.

2.0beta is still NOT INTENDED FOR PRODUCTION, and some architectural details will change prior to the full 2.0 release in 2013. However, the code is maturing, and this release should be suitable for use by early adopters willing to follow development closely over the coming months.

To download the preview release and learn more about VuFind 2.0, visit http://vufind.org/downloads.php .