Editing Repository configuration (section)

==The Primary Archive Configuration File==
This XML file appears in the <tt>archives/</tt> directory, usually <tt>/opt/eprints2/archives/</tt>, it describes the most very basic details about the archive. It is generated (and modified) by configure_archive and will not normally need to be edited.

EPrints looks in this directory for XML files and attempts to load them all when starting the webserver.

This file should be chmod'd so that it can not be read by random users as it contains the database password.

The top level element is "archive" which has the attribute "id" which is the id of the archive. It should be the same as the filename. If this file is foo.xml then the id should be foo.

<tt> <archive> </tt> contains a list of XML tags enclosing some text. eg.


<code>
  <host>stoatprints.org</host>
</code>
The following tags are expected in no special order:

; <host> : The hostname of this archive.
; <alias redirect="''yes-or-no''"> : This is optional and may be repeated. It has the attribute "redirect" which may be set to yes or no. This controls what virtual hosts are supported and if they should redirect to the main <host>.
; <language> : The ISO id of a language supported by this archive. Repeatable. One of these should also be the defaultlanguage. See below.
; <port> : The port number that the server is running on. Usually 80.
; <urlpath> : The directory from the root of the server name. Usually <tt>/</tt>
; <archiveroot> : The filesystem path of the rest of the archive configuration.
; <configmodule> : The path to the perl module which does the main configuration (ArchiveConfig.pm)
; <dbname> : The name of the MySQL database. Usually the same as the archive ID.
; <dbhost> : The host on which MySQL is running. Usually localhost.
; <dbport> : An optional MySQL port, if it's not the standard one. Should be empty if we are to use the default.
; <dbsock> : An optional MySQL socket. Should be empty if we are to use the default.
; <dbuser> : The username to use when connecting to MySQL, usually "eprints".
; <dbpass> : The password to use to connect to MySQL.
; <defaultlanguage> : One of the supported language. This is the default for this archive.
; <adminemail> : The email address of the archive administrator. I strongly suggest that this is an alias rather than a personal email address. If all your webpages contain "bob@footle.edu" and bill takes over from bob you would have to regenerate every page with "bill@footle.edu". Much better to set up an email alias or forward from "archive-support@footle.edu" and point it at bob (for now). Heed these words spoken from grim experience!
; <archivename language="''langcode''"> : The name of the archive. This has an attribute "language" the value of which is an iso language id. There should be one of these archivename elements per supported language. eg.

<code>
    <archivename language="en">White Lemur</archivename>
    <archivename language="fr">La Archive d'Lemur Blanc</archivename>
</code>
(apologies to the french, human languages aren't my strong suit)
; <securehost> (since v2.2) : Used for experiemental https support.
; <securepath> (since v2.2) : Used for experiemental https support.