Installing EPrints 3 on Win32

From EPrints Documentation
Revision as of 11:25, 10 January 2011 by Tdb01r (talk | contribs) (MySQL)
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.

Requirements

  • 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)

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

Apache

Download and install Apache 2.2 + OpenSSL (if needed) from http://httpd.apache.org/download.cgi#apache22.

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

MySQL

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

During the MySQL configuration Wizard:

  • Change default character set to Best support For Multilingualism

Perl

Download and install ActiveState Perl 5.10 from http://www.activestate.com/activeperl/downloads/

You should use the 32 bit version, as there are only 32 bit builds of Apache available.

Perl Modules

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

ppm area list

you should see something like:

┌────────────┬──────┬──────────────────────┐
│ 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

Configuration

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/mod_perl.so

And at the end of the file:

Include C:/eprints/cfg/apache.conf

Getting Started

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