Difference between revisions of "Installing EPrints 3 on Win32"

From EPrints Documentation
Jump to: navigation, search
(Perl Modules)
 
(4 intermediate revisions by the same user not shown)
Line 2: Line 2:
 
{{Version|since=3.2.1}}
 
{{Version|since=3.2.1}}
  
This page contains notes concerning installing version 3.2 on Win32-based platforms. There is still work to go on supporting EPrints on Win32.
+
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.
  
 
==Requirements==
 
==Requirements==
Line 10: Line 10:
 
* MySQL 5 or later
 
* MySQL 5 or later
 
* ModPerl 2.0 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 EPrints Windows Installation Package (MSI)==
Line 16: Line 22:
  
 
==Supporting Software==
 
==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===
 
===MySQL===
  
Download and install MySQL from http://dev.mysql.com/downloads/mysql/
+
Download and install 64bit MySQL from http://dev.mysql.com/downloads/mysql/
  
 
During the MySQL configuration Wizard:
 
During the MySQL configuration Wizard:
  
 
* Change default character set to '''Best support For Multilingualism'''
 
* 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===
 
===Perl===
  
Download and install ActiveState Perl '''5.10''' from http://www.activestate.com/activeperl/downloads/
+
Download and install the 64bit Strawberry Perl 5.16 from http://strawberryperl.com/ to C:\Strawberry
  
You should use the '''32 bit''' version, as there are only 32 bit builds of Apache available.
+
==Nod_Perl==
 +
 
 +
Download and install the 64bit mod_perl for Strawberry Perl 5.16 from http://people.apache.org/~stevehay/.
  
 
===Perl Modules===
 
===Perl Modules===
  
Add the uwinnipeg repository to PPM:
+
At a command-prompt run:
  
* Start the "Perl Package Manager" (ActiveState Perl start menu)
+
> cpan install Win32-Daemon
* Edit → Preferences
+
> cpan install Win32-DriveInfo
* 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').
+
===Indexing and Thumbnailing Tools===
  
> ppm install DBD-mysql
+
To get indexing and thumbnailing working will require some configuration file changes.
> ppm install XML-LibXML
+
> ppm install Win32-Daemon
+
> ppm install Win32-DriveInfo
+
> ppm install mod_perl
+
  
* Set the Apache modules directory to '''C:/Apache/modules'''
+
When you have installed a tool you need to tell EPrints where to find it. Edit perl_lib\EPrints\SystemSettings.pm:
  
  > ppm install XML-LibXSLT
+
  $EPrints::SystemSettings::conf = {
 +
  ...,
 +
  executables => {
 +
  convert => '/ImageMagick/convert.exe',
 +
  pdftotext => '/xpdf/pdftotext.exe',
 +
  },
 +
};
  
* Allow fetching of the required libraries
+
For a full list of tools look in lib\syscfg.d\executables.pl.
  
 
==Configuration==
 
==Configuration==
  
Edit the Apache configuration file '''C:\Apache\conf\httpd.conf''' and add below the last LoadModule line:
+
Edit the Apache configuration file '''C:\Apache2\conf\httpd.conf''' and add below the last LoadModule line:
  
  LoadFile C:/perl/bin/perl510.dll
+
  # LoadFile C:/perl/bin/perl510.dll # Not necessary?
 
  LoadModule perl_module modules/mod_perl.so
 
  LoadModule perl_module modules/mod_perl.so
  
Line 77: Line 84:
  
 
  > perl C:\eprints\bin\indexer install
 
  > perl C:\eprints\bin\indexer install
 
Then use the Windows Services manager to start/stop the indexer.
 
  
 
Before starting Apache configure a new repository, see [[Getting Started with EPrints 3]].
 
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.

Latest revision as of 15:56, 31 May 2013

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 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.

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:

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.