EPrints Documentation - User contributions [en-gb]

Installing Eprints 3 on Windows

2008-05-01T15:33:43Z

Harry: Use Latin-1, not Unicode; EPrints handles Unicode internally.

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

Recent versions of the EPrints 3.0 Windows Installer are licensed under the Microsoft Reciprocal License.

==Caveats==

* Releases before r3380: The installation directory is fixed as C:\EPrints\
* Releases from r3380: You can now specify the installation directory. However, EPrints assumes GhostScript and catdoc can be found relative to this directory.

==Required Software==

===Apache===

'''Apache 2.2.6/2.2.8 have an incompatibility with mod_perl. Use 2.2.4 until this problem is fixed.'''

Download the MSI Win32 binary of Apache 2.2. Available in the "Other files" section of http://httpd.apache.org/download.cgi

===ActivePerl===

'''Note: ActiveState Perl 822 has an incompatibility with mod_perl. Use 820 until this problem is fixed.'''

Download ActiveState Perl Free Edition from http://downloads.activestate.com/ActivePerl/Windows/5.8/ActivePerl-5.8.8.820-MSWin32-x86-274739.msi

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

# http://files.eprints.org/336/1/EPrints.exe

Like all EPrints releases, this is supplied without warranty and cannot be guaranteed to be free of bugs. Good backups are essential in a live archive.

==Optional Software==

===GhostScript 8.60===

This is used to convert PS and PDF formats. If it isn't installed these formats cannot be previewed or indexed by EPrints, but can still be accessed normally by users.

Download from http://downloads.sourceforge.net/ghostscript/gs860w32.exe

===Catdoc 0.94.2===

This is used to convert Microsoft Word and Powerpoint files. If it isn't installed these formats cannot be indexed by EPrints, but can still be accessed normally by users.

Download from http://webaugur.com/wares/files/catdoc-0.94.2-win32.zip

===ImageMagick 6.3.5-6===

This is used to convert image formats for preview. If it isn't installed these formats cannot be previewed, and thumbnails will have a generic icon.

'''Note: Recent versions of ImageMagick do not work with ActiveState Perl 820. Use 6.3.5-6 until this problem is fixed.'''

Old versions of ImageMagick are not available from the main site.

Download the Q16 DLL version from http://list.veidrodis.com/image_magick/binaries/ImageMagick-6.3.5-6-Q16-windows-dll.exe

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache===

Run the Apache installer. When prompted, choose to install in the directory C:\EPrints\Apache2.

===Install ActivePerl===

Run the ActivePerl installer. When prompted, choose to install in the directory C:\EPrints\Perl.
Ensure that Perl is added to your PATH.

When installation is complete, some optional components need to be installed from the command line. Open a command prompt and enter:

ppm install http://theoryx5.uwinnipeg.ca/ppms/DBD-mysql.ppd
ppm install http://theoryx5.uwinnipeg.ca/ppms/mod_perl.ppd

The mod_perl installer will prompt you for the Apache module path. Enter:
C:/EPrints/Apache2/modules

To add mod_perl support to Apache, edit the Apache configuration file, C:\EPrints\Apache2\conf\httpd.conf in a text editor, and add the following lines:

LoadFile "C:/EPrints/Perl/bin/perl58.dll"
LoadModule perl_module modules/mod_perl.so

===Configuring Apache and Perl===

You will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Make sure both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin are included in the Path variable, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* As the character set, choose Latin-1.
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install optional components===

Install GhostScript, ImageMagick, and catdoc. These tools are not essential to try out EPrints, but provide extra functionality.

GhostScript should be installed in C:\EPrints\GhostScript .

Catdoc should be unzipped into C:\EPrints\catdoc-0.94.2 .

ImageMagick should be installed in C:\EPrints\ImageMagick . Select the options "Update executable search path" and "Install PerlMagick for ActiveState Perl". Other options can be deselected.

A ppm error may occur while installing the Perl component. If so, open a command prompt afterwards and enter:

cd\EPrints\ImageMagick\PerlMagick
ppm install Image-Magick.ppd

===Install EPrints 3===

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished copying files, it will prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

PerlPassEnv PERL5LIB
Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Control Apache from the Services panel. Stop and start the service before testing, to reload the configuration file.

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

====Indexer====

Task Scheduler should also be used to replace the indexer daemon. The options are as above, except with the script is called:
C:\EPrints\EPrints\bin\makeindex
However, to run more frequently than once per day, it is necessary to create a recurring Trigger. In the properties screen, modify the Trigger and set the Repeat task every: option.

Installing Eprints 3 on Windows

2008-04-25T15:37:33Z

Harry: Row length problem with using UTF-8. Use UCS-2 as the server character set.

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

Recent versions of the EPrints 3.0 Windows Installer are licensed under the Microsoft Reciprocal License.

==Caveats==

* Releases before r3380: The installation directory is fixed as C:\EPrints\
* Releases from r3380: You can now specify the installation directory. However, EPrints assumes GhostScript and catdoc can be found relative to this directory.

==Required Software==

===Apache===

'''Apache 2.2.6/2.2.8 have an incompatibility with mod_perl. Use 2.2.4 until this problem is fixed.'''

Download the MSI Win32 binary of Apache 2.2. Available in the "Other files" section of http://httpd.apache.org/download.cgi

===ActivePerl===

'''Note: ActiveState Perl 822 has an incompatibility with mod_perl. Use 820 until this problem is fixed.'''

Download ActiveState Perl Free Edition from http://downloads.activestate.com/ActivePerl/Windows/5.8/ActivePerl-5.8.8.820-MSWin32-x86-274739.msi

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

# http://files.eprints.org/336/1/EPrints.exe

Like all EPrints releases, this is supplied without warranty and cannot be guaranteed to be free of bugs. Good backups are essential in a live archive.

==Optional Software==

===GhostScript 8.60===

This is used to convert PS and PDF formats. If it isn't installed these formats cannot be previewed or indexed by EPrints, but can still be accessed normally by users.

Download from http://downloads.sourceforge.net/ghostscript/gs860w32.exe

===Catdoc 0.94.2===

This is used to convert Microsoft Word and Powerpoint files. If it isn't installed these formats cannot be indexed by EPrints, but can still be accessed normally by users.

Download from http://webaugur.com/wares/files/catdoc-0.94.2-win32.zip

===ImageMagick 6.3.5-6===

This is used to convert image formats for preview. If it isn't installed these formats cannot be previewed, and thumbnails will have a generic icon.

'''Note: Recent versions of ImageMagick do not work with ActiveState Perl 820. Use 6.3.5-6 until this problem is fixed.'''

Old versions of ImageMagick are not available from the main site.

Download the Q16 DLL version from http://list.veidrodis.com/image_magick/binaries/ImageMagick-6.3.5-6-Q16-windows-dll.exe

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache===

Run the Apache installer. When prompted, choose to install in the directory C:\EPrints\Apache2.

===Install ActivePerl===

Run the ActivePerl installer. When prompted, choose to install in the directory C:\EPrints\Perl.
Ensure that Perl is added to your PATH.

When installation is complete, some optional components need to be installed from the command line. Open a command prompt and enter:

ppm install http://theoryx5.uwinnipeg.ca/ppms/DBD-mysql.ppd
ppm install http://theoryx5.uwinnipeg.ca/ppms/mod_perl.ppd

The mod_perl installer will prompt you for the Apache module path. Enter:
C:/EPrints/Apache2/modules

To add mod_perl support to Apache, edit the Apache configuration file, C:\EPrints\Apache2\conf\httpd.conf in a text editor, and add the following lines:

LoadFile "C:/EPrints/Perl/bin/perl58.dll"
LoadModule perl_module modules/mod_perl.so

===Configuring Apache and Perl===

You will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Make sure both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin are included in the Path variable, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* As the character set, manually choose ucs2.
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list
* In the <nowiki>[mysql]</nowiki> section (client settings) change default-character-set from ucs2 to utf8

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install optional components===

Install GhostScript, ImageMagick, and catdoc. These tools are not essential to try out EPrints, but provide extra functionality.

GhostScript should be installed in C:\EPrints\GhostScript .

Catdoc should be unzipped into C:\EPrints\catdoc-0.94.2 .

ImageMagick should be installed in C:\EPrints\ImageMagick . Select the options "Update executable search path" and "Install PerlMagick for ActiveState Perl". Other options can be deselected.

A ppm error may occur while installing the Perl component. If so, open a command prompt afterwards and enter:

cd\EPrints\ImageMagick\PerlMagick
ppm install Image-Magick.ppd

===Install EPrints 3===

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished copying files, it will prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

PerlPassEnv PERL5LIB
Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Control Apache from the Services panel. Stop and start the service before testing, to reload the configuration file.

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

====Indexer====

Task Scheduler should also be used to replace the indexer daemon. The options are as above, except with the script is called:
C:\EPrints\EPrints\bin\makeindex
However, to run more frequently than once per day, it is necessary to create a recurring Trigger. In the properties screen, modify the Trigger and set the Repeat task every: option.

Files/EPrints 3.0 Windows Installer (r3380)

2008-04-07T07:30:42Z

Harry: Redirecting to Installing Eprints 3 on Windows

#REDIRECT [[Installing_Eprints_3_on_Windows]]

Installing Eprints 3 on Windows

2008-04-07T07:29:38Z

Harry: Changes for r3380

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

Recent versions of the EPrints 3.0 Windows Installer are licensed under the Microsoft Reciprocal License.

==Caveats==

* Releases before r3380: The installation directory is fixed as C:\EPrints\
* Releases from r3380: You can now specify the installation directory. However, EPrints assumes GhostScript and catdoc can be found relative to this directory.

==Required Software==

===Apache===

'''Apache 2.2.6/2.2.8 have an incompatibility with mod_perl. Use 2.2.4 until this problem is fixed.'''

Download the MSI Win32 binary of Apache 2.2. Available in the "Other files" section of http://httpd.apache.org/download.cgi

===ActivePerl===

'''Note: ActiveState Perl 822 has an incompatibility with mod_perl. Use 820 until this problem is fixed.'''

Download ActiveState Perl Free Edition from http://downloads.activestate.com/ActivePerl/Windows/5.8/ActivePerl-5.8.8.820-MSWin32-x86-274739.msi

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

# http://files.eprints.org/336/1/EPrints.exe

Like all EPrints releases, this is supplied without warranty and cannot be guaranteed to be free of bugs. Good backups are essential in a live archive.

==Optional Software==

===GhostScript 8.60===

This is used to convert PS and PDF formats. If it isn't installed these formats cannot be previewed or indexed by EPrints, but can still be accessed normally by users.

Download from http://downloads.sourceforge.net/ghostscript/gs860w32.exe

===Catdoc 0.94.2===

This is used to convert Microsoft Word and Powerpoint files. If it isn't installed these formats cannot be indexed by EPrints, but can still be accessed normally by users.

Download from http://webaugur.com/wares/files/catdoc-0.94.2-win32.zip

===ImageMagick 6.3.5-6===

This is used to convert image formats for preview. If it isn't installed these formats cannot be previewed, and thumbnails will have a generic icon.

'''Note: Recent versions of ImageMagick do not work with ActiveState Perl 820. Use 6.3.5-6 until this problem is fixed.'''

