View source for Installing EPrints 3 on Win32

{{Installation}}
{{Version|since=3.2.1}}

'''EPrints 3.4+ no longer supports installation on Windows.  If you do not have a Linux server, you can always create a Linux virtual machine on a Windows PC, get one on a Cloud hosting service or use [[Installing_EPrints_using_Docker|Docker]].'''

This page contains notes concerning installing version EPrints 3.3 on Win32-based platforms. Windows is not a well-supported platform and these instructions are likely to go out of date, due to the complexity of getting a working Apache-Perl environment working.  It is strongly recommended to install EPrints on Linux operating system such as [[Installing EPrints on RHEL/Fedora/CentOS|RedHat]] or [[Installing EPrints on Debian/Ubuntu|Ubuntu]].

==Requirements==

* Microsoft Windows XP or later
* Apache 2.0 or later
* MySQL 5 or later
* ModPerl 2.0 or later

For indexing and thumbnailing you will also need:

* [http://www.imagemagick.org/ ImageMagick]
* [http://www.foolabs.com/xpdf/ xpdf] (for the pdftotext utility)
* [http://gnuwin32.sourceforge.net/ GNU Win32 tools]

==Download EPrints Windows Installation Package (MSI)==

Download the latest Win32 build from the link at the top of this page - do not install this until ALL supporting software is in place and in the places outlined!

==Supporting Software==

===MySQL===

Download and install 64bit MySQL from http://dev.mysql.com/downloads/mysql/

During the MySQL configuration Wizard:

* Change default character set to '''Best support For Multilingualism'''

===Apache===

Download and install the 64bit Apache '''2.2''' from http://www.apachelounge.com/download/ to C:\Apache2.

* Add '''C:\Apache2\bin''' to the windows path environment variable. Failure to add this path will result with a missing libaprutil-1.dll error when you attempt to run EPrints.

===Perl===

Download and install the 64bit Strawberry Perl 5.16 from http://strawberryperl.com/ to C:\Strawberry

==Nod_Perl==

Download and install the 64bit mod_perl for Strawberry Perl 5.16 from http://people.apache.org/~stevehay/.

===Perl Modules===

At a command-prompt run:

 > cpan install Win32-Daemon
 > cpan install Win32-DriveInfo

===Indexing and Thumbnailing Tools===

To get indexing and thumbnailing working will require some configuration file changes.

When you have installed a tool you need to tell EPrints where to find it. Edit perl_lib\EPrints\SystemSettings.pm:

 $EPrints::SystemSettings::conf = {
  ...,
  executables => {
   convert => '/ImageMagick/convert.exe',
   pdftotext => '/xpdf/pdftotext.exe',
  },
 };

For a full list of tools look in lib\syscfg.d\executables.pl.

==Configuration==

Edit the Apache configuration file '''C:\Apache2\conf\httpd.conf''' and add below the last LoadModule line:

 # LoadFile C:/perl/bin/perl510.dll # Not necessary?
 LoadModule perl_module modules/mod_perl.so

And at the end of the file:

 Include C:/eprints/cfg/apache.conf

==Getting Started==

To create the indexer service entries (EPrints 3.3+), as administrator run:

 > perl C:\eprints\bin\indexer install

Before starting Apache configure a new repository, see [[Getting Started with EPrints 3]].

You will need to manually restart the indexer if you change the repository configuration.