Pm705 at 14:07, 8 February 2010

2010-02-08T14:07:54Z

← Older revision		Revision as of 14:07, 8 February 2010
Line 1:		Line 1:
	{{development}}		{{development}}
	{{manual}}		{{manual}}
			[[Category:Configuration]]

	This page deals with configuring the software.		This page deals with configuring the software.

Moj at 12:21, 3 January 2007

2007-01-03T12:21:14Z

← Older revision		Revision as of 12:21, 3 January 2007
Line 1:		Line 1:
			{{development}}
	{{manual}}		{{manual}}

WikiSysop: EPrints Configuration moved to EPrints configuration

2006-03-01T17:58:03Z

EPrints Configuration moved to EPrints configuration

← Older revision	Revision as of 17:58, 1 March 2006
(No difference)

WikiSysop at 17:57, 1 March 2006

2006-03-01T17:57:51Z

New page

{{manual}}

This page deals with configuring the software.

See also: [[repository configuration]]

==EPrints General Configuration==
This section describes all the configuration files in the EPrints system which do not relate to any specific archive.

===EPrints Configuration Directory===
The general EPrints configuration directory is usually /opt/eprints2/cfg/ and contains the following files:

; '''apache.conf''' : This file is generated by '''generate_apacheconf'''. See the documentation of '''generate_apacheconf''' for more information.
; '''auto-apache.conf''' : This file is generated and overwritten by '''generate_apacheconf'''. Do not edit it directly. See the documentation of '''generate_apacheconf''' for more information.
; '''auto-apache-includes.conf''' : This file is generated and overwritten by '''generate_apacheconf'''. Do not edit it directly. See the documentation of '''generate_apacheconf''' for more information.
; '''languages.xml''' : This XML file contains an (exhaustive) list of all ISO language ID's and their names.
; '''system-phrases-''languageid''.xml''' : One of these files per language needed for any archive in this system. These files contain the phrases needed to render the website and email in each language, not counting names of things like metadata fields which vary between archives. It should not be edited by hand, but may be overridden. See the instructions on phrase files in the archive config documentation.
; '''SystemSettings.pm''' : Described below.

===SystemSettings.pm===
This is a perl module which is created and edited by the eprints installer script when installing or upgrading EPrints. It's found in <tt>perl-lib/EPrints/</tt>

SystemSettings contains system specific things:

; '''base_path''' : The root directory of your eprints install. Normally /opt/eprints2/
; '''executables''' : A hash of the path of various external commands such as sendmail and wget.
; '''invocation''' : A hash of how eprints is to invoke various external commands. The variables with uppercase names - $(FOO) - are replaced with parameters from eprints, the lowercase names - $(sendmail) - are replaced with the strings in executables.
; '''archive_formats''' : An array of id's of archive formats offered in the upload document page. For each their must be an entry in the archive_extension and invocation, $(DIR) is the where eprints wants the contents of the archive and $(ARC) is the archive file.
; '''version_id ''' : The id of the current eprints version.
; '''version ''' : The human readable version number.
; '''user ''' : The UNIX user eprints will run as. Usually "eprints".
; '''group ''' : The UNIX user eprints will run as. Usually "eprints".
; '''virtualhost''' (Since v2.1) : If this is set, it is used for the VirtualHostName in the Apache configuration files. (By default EPrints uses "*").
; '''disable_df''' (Since v2.1) : If this is set to 1 then this disables the parts of EPrints which use the df call (disk free). If the "configure" script tested the "df" command and found that it failed the this function will initially be set to 1, otherwise 0.
; '''enable_gdome''' (Since v2.2) : If this is set to 1 then it enables the use of the XML::GDOME module, rather than XML::DOM. XML::GDOME is faster and less memory intensive but depends on a number of other libraries and modules which are not worth installing for a trial system.

EPrints configuration - Revision history

Pm705 at 14:07, 8 February 2010

Moj at 12:21, 3 January 2007

WikiSysop: EPrints Configuration moved to EPrints configuration

WikiSysop at 17:57, 1 March 2006