Old versions of ImageMagick are not available from the main site.

Download the Q16 DLL version from http://list.veidrodis.com/image_magick/binaries/ImageMagick-6.3.5-6-Q16-windows-dll.exe

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache===

Run the Apache installer. When prompted, choose to install in the directory C:\EPrints\Apache2.

===Install ActivePerl===

Run the ActivePerl installer. When prompted, choose to install in the directory C:\EPrints\Perl.
Ensure that Perl is added to your PATH.

When installation is complete, some optional components need to be installed from the command line. Open a command prompt and enter:

ppm install http://theoryx5.uwinnipeg.ca/ppms/DBD-mysql.ppd
ppm install http://theoryx5.uwinnipeg.ca/ppms/mod_perl.ppd

The mod_perl installer will prompt you for the Apache module path. Enter:
C:/EPrints/Apache2/modules

To add mod_perl support to Apache, edit the Apache configuration file, C:\EPrints\Apache2\conf\httpd.conf in a text editor, and add the following lines:

LoadFile "C:/EPrints/Perl/bin/perl58.dll"
LoadModule perl_module modules/mod_perl.so

===Configuring Apache and Perl===

You will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Make sure both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin are included in the Path variable, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install optional components===

Install GhostScript, ImageMagick, and catdoc. These tools are not essential to try out EPrints, but provide extra functionality.

GhostScript should be installed in C:\EPrints\GhostScript .

Catdoc should be unzipped into C:\EPrints\catdoc-0.94.2 .

ImageMagick should be installed in C:\EPrints\ImageMagick . Select the options "Update executable search path" and "Install PerlMagick for ActiveState Perl". Other options can be deselected.

A ppm error may occur while installing the Perl component. If so, open a command prompt afterwards and enter:

cd\EPrints\ImageMagick\PerlMagick
ppm install Image-Magick.ppd

===Install EPrints 3===

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished copying files, it will prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

PerlPassEnv PERL5LIB
Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Control Apache from the Services panel. Stop and start the service before testing, to reload the configuration file.

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

====Indexer====

Task Scheduler should also be used to replace the indexer daemon. The options are as above, except with the script is called:
C:\EPrints\EPrints\bin\makeindex
However, to run more frequently than once per day, it is necessary to create a recurring Trigger. In the properties screen, modify the Trigger and set the Repeat task every: option.

Installing Eprints 3 on Windows

2008-03-19T15:41:58Z

Harry: /* Caveats */

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

'''The EPrints 3.0 Windows Installer is under a proprietary license and is NOT redistributable.'''

==Caveats==

* Releases before r3380: The installation directory is fixed as C:\EPrints\
* Releases from r3380: You can now specify the installation directory. However, EPrints assumes GhostScript and catdoc can be found relative to this directory.

==Required Software==

===Apache===

'''Apache 2.2.6/2.2.8 have an incompatibility with mod_perl. Use 2.2.4 until this problem is fixed.'''

Download the MSI Win32 binary of Apache 2.2. Available in the "Other files" section of http://httpd.apache.org/download.cgi

===ActivePerl===

'''Note: ActiveState Perl 822 has an incompatibility with mod_perl. Use 820 until this problem is fixed.'''

Download ActiveState Perl Free Edition from http://downloads.activestate.com/ActivePerl/Windows/5.8/ActivePerl-5.8.8.820-MSWin32-x86-274739.msi

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

'''This file is under a proprietary license and are NOT redistributable.'''

# http://files.eprints.org/303/1/EPrints.exe

Like all EPrints releases, this is supplied without warranty and cannot be guaranteed to be free of bugs. Good backups are essential in a live archive.

==Optional Software==

===GhostScript 8.60===

This is used to convert PS and PDF formats. If it isn't installed these formats cannot be previewed or indexed by EPrints, but can still be accessed normally by users.

Download from http://downloads.sourceforge.net/ghostscript/gs860w32.exe

===Catdoc 0.94.2===

This is used to convert Microsoft Word and Powerpoint files. If it isn't installed these formats cannot be indexed by EPrints, but can still be accessed normally by users.

Download from http://webaugur.com/wares/files/catdoc-0.94.2-win32.zip

===ImageMagick 6.3.5-6===

This is used to convert image formats for preview. If it isn't installed these formats cannot be previewed, and thumbnails will have a generic icon.

'''Note: Recent versions of ImageMagick do not work with ActiveState Perl 820. Use 6.3.5-6 until this problem is fixed.'''

Old versions of ImageMagick are not available from the main site.

Download the Q16 DLL version from http://list.veidrodis.com/image_magick/binaries/ImageMagick-6.3.5-6-Q16-windows-dll.exe

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache===

Run the Apache installer. When prompted, choose to install in the directory C:\EPrints\Apache2.

===Install ActivePerl===

Run the ActivePerl installer. When prompted, choose to install in the directory C:\EPrints\Perl.
Ensure that Perl is added to your PATH.

When installation is complete, some optional components need to be installed from the command line. Open a command prompt and enter:

ppm install http://theoryx5.uwinnipeg.ca/ppms/DBD-mysql.ppd
ppm install http://theoryx5.uwinnipeg.ca/ppms/mod_perl.ppd

The mod_perl installer will prompt you for the Apache module path. Enter:
C:/EPrints/Apache2/modules

To add mod_perl support to Apache, edit the Apache configuration file, C:\EPrints\Apache2\conf\httpd.conf in a text editor, and add the following lines:

LoadFile "C:/EPrints/Perl/bin/perl58.dll"
LoadModule perl_module modules/mod_perl.so

===Configuring Apache and Perl===

You will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Make sure both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin are included in the Path variable, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install optional components===

Install GhostScript, ImageMagick, and catdoc. These tools are not essential to try out EPrints, but provide extra functionality.

GhostScript should be installed in C:\EPrints\GhostScript .

Catdoc should be unzipped into C:\EPrints\catdoc-0.94.2 .

ImageMagick should be installed in C:\EPrints\ImageMagick . Select the options "Update executable search path" and "Install PerlMagick for ActiveState Perl". Other options can be deselected.

A ppm error may occur while installing the Perl component. If so, open a command prompt afterwards and enter:

cd\EPrints\ImageMagick\PerlMagick
ppm install Image-Magick.ppd

===Install EPrints 3===

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished copying files, it will prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

PerlPassEnv PERL5LIB
Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Control Apache from the Services panel. Stop and start the service before testing, to reload the configuration file.

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

====Indexer====

Task Scheduler should also be used to replace the indexer daemon. The options are as above, except with the script is called:
C:\EPrints\EPrints\bin\makeindex
However, to run more frequently than once per day, it is necessary to create a recurring Trigger. In the properties screen, modify the Trigger and set the Repeat task every: option.

Installing Eprints 3 on Windows

2008-03-04T17:08:15Z

Harry: Avoid editing startup.pl. Also new location for DBD-mysql.ppd

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

'''The EPrints 3.0 Windows Installer is under a proprietary license and is NOT redistributable.'''

==Caveats==

* The installation directory is fixed as C:\EPrints\

==Required Software==

===Apache===

'''Apache 2.2.6/2.2.8 have an incompatibility with mod_perl. Use 2.2.4 until this problem is fixed.'''

Download the MSI Win32 binary of Apache 2.2. Available in the "Other files" section of http://httpd.apache.org/download.cgi

===ActivePerl===

'''Note: ActiveState Perl 822 has an incompatibility with mod_perl. Use 820 until this problem is fixed.'''

Download ActiveState Perl Free Edition from http://downloads.activestate.com/ActivePerl/Windows/5.8/ActivePerl-5.8.8.820-MSWin32-x86-274739.msi

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

'''This file is under a proprietary license and are NOT redistributable.'''

# http://files.eprints.org/303/1/EPrints.exe

Like all EPrints releases, this is supplied without warranty and cannot be guaranteed to be free of bugs. Good backups are essential in a live archive.

==Optional Software==

===GhostScript 8.60===

This is used to convert PS and PDF formats. If it isn't installed these formats cannot be previewed or indexed by EPrints, but can still be accessed normally by users.

Download from http://downloads.sourceforge.net/ghostscript/gs860w32.exe

===Catdoc 0.94.2===

This is used to convert Microsoft Word and Powerpoint files. If it isn't installed these formats cannot be indexed by EPrints, but can still be accessed normally by users.

Download from http://webaugur.com/wares/files/catdoc-0.94.2-win32.zip

===ImageMagick 6.3.5-6===

This is used to convert image formats for preview. If it isn't installed these formats cannot be previewed, and thumbnails will have a generic icon.

'''Note: Recent versions of ImageMagick do not work with ActiveState Perl 820. Use 6.3.5-6 until this problem is fixed.'''

Old versions of ImageMagick are not available from the main site.

Download the Q16 DLL version from http://list.veidrodis.com/image_magick/binaries/ImageMagick-6.3.5-6-Q16-windows-dll.exe

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache===

Run the Apache installer. When prompted, choose to install in the directory C:\EPrints\Apache2.

===Install ActivePerl===

Run the ActivePerl installer. When prompted, choose to install in the directory C:\EPrints\Perl.
Ensure that Perl is added to your PATH.

When installation is complete, some optional components need to be installed from the command line. Open a command prompt and enter:

ppm install http://theoryx5.uwinnipeg.ca/ppms/DBD-mysql.ppd
ppm install http://theoryx5.uwinnipeg.ca/ppms/mod_perl.ppd

The mod_perl installer will prompt you for the Apache module path. Enter:
C:/EPrints/Apache2/modules

To add mod_perl support to Apache, edit the Apache configuration file, C:\EPrints\Apache2\conf\httpd.conf in a text editor, and add the following lines:

LoadFile "C:/EPrints/Perl/bin/perl58.dll"
LoadModule perl_module modules/mod_perl.so

===Configuring Apache and Perl===

You will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Make sure both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin are included in the Path variable, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install optional components===

Install GhostScript, ImageMagick, and catdoc. These tools are not essential to try out EPrints, but provide extra functionality.

GhostScript should be installed in C:\EPrints\GhostScript .

Catdoc should be unzipped into C:\EPrints\catdoc-0.94.2 .

ImageMagick should be installed in C:\EPrints\ImageMagick . Select the options "Update executable search path" and "Install PerlMagick for ActiveState Perl". Other options can be deselected.

A ppm error may occur while installing the Perl component. If so, open a command prompt afterwards and enter:

cd\EPrints\ImageMagick\PerlMagick
ppm install Image-Magick.ppd

===Install EPrints 3===

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished copying files, it will prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

PerlPassEnv PERL5LIB
Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Control Apache from the Services panel. Stop and start the service before testing, to reload the configuration file.

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

====Indexer====

Task Scheduler should also be used to replace the indexer daemon. The options are as above, except with the script is called:
C:\EPrints\EPrints\bin\makeindex
However, to run more frequently than once per day, it is necessary to create a recurring Trigger. In the properties screen, modify the Trigger and set the Repeat task every: option.

Installing Eprints 3 on Windows

2008-02-29T15:45:48Z

Harry: 2.2.8 seems to be broken too, for now

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

'''The EPrints 3.0 Windows Installer is under a proprietary license and is NOT redistributable.'''

==Caveats==

* The installation directory is fixed as C:\EPrints\

==Required Software==

