Warning: This page has not been updated in over over a year and may be outdated or deprecated.
legacy:installation:windows
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
legacy:installation:windows [2015/12/08 19:19] – ↷ Links adapted because of a move operation demiankatz | legacy:installation:windows [2018/12/19 17:11] (current) – demiankatz | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Installation ====== | ====== Installation ====== | ||
- | // These instructions are for use with VuFind 1.x; for later versions, see the [[vufind2: | + | // This outdated page has been deleted to prevent confusion; for current documentation, see [[installation: |
- | + | ||
- | **These instructions assume that you are installing your MySQL database on the same server as VuFind itself and that you are using an installation | + | |
- | + | ||
- | + | ||
- | ===== Requirements ===== | + | |
- | + | ||
- | To satisfy VuFind' | + | |
- | + | ||
- | greg_pendlebury (Nov 08) : //I usually run [[http:// | + | |
- | + | ||
- | rmchugh (April 12) : //Note that if you use xampp you will need to ensure the following line is present in the php.ini in xampp/php/: extension=php_xsl.dll | + | |
- | + | ||
- | Otherwise operations that require the xslt processor will not work properly.// | + | |
- | + | ||
- | ===== Installation Procedure ===== | + | |
- | + | ||
- | + | ||
- | ==== 1. Download VuFind ==== | + | |
- | + | ||
- | Extract the VuFind source -- you can download it [[http:// | + | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | ==== 2. Install the Apache HTTP Server ==== | + | |
- | + | ||
- | You can download the server [[http:// | + | |
- | + | ||
- | Make sure that the mod_rewrite module is activated -- edit the Apache configuration file (something like c:\Program Files\Apache Software Foundation\Apache# | + | |
- | + | ||
- | LoadModule rewrite_module modules/ | + | |
- | + | ||
- | Also make sure that the DirectoryIndex command includes index.php. | + | |
- | + | ||
- | DirectoryIndex index.html index.php | + | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | ==== 3. Install MySQL ==== | + | |
- | + | ||
- | You can download the database from [[http:// | + | |
- | + | ||
- | One important piece of the MySQL installation is the library file, libmysql.dll. | + | |
- | + | ||
- | 1.) Make sure that libmysql.dll is in your PHP directory and that your PHP directory is included in your system path (as described below in the [[windows# | + | |
- | + | ||
- | 2.) If libmysql.dll is not in your PHP directory, it may be in your MySQL directory (usually something like C:\Program Files\MySQL\MySQL Server 5.0\bin). | + | |
- | + | ||
- | 3.) As a last resort, you may try copying libmySQL.dll to your c: | + | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | ==== 4. Install PHP ==== | + | |
- | + | ||
- | You can download PHP [[http:// | + | |
- | + | ||
- | When prompted, choose the appropriate version of Apache and provide your configuration directory (i.e. c:\Program Files\Apache Software Foundation\Apache# | + | |
- | + | ||
- | When you reach the " | + | |
- | + | ||
- | * LDAP (optional) | + | |
- | * MySQL | + | |
- | * PDO (with MySQL) | + | |
- | * Pspell (optional) | + | |
- | * XSL | + | |
- | * GD2 (optional, but recommended | + | |
- | * Multi-Byte String (optional, but recommended) | + | |
- | + | ||
- | Note: Don't panic if you forget to add a component on your first installation. | + | |
- | + | ||
- | Note: It is possible that PHP will install some extensions without all of the necessary library files. | + | |
- | + | ||
- | Note: If you are a Voyager library, you will also need to install the PHP OCI Driver for Oracle – see [[: | + | |
- | + | ||
- | === Activate PEAR === | + | |
- | + | ||
- | You should now set up the PEAR code used for downloading standard code libraries for PHP. Go to the command prompt and type these commands: | + | |
- | + | ||
- | cd "c:\Program Files\PHP" | + | |
- | go-pear | + | |
- | + | ||
- | Note: Under Windows 7, the path to PHP may actually be " | + | |
- | + | ||
- | Follow the on-screen prompts; you should be able to leave settings at the defaults unless you want to change them for some reason. | + | |
- | + | ||
- | greg_pendlebury (July 2010): //The latest XAMPP installers (1.7.0+) do not require go-pear to be run at all. The comment | + | |
- | + | ||
- | greg_pendlebury (Nov 2008): //The XAMPP installer doesn' | + | |
- | + | ||
- | === PEAR behind a Proxy === | + | |
- | + | ||
- | If you are behind a proxy server when performing the install, PEAR will need to know about your proxy server before the installation will work. Just before running the installation script you will need to execute this command: | + | |
- | + | ||
- | pear config-set http_proxy http:// | + | |
- | + | ||
- | === Download Smarty === | + | |
- | + | ||
- | To install the template system used by VuFind, you need to download Smarty from [[http:// | + | |
- | + | ||
- | It is important that you install the CONTENTS of the libs folder and not the folder itself. | + | |
- | + | ||
- | greg_pendlebury (Nov 08) : //With XAMPP the path required was c: | + | |
- | + | ||
- | + | ||
- | ==== 5. Install the Java JDK ==== | + | |
- | + | ||
- | You can download the JDK [[http:// | + | |
- | + | ||
- | Set a system environment variable named JAVA_HOME to the path to your Java installation: | + | |
- | + | ||
- | === Windows XP or earlier === | + | |
- | * Open Control Panel | + | |
- | * Go to System (available in Classic View under XP) | + | |
- | * Advanced tab | + | |
- | * Environment Variables | + | |
- | + | ||
- | === Windows Vista/7 === | + | |
- | * Open Start Menu | + | |
- | * Right click " | + | |
- | * Click Properties | + | |
- | * Click " | + | |
- | * Click " | + | |
- | + | ||
- | === All versions (after following version-specific instructions above) === | + | |
- | * In the lower box marked System variables, click on New | + | |
- | * Variable name: JAVA_HOME | + | |
- | * Variable value: [c: | + | |
- | * While we are here, double click on the PATH variable in the user variables box and add C: | + | |
- | * (Note: | + | |
- | + | ||
- | Reboot. | + | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | ==== 6. Run VuFind Installation Script ==== | + | |
- | + | ||
- | Starting with VuFind 1.0RC2, a Windows installation script is included with VuFind. | + | |
- | + | ||
- | * Go to Start> | + | |
- | * In Windows 7, there is no " | + | |
- | * Switch to your VuFind directory (i.e. "cd c: | + | |
- | * If you are behind a proxy server remember to run the pear proxy command mentioned above. | + | |
- | * Type " | + | |
- | + | ||
- | You will be prompted for database settings; most can be left at their defaults. Now is when you'll need to remember the root MySQL password if you set one up earlier. You may see some minor errors and warnings while everything gets set up – this is normal, so don't panic! | + | |
- | + | ||
- | If you are installing an old version of VuFind without an install script, please see [[http:// | + | |
- | + | ||
- | //mbeccaria (12-10-2009): | + | |
- | + | ||
- | greg_pendlebury (July 2010): //If you installed XAMPP, PHP_PEAR_PHP_BIN won't even exist. You can either create it as per above, or add the the XAMPP path to the system PATH variable. Something like ' | + | |
- | + | ||
- | + | ||
- | ==== 7. Configure VuFind ==== | + | |
- | + | ||
- | === Linking VuFind to Apache === | + | |
- | + | ||
- | Edit the Apache configuration file (something like c:\Program Files\Apache Software Foundation\Apache# | + | |
- | + | ||
- | Include c:/ | + | |
- | + | ||
- | Change all the /usr paths (on lines 2 and 3 plus close to the bottom in the AuthUserFile setting) to Windows based paths (i.e. change / | + | |
- | + | ||
- | Once the configuration files are edited, you need to restart Apache for them to take effect -- you can do this from the Start menu under Apache HTTP Server, Control Apache Server, Restart. | + | |
- | + | ||
- | == Troubleshooting Apache == | + | |
- | + | ||
- | System-specific configuration issues may prevent things from working at this point. | + | |
- | + | ||
- | If your PHP installation was unable to automatically add PHP to the Apache logs, you may need to add these lines to your Apache configuration, | + | |
- | + | ||
- | LoadModule php5_module " | + | |
- | AddType application/ | + | |
- | PHPIniDir " | + | |
- | + | ||
- | (note that you may need to substitute a slightly different path to PHP depending on your Windows version -- in Windows 7, it will be " | + | |
- | + | ||
- | It is often helpful when troubleshooting to look at the Apache logs -- you can find these in the Start menu under Apache HTTP Server, Review Server Log Files. | + | |
- | + | ||
- | mike_beccaria (Jun 09) : //Add " | + | |
- | + | ||
- | demiankatz (Jul 09) : //if the PHP install added multiple PHPIniDir and LoadModule entries to the bottom of httpd.conf and this is preventing Apache from starting, comment out the duplicate ones and leave only the first pair intact.// | + | |
- | + | ||
- | === Setting up VuFind Itself === | + | |
- | + | ||
- | Edit c:/ | + | |
- | + | ||
- | [Site] | + | |
- | path = /vufind | + | |
- | url = http:// | + | |
- | local = c:/ | + | |
- | + | ||
- | [Database] | + | |
- | database | + | |
- | schema_location = c:/ | + | |
- | class_location | + | |
- | + | ||
- | Be sure to replace any /usr/local/ references in the config file not listed above with c:/ as well. | + | |
- | + | ||
- | == Troubleshooting VuFind == | + | |
- | + | ||
- | If something isn't quite right with VuFind, you will often discover that going to its URL simply gives you a blank white screen. | + | |
- | + | ||
- | === Configuring SolrMarc === | + | |
- | + | ||
- | If you are going to be loading MARC records into VuFind, edit c:/ | + | |
- | + | ||
- | === Configuring Solr === | + | |
- | + | ||
- | The config files for each Solr index are currently set up to use relative paths. | + | |
- | + | ||
- | In the following files: | + | |
- | c:/ | + | |
- | c:/ | + | |
- | c:/ | + | |
- | + | ||
- | Find the node: | + | |
- | \config\dataDir | + | |
- | + | ||
- | And change the relative paths currently there to: | + | |
- | c:/ | + | |
- | c:/ | + | |
- | c:/ | + | |
- | + | ||
- | For example, you would change this: | + | |
- | + | ||
- | <code xml> | + | |
- | < | + | |
- | </ | + | |
- | + | ||
- | to this: | + | |
- | + | ||
- | <code xml> | + | |
- | < | + | |
- | </ | + | |
- | + | ||
- | ==== 8. Start VuFind ==== | + | |
- | + | ||
- | Now that VuFind is installed and basic configuration is complete, you can start the server running. | + | |
- | + | ||
- | ==== 9. Import Records ==== | + | |
- | + | ||
- | Import bib records using the instructions on the [[: | + | |
- | + | ||
- | ==== Appendix: General Notes ==== | + | |
- | + | ||
- | If you are using VuFind' | + | |
---- struct data ---- | ---- struct data ---- | ||
+ | properties.Page Owner : | ||
---- | ---- | ||
legacy/installation/windows.txt · Last modified: 2018/12/19 17:11 by demiankatz