Installation - Revision history

Drn@ecs.soton.ac.uk: Added info about downloading EPrints.

2021-02-23T23:46:40Z

Added info about downloading EPrints.

← Older revision		Revision as of 23:46, 23 February 2021
Line 2:		Line 2:
	[[Category:Installation]]		[[Category:Installation]]
	'''Below describes installing EPrints on a generic Linux distribution. It is recommended that EPrints is installed on either [[Installing EPrints on RHEL/Fedora/CentOS\|Red Hat based]] or [[Installing EPrints on Debian/Ubuntu\|Debian based]] Linux.'''		'''Below describes installing EPrints on a generic Linux distribution. It is recommended that EPrints is installed on either [[Installing EPrints on RHEL/Fedora/CentOS\|Red Hat based]] or [[Installing EPrints on Debian/Ubuntu\|Debian based]] Linux.'''

			==Download==
			EPrints can be downloaded from https://files.eprints.org/

	==Installation==		==Installation==

Drn@ecs.soton.ac.uk: Moved backed to non-boxed warnings

2017-09-08T13:07:26Z

Moved backed to non-boxed warnings

← Older revision		Revision as of 13:07, 8 September 2017
Line 1:		Line 1:
	{{Warning\|message='''Below describes installing EPrints on a generic Linux distribution. It is recommended that EPrints is installed on either [[Installing EPrints on RHEL/Fedora/CentOS\|Red Hat based]] or [[Installing EPrints on Debian/Ubuntu\|Debian based]] Linux.'''}}{{manual}}		{{manual}}
	[[Category:Installation]]		[[Category:Installation]]
			'''Below describes installing EPrints on a generic Linux distribution. It is recommended that EPrints is installed on either [[Installing EPrints on RHEL/Fedora/CentOS\|Red Hat based]] or [[Installing EPrints on Debian/Ubuntu\|Debian based]] Linux.'''

	==Installation==		==Installation==

Drn@ecs.soton.ac.uk: Made top message a proper warning

2017-09-08T12:49:07Z

Made top message a proper warning

← Older revision		Revision as of 12:49, 8 September 2017
Line 1:		Line 1:
	{{Warning\|message='''Below describes installing EPrints on a generic Linux distribution. It is recommended that EPrints is installed on either [[Installing EPrints on RHEL/Fedora/CentOS\|Red Hat based]] or [[Installing EPrints on Debian/Ubuntu\|Debian based]] Linux.'''}}		{{Warning\|message='''Below describes installing EPrints on a generic Linux distribution. It is recommended that EPrints is installed on either [[Installing EPrints on RHEL/Fedora/CentOS\|Red Hat based]] or [[Installing EPrints on Debian/Ubuntu\|Debian based]] Linux.'''}}{{manual}}

	{{manual}}
	[[Category:Installation]]		[[Category:Installation]]

Drn@ecs.soton.ac.uk: Made top message a proper warning

2017-09-08T12:48:10Z

Made top message a proper warning

← Older revision		Revision as of 12:48, 8 September 2017
Line 1:		Line 1:
			{{Warning\|message='''Below describes installing EPrints on a generic Linux distribution. It is recommended that EPrints is installed on either [[Installing EPrints on RHEL/Fedora/CentOS\|Red Hat based]] or [[Installing EPrints on Debian/Ubuntu\|Debian based]] Linux.'''}}

	{{manual}}		{{manual}}
	[[Category:Installation]]		[[Category:Installation]]

	'''These instructions are for installing EPrints on a generic distribution of Linux. It is recommended that EPrints is installed on either [[Installing EPrints on RHEL/Fedora/CentOS\|Red Hat based]] or [[Installing EPrints on Debian/Ubuntu\|Debian based]] Linux.'''

	==Installation==		==Installation==

Drn@ecs.soton.ac.uk at 16:00, 6 September 2017

2017-09-06T16:00:36Z

← Older revision		Revision as of 16:00, 6 September 2017
Line 5:		Line 5:

	==Installation==		==Installation==
	(If you are upgrading an existing installation of eprints please see the section on ~~upgrading elsewhere in~~ this manual.)		''If you are upgrading an existing installation of eprints please see the section on [[Upgrading]] section of this manual.''

	EPrints needs to be installed as the same user as the apache webserver runs as. We suggest you install it as user "eprints" and group "eprints". Under some UNIX platforms, creating a user and group can be done using the "adduser" command. Otherwise refer to your operating system documentation.		EPrints needs to be installed as the same user as the apache webserver runs as. We suggest you install it as user "eprints" and group "eprints". Under some UNIX platforms, creating a user and group can be done using the "adduser" command. Otherwise refer to your operating system documentation.

Drn@ecs.soton.ac.uk: Added warning about what Linux should be installed on

2017-09-05T11:04:51Z

Added warning about what Linux should be installed on

← Older revision		Revision as of 11:04, 5 September 2017
Line 1:		Line 1:
	{{manual}}		{{manual}}
	[[Category:Installation]]		[[Category:Installation]]

			'''These instructions are for installing EPrints on a generic distribution of Linux. It is recommended that EPrints is installed on either [[Installing EPrints on RHEL/Fedora/CentOS\|Red Hat based]] or [[Installing EPrints on Debian/Ubuntu\|Debian based]] Linux.'''

	==Installation==		==Installation==
	(If you are upgrading an existing installation of eprints please see the section on upgrading elsewhere in this manual.)		(If you are upgrading an existing installation of eprints please see the section on upgrading elsewhere in this manual.)