===Apache===

'''Apache 2.2.6/2.2.8 have an incompatibility with mod_perl. Use 2.2.4 until this problem is fixed.'''

Download the MSI Win32 binary of Apache 2.2. Available in the "Other files" section of http://httpd.apache.org/download.cgi

===ActivePerl===

'''Note: ActiveState Perl 822 has an incompatibility with mod_perl. Use 820 until this problem is fixed.'''

Download ActiveState Perl Free Edition from http://downloads.activestate.com/ActivePerl/Windows/5.8/ActivePerl-5.8.8.820-MSWin32-x86-274739.msi

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

'''This file is under a proprietary license and are NOT redistributable.'''

# http://files.eprints.org/303/1/EPrints.exe

Like all EPrints releases, this is supplied without warranty and cannot be guaranteed to be free of bugs. Good backups are essential in a live archive.

==Optional Software==

===GhostScript 8.60===

This is used to convert PS and PDF formats. If it isn't installed these formats cannot be previewed or indexed by EPrints, but can still be accessed normally by users.

Download from http://downloads.sourceforge.net/ghostscript/gs860w32.exe

===Catdoc 0.94.2===

This is used to convert Microsoft Word and Powerpoint files. If it isn't installed these formats cannot be indexed by EPrints, but can still be accessed normally by users.

Download from http://webaugur.com/wares/files/catdoc-0.94.2-win32.zip

===ImageMagick 6.3.5-6===

This is used to convert image formats for preview. If it isn't installed these formats cannot be previewed, and thumbnails will have a generic icon.

'''Note: Recent versions of ImageMagick do not work with ActiveState Perl 820. Use 6.3.5-6 until this problem is fixed.'''

Old versions of ImageMagick are not available from the main site.

Download the Q16 DLL version from http://list.veidrodis.com/image_magick/binaries/ImageMagick-6.3.5-6-Q16-windows-dll.exe

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache===

Run the Apache installer. When prompted, choose to install in the directory C:\EPrints\Apache2.

===Install ActivePerl===

Run the ActivePerl installer. When prompted, choose to install in the directory C:\EPrints\Perl.
Ensure that Perl is added to your PATH.

When installation is complete, some optional components need to be installed from the command line. Open a command prompt and enter:

ppm install DBD::mysql
ppm install http://theoryx5.uwinnipeg.ca/ppms/mod_perl.ppd

The mod_perl installer will prompt you for the Apache module path. Enter:
C:/EPrints/Apache2/modules

To add mod_perl support to Apache, edit the Apache configuration file, C:\EPrints\Apache2\conf\httpd.conf in a text editor, and add the following lines:

LoadFile "C:/EPrints/Perl/bin/perl58.dll"
LoadModule perl_module modules/mod_perl.so

===Configuring Apache and Perl===

You will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Make sure both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin are included in the Path variable, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install optional components===

Install GhostScript, ImageMagick, and catdoc. These tools are not essential to try out EPrints, but provide extra functionality.

GhostScript should be installed in C:\EPrints\GhostScript .

Catdoc should be unzipped into C:\EPrints\catdoc-0.94.2 .

ImageMagick should be installed in C:\EPrints\ImageMagick . Select the options "Update executable search path" and "Install PerlMagick for ActiveState Perl". Other options can be deselected.

A ppm error may occur while installing the Perl component. If so, open a command prompt afterwards and enter:

cd\EPrints\ImageMagick\PerlMagick
ppm install Image-Magick.ppd

===Install EPrints 3===

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished copying files, it will prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

Also edit C:\EPrints\EPrints\bin\startup.pl, and change the first line to:
use lib 'C:/EPrints/EPrints/perl_lib';
This will be fixed in the next release.

===Starting Apache===

Control Apache from the Services panel. Stop and start the service before testing, to reload the configuration file.

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

====Indexer====

Task Scheduler should also be used to replace the indexer daemon. The options are as above, except with the script is called:
C:\EPrints\EPrints\bin\makeindex
However, to run more frequently than once per day, it is necessary to create a recurring Trigger. In the properties screen, modify the Trigger and set the Repeat task every: option.

Installing Eprints 3 on Windows

2007-11-14T14:41:33Z

Harry: Apache Perl no longer supported. Downgraded to older versions to avoid crashes on pre-Vista versions.

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

'''The EPrints 3.0 Windows Installer is under a proprietary license and is NOT redistributable.'''

==Caveats==

* The installation directory is fixed as C:\EPrints\

==Required Software==

===Apache===

'''Apache 2.2.6 has an incompatibility with mod_perl. Use 2.2.4 until this problem is fixed.'''

Download the MSI Win32 binary of Apache 2.2. Available in the "Other files" section of http://httpd.apache.org/download.cgi

===ActivePerl===

'''Note: ActiveState Perl 822 has an incompatibility with mod_perl. Use 820 until this problem is fixed.'''

Download ActiveState Perl Free Edition from http://downloads.activestate.com/ActivePerl/Windows/5.8/ActivePerl-5.8.8.820-MSWin32-x86-274739.msi

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

'''This file is under a proprietary license and are NOT redistributable.'''

# http://files.eprints.org/303/1/EPrints.exe

Like all EPrints releases, this is supplied without warranty and cannot be guaranteed to be free of bugs. Good backups are essential in a live archive.

==Optional Software==

===GhostScript 8.60===

This is used to convert PS and PDF formats. If it isn't installed these formats cannot be previewed or indexed by EPrints, but can still be accessed normally by users.

Download from http://downloads.sourceforge.net/ghostscript/gs860w32.exe

===Catdoc 0.94.2===

This is used to convert Microsoft Word and Powerpoint files. If it isn't installed these formats cannot be indexed by EPrints, but can still be accessed normally by users.

Download from http://webaugur.com/wares/files/catdoc-0.94.2-win32.zip

===ImageMagick 6.3.5-6===

This is used to convert image formats for preview. If it isn't installed these formats cannot be previewed, and thumbnails will have a generic icon.

'''Note: Recent versions of ImageMagick do not work with ActiveState Perl 820. Use 6.3.5-6 until this problem is fixed.'''

Old versions of ImageMagick are not available from the main site.

Download the Q16 DLL version from http://list.veidrodis.com/image_magick/binaries/ImageMagick-6.3.5-6-Q16-windows-dll.exe

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache===

Run the Apache installer. When prompted, choose to install in the directory C:\EPrints\Apache2.

===Install ActivePerl===

Run the ActivePerl installer. When prompted, choose to install in the directory C:\EPrints\Perl.
Ensure that Perl is added to your PATH.

When installation is complete, some optional components need to be installed from the command line. Open a command prompt and enter:

ppm install DBD::mysql
ppm install http://theoryx5.uwinnipeg.ca/ppms/mod_perl.ppd

The mod_perl installer will prompt you for the Apache module path. Enter:
C:/EPrints/Apache2/modules

To add mod_perl support to Apache, edit the Apache configuration file, C:\EPrints\Apache2\conf\httpd.conf in a text editor, and add the following lines:

LoadFile "C:/EPrints/Perl/bin/perl58.dll"
LoadModule perl_module modules/mod_perl.so

===Configuring Apache and Perl===

You will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Make sure both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin are included in the Path variable, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install optional components===

Install GhostScript, ImageMagick, and catdoc. These tools are not essential to try out EPrints, but provide extra functionality.

GhostScript should be installed in C:\EPrints\GhostScript .

Catdoc should be unzipped into C:\EPrints\catdoc-0.94.2 .

ImageMagick should be installed in C:\EPrints\ImageMagick . Select the options "Update executable search path" and "Install PerlMagick for ActiveState Perl". Other options can be deselected.

A ppm error may occur while installing the Perl component. If so, open a command prompt afterwards and enter:

cd\EPrints\ImageMagick\PerlMagick
ppm install Image-Magick.ppd

===Install EPrints 3===

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished copying files, it will prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

Also edit C:\EPrints\EPrints\bin\startup.pl, and change the first line to:
use lib 'C:/EPrints/EPrints/perl_lib';
This will be fixed in the next release.

===Starting Apache===

Control Apache from the Services panel. Stop and start the service before testing, to reload the configuration file.

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

====Indexer====

Task Scheduler should also be used to replace the indexer daemon. The options are as above, except with the script is called:
C:\EPrints\EPrints\bin\makeindex
However, to run more frequently than once per day, it is necessary to create a recurring Trigger. In the properties screen, modify the Trigger and set the Repeat task every: option.

Installing Eprints 3 on Windows

2007-11-08T17:38:48Z

Harry: ActiveState Perl causing crashes. Please use Apache Perl until fixed.

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

'''The EPrints 3.0 Windows Installer is under a proprietary license and is NOT redistributable.'''

==Caveats==

* The installation directory is fixed as C:\EPrints\

==Required Software==

Either download Apache and ActivePerl, or the Apache Perl bundle. Apache Perl was supported because of the license conditions of ActivePerl, but contains older versions which may be missing security fixes.

'''NOTE: There is a problem with Apache and ActiveState, causing Apache to crash on startup. Please use Apache Perl for now.'''

===Apache===

'''Apache 2.2.6 has an incompatibility with mod_perl. Use 2.2.4 until this problem is fixed.'''

Download the MSI Win32 binary of Apache 2.2. Available in the "Other files" section of http://httpd.apache.org/download.cgi

===ActivePerl===

Download ActiveState Perl Free Edition from http://www.activestate.com/

===Apache Perl===

Alternatively, the Apache Perl bundle includes Apache, Perl, and mod_perl. However it is an older version of Apache which may be missing important updates.

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

'''This file is under a proprietary license and are NOT redistributable.'''

# http://files.eprints.org/303/1/EPrints.exe

Like all EPrints releases, this is supplied without warranty and cannot be guaranteed to be free of bugs. Good backups are essential in a live archive.

==Optional Software==

===GhostScript 8.60===

This is used to convert PS and PDF formats. If it isn't installed these formats cannot be previewed or indexed by EPrints, but can still be accessed normally by users.

Download from http://downloads.sourceforge.net/ghostscript/gs860w32.exe

===Catdoc 0.94.2===

This is used to convert Microsoft Word and Powerpoint files. If it isn't installed these formats cannot be indexed by EPrints, but can still be accessed normally by users.

Download from http://webaugur.com/wares/files/catdoc-0.94.2-win32.zip

===ImageMagick===

This is used to convert image formats for preview. If it isn't installed these formats cannot be previewed, and thumbnails will have a generic icon.

Download the Q8 DLL version from http://www.imagemagick.org/download/binaries/

The installation must update the search path and include the Perl component. Make sure Perl is installed first.

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

'''NOTE: There is a problem with Apache and ActiveState, causing Apache to crash on startup. Please use Apache Perl for now.'''

===Install Apache===

Run the Apache installer. When prompted, choose to install in the directory C:\EPrints\Apache2.

===Install ActivePerl===

Run the ActivePerl installer. When prompted, choose to install in the directory C:\EPrints\Perl.
Ensure that Perl is added to your PATH.

When installation is complete, some optional components need to be installed from the command line. Open a command prompt and enter:

ppm install DBD::mysql
ppm install http://theoryx5.uwinnipeg.ca/ppms/mod_perl.ppd

The mod_perl installer will prompt you for the Apache module path. Enter:
C:/EPrints/Apache2/modules

To add mod_perl support to Apache, edit the Apache configuration file, C:\EPrints\Apache2\conf\httpd.conf in a text editor, and add the following lines:

LoadFile "C:/EPrints/Perl/bin/perl58.dll"
LoadModule perl_module modules/mod_perl.so

===Install Apache Perl===

Follow these instructions if you chose to use Apache Perl.

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

===Configuring Apache and Perl===

You will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Make sure both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin are included in the Path variable, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install optional components===

Install GhostScript, ImageMagick, and catdoc. These tools are not essential to try out EPrints, but provide extra functionality.

GhostScript should be installed in C:\EPrints\GhostScript .

Catdoc should be unzipped into C:\EPrints\catdoc-0.94.2 .

ImageMagick should be installed in C:\EPrints\ImageMagick . Make sure to update the search path and install the Perl components.

===Install EPrints 3===

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished copying files, it will prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Control Apache from the Services panel. Stop and start the service before testing, to reload the configuration file.

====Apache Perl====

If using Apache Perl, Apache will not automatically be registered as a service.

To test, start Apache from the command line:

C:
cd \EPrints\Apache2
bin\apache

To terminate Apache, press Ctrl-C.

To register Apache as a service, run the following command ''as Administrator'' (right-click on the Command Prompt application icon and select Run as Administrator):

C:
cd \EPrints\Apache2
bin\apache -k install

Note that this does not start Apache immediately nor configure it to start automatically. These options should be set in the standard Services tool as normal.

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

====Indexer====

Task Scheduler should also be used to replace the indexer daemon. The options are as above, except with the script is called:
C:\EPrints\EPrints\bin\makeindex
However, to run more frequently than once per day, it is necessary to create a recurring Trigger. In the properties screen, modify the Trigger and set the Repeat task every: option.

Talk:Installing Eprints 3 on Windows

2007-11-08T17:33:57Z

Harry:

Please email me ( hjm03r @ ecs.soton.ac.uk ) directly if you are having problems with installing EPrints on Windows.

Installing Eprints 3 on Windows

2007-11-07T11:54:02Z

Harry: ImageMagick release change

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

'''The EPrints 3.0 Windows Installer is under a proprietary license and is NOT redistributable.'''

==Caveats==

* The installation directory is fixed as C:\EPrints\

==Required Software==

Either download Apache and ActivePerl, or the Apache Perl bundle. Apache Perl was supported because of the license conditions of ActivePerl, but contains older versions which may be missing security fixes.

===Apache===

'''Apache 2.2.6 has an incompatibility with mod_perl. Use 2.2.4 until this problem is fixed.'''

Download the MSI Win32 binary of Apache 2.2. Available in the "Other files" section of http://httpd.apache.org/download.cgi

===ActivePerl===

Download ActiveState Perl Free Edition from http://www.activestate.com/

===Apache Perl===

Alternatively, the Apache Perl bundle includes Apache, Perl, and mod_perl. However it is an older version of Apache which may be missing important updates.

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

'''This file is under a proprietary license and are NOT redistributable.'''

# http://files.eprints.org/303/1/EPrints.exe

Like all EPrints releases, this is supplied without warranty and cannot be guaranteed to be free of bugs. Good backups are essential in a live archive.

==Optional Software==

===GhostScript 8.60===

This is used to convert PS and PDF formats. If it isn't installed these formats cannot be previewed or indexed by EPrints, but can still be accessed normally by users.

Download from http://downloads.sourceforge.net/ghostscript/gs860w32.exe

===Catdoc 0.94.2===

This is used to convert Microsoft Word and Powerpoint files. If it isn't installed these formats cannot be indexed by EPrints, but can still be accessed normally by users.

Download from http://webaugur.com/wares/files/catdoc-0.94.2-win32.zip

===ImageMagick===

This is used to convert image formats for preview. If it isn't installed these formats cannot be previewed, and thumbnails will have a generic icon.

Download the Q8 DLL version from http://www.imagemagick.org/download/binaries/

The installation must update the search path and include the Perl component. Make sure Perl is installed first.

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache===

Run the Apache installer. When prompted, choose to install in the directory C:\EPrints\Apache2.

===Install ActivePerl===

Run the ActivePerl installer. When prompted, choose to install in the directory C:\EPrints\Perl.
Ensure that Perl is added to your PATH.

When installation is complete, some optional components need to be installed from the command line. Open a command prompt and enter:

ppm install DBD::mysql
ppm install http://theoryx5.uwinnipeg.ca/ppms/mod_perl.ppd

The mod_perl installer will prompt you for the Apache module path. Enter:
C:/EPrints/Apache2/modules

To add mod_perl support to Apache, edit the Apache configuration file, C:\EPrints\Apache2\conf\httpd.conf in a text editor, and add the following lines:

LoadFile "C:/EPrints/Perl/bin/perl58.dll"
LoadModule perl_module modules/mod_perl.so

===Install Apache Perl===

Follow these instructions if you chose to use Apache Perl.

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

===Configuring Apache and Perl===

You will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Make sure both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin are included in the Path variable, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install optional components===

Install GhostScript, ImageMagick, and catdoc. These tools are not essential to try out EPrints, but provide extra functionality.

GhostScript should be installed in C:\EPrints\GhostScript .

Catdoc should be unzipped into C:\EPrints\catdoc-0.94.2 .

ImageMagick should be installed in C:\EPrints\ImageMagick . Make sure to update the search path and install the Perl components.

===Install EPrints 3===

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished copying files, it will prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Control Apache from the Services panel. Stop and start the service before testing, to reload the configuration file.

====Apache Perl====

If using Apache Perl, Apache will not automatically be registered as a service.

To test, start Apache from the command line:

C:
cd \EPrints\Apache2
bin\apache

To terminate Apache, press Ctrl-C.

To register Apache as a service, run the following command ''as Administrator'' (right-click on the Command Prompt application icon and select Run as Administrator):

C:
cd \EPrints\Apache2
bin\apache -k install

Note that this does not start Apache immediately nor configure it to start automatically. These options should be set in the standard Services tool as normal.

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

====Indexer====

Task Scheduler should also be used to replace the indexer daemon. The options are as above, except with the script is called:
C:\EPrints\EPrints\bin\makeindex
However, to run more frequently than once per day, it is necessary to create a recurring Trigger. In the properties screen, modify the Trigger and set the Repeat task every: option.

Installing Eprints 3 on Windows

2007-10-12T16:20:04Z

Harry:

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

'''The EPrints 3.0 Windows Installer is under a proprietary license and is NOT redistributable.'''

==Caveats==

* The installation directory is fixed as C:\EPrints\

==Required Software==

Either download Apache and ActivePerl, or the Apache Perl bundle. Apache Perl was supported because of the license conditions of ActivePerl, but contains older versions which may be missing security fixes.

===Apache===

'''Apache 2.2.6 has an incompatibility with mod_perl. Use 2.2.4 until this problem is fixed.'''

Download the MSI Win32 binary of Apache 2.2. Available in the "Other files" section of http://httpd.apache.org/download.cgi

===ActivePerl===

Download ActiveState Perl Free Edition from http://www.activestate.com/

===Apache Perl===

Alternatively, the Apache Perl bundle includes Apache, Perl, and mod_perl. However it is an older version of Apache which may be missing important updates.

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

'''This file is under a proprietary license and are NOT redistributable.'''

# http://files.eprints.org/303/1/EPrints.exe

Like all EPrints releases, this is supplied without warranty and cannot be guaranteed to be free of bugs. Good backups are essential in a live archive.

==Optional Software==

===GhostScript 8.60===

This is used to convert PS and PDF formats. If it isn't installed these formats cannot be previewed or indexed by EPrints, but can still be accessed normally by users.

Download from http://downloads.sourceforge.net/ghostscript/gs860w32.exe

===Catdoc 0.94.2===

This is used to convert Microsoft Word and Powerpoint files. If it isn't installed these formats cannot be indexed by EPrints, but can still be accessed normally by users.

Download from http://webaugur.com/wares/files/catdoc-0.94.2-win32.zip

===ImageMagick===

This is used to convert image formats for preview. If it isn't installed these formats cannot be previewed, and thumbnails will have a generic icon.

Download from http://www.imagemagick.org/download/binaries/ImageMagick-6.3.5-10-Q8-windows-dll.exe

The installation must update the search path and include the Perl component. Make sure Perl is installed first.

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache===

Run the Apache installer. When prompted, choose to install in the directory C:\EPrints\Apache2.

===Install ActivePerl===

Run the ActivePerl installer. When prompted, choose to install in the directory C:\EPrints\Perl.
Ensure that Perl is added to your PATH.

When installation is complete, some optional components need to be installed from the command line. Open a command prompt and enter:

ppm install DBD::mysql
ppm install http://theoryx5.uwinnipeg.ca/ppms/mod_perl.ppd

The mod_perl installer will prompt you for the Apache module path. Enter:
C:/EPrints/Apache2/modules

To add mod_perl support to Apache, edit the Apache configuration file, C:\EPrints\Apache2\conf\httpd.conf in a text editor, and add the following lines:

LoadFile "C:/EPrints/Perl/bin/perl58.dll"
LoadModule perl_module modules/mod_perl.so

===Install Apache Perl===

Follow these instructions if you chose to use Apache Perl.

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

===Configuring Apache and Perl===

You will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Make sure both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin are included in the Path variable, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install optional components===

Install GhostScript, ImageMagick, and catdoc. These tools are not essential to try out EPrints, but provide extra functionality.

GhostScript should be installed in C:\EPrints\GhostScript .

Catdoc should be unzipped into C:\EPrints\catdoc-0.94.2 .

ImageMagick should be installed in C:\EPrints\ImageMagick . Make sure to update the search path and install the Perl components.

===Install EPrints 3===

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished copying files, it will prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Control Apache from the Services panel. Stop and start the service before testing, to reload the configuration file.

====Apache Perl====

If using Apache Perl, Apache will not automatically be registered as a service.

To test, start Apache from the command line:

C:
cd \EPrints\Apache2
bin\apache

To terminate Apache, press Ctrl-C.

To register Apache as a service, run the following command ''as Administrator'' (right-click on the Command Prompt application icon and select Run as Administrator):

C:
cd \EPrints\Apache2
bin\apache -k install

Note that this does not start Apache immediately nor configure it to start automatically. These options should be set in the standard Services tool as normal.

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

====Indexer====

Task Scheduler should also be used to replace the indexer daemon. The options are as above, except with the script is called:
C:\EPrints\EPrints\bin\makeindex
However, to run more frequently than once per day, it is necessary to create a recurring Trigger. In the properties screen, modify the Trigger and set the Repeat task every: option.

Installing Eprints 3 on Windows

2007-10-12T16:18:10Z

Harry: bugfix update

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

'''The EPrints 3.0 Windows Installer is under a proprietary license and is NOT redistributable.'''

==Caveats==

* The installation directory is fixed as C:\EPrints\

==Required Software==

Either download Apache and ActivePerl, or the Apache Perl bundle. Apache Perl was supported because of the license conditions of ActivePerl, but contains older versions which may be missing security fixes.

===Apache===

'''Apache 2.2.6 has an incompatibility with mod_perl. Use 2.2.4 until this problem is fixed.'''

