Difference between revisions of "Installing EPrints 3 on Win32"
(→Supporting Software) |
(Added message about no Windows support in 3.4+) |
||
(3 intermediate revisions by 2 users not shown) | |||
Line 2: | Line 2: | ||
{{Version|since=3.2.1}} | {{Version|since=3.2.1}} | ||
− | This page contains notes concerning installing version 3. | + | '''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]]. | ||
==Requirements== | ==Requirements== | ||
Line 22: | Line 24: | ||
==Supporting Software== | ==Supporting Software== | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
===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 33: | ||
* Change default character set to '''Best support For Multilingualism''' | * Change default character set to '''Best support For Multilingualism''' | ||
− | === | + | ===Apache=== |
− | Download and install | + | 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 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=== | ===Indexing and Thumbnailing Tools=== | ||
Line 76: | Line 63: | ||
..., | ..., | ||
executables => { | executables => { | ||
− | convert => ' | + | convert => '/ImageMagick/convert.exe', |
− | pdftotext => ' | + | pdftotext => '/xpdf/pdftotext.exe', |
}, | }, | ||
}; | }; | ||
Line 85: | Line 72: | ||
==Configuration== | ==Configuration== | ||
− | Edit the Apache configuration file '''C:\ | + | 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 | ||
Latest revision as of 10:31, 29 May 2022
Download an appropriate EPrints Release
This feature requires EPrints version 3.2.1 or later |
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 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 RedHat or Ubuntu.
Contents
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:
- ImageMagick
- xpdf (for the pdftotext utility)
- GNU Win32 tools
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.