Af05v@ecs.soton.ac.uk at 12:56, 14 October 2015

2015-10-14T12:56:28Z

← Older revision		Revision as of 12:56, 14 October 2015
Line 1:		Line 1:
	~~{{development}}~~
	{{manual}}		{{manual}}
	[[Category:Installation]]		[[Category:Installation]]

Jy2e08@ecs.soton.ac.uk: /* Installation */

2015-04-17T14:48:21Z

Installation

← Older revision		Revision as of 14:48, 17 April 2015
Line 51:		Line 51:
	Note that this file is only available after you created your archive via <tt>epadmin create</tt>. See [[Getting_Started_with_EPrints_3#Running_epadmin\|Running epadmin]] for more information on creating an archive.		Note that this file is only available after you created your archive via <tt>epadmin create</tt>. See [[Getting_Started_with_EPrints_3#Running_epadmin\|Running epadmin]] for more information on creating an archive.

	You ~~may also wish~~ to ~~change~~ the user ~~and group apache runs as~~. The user ''must'' be the same as the user you installed eprints as. We recommend:		You need to make sure the apache user have read/write access to the installation directory (/opt/eprints3). The user ''must'' be the same as the user you installed eprints as. We recommend to configure your apache to run as:

	User eprints		User eprints
	Group eprints		Group eprints

Pm705 at 16:04, 8 February 2010

2010-02-08T16:04:56Z

New page

{{development}}
{{manual}}
[[Category:Installation]]
==Installation==
(If you are upgrading an existing installation of eprints please see the section on upgrading elsewhere in this manual.)

EPrints needs to be installed as the same user as the apache webserver runs as. We suggest you install it as user "eprints" and group "eprints". Under some UNIX platforms, creating a user and group can be done using the "adduser" command. Otherwise refer to your operating system documentation.

Unpack the eprints tar.gz file:

% gunzip eprints-3.something.tar.gz
% tar xf eprints-3.something.tar

Now run the "configure" script. This is a /bin/sh script which will attempt to locate various parts of your system such as the perl binary. It will also check your system for required components.

% cd eprints-3.something
% ./configure

By default the system installs as user and group "eprints". You will need to change this if you are not installing as either "root" or "eprints".

The configure script accepts a number of options.

; --help : List all the options (many are intended for compiled software and are ignored).

Recommended:

; --prefix=PREFIX : Where to install EPrints (or look for a version to upgrade). By default <tt>/opt/eprints3/</tt>
; --with-smtp-server=[HOST] : Use HOST to deliver mail. If the server running EPrints has an MTA such as <tt>exim</tt> or <tt>sendmail</tt>, you can specify '''localhost'''. If you do not specify this option, you will get a warning to configure it later.
; --with-user=[USER] : Install eprints to run as USER. By default "eprints".
; --with-group=[GROUP] : Install eprints to run as GROUP. By default "eprints".

Optional:

; --with-perl=[PATH] : Path of perl interpreter (in case configure can't find it, or you have more than one and want to use a specific one).
; --with-virtualhost=[VIRTUALHOST] : Use VIRTUALHOST rather than * for apache VirtualHost directives.
; --with-toolpath=[PATH] : An alternate path to search for the required binaries.
; --disable-diskfree : Disable disk free space calls. These can cause problems on some platforms, notably 64-bit.

Deprecated:

; --with-apache=1 : Use Apache 1.x.x instead of 2.x.x, but EPrints 3 does not support this.

Once you are happy with your configuration you may install eprints by running install.pl:

% ./install.pl

Now you should edit the configuration file for your copy of apache. This is often <tt>/usr/local/apache/conf/http.conf</tt> or <tt>/etc/httpd/conf/httpd.conf</tt>

Add this line: (If you didn't install eprints in <tt>/opt/eprints3/</tt> replace that with the location on your system).
Include /opt/eprints3/cfg/apache.conf
Note that this file is only available after you created your archive via <tt>epadmin create</tt>. See [[Getting_Started_with_EPrints_3#Running_epadmin|Running epadmin]] for more information on creating an archive.

You may also wish to change the user and group apache runs as. The user ''must'' be the same as the user you installed eprints as. We recommend:

User eprints
Group eprints

Fmccown: Link to Running epadmin

2007-03-21T14:04:28Z

Link to Running epadmin

← Older revision		Revision as of 14:04, 21 March 2007
Line 37:		Line 37:
	Add this line: (If you didn't install eprints in <tt>/opt/eprints3/</tt> replace that with the location on your system).		Add this line: (If you didn't install eprints in <tt>/opt/eprints3/</tt> replace that with the location on your system).
	Include /opt/eprints3/cfg/apache.conf		Include /opt/eprints3/cfg/apache.conf
	Note that this file is only available after you created your archive via <tt>epadmin create</tt>.		Note that this file is only available after you created your archive via <tt>epadmin create</tt>. See [[Getting_Started_with_EPrints_3#Running_epadmin\|Running epadmin]] for more information on creating an archive.

	You may also wish to change the user and group apache runs as. The user ''must'' be the same as the user you installed eprints as. We recommend:		You may also wish to change the user and group apache runs as. The user ''must'' be the same as the user you installed eprints as. We recommend: