Skip to content
Snippets Groups Projects
README.md 1.63 KiB
Newer Older
VuFind
======

Introduction
------------
VuFind is an open source discovery environment for searching a collection of
records.  To learn more, visit http://vufind.org.


Installation
------------

WARNING: VuFind 2.0 is a work in progress.

Instructions
------------

1. Install PHP 5.3 and MySQL; the existing installation instructions for VuFind 1.x
will help you set up these dependencies (see http://vufind.org/wiki/installation).

2. Copy the VuFind 2 code to /usr/local/vufind2 (or another directory of your
choice).

3. Run the VuFind2 install script:

cd /usr/local/vufind2
php install.php

If you are testing VuFind 2 on a server that is also running VuFind 1.x, be sure you
choose a base path for the URL that does not conflict with VuFind 1.x (/vufind2
is a good choice).

4. Load VuFind2's Apache configuration file using the instructions displayed by the
install script.

5. Ensure that your web server can write to the "local" directories

sudo chown -R www-data:www-data /usr/local/vufind2/local

(Note that this step may vary depending on your operating system -- you may need to
replace www-data with apache).

6. To finish configuration, navigate to http://your-vufind-server/vufind2/Install and
follow the on-screen instructions.  If you are upgrading from VuFind 1.x, navigate to
http://your-vufind-server/vufind2/Upgrade instead.

7. If you run into problems, uncomment the "SetEnv VUFIND_ENV development" line in
/usr/local/vufind2/local/httpd-vufind.conf and restart Apache to see more detailed
error messages.

--------------------------------

You should now have a working VuFind 2.0 instance running at
http://your-vufind-server/vufind2