This installation documentation is designed for installation of VuFind 0.8 on a Linux server.

These are the requirements that VuFind was built with and tested under. You may use other versions at your own risk

• Apache HTTP Server 2.2 or later
• PHP 5.2.0 or later
• MySQL 4.1 or later
• Java J2SE JDK 1.4 or later
• GNU Aspell Library

http://httpd.apache.org/docs/2.2/install.html Ensure that mod_rewrite is included in the build

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

a sample http config might include:

<Directory "/usr/local/vufind/web/">
  AllowOverride all
</Directory>

Alias /vufind /usr/local/vufind/web

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

--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.

1)

• 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.

http://java.sun.com/javase/downloads/

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

%> ./install

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

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       

Copy the MARC file that is exported from your ILS into the import directory with the name catalog.mrc. Then simply run the MARC Import Tool form the command line:

%> ./import.sh

While the Import Tool loads the MARC records, you can begin to use your VuFind system. You will get an email notification from the Import Tool once the import process has finished. For more information on customizing the UI of VuFind - visit the Customization Page.