Download the MSI Win32 binary of Apache 2.2. Available in the "Other files" section of http://httpd.apache.org/download.cgi

===ActivePerl===

Download ActiveState Perl Free Edition from http://www.activestate.com/

===Apache Perl===

Alternatively, the Apache Perl bundle includes Apache, Perl, and mod_perl. However it is an older version of Apache which may be missing important updates.

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

'''This file is under a proprietary license and are NOT redistributable.'''

# http://files.eprints.org/303/1/EPrints.exe

Like all EPrints releases, this is supplied without warranty and cannot be guaranteed to be free of bugs. Good backups are essential in a live archive.

==Optional Software==

===GhostScript 8.60===

This is used to convert PS and PDF formats. If it isn't installed these formats cannot be previewed or indexed by EPrints, but can still be accessed normally by users.

Download from http://downloads.sourceforge.net/ghostscript/gs860w32.exe

===Catdoc 0.94.2===

This is used to convert Microsoft Word and Powerpoint files. If it isn't installed these formats cannot be indexed by EPrints, but can still be accessed normally by users.

Download from http://webaugur.com/wares/files/catdoc-0.94.2-win32.zip

===ImageMagick===

This is used to convert image formats for preview. If it isn't installed these formats cannot be previewed, and thumbnails will have a generic icon.

Download from http://www.imagemagick.org/download/binaries/ImageMagick-6.3.5-10-Q8-windows-dll.exe

The installation must update the search path and include the Perl component. Make sure Perl is installed first.

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache===

Run the Apache installer. When prompted, choose to install in the directory C:\EPrints\Apache2.

===Install ActivePerl===

Run the ActivePerl installer. When prompted, choose to install in the directory C:\EPrints\Perl.
Ensure that Perl is added to your PATH.

When installation is complete, some optional components need to be installed from the command line. Open a command prompt and enter:

ppm install DBD::mysql
ppm install http://theoryx5.uwinnipeg.ca/ppms/mod_perl.ppd

To add mod_perl support to Apache, edit the Apache configuration file, C:\EPrints\Apache2\conf\httpd.conf in a text editor, and add the following lines:

LoadFile "C:/EPrints/Perl/bin/perl58.dll"
LoadModule perl_module modules/mod_perl.so

===Install Apache Perl===

Follow these instructions if you chose to use Apache Perl.

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

===Configuring Apache and Perl===

You will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Make sure both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin are included in the Path variable, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install optional components===

Install GhostScript, ImageMagick, and catdoc. These tools are not essential to try out EPrints, but provide extra functionality.

GhostScript should be installed in C:\EPrints\GhostScript .

Catdoc should be unzipped into C:\EPrints\catdoc-0.94.2 .

ImageMagick should be installed in C:\EPrints\ImageMagick . Make sure to update the search path and install the Perl components.

===Install EPrints 3===

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished copying files, it will prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Control Apache from the Services panel. Stop and start the service before testing, to reload the configuration file.

====Apache Perl====

If using Apache Perl, Apache will not automatically be registered as a service.

To test, start Apache from the command line:

C:
cd \EPrints\Apache2
bin\apache

To terminate Apache, press Ctrl-C.

To register Apache as a service, run the following command ''as Administrator'' (right-click on the Command Prompt application icon and select Run as Administrator):

C:
cd \EPrints\Apache2
bin\apache -k install

Note that this does not start Apache immediately nor configure it to start automatically. These options should be set in the standard Services tool as normal.

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

====Indexer====

Task Scheduler should also be used to replace the indexer daemon. The options are as above, except with the script is called:
C:\EPrints\EPrints\bin\makeindex
However, to run more frequently than once per day, it is necessary to create a recurring Trigger. In the properties screen, modify the Trigger and set the Repeat task every: option.

Files/EPrints 3.0 Windows Installer (r2963)

2007-10-12T16:16:40Z

Harry:

#REDIRECT [[Installing_Eprints_3_on_Windows]]

Installing Eprints 3 on Windows

2007-10-12T15:26:20Z

Harry: ActivePerl support

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

'''The EPrints 3.0 Windows Installer is under a proprietary license and is NOT redistributable.'''

==Caveats==

* The installation directory is fixed as C:\EPrints\

==Required Software==

Either download Apache and ActivePerl, or the Apache Perl bundle. Apache Perl was supported because of the license conditions of ActivePerl, but contains older versions which may be missing security fixes.

===Apache===

'''Apache 2.2.6 has an incompatibility with mod_perl. Use 2.2.4 until this problem is fixed.'''

Download the MSI Win32 binary of Apache 2.2. Available in the "Other files" section of http://httpd.apache.org/download.cgi

===ActivePerl===

Download ActiveState Perl Free Edition from http://www.activestate.com/

===Apache Perl===

Alternatively, the Apache Perl bundle includes Apache, Perl, and mod_perl. However it is an older version of Apache which may be missing important updates.

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

'''This file is under a proprietary license and are NOT redistributable.'''

# http://files.eprints.org/300/1/EPrints.exe

Like all EPrints releases, this is supplied without warranty and cannot be guaranteed to be free of bugs. Good backups are essential in a live archive.

==Optional Software==

===GhostScript 8.60===

This is used to convert PS and PDF formats. If it isn't installed these formats cannot be previewed or indexed by EPrints, but can still be accessed normally by users.

Download from http://downloads.sourceforge.net/ghostscript/gs860w32.exe

===Catdoc 0.94.2===

This is used to convert Microsoft Word and Powerpoint files. If it isn't installed these formats cannot be indexed by EPrints, but can still be accessed normally by users.

Download from http://webaugur.com/wares/files/catdoc-0.94.2-win32.zip

===ImageMagick===

This is used to convert image formats for preview. If it isn't installed these formats cannot be previewed, and thumbnails will have a generic icon.

Download from http://www.imagemagick.org/download/binaries/ImageMagick-6.3.5-10-Q8-windows-dll.exe

The installation must update the search path and include the Perl component. Make sure Perl is installed first.

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache===

Run the Apache installer. When prompted, choose to install in the directory C:\EPrints\Apache2.

===Install ActivePerl===

Run the ActivePerl installer. When prompted, choose to install in the directory C:\EPrints\Perl.
Ensure that Perl is added to your PATH.

When installation is complete, some optional components need to be installed from the command line. Open a command prompt and enter:

ppm install DBD::mysql
ppm install http://theoryx5.uwinnipeg.ca/ppms/mod_perl.ppd

To add mod_perl support to Apache, edit the Apache configuration file, C:\EPrints\Apache2\conf\httpd.conf in a text editor, and add the following lines:

LoadFile "C:/EPrints/Perl/bin/perl58.dll"
LoadModule perl_module modules/mod_perl.so

===Install Apache Perl===

Follow these instructions if you chose to use Apache Perl.

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

===Configuring Apache and Perl===

You will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Make sure both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin are included in the Path variable, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install optional components===

Install GhostScript, ImageMagick, and catdoc. These tools are not essential to try out EPrints, but provide extra functionality.

GhostScript should be installed in C:\EPrints\GhostScript .

Catdoc should be unzipped into C:\EPrints\catdoc-0.94.2 .

ImageMagick should be installed in C:\EPrints\ImageMagick . Make sure to update the search path and install the Perl components.

===Install EPrints 3===

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished copying files, it will prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Control Apache from the Services panel.

====Apache Perl====

If using Apache Perl, Apache will not automatically be registered as a service.

To test, start Apache from the command line:

C:
cd \EPrints\Apache2
bin\apache

To terminate Apache, press Ctrl-C.

To register Apache as a service, run the following command ''as Administrator'' (right-click on the Command Prompt application icon and select Run as Administrator):

C:
cd \EPrints\Apache2
bin\apache -k install

Note that this does not start Apache immediately nor configure it to start automatically. These options should be set in the standard Services tool as normal.

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

====Indexer====

Task Scheduler should also be used to replace the indexer daemon. The options are as above, except with the script is called:
C:\EPrints\EPrints\bin\makeindex
However, to run more frequently than once per day, it is necessary to create a recurring Trigger. In the properties screen, modify the Trigger and set the Repeat task every: option.

Installing Eprints 3 on Windows

2007-10-11T15:45:22Z

Harry: /* Caveats */ Indexing and images now supported

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

'''The EPrints 3.0 Windows Installer is under a proprietary license and is NOT redistributable.'''

==Caveats==

* The installation directory is fixed as C:\EPrints\
* The "Apache Perl" bundle currently used* includes an old release of Apache which is missing subsequent security updates: see http://www.apache.org/dist/httpd/CHANGES_2.0 Alternative versions of Apache, Perl, and mod_perl have not yet been tested.

''* This Apache/Perl bundle was chosen because ActiveState Perl's license does not permit redistribution.''

==Required Software==

===Apache Perl===

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

'''This file is under a proprietary license and are NOT redistributable.'''

# http://files.eprints.org/300/1/EPrints.exe

Like all EPrints releases, this is supplied without warranty and cannot be guaranteed to be free of bugs. Good backups are essential in a live archive.

==Optional Software==

===GhostScript 8.60===

This is used to convert PS and PDF formats. If it isn't installed these formats cannot be previewed or indexed by EPrints, but can still be accessed normally by users.

Download from http://downloads.sourceforge.net/ghostscript/gs860w32.exe

===Catdoc 0.94.2===

This is used to convert Microsoft Word and Powerpoint files. If it isn't installed these formats cannot be indexed by EPrints, but can still be accessed normally by users.

Download from http://webaugur.com/wares/files/catdoc-0.94.2-win32.zip

===ImageMagick===

This is used to convert image formats for preview. If it isn't installed these formats cannot be previewed, and thumbnails will have a generic icon.

Download from http://www.imagemagick.org/download/binaries/ImageMagick-6.3.5-10-Q8-windows-dll.exe

The installation must update the search path and include the Perl component. Make sure Perl is installed first.

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache Perl===

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

===Configure Apache Perl===

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

When the configuration tool is finished, you will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Add both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin to Path, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install optional components===

Install GhostScript, ImageMagick, and catdoc. These tools are not essential to try out EPrints, but provide extra functionality.

GhostScript should be installed in C:\EPrints\GhostScript .

Catdoc should be unzipped into C:\EPrints\catdoc-0.94.2 .

ImageMagick should be installed in C:\EPrints\ImageMagick . Make sure to update the search path and install the Perl components.

===Install EPrints 3===

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished copying files, it will prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

To test, start Apache from the command line:

C:
cd \EPrints\Apache2
bin\apache

To terminate Apache, press Ctrl-C.

To register Apache as a service, run the following command ''as Administrator'' (right-click on the Command Prompt application icon and select Run as Administrator):

C:
cd \EPrints\Apache2
bin\apache -k install

Note that this does not start Apache immediately nor configure it to start automatically. These options should be set in the standard Services tool as normal.

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

====Indexer====

Task Scheduler should also be used to replace the indexer daemon. The options are as above, except with the script is called:
C:\EPrints\EPrints\bin\makeindex
However, to run more frequently than once per day, it is necessary to create a recurring Trigger. In the properties screen, modify the Trigger and set the Repeat task every: option.

Installing Eprints 3 on Windows

2007-10-09T10:28:39Z

