These instructions are based on VUFind 0.7. It assumes the MySQL database is on the same server, and an installation path of c:/vufind

VUFind installation on a Windows server is fairly straightforward. First install the following applications:

• Apache HTTP Server 2.2 or later
• PHP 5.1 or later
• MySQL 4.1 or later
• Java J2SE JDK 1.4 or later
• YAZ 3.0 or later
• GNU Aspell Library (Optional)

1. Extract the VUFind source. These instructions assume a path of c:/vufind.

2. Install the Apache HTTP Server

In the httpd.conf file:

• Uncomment out (remove the semi-colon in front of) “LoadModule rewrite_module modules/mod_rewrite.so”
• Change “AllowOverride None” to “AllowOverride All”
• Add the following:

  Alias /vufind c:/vufind/web
  <Directory c:/vufind/web>
  AllowOverride ALL
  Order allow,deny
  allow from all
  </Directory>

3. Install MySQL

• Open a command line by going to Start>Run>“cmd”
• Enter the following commands:

  mysql -u root -p
  [enter password when prompted]
  GRANT ALL ON vufind.* TO 'vufind'@'localhost' IDENTIFIED BY 'password';
  source c:/vufind/mysql.sql;
  quit; 

4. Install PHP

Uncomment out the following lines from the php.ini file:

  extension=php_mysql.dll
  extension=php_ldap.dll  (optional)
  extension=php_xsl.dll
  extension=php_pdo.dll  (optional)
 

Note: If you compile and use the PDO-OCI module, you will need to add “extension=php_pdo_oci.dll” Do not add the line until the dll file is compiled or it will generate errors.

Download Smarty: http://www.smarty.net/download.php and the Smarty*.zip file into your PHP directory.

5. Install the Java JDK

Set a system environment variable named JAVA_HOME to the path to your Java installation:

• Open Control Panel
• Go to System
• Advanced tab
• Environment Variables
• In the lower box marked System variables, click on New
• Variable name: JAVA_HOME
• Variable value: [c:\path\to\java\]
• While we are here, double click on the PATH variable in the user variables box and add C:\path\to\php;c:\path\to\php\pear

Rebooting is not a bad idea right now.

6. Install YAZ

7. The install script is for Linux, so we'll use the command line to install the pear modules:

• Go to Start>Run and enter “cmd” with no quotes
• Enter each of the following commands, one after the other:

  pear upgrade pear
  pear install --onlyreqdeps DB
  pear install --onlyreqdeps DB_DataObject
  pear install --onlyreqdeps Structures_DataGrid-beta
  pear install --onlyreqdeps Structures_DataGrid_DataSource_DataObject-beta
  pear install --onlyreqdeps Structures_DataGrid_DataSource_Array-beta
  pear install --onlyreqdeps Structures_DataGrid_Renderer_HTMLTable-beta
  pear install --onlyreqdeps HTTP_Client
  pear install --onlyreqdeps HTTP_Request
  pear install --onlyreqdeps Mail
  pear install --onlyreqdeps Mail_Mime
  pear install --onlyreqdeps Pager
  pear install --onlyreqdeps XML_Serializer-beta
  pear install --onlyreqdeps Console_ProgressBar-beta
  pear install --onlyreqdeps File_Marc-alpha

8. Edit c:/vufind/web/conf/config.ini. Many of the settings are self explanatory and institution-specific. The following must be set specifically for Windows:

  [Site]
  path            = /vufind
  url             = http://localhost/vufind
  local           = c:/vufind/web
  [Data]
  src             = c:/vufind/data
  [Database]
  database        = mysql://[vufind]:[password]@localhost/vufind
  schema_location = c:/vufind/web/conf
  class_location  = c:/vufind/web/services/MyResearch/lib

9. The startup script is built for Linux so it won't work for us. Instead, from the command line, run:

  cd \vufind\solr\jetty\
  java -Dsolr.solr.home=c:\vufind\solr -Xmx1G -Xms1G -jar start.jar

Note: The above command assumes you want to dedicate 1 Gig of memory to the Java engine. Change the values as needed. This is especially important on lower end machines that will quick freeze up during indexing if no memory limit is established.

Jetty can also be started as a service instead of by the command line. Details are here: http://docs.codehaus.org/display/JETTY/Win32Wrapper (Note: I have not done this yet. Details will follow when I have.)

10. Import bib records. Because indexing will be done differently in 0.8, I am leaving these out for now. In the meantime, please see the main install page as they are essentially the same in Windows and Linux.

11. Future steps

PDO-OCI support is available in Windows. Step by step instructions will be added as I go through them (though if anyone else wants to add them, please do so and remove this paragraph).