Installing EPrints 3 on Win32 - Revision history

Drn@ecs.soton.ac.uk: Added message about no Windows support in 3.4+

2022-05-29T10:31:53Z

Added message about no Windows support in 3.4+

Drn@ecs.soton.ac.uk: Added suggestion to use RedHat or Ubuntu.

2020-07-11T12:26:28Z

Added suggestion to use RedHat or Ubuntu.

Tdb01r at 15:56, 31 May 2013

2013-05-31T15:56:43Z

Tdb01r: /* Indexing and Thumbnailing Tools */

2011-01-14T12:17:18Z

‎Indexing and Thumbnailing Tools

Tdb01r: /* Supporting Software */

2011-01-14T12:17:03Z

‎Supporting Software

Tdb01r: /* Requirements */

2011-01-14T12:10:40Z

‎Requirements

Tdb01r: /* Getting Started */

2011-01-14T12:06:06Z

‎Getting Started

Tdb01r: /* Perl Modules */

2011-01-14T12:04:45Z

‎Perl Modules

Tdb01r: /* Getting Started */

2011-01-14T12:02:37Z

‎Getting Started

Tdb01r: /* Perl Modules */

2011-01-12T13:45:19Z

‎Perl Modules

@@ Line 1: / Line 1: @@
 {{Installation}}
 {{Version|since=3.2.1}}
 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]].

@@ Line 2: / Line 2: @@
 {{Version|since=3.2.1}}
-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.
+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==

@@ Line 2: / Line 2: @@
 {{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==
@@ Line 22: / Line 22: @@
 ==Supporting Software==
 ===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:
@@ Line 38: / Line 31: @@
 * Change default character set to '''Best support For Multilingualism'''
-===Perl===
+===Apache===
-Download and install ActiveState Perl '''5.10''' from http://www.activestate.com/activeperl/downloads/
+Download and install the 64bit Apache '''2.2''' from http://www.apachelounge.com/download/ to C:\Apache2.
-You should use the '''32 bit''' version, as there are only 32 bit builds of Apache available.
+* 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 Modules===
+===Perl===
-Add the uwinnipeg repository to PPM:
+Download and install the 64bit Strawberry Perl 5.16 from http://strawberryperl.com/ to C:\Strawberry
-* Start the "Perl Package Manager" (ActiveState Perl start menu)
+==Nod_Perl==
-Run a command-prompt. On Vista+ you must run the command-prompt as administrator (right-click command prompt icon and select 'Run as administrator').
+Download and install the 64bit mod_perl for Strawberry Perl 5.16 from http://people.apache.org/~stevehay/.
- > ppm install DBD-mysql
+===Perl Modules===
- > ppm install XML-LibXSLT
+At a command-prompt run:
-* Allow fetching of the required libraries
+ > cpan install Win32-Daemon
 ===Indexing and Thumbnailing Tools===
@@ Line 85: / Line 70: @@
 ==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

@@ Line 76: / Line 76: @@
    ...,
    executables => {
-    convert => 'C:/ImageMagick/convert.exe',
+    convert => '/ImageMagick/convert.exe',
-    pdftotext => 'C:/xpdf/pdftotext.exe',
+    pdftotext => '/xpdf/pdftotext.exe',
    },
   };

← Older revision		Revision as of 12:17, 14 January 2011
Line 66:		Line 66:

	* Allow fetching of the required libraries		* Allow fetching of the required libraries
		+
		+	===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 => 'C:/ImageMagick/convert.exe',
		+	pdftotext => 'C:/xpdf/pdftotext.exe',
		+	},
		+	};
		+
		+	For a full list of tools look in lib\syscfg.d\executables.pl.

	==Configuration==		==Configuration==

@@ Line 10: / Line 10: @@
 * MySQL 5 or later
 * ModPerl 2.0 or later
 ==Download EPrints Windows Installation Package (MSI)==

@@ Line 78: / Line 78: @@
   > 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.

@@ Line 47: / Line 47: @@
 * 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).
+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 required modules:
+ > ppm install DBD-mysql
-* > ppm install DBD-mysql
+* Set the Apache modules directory to '''C:/Apache/modules'''
-Install mod_perl:
+ > ppm install XML-LibXSLT
-* > ppm install mod_perl
+* Allow fetching of the required libraries
 ==Configuration==

← Older revision		Revision as of 12:02, 14 January 2011
Line 78:		Line 78:

	==Getting Started==		==Getting Started==
		+
		+	To create the indexer service entries (EPrints 3.3+), as administrator run:
		+
		+	> 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]].

@@ Line 48: / Line 48: @@
 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:
@@ Line 53: / Line 60: @@
 * > ppm install mod_perl
 * When asked, set the Apache modules directory to '''C:/Apache/modules'''
 Install XML::LibXSLT:
@@ Line 66: / Line 65: @@
 * > ppm install XML-LibXSLT
 * When asked, allow fetching of the required libraries.
 ==Configuration==