Harry: Updated instructions for production release

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

'''The EPrints 3.0 Windows Installer is under a proprietary license and is NOT redistributable.'''

==Caveats==

* The installation directory is fixed as C:\EPrints\
* EPrints cannot yet run external commands, for example using ImageMagick to generate thumbnails of image deposits.
* Documents are not yet indexed. A workaround is available and will be added to this page shortly.
* The "Apache Perl" bundle currently used* includes an old release of Apache which is missing subsequent security updates: see http://www.apache.org/dist/httpd/CHANGES_2.0 Alternative versions of Apache, Perl, and mod_perl have not yet been tested.

''* This Apache/Perl bundle was chosen because ActiveState Perl's license does not permit redistribution.''

==Required Software==

===Apache Perl===

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

'''This file is under a proprietary license and are NOT redistributable.'''

# http://files.eprints.org/300/1/EPrints.exe

Like all EPrints releases, this is supplied without warranty and cannot be guaranteed to be free of bugs. Good backups are essential in a live archive.

==Optional Software==

===GhostScript 8.60===

This is used to convert PS and PDF formats. If it isn't installed these formats cannot be previewed or indexed by EPrints, but can still be accessed normally by users.

Download from http://downloads.sourceforge.net/ghostscript/gs860w32.exe

===Catdoc 0.94.2===

This is used to convert Microsoft Word and Powerpoint files. If it isn't installed these formats cannot be indexed by EPrints, but can still be accessed normally by users.

Download from http://webaugur.com/wares/files/catdoc-0.94.2-win32.zip

===ImageMagick===

This is used to convert image formats for preview. If it isn't installed these formats cannot be previewed, and thumbnails will have a generic icon.

Download from http://www.imagemagick.org/download/binaries/ImageMagick-6.3.5-10-Q8-windows-dll.exe

The installation must update the search path and include the Perl component. Make sure Perl is installed first.

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache Perl===

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

===Configure Apache Perl===

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

When the configuration tool is finished, you will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Add both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin to Path, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install optional components===

Install GhostScript, ImageMagick, and catdoc. These tools are not essential to try out EPrints, but provide extra functionality.

GhostScript should be installed in C:\EPrints\GhostScript .

Catdoc should be unzipped into C:\EPrints\catdoc-0.94.2 .

ImageMagick should be installed in C:\EPrints\ImageMagick . Make sure to update the search path and install the Perl components.

===Install EPrints 3===

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished copying files, it will prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

To test, start Apache from the command line:

C:
cd \EPrints\Apache2
bin\apache

To terminate Apache, press Ctrl-C.

To register Apache as a service, run the following command ''as Administrator'' (right-click on the Command Prompt application icon and select Run as Administrator):

C:
cd \EPrints\Apache2
bin\apache -k install

Note that this does not start Apache immediately nor configure it to start automatically. These options should be set in the standard Services tool as normal.

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

====Indexer====

Task Scheduler should also be used to replace the indexer daemon. The options are as above, except with the script is called:
C:\EPrints\EPrints\bin\makeindex
However, to run more frequently than once per day, it is necessary to create a recurring Trigger. In the properties screen, modify the Trigger and set the Repeat task every: option.

Installing Eprints 3 on Windows

2007-09-28T16:00:35Z

Harry: /* Scheduling tasks */ Indexer

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

'''The EPrints 3.0 Windows Installer is under a proprietary license and is NOT redistributable.'''

==Caveats==

* The installation directory is fixed as C:\EPrints\
* EPrints cannot yet run external commands, for example using ImageMagick to generate thumbnails of image deposits.
* Documents are not yet indexed. A workaround is available and will be added to this page shortly.
* The "Apache Perl" bundle currently used* includes an old release of Apache which is missing subsequent security updates: see http://www.apache.org/dist/httpd/CHANGES_2.0 Alternative versions of Apache, Perl, and mod_perl have not yet been tested.

''* This Apache/Perl bundle was chosen because ActiveState Perl's license does not permit redistribution.''

==Required Software==

===Apache Perl===

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

'''This is an evaluation release. We do not recommend that it be used in a production environment.'''

'''This file is under a proprietary license and are NOT redistributable.'''

# http://files.eprints.org/300/1/EPrints.exe

==Optional Software==

===GhostScript 8.60===

This is used to convert PS and PDF formats. If it isn't installed these formats cannot be previewed or indexed by EPrints, but can still be accessed normally by users.

Download from http://downloads.sourceforge.net/ghostscript/gs860w32.exe

This should be installed in C:\EPrints\GhostScript .

===Catdoc 0.94.2===

This is used to convert Microsoft Word and Powerpoint files. If it isn't installed these formats cannot be indexed by EPrints, but can still be accessed normally by users.

Download from http://webaugur.com/wares/files/catdoc-0.94.2-win32.zip

This should be installed in C:\EPrints\catdoc-0.94.2 .

===ImageMagick===

This is used to convert image formats for preview. If it isn't installed these formats cannot be previewed, and thumbnails will have a generic icon.

Download from http://www.imagemagick.org/download/binaries/ImageMagick-6.3.5-10-Q8-windows-dll.exe

This should be installed in C:\EPrints\ImageMagick .
The installation must update the search path and include the Perl component. Make sure Perl is installed first.

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache Perl===

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

===Configure Apache Perl===

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

When the configuration tool is finished, you will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Add both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin to Path, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install optional components===

Install GhostScript, ImageMagick, and catdoc. These tools are not essential to try out EPrints, but provide extra functionality.

===Install EPrints 3===

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished copying files, it will prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

To test, start Apache from the command line:

C:
cd\EPrints\Apache2
bin\apache

To terminate Apache, press Ctrl-C.

To register Apache as a service, run the following command ''as Administrator'' (right-click on the Command Prompt application icon and select Run as Administrator):

C:
C:\EPrints\Apache2
bin\apache -k install

Note that this does not start Apache immediately nor configure it to start automatically. These options should be set in the standard Services tool as normal.

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

====Indexer====

Task Scheduler should also be used to replace the indexer daemon. The options are as above, except with the script is called:
C:\EPrints\EPrints\bin\makeindex
However, to run more frequently than once per day, it is necessary to create a recurring Trigger. In the properties screen, modify the Trigger and set the Repeat task every: option.

Installing Eprints 3 on Windows

2007-09-28T10:25:56Z

Harry: /* Starting Apache */ Services instructions

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

'''The EPrints 3.0 Windows Installer is under a proprietary license and is NOT redistributable.'''

==Caveats==

* The installation directory is fixed as C:\EPrints\
* EPrints cannot yet run external commands, for example using ImageMagick to generate thumbnails of image deposits.
* Documents are not yet indexed. A workaround is available and will be added to this page shortly.
* The "Apache Perl" bundle currently used* includes an old release of Apache which is missing subsequent security updates: see http://www.apache.org/dist/httpd/CHANGES_2.0 Alternative versions of Apache, Perl, and mod_perl have not yet been tested.

''* This Apache/Perl bundle was chosen because ActiveState Perl's license does not permit redistribution.''

==Required Software==

===Apache Perl===

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

'''This is an evaluation release. We do not recommend that it be used in a production environment.'''

'''This file is under a proprietary license and are NOT redistributable.'''

# http://files.eprints.org/300/1/EPrints.exe

==Optional Software==

===GhostScript 8.60===

This is used to convert PS and PDF formats. If it isn't installed these formats cannot be previewed or indexed by EPrints, but can still be accessed normally by users.

Download from http://downloads.sourceforge.net/ghostscript/gs860w32.exe

This should be installed in C:\EPrints\GhostScript .

===Catdoc 0.94.2===

This is used to convert Microsoft Word and Powerpoint files. If it isn't installed these formats cannot be indexed by EPrints, but can still be accessed normally by users.

Download from http://webaugur.com/wares/files/catdoc-0.94.2-win32.zip

This should be installed in C:\EPrints\catdoc-0.94.2 .

===ImageMagick===

This is used to convert image formats for preview. If it isn't installed these formats cannot be previewed, and thumbnails will have a generic icon.

Download from http://www.imagemagick.org/download/binaries/ImageMagick-6.3.5-10-Q8-windows-dll.exe

This should be installed in C:\EPrints\ImageMagick .
The installation must update the search path and include the Perl component. Make sure Perl is installed first.

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache Perl===

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

===Configure Apache Perl===

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

When the configuration tool is finished, you will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Add both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin to Path, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install optional components===

Install GhostScript, ImageMagick, and catdoc. These tools are not essential to try out EPrints, but provide extra functionality.

===Install EPrints 3===

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished copying files, it will prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

To test, start Apache from the command line:

C:
cd\EPrints\Apache2
bin\apache

To terminate Apache, press Ctrl-C.

To register Apache as a service, run the following command ''as Administrator'' (right-click on the Command Prompt application icon and select Run as Administrator):

C:
C:\EPrints\Apache2
bin\apache -k install

Note that this does not start Apache immediately nor configure it to start automatically. These options should be set in the standard Services tool as normal.

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

Installing Eprints 3 on Windows

2007-09-27T15:35:23Z

Harry: New documentation. Indexer task still not documented.

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

'''The EPrints 3.0 Windows Installer is under a proprietary license and is NOT redistributable.'''

==Caveats==

* The installation directory is fixed as C:\EPrints\
* EPrints cannot yet run external commands, for example using ImageMagick to generate thumbnails of image deposits.
* Documents are not yet indexed. A workaround is available and will be added to this page shortly.
* The "Apache Perl" bundle currently used* includes an old release of Apache which is missing subsequent security updates: see http://www.apache.org/dist/httpd/CHANGES_2.0 Alternative versions of Apache, Perl, and mod_perl have not yet been tested.

''* This Apache/Perl bundle was chosen because ActiveState Perl's license does not permit redistribution.''

==Required Software==

===Apache Perl===

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

'''This is an evaluation release. We do not recommend that it be used in a production environment.'''

'''This file is under a proprietary license and are NOT redistributable.'''

# http://files.eprints.org/300/1/EPrints.exe

==Optional Software==

===GhostScript 8.60===

This is used to convert PS and PDF formats. If it isn't installed these formats cannot be previewed or indexed by EPrints, but can still be accessed normally by users.

Download from http://downloads.sourceforge.net/ghostscript/gs860w32.exe

This should be installed in C:\EPrints\GhostScript .

===Catdoc 0.94.2===

This is used to convert Microsoft Word and Powerpoint files. If it isn't installed these formats cannot be indexed by EPrints, but can still be accessed normally by users.

Download from http://webaugur.com/wares/files/catdoc-0.94.2-win32.zip

This should be installed in C:\EPrints\catdoc-0.94.2 .

===ImageMagick===

This is used to convert image formats for preview. If it isn't installed these formats cannot be previewed, and thumbnails will have a generic icon.

Download from http://www.imagemagick.org/download/binaries/ImageMagick-6.3.5-10-Q8-windows-dll.exe

This should be installed in C:\EPrints\ImageMagick .
The installation must update the search path and include the Perl component. Make sure Perl is installed first.

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache Perl===

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

===Configure Apache Perl===

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

When the configuration tool is finished, you will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Add both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin to Path, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install optional components===

Install GhostScript, ImageMagick, and catdoc. These tools are not essential to try out EPrints, but provide extra functionality.

===Install EPrints 3===

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished copying files, it will prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Now start Apache from the command line:

C:
cd\EPrints\Apache2
bin\apache

To register Apache as a service, run the following command ''as Administrator'' (right-click on the Command Prompt application icon and select Run as Administrator):

C:
C:\EPrints\Apache2
bin\apache -k install

Apache can then be controlled from the Services panel.

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

Installing Eprints 3 on Windows

2007-09-25T14:20:25Z

Harry: New release including convert plugins. Clearer instructions to come.

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

'''The EPrints 3.0 Windows Installer is under a proprietary license and is NOT redistributable.'''

==Caveats==

* The installation directory is fixed as C:\EPrints\
* EPrints cannot yet run external commands, for example using ImageMagick to generate thumbnails of image deposits.
* Documents are not yet indexed. A workaround is available and will be added to this page shortly.
* The "Apache Perl" bundle currently used* includes an old release of Apache which is missing subsequent security updates: see http://www.apache.org/dist/httpd/CHANGES_2.0 Alternative versions of Apache, Perl, and mod_perl have not yet been tested.

''* This Apache/Perl bundle was chosen because ActiveState Perl's license does not permit redistribution.''

==Required Software==

===Apache Perl===

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

'''This is an evaluation release. We do not recommend that it be used in a production environment.'''

'''This file is under a proprietary license and are NOT redistributable.'''

# http://files.eprints.org/300/1/EPrints.exe

==Optional Software==

===GhostScript 8.60===

This is used to convert PS and PDF formats. If it isn't installed these formats cannot be previewed or indexed by EPrints, but can still be accessed normally by users.

http://downloads.sourceforge.net/ghostscript/gs860w32.exe

This should be installed in C:\EPrints\GhostScript

===Catdoc 0.94.2===

This is used to convert Microsoft Word and Powerpoint files. If it isn't installed these formats cannot be indexed by EPrints, but can still be accessed normally by users.

http://webaugur.com/wares/files/catdoc-0.94.2-win32.zip

This should be installed in C:\EPrints\catdoc

===ImageMagick===

This is used to convert image formats for preview. If it isn't installed these formats cannot be previewed, and thumbnails will have a generic icon.

http://www.imagemagick.org/download/binaries/ImageMagick-6.3.5-10-Q8-windows-dll.exe

This should be installed in C:\EPrints\ImageMagick and must include the Perl component. Make sure Perl is installed first.

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache Perl===

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

===Configure Apache Perl===

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

When the configuration tool is finished, you will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Add both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin to Path, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install EPrints 3===

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished copying files, it will prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Now start Apache from the command line:

C:
cd\EPrints\Apache2
bin\apache

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

Files/EPrints 3.0 Windows Installer (r2892)

2007-09-25T13:46:15Z

Harry: Latest version

#REDIRECT [[Installing_Eprints_3_on_Windows]]

Installing Eprints 3 on Windows

2007-09-25T13:40:22Z

Harry: Spam removed

{{Installation}}

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

'''The EPrints 3.0 Windows Installer is under a proprietary license and is NOT redistributable.'''

==Caveats==

* The installation directory is fixed as C:\EPrints\
* EPrints cannot yet run external commands, for example using ImageMagick to generate thumbnails of image deposits.
* Documents are not yet indexed. A workaround is available and will be added to this page shortly.
* The "Apache Perl" bundle currently used* includes an old release of Apache which is missing subsequent security updates: see http://www.apache.org/dist/httpd/CHANGES_2.0 Alternative versions of Apache, Perl, and mod_perl have not yet been tested.

''* This Apache/Perl bundle was chosen because ActiveState Perl's license does not permit redistribution.''

==Required Software==

===Apache Perl===

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

'''This is an evaluation release. We do not recommend that it be used in a production environment.'''

'''This file is under a proprietary license and are NOT redistributable.'''

# http://files.eprints.org/279/1/EPrints.exe

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache Perl===

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

===Configure Apache Perl===

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

When the configuration tool is finished, you will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Add both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin to Path, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install EPrints 3===

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished copying files, it will prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Now start Apache from the command line:

C:
cd\EPrints\Apache2
bin\apache

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

Talk:Installing Eprints 3 on Windows

2007-07-16T14:47:22Z

Harry: Informal explanation of the license

The EPrints 3.0 Windows Installer is under a proprietary license and is NOT redistributable, What do you mean whith this?
How can i ask for the license?

: I am not a lawyer but this is informally what is intended by the license.

: The complete text is "This code may not be redistributed in any way or for any purpose."

: You have the same rights as you would normally have for books, music, and other typical copyrighted works. You can use it for anything, and modify your private copy, but not distribute copies at all.

: Note that except for the code unique to the Windows platform, the Linux version of EPrints is identical and is distributed under the GPL.

Installing Eprints 3 on Windows

2007-07-11T16:30:55Z

Harry: New version doesn't require the platform customization file.

Files/EPrints 3.0 Windows Installer (r2847)

2007-07-11T16:26:50Z

Harry: Redirect to general installation page

#REDIRECT [[Installing_Eprints_3_on_Windows]]

Installing Eprints 3 on Windows

2007-04-25T07:48:15Z

Harry: added known bug in Platform.pm. This fixes an Internal Server Error on uploading a file.

{{Installation}}

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

'''The EPrints 3.0 Windows Installer is under a proprietary license and is NOT redistributable.'''

==Caveats==

* See the [[#Known bugs|Known bugs]] section for outstanding bugs in this release.
* The installation directory is fixed as C:\EPrints\
* EPrints cannot yet run external commands, for example using ImageMagick to generate thumbnails of image deposits.
* Full text documents are not yet indexed.
* The "Apache Perl" bundle currently used* includes an old release of Apache which is missing subsequent security updates: see http://www.apache.org/dist/httpd/CHANGES_2.0 Alternative versions of Apache, Perl, and mod_perl have not yet been tested.

''* this Apache/Perl bundle was chosen because ActiveState Perl's license does not permit redistribution''

==Required Software==

===Apache Perl===

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

'''This is an evaluation release. We do not recommend that it be used in a production environment.'''

'''These files are under proprietary license and are NOT redistributable.'''

# http://files.eprints.org/233/2/epv3.exe
# http://files.eprints.org/233/1/windows-install.pl

Save these files in the same directory.

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache Perl===

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

===Configure Apache Perl===

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

When the configuration tool is finished, you will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Add both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin to Path, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install EPrints 3===

The EPrints installer requires the Windows customization file, windows-install.pl. First Check that windows-install.pl is in the same directory as the EPrints installer .exe file.

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished, it will open a window to prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Now start Apache from the command line:

C:
cd\EPrints\Apache2
bin\apache

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

==Known bugs==

C:\EPrints\EPrints\perl_lib\EPrints\Platform.pm line 134 should read:
sub get_hash_name { return &{$real_module."::get_hash_name"}( @_ ); }

Installing Eprints 3 on Windows

2007-03-28T15:51:53Z

Harry: Added brief instructions for scheduling tasks

{{Installation}}

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista).

'''The EPrints 3.0 Windows Installer is under a proprietary license and is NOT redistributable.'''

==Caveats==

* The installation directory is fixed as C:\EPrints\
* EPrints cannot yet run external commands, for example using ImageMagick to generate thumbnails of image deposits.
* Full text documents are not yet indexed.
* The "Apache Perl" bundle currently used* includes an old release of Apache which is missing subsequent security updates: see http://www.apache.org/dist/httpd/CHANGES_2.0 Alternative versions of Apache, Perl, and mod_perl have not yet been tested.

''* this Apache/Perl bundle was chosen because ActiveState Perl's license does not permit redistribution''

==Required Software==

===Apache Perl===

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3.0 Windows Installer===

'''This is an evaluation release. We do not recommend that it be used in a production environment.'''

'''These files are under proprietary license and are NOT redistributable.'''

# http://files.eprints.org/233/2/epv3.exe
# http://files.eprints.org/233/1/windows-install.pl

Save these files in the same directory.

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache Perl===

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

===Configure Apache Perl===

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

When the configuration tool is finished, you will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Add both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin to Path, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install EPrints 3===

The EPrints installer requires the Windows customization file, windows-install.pl. First Check that windows-install.pl is in the same directory as the EPrints installer .exe file.

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished, it will open a window to prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Now start Apache from the command line:

C:
cd\EPrints\Apache2
bin\apache

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

==Administration==

===Scheduling tasks===

The Windows Task Scheduler can be used to automate regular tasks, similarly to the cron daemon under Unix. This tool can be found on Windows Vista under Accessories → System Tools → Task Scheduler.

Choose Create Basic Task... to add a new task. You will need four tasks in total: one for generate_views and three for saved searches.

For Trigger, select Daily, Weekly, or Monthly and configure the time appropriately.

For Action, choose Start a Program.
* Program name is C:\EPrints\Perl\bin\perl.exe
* Arguments are the path to the script and its arguments; either:
C:\EPrints\EPrints\bin\send_alerts myarchive daily
C:\EPrints\EPrints\bin\send_alerts myarchive weekly
C:\EPrints\EPrints\bin\send_alerts myarchive monthly
C:\EPrints\EPrints\bin\generate_views myarchive
* Start In is C:\EPrints\EPrints

On the Finish screen choose to display the properties for the task.

* Choose Run whether user is logged on or not, and select Do not store password.

Installing Eprints 3 on Windows

2007-03-07T15:39:12Z

Harry: /* Configure EPrints 3 */

{{Installation}}

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista). Please add bugs and comments to the end of this page.

==Caveats==

* The installation directory is fixed as C:\EPrints\
* EPrints cannot yet run external commands, for example using ImageMagick to generate thumbnails of image deposits.
* Scheduling EPrints tasks (eg. running generate_views to update the view pages) is not yet tested with the Windows task scheduler.
* Full text documents are not yet indexed.
* The "Apache Perl" bundle currently used* includes an old release of Apache which is missing subsequent security updates: see http://www.apache.org/dist/httpd/CHANGES_2.0 Alternative versions of Apache, Perl, and mod_perl have not yet been tested.

''* this Apache/Perl bundle was chosen because ActiveState Perl's license does not permit redistribution''

==Required Software==

===Apache Perl===

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3 for Windows===

'''This is an evaluation release. We do not recommend that it be used in a production environment.'''

Download the EPrints 3 for Windows components:

# EPrints 3 Windows installer http://files.eprints.org/233/2/epv3.exe
# EPrints 3 Windows Customization Script http://files.eprints.org/233/1/windows-install.pl '''This file is under a proprietary license and is not redistributable.''' Save this file in the same directory as the installer executable.

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache Perl===

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

===Configure Apache Perl===

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

When the configuration tool is finished, you will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Add both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin to Path, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install EPrints 3===

