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 revision | ||
vufind2:installation_windows [2013/05/18 05:18] – [7. Configure VuFind] Add information about timeouts dmaus | installation:windows [2021/10/28 11:15] (current) – [4. Install PHP] demiankatz | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Installation ====== | ====== Installation ====== | ||
- | |||
- | // These instructions are for use with VuFind 2.x; for earlier versions, see the [[..: | ||
**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 6: | ||
===== 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 33: | ||
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 42: | ||
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 63: | Line 57: | ||
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 72: | Line 68: | ||
* LDAP (optional) | * LDAP (optional) | ||
* Multi-Byte String (optional, but recommended) | * Multi-Byte String (optional, but recommended) | ||
- | * MySQL | ||
* MySQLi | * MySQLi | ||
* PDO (with MySQL) | * PDO (with MySQL) | ||
Line 86: | Line 81: | ||
* 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:// | ||
Line 120: | Line 117: | ||
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 134: | Line 138: | ||
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. | 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. | ||
- | |||
- | 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. | ||
mike_beccaria (Jun 09) : //Add " | mike_beccaria (Jun 09) : //Add " | ||
Line 148: | Line 145: | ||
=== Configuring Solr === | === Configuring Solr === | ||
- | The config files for each Solr index are currently set up to use relative paths. | + | Starting with VuFind 3.0, no special Solr configuration should be necessary |
- | + | ==== 8. Start Solr ==== | |
- | In the following files: | + | |
- | c:/ | + | |
- | c:/ | + | |
- | c:/ | + | |
- | + | ||
- | Find the node: | + | |
- | \config\dataDir | + | |
- | + | ||
- | And change | + | |
- | 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. | + | Now that VuFind is installed and basic configuration is complete, you can start the Solr server running. |
==== 9. Final Configuration ==== | ==== 9. Final Configuration ==== | ||
Line 191: | Line 162: | ||
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 212: | Line 183: | ||
=== 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 ==== | ==== Appendix: General Notes ==== | ||
Line 244: | Line 215: | ||
---- struct data ---- | ---- struct data ---- | ||
+ | properties.Page Owner : | ||
---- | ---- | ||
installation/windows.1368854293.txt.gz · Last modified: 2014/06/13 13:13 (external edit)