Difference between revisions of "Installing EPrints 3 on Win32"

From EPrints Documentation
Jump to: navigation, search
(MySQL)
(Perl Modules)
Line 39: Line 39:
  
 
===Perl Modules===
 
===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:
 
Add the uwinnipeg repository to PPM:
Line 62: Line 47:
 
* Click Ok then close PPM
 
* Click Ok then close PPM
  
Install mod_perl from the command prompt:
+
Run a command-prompt. On Vista+ you must run the command-prompt as administrator (right-click command prompt icon and select 'Run as administrator).
  
* ppm install mod_perl
+
Install mod_perl:
 +
 
 +
* > ppm install mod_perl
 
* When asked, set the Apache modules directory to '''C:/Apache/modules'''
 
* When asked, set the Apache modules directory to '''C:/Apache/modules'''
  
Install DBD::mysql from the command prompt:
+
Install DBD::mysql:
 +
 
 +
* > ppm install DBD-mysql
 +
 
 +
Install XML::LibXML:
 +
 
 +
* > ppm install XML-LibXML
 +
 
 +
Install XML::LibXSLT:
  
* ppm install DBD-mysql
+
* > ppm install XML-LibXSLT
 +
* When asked, allow fetching of the required libraries.
  
Install XML::LibXML from the command prompt:
+
Install Win32::Daemon:
  
* ppm install XML-LibXML
+
* > ppm install Win32::Daemon
  
 
==Configuration==
 
==Configuration==

Revision as of 13:27, 12 January 2011

Download EPrints Releases: http://files.eprints.org/view/type/release.html


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

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

Run a command-prompt. On Vista+ you must run the command-prompt as administrator (right-click command prompt icon and select 'Run as administrator).

Install mod_perl:

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

Install DBD::mysql:

  • > ppm install DBD-mysql

Install XML::LibXML:

  • > ppm install XML-LibXML

Install XML::LibXSLT:

  • > ppm install XML-LibXSLT
  • When asked, allow fetching of the required libraries.

Install Win32::Daemon:

  • > ppm install Win32::Daemon

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.