|
|
| (37 intermediate revisions by 6 users not shown) |
| Line 1: |
Line 1: |
| − | {{Installation}}
| + | #REDIRECT [[Installing_EPrints_3_on_Win32]] |
| − | | |
| − | We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista). Please add bugs and comments to the end of this page.
| |
| − | | |
| − | ==Caveats==
| |
| − | | |
| − | * The installation directory is fixed as C:\EPrints\
| |
| − | * EPrints cannot yet run external commands, for example using ImageMagick to generate thumbnails of image deposits.
| |
| − | * Scheduling EPrints tasks (eg. running generate_views to update the view pages) is not yet tested with the Windows task scheduler.
| |
| − | * Full text documents are not yet indexed.
| |
| − | * The "Apache Perl" bundle currently used* includes an old release of Apache which is missing subsequent security updates: see http://www.apache.org/dist/httpd/CHANGES_2.0 Alternative versions of Apache, Perl, and mod_perl have not yet been tested.
| |
| − | | |
| − | ''* this Apache/Perl bundle was chosen because ActiveState Perl's license does not permit redistribution''
| |
| − | | |
| − | ==Required Software==
| |
| − | | |
| − | ===Apache Perl===
| |
| − | | |
| − | Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe
| |
| − | | |
| − | ===MySQL===
| |
| − | | |
| − | Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/
| |
| − | | |
| − | EPrints has been tested with MySQL 5.0, but other versions may work.
| |
| − | | |
| − | ===EPrints 3 for Windows===
| |
| − | | |
| − | '''This is an evaluation release. We do not recommend that it be used in a production environment.'''
| |
| − | | |
| − | Download the EPrints 3 for Windows components:
| |
| − | | |
| − | # EPrints 3 Windows installer http://files.eprints.org/233/2/epv3.exe | |
| − | # EPrints 3 Windows Customization Script http://files.eprints.org/233/1/windows-install.pl '''This file is under a proprietary license and is not redistributable.''' Save this file in the same directory as the installer executable.
| |
| − | | |
| − | ==Installation==
| |
| − | | |
| − | Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.
| |
| − | | |
| − | ===Install Apache Perl===
| |
| − | | |
| − | Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.
| |
| − | | |
| − | ===Configure Apache Perl===
| |
| − | | |
| − | When the installation completes, it asks you to configure the binary. Set the following options:
| |
| − | | |
| − | * Disable configuring CPAN.pm
| |
| − | * Disable building HTML documentation
| |
| − | * When prompted, choose not to install nmake.
| |
| − | | |
| − | Leave the other options at their defaults, and press Configure.
| |
| − | | |
| − | When the configuration tool is finished, you will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…
| |
| − | | |
| − | * Add both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin to Path, separated by a semicolon ;
| |
| − | * Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).
| |
| − | | |
| − | ===Install MySQL===
| |
| − | | |
| − | Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:
| |
| − | | |
| − | * Install the server and client programs
| |
| − | * Do not install the C files
| |
| − | * Skip signing up to MySQL.com
| |
| − | | |
| − | ===Configure MySQL===
| |
| − | | |
| − | When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).
| |
| − | | |
| − | Choose Detailed installation. Accept most of the default settings:
| |
| − | | |
| − | * Choose Best Support for Multilingualism as the character set
| |
| − | * Choose a secure root password when prompted
| |
| − | | |
| − | When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.
| |
| − | | |
| − | * In the sql-mode option, remove NO_AUTO_CREATE_USER from the list
| |
| − | | |
| − | Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.
| |
| − | | |
| − | ===Install EPrints 3===
| |
| − | | |
| − | The EPrints installer requires the Windows customization file, windows-install.pl. First Check that windows-install.pl is in the same directory as the EPrints installer .exe file.
| |
| − | | |
| − | Run the EPrints installer. This will install files into C:\EPrints\EPrints.
| |
| − | | |
| − | When the installer has finished, it will open a window to prompt you for site specific information. Follow the instructions to complete the installation.
| |
| − | | |
| − | ===Configure EPrints 3===
| |
| − | | |
| − | Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process.
| |
| − | | |
| − | Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:
| |
| − | | |
| − | perl bin/generate_static myarchive
| |
| − | | |
| − | First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run perl bin/epadmin create
| |
| − | | |
| − | epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.
| |
| − | | |
| − | Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:
| |
| − | | |
| − | Include C:/EPrints/EPrints/cfg/apache.conf
| |
| − | | |
| − | ===Starting Apache===
| |
| − | | |
| − | Now start Apache from the command line:
| |
| − | | |
| − | C:
| |
| − | cd\EPrints\Apache2
| |
| − | bin\apache
| |