The EPrints installer requires the Windows customization file, windows-install.pl. First Check that windows-install.pl is in the same directory as the EPrints installer .exe file.

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished, it will open a window to prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process: [[Installation]]/[[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Now start Apache from the command line:

C:
cd\EPrints\Apache2
bin\apache

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

Installing Eprints 3 on Windows

2007-03-07T15:38:50Z

Harry:

{{Installation}}

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista). Please add bugs and comments to the end of this page.

==Caveats==

* The installation directory is fixed as C:\EPrints\
* EPrints cannot yet run external commands, for example using ImageMagick to generate thumbnails of image deposits.
* Scheduling EPrints tasks (eg. running generate_views to update the view pages) is not yet tested with the Windows task scheduler.
* Full text documents are not yet indexed.
* The "Apache Perl" bundle currently used* includes an old release of Apache which is missing subsequent security updates: see http://www.apache.org/dist/httpd/CHANGES_2.0 Alternative versions of Apache, Perl, and mod_perl have not yet been tested.

''* this Apache/Perl bundle was chosen because ActiveState Perl's license does not permit redistribution''

==Required Software==

===Apache Perl===

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3 for Windows===

'''This is an evaluation release. We do not recommend that it be used in a production environment.'''

Download the EPrints 3 for Windows components:

# EPrints 3 Windows installer http://files.eprints.org/233/2/epv3.exe
# EPrints 3 Windows Customization Script http://files.eprints.org/233/1/windows-install.pl '''This file is under a proprietary license and is not redistributable.''' Save this file in the same directory as the installer executable.

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache Perl===

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

===Configure Apache Perl===

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

When the configuration tool is finished, you will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Add both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin to Path, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install EPrints 3===

The EPrints installer requires the Windows customization file, windows-install.pl. First Check that windows-install.pl is in the same directory as the EPrints installer .exe file.

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished, it will open a window to prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process. [[Installation]] [[Getting Started]]

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run: perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Now start Apache from the command line:

C:
cd\EPrints\Apache2
bin\apache

===Finish===

EPrints should now be accessible from your browser, at the hostname you specified to epadmin above.

Installing Eprints 3 on Windows

2007-03-07T15:28:34Z

Harry: /* EPrints 3 for Windows */

{{Installation}}

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista). Please add bugs and comments to the end of this page.

==Caveats==

* The installation directory is fixed as C:\EPrints\
* EPrints cannot yet run external commands, for example using ImageMagick to generate thumbnails of image deposits.
* Scheduling EPrints tasks (eg. running generate_views to update the view pages) is not yet tested with the Windows task scheduler.
* Full text documents are not yet indexed.
* The "Apache Perl" bundle currently used* includes an old release of Apache which is missing subsequent security updates: see http://www.apache.org/dist/httpd/CHANGES_2.0 Alternative versions of Apache, Perl, and mod_perl have not yet been tested.

''* this Apache/Perl bundle was chosen because ActiveState Perl's license does not permit redistribution''

==Required Software==

===Apache Perl===

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3 for Windows===

'''This is an evaluation release. We do not recommend that it be used in a production environment.'''

Download the EPrints 3 for Windows components:

# EPrints 3 Windows installer http://files.eprints.org/233/2/epv3.exe
# EPrints 3 Windows Customization Script http://files.eprints.org/233/1/windows-install.pl '''This file is under a proprietary license and is not redistributable.''' Save this file in the same directory as the installer executable.

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache Perl===

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

===Configure Apache Perl===

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

When the configuration tool is finished, you will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Add both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin to Path, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install EPrints 3===

The EPrints installer requires the Windows customization file, windows-install.pl. First Check that windows-install.pl is in the same directory as the EPrints installer .exe file.

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished, it will open a window to prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process.

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Now start Apache from the command line:

C:
cd\EPrints\Apache2
bin\apache

Files/EPrints 3.0 Windows Installer (r2529)

2007-03-07T15:27:52Z

Harry:

#REDIRECT [[Installing_Eprints_3_on_Windows]]

Installing Eprints 3 on Windows

2007-03-07T15:07:26Z

Harry: /* Configure EPrints 3 */

{{Installation}}

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista). Please add bugs and comments to the end of this page.

==Caveats==

* The installation directory is fixed as C:\EPrints\
* No external commands are supported. This includes compressed files and image thumbnail support.
* Scheduling tasks, for example periodically running generate_static, is not tested though the Windows task scheduler may work.
* No full text indexer support.
* Apache Perl includes an old release of Apache. This is missing subsequent security updates; see http://www.apache.org/dist/httpd/CHANGES_2.0 for details. This Apache/Perl bundle was chosen because ActiveState Perl's license does not permit redistribution. Alternative versions of Apache, Perl, and mod_perl are untested but may work.

==Required Software==

===Apache Perl===

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3 for Windows===

'''This is an evaluation release. We do not recommend that it be used in a production environment.'''

Download the EPrints 3 for Windows components:

# EPrints 3 Windows installer http://files.eprints.org/230/2/epv3.exe
# EPrints 3 Windows Customization Script http://files.eprints.org/230/1/windows-install.pl '''This file is under a proprietary license and is not redistributable.''' Save this file in the same directory as the installer executable.

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache Perl===

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

===Configure Apache Perl===

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

When the configuration tool is finished, you will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Add both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin to Path, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install EPrints 3===

The EPrints installer requires the Windows customization file, windows-install.pl. First Check that windows-install.pl is in the same directory as the EPrints installer .exe file.

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished, it will open a window to prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process.

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run perl bin/epadmin create

epadmin will fail to run generate_static, import_subjects, and generate_apacheconf automatically. Run them manually according to the standard instructions.

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Now start Apache from the command line:

C:
cd\EPrints\Apache2
bin\apache

Installing Eprints 3 on Windows

2007-03-07T14:48:22Z

Harry: /* Configure Apache Perl */ wrong PATH

{{Installation}}

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista). Please add bugs and comments to the end of this page.

==Caveats==

* The installation directory is fixed as C:\EPrints\
* No external commands are supported. This includes compressed files and image thumbnail support.
* Scheduling tasks, for example periodically running generate_static, is not tested though the Windows task scheduler may work.
* No full text indexer support.
* Apache Perl includes an old release of Apache. This is missing subsequent security updates; see http://www.apache.org/dist/httpd/CHANGES_2.0 for details. This Apache/Perl bundle was chosen because ActiveState Perl's license does not permit redistribution. Alternative versions of Apache, Perl, and mod_perl are untested but may work.

==Required Software==

===Apache Perl===

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3 for Windows===

'''This is an evaluation release. We do not recommend that it be used in a production environment.'''

Download the EPrints 3 for Windows components:

# EPrints 3 Windows installer http://files.eprints.org/230/2/epv3.exe
# EPrints 3 Windows Customization Script http://files.eprints.org/230/1/windows-install.pl '''This file is under a proprietary license and is not redistributable.''' Save this file in the same directory as the installer executable.

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache Perl===

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

===Configure Apache Perl===

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

When the configuration tool is finished, you will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Add both C:\EPrints\Perl\bin and C:\EPrints\Apache2\bin to Path, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install EPrints 3===

The EPrints installer requires the Windows customization file, windows-install.pl. First Check that windows-install.pl is in the same directory as the EPrints installer .exe file.

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished, it will open a window to prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process.

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run perl bin/epadmin create

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Now start Apache from the command line:

C:
cd\EPrints\Apache2
bin\apache

Installing Eprints 3 on Windows

2007-03-06T16:11:11Z

Harry:

{{Installation}}

We are working to support the Windows platform. This guide describes the process of getting EPrints 3 running on Windows (tested with XP and Vista). Please add bugs and comments to the end of this page.

==Caveats==

* The installation directory is fixed as C:\EPrints\
* No external commands are supported. This includes compressed files and image thumbnail support.
* Scheduling tasks, for example periodically running generate_static, is not tested though the Windows task scheduler may work.
* No full text indexer support.
* Apache Perl includes an old release of Apache. This is missing subsequent security updates; see http://www.apache.org/dist/httpd/CHANGES_2.0 for details. This Apache/Perl bundle was chosen because ActiveState Perl's license does not permit redistribution. Alternative versions of Apache, Perl, and mod_perl are untested but may work.

==Required Software==

===Apache Perl===

Includes the Perl interpreter, Apache web server, and the mod_perl library. Get the latest version from http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin.exe

===MySQL===

Download MySQL Community Server, Windows Essentials (x86) from http://dev.mysql.com/downloads/

EPrints has been tested with MySQL 5.0, but other versions may work.

===EPrints 3 for Windows===

'''This is an evaluation release. We do not recommend that it be used in a production environment.'''

Download the EPrints 3 for Windows components:

# EPrints 3 Windows installer http://files.eprints.org/230/2/epv3.exe
# EPrints 3 Windows Customization Script http://files.eprints.org/230/1/windows-install.pl '''This file is under a proprietary license and is not redistributable.''' Save this file in the same directory as the installer executable.

==Installation==

Each component of the complete EPrints system will be installed in a subdirectory of C:\EPrints\ for ease of maintenance.

===Install Apache Perl===

Run the Apache Perl installer, selecting to install into C:\EPrints. This will install Apache in C:\EPrints\Apache2, and Perl in C:\EPrints\Perl.

===Configure Apache Perl===

When the installation completes, it asks you to configure the binary. Set the following options:

* Disable configuring CPAN.pm
* Disable building HTML documentation
* When prompted, choose not to install nmake.

Leave the other options at their defaults, and press Configure.

When the configuration tool is finished, you will need to set some environment variables so EPrints can find Perl and its libraries. To set environment variables, use Control Panel → System → Advanced system settings → Advanced → Environment Variables…

* Add C:\EPrints\Perl\bin to Path, separated by a semicolon ;
* Create a new variable PERL5LIB, with the value C:/EPrints/EPrints/perl_lib (note forward slashes).

===Install MySQL===

Now run the MySQL installer, and choose a Custom installation in C:\EPrints\MySQL. You will need to set the following options:

* Install the server and client programs
* Do not install the C files
* Skip signing up to MySQL.com

===Configure MySQL===

When the installation completes, you should configure the server as prompted (this tool is also available from the Start Menu afterwards).

Choose Detailed installation. Accept most of the default settings:

* Choose Best Support for Multilingualism as the character set
* Choose a secure root password when prompted

When configuration has finished, you need to set an option manually in MySQL's configuration file by editing C:\EPrints\MySQL\my.ini in a text editor.

* In the sql-mode option, remove NO_AUTO_CREATE_USER from the list

Now restart MySQL so that the new options take effect. In Control Panel → Administrative Tools → Services, find MySQL and choose Restart.

===Install EPrints 3===

The EPrints installer requires the Windows customization file, windows-install.pl. First Check that windows-install.pl is in the same directory as the EPrints installer .exe file.

Run the EPrints installer. This will install files into C:\EPrints\EPrints.

When the installer has finished, it will open a window to prompt you for site specific information. Follow the instructions to complete the installation.

===Configure EPrints 3===

Now you can run epadmin to configure the archive. This process is the same on all platforms, so you can follow the standard instructions for the details of this process.

Note: Whenever you need to run an EPrints command line tool, it must be prefixed with perl:

perl bin/generate_static myarchive

First open a command prompt and change directory to C:\EPrints\EPrints. To start the process, run perl bin/epadmin create

Finally you need to add the EPrints configuration file to Apache. Edit C:\EPrints\Apache2\conf\httpd.conf and add at the bottom of the file:

Include C:/EPrints/EPrints/cfg/apache.conf

===Starting Apache===

Now start Apache from the command line:

C:
cd\EPrints\Apache2
bin\apache