Warning: This page has not been updated in over over a year and may be outdated or deprecated.
installation:windows
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
vufind2:installation_windows [2012/09/20 13:46] – demiankatz | installation:windows [2016/09/14 12:45] – [5. Install the Java JDK] demiankatz | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Installation ====== | ====== Installation ====== | ||
- | // These instructions are for use with VuFind 2.x; for earlier versions, see the [[..:installation_windows|1.x instructions]].// | + | // These instructions are for use with VuFind 2.x and newer; for earlier versions, see the [[legacy: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 path of c:\vufind** | **These instructions assume that you are installing your MySQL database on the same server as VuFind itself and that you are using an installation path of c:\vufind** | ||
Line 8: | Line 8: | ||
===== Requirements ===== | ===== Requirements ===== | ||
- | To satisfy VuFind' | + | To satisfy VuFind' |
These instructions assume that you are installing all software components separately. | These instructions assume that you are installing all software components separately. | ||
Line 35: | Line 35: | ||
DirectoryIndex index.html index.php | DirectoryIndex index.html index.php | ||
- | + | // IMPORTANT: If your VuFind instance will include records with slashes in their IDs, you need to add " | |
- | + | ||
- | + | ||
- | + | ||
==== 3. Install MySQL ==== | ==== 3. Install MySQL ==== | ||
Line 48: | Line 44: | ||
One important piece of the MySQL installation is the library file, libmysql.dll. | 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 [[installation_windows# | + | 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). | 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). | ||
Line 59: | Line 55: | ||
==== 4. Install PHP ==== | ==== 4. Install PHP ==== | ||
+ | |||
+ | === Install === | ||
You can download PHP [[http:// | You can download PHP [[http:// | ||
+ | |||
+ | :!: Pay attention to which version of Apache you downloaded -- PHP and Apache will integrate better if they are built for the same architecture (32-bit vs. 64-bit) using the same compiler. For example, if you downloaded a 32-bit (x86) version of Apache, you should not try to install a 64-bit (x64) version of PHP. | ||
When prompted, choose the appropriate version of Apache and provide your configuration directory (i.e. c:\Program Files\Apache Software Foundation\Apache# | When prompted, choose the appropriate version of Apache and provide your configuration directory (i.e. c:\Program Files\Apache Software Foundation\Apache# | ||
Line 74: | Line 74: | ||
* PDO (with MySQL) | * PDO (with MySQL) | ||
* XSL | * XSL | ||
+ | |||
+ | === Set up Environment === | ||
+ | |||
+ | Make sure that your Windows PATH environment variable includes the location of PHP (this location was specified during installation). | ||
=== Notes === | === Notes === | ||
Line 80: | Line 84: | ||
* It is possible that PHP will install some extensions without all of the necessary library files. | * It is possible that PHP will install some extensions without all of the necessary library files. | ||
* If you are using XAMPP instead of separate components, the installation process won't ask you about extensions. | * If you are using XAMPP instead of separate components, the installation process won't ask you about extensions. | ||
- | * If you are a Voyager library, you will also need to install the PHP OCI Driver for Oracle – see [[..: | + | * If you are a Voyager library, you will also need to install the PHP OCI Driver for Oracle – see [[php_oci|this page]] for detailed instructions. |
==== 5. Install the Java JDK ==== | ==== 5. Install the Java JDK ==== | ||
+ | |||
+ | Next install JDK (the Java Development Kit) on the server – VuFind' | ||
You can download the JDK [[http:// | You can download the JDK [[http:// | ||
- | Set a system environment variable named JAVA_HOME to the path to your Java installation: | + | Set a system environment variable named JAVA_HOME |
- | + | ||
- | === 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:\path\to\php. If no PATH variable exists, create it and add the same details. | + | |
- | + | ||
- | Reboot. | + | |
==== 6. Run VuFind Installation Script ==== | ==== 6. Run VuFind Installation Script ==== | ||
Line 136: | Line 120: | ||
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. | 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. | ||
+ | |||
+ | In order to properly handle network timeouts you should modify PHP's maximum execution time and default socket timeout settings. You can do this either in the webserver' | ||
+ | |||
+ | php_value default_socket_timeout 25 | ||
+ | php_value max_execution_time 30 | ||
+ | |||
+ | You can choose lower or higher values (both in seconds) depending on your environment. The socket timeout should always be lower than the max execution time. **This is 100% windows specific** -- the time to connect to a remote host (default_socket_timeout) counts towards the maximum time a PHP script is allowed to run. On *nix platforms it does not. | ||
== Troubleshooting Apache == | == Troubleshooting Apache == | ||
Line 156: | Line 147: | ||
=== Configuring Solr === | === Configuring Solr === | ||
+ | |||
+ | :!: Important -- the instructions in this section are probably not necessary for VuFind 3.0 or newer; please ignore unless you are using an older version. :!: | ||
The config files for each Solr index are currently set up to use relative paths. | The config files for each Solr index are currently set up to use relative paths. | ||
Line 184: | Line 177: | ||
</ | </ | ||
- | ==== 8. Start VuFind | + | ==== 8. Start Solr ==== |
- | Now that VuFind is installed and basic configuration is complete, you can start the server running. | + | Now that VuFind is installed and basic configuration is complete, you can start the Solr server running. |
==== 9. Final Configuration ==== | ==== 9. Final Configuration ==== | ||
Line 200: | Line 193: | ||
If you see a blank white screen, something is wrong. | If you see a blank white screen, something is wrong. | ||
- | * Check your Apache error log for messages -- see [[#Apache_Troubleshooting|Apache | + | * Check your Apache error log for messages -- see [[#Troubleshooting_Apache|Troubleshooting |
* If that does not help, try editing c:/ | * If that does not help, try editing c:/ | ||
Line 221: | Line 214: | ||
=== Locking Down Configurations === | === Locking Down Configurations === | ||
- | Once all configuration issues are successfully resolved, you will see a " | + | Once all configuration issues are successfully resolved, you will see a " |
==== 10. Import Records ==== | ==== 10. Import Records ==== | ||
- | Import bib records using the instructions on the [[..:importing records]] page. | + | Import bib records using the instructions on the [[:indexing]] page. |
+ | |||
+ | ==== Appendix: General Notes ==== | ||
+ | |||
+ | If you are using VuFind' | ||
==== Appendix: Editing Environment Variables ==== | ==== Appendix: Editing Environment Variables ==== |
installation/windows.txt · Last modified: 2021/10/28 11:15 (external edit)