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