Installing EPrints 3 on Win32

From EPrints Documentation
Revision as of 17:18, 19 May 2010 by Tdb01r (talk | contribs) (EPrints Configuration)
Jump to: navigation, search

Download an appropriate EPrints Release

Warning This feature requires EPrints version 3.2.1 or later

This page contains notes concerning installing version 3.2 on Win32-based platforms. There is still work to go on supporting EPrints on Win32.


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

Download EPrints Windows Installation Package (MSI)

Do not install this until ALL supporting software is in place and in the places outlined.

Supporting Software


Download and install Apache 2.2 + OpenSSL (if needed) from

  • Change the installation directory to C:\Apache
  • After install manually add C:\Apache\bin to the windows path enviroment variable.


Download and install MySQL from

  • Change default character set to Best support For Multilingualism


Download and install ActiveState Perl from

Perl Modules

Check you can write to the Perl library from the command prompt:

ppm area list
│ name       │ pkgs │ lib                  │
│ (perl_lib) │  n/a │ C:/eprints//perl_lib │
│ (site)     │    2 │ C:/Perl/site/lib     │
│ (perl)     │  206 │ C:/Perl/lib          │

If the "site" name is in brackets (as shown) you need to fix the folder permissions on C:/Perl/site so that your user can write to it. (TODO: Windows expert can explain why this breaks?)

Add the uwinnipeg repository to PPM:

  • Start the "Perl Package Manager" (ActiveState Perl start menu)
  • Edit → Preferences
  • Under the Repositories tab add the University of Winnipeg repository from the suggested list.
  • Click Ok then close PPM

Install mod_perl from the command prompt:

  • ppm install mod_perl
  • When asked, set the Apache modules directory to C:/Apache/modules

Install DBD::mysql from the command prompt:

  • ppm install DBD-mysql

Install XML::LibXML from the command prompt:

  • ppm install XML-LibXML


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

LoadFile C:/perl/bin/perl510.dll
LoadModule perl_module modules/

And at the end of the file:

Include C:/eprints/cfg/apache.conf

Getting Started