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+

← Older revision		Revision as of 10:31, 29 May 2022
Line 1:		Line 1:
	{{Installation}}		{{Installation}}
	{{Version\|since=3.2.1}}		{{Version\|since=3.2.1}}

			'''EPrints 3.4+ no longer supports installation on Windows. If you do not have a Linux server, you can always create a Linux virtual machine on a Windows PC, get one on a Cloud hosting service or use [[Installing_EPrints_using_Docker\|Docker]].'''

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

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

2020-07-11T12:26:28Z

Added suggestion to use RedHat or Ubuntu.

← Older revision		Revision as of 12:26, 11 July 2020
Line 2:		Line 2:
	{{Version\|since=3.2.1}}		{{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==		==Requirements==

Tdb01r at 15:56, 31 May 2013

2013-05-31T15:56:43Z

← Older revision		Revision as of 15:56, 31 May 2013
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 22:		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:
Line 38:		Line 31:
	* Change default character set to '''Best support For Multilingualism'''		* 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==
	* 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')~~.		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-LibXML~~
	~~> ppm install Win32-Daemon~~
	~~> ppm install Win32-DriveInfo~~
	~~> ppm install mod_perl~~

	* Set the Apache modules directory to '''C:/Apache/modules'''

	~~> ppm install XML~~-~~LibXSLT~~		At a command-prompt run:

	* Allow fetching of the required libraries		> cpan install Win32-Daemon
			> cpan install Win32-DriveInfo

	===Indexing and Thumbnailing Tools===		===Indexing and Thumbnailing Tools===
Line 85:		Line 70:
	==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

Tdb01r: /* Indexing and Thumbnailing Tools */

2011-01-14T12:17:18Z

Indexing and Thumbnailing Tools

← Older revision		Revision as of 12:17, 14 January 2011
Line 76:		Line 76:
	...,		...,
	executables => {		executables => {
	convert => 'C:/ImageMagick/convert.exe',		convert => '/ImageMagick/convert.exe',
	pdftotext => 'C:/xpdf/pdftotext.exe',		pdftotext => '/xpdf/pdftotext.exe',
	},		},
	};		};

Tdb01r: /* Supporting Software */

2011-01-14T12:17:03Z

Supporting Software

← 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==

Tdb01r: /* Requirements */

2011-01-14T12:10:40Z

Requirements

← Older revision		Revision as of 12:10, 14 January 2011
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)==

Tdb01r: /* Getting Started */

2011-01-14T12:06:06Z

Getting Started

← Older revision		Revision as of 12:06, 14 January 2011
Line 78:		Line 78:
	> 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.

Tdb01r: /* Perl Modules */

2011-01-14T12:04:45Z

Perl Modules

← Older revision		Revision as of 12:04, 14 January 2011
Line 47:		Line 47:
	* Click Ok then close PPM		* 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 XML-LibXML
			> ppm install Win32-Daemon
			> ppm install Win32-DriveInfo
			> ppm install mod_perl

	* ~~> ppm install DBD-mysql~~		* Set the Apache modules directory to '''C:/Apache/modules'''
	* > ppm install XML-LibXML
	* > ppm install Win32-Daemon
	* > ppm install Win32-DriveInfo

	~~Install mod_perl:~~		> ppm install XML-LibXSLT

	* ~~> ppm install mod_perl~~		* Allow fetching of the required libraries
	* When asked, set the Apache modules directory to '''C:/Apache/modules'''

	~~Install XML::LibXSLT:~~

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

	==Configuration==		==Configuration==

Tdb01r: /* Getting Started */

2011-01-14T12:02:37Z

Getting Started

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

Tdb01r: /* Perl Modules */

2011-01-12T13:45:19Z

Perl Modules

@@ 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==