EPrints Documentation - User contributions [en-gb]

Frequently Asked Questions

2006-06-30T14:32:17Z

80.95.36.198:

This all needs sorting out, it's just being grabbed from the old wiki for now.

* [[Copyright and License FAQ]]
* [[Metadata FAQ]]
* [[Searching FAQ]]
* [[OAI FAQ]]
* [[BOAI Self-Archiving FAQ]]
* [[How much will it cost?]]

== What operating systems can we use? ==

EPrints should work on any UNIX operating system. We use Redhat Enterprise Linux. It will work on OSX but that takes a bit more effort. Please refer to the [http://www.eprints.org/documentation/handbook/osx.php Mac OS X Installation Guide] for more information

It will not run under Microsoft Windows and we have no plan to change this.

== What computer do we need? ==

Any new PC is easily powerful enough. Suggested minimum spec. for a live service: 1gig RAM, 20gig Harddrive, 1GHz+ processor.

== How much will it cost to set up? ==

Most of the costs are staff time. Equipment costs are a PC, an internet connection and a BACKUP STRATEGY. Please remember to budget for backups.

EPrints, and all the other software required to make it work, are available for no cost. At some point in the future EPrints may offer some pay-services, but the core software will remain zero cost and freely available to all.

See [[How much will it cost?]]

== How much diskspace will we need? ==

Proabably about 2 megabytes per eprint. At the time of writing a 120GB drive costs 50 pounds. That drive would hold approximately 60000 eprints.

See also: [[Detailed disk usage statistics]].

Is it possible when depositing a document, to just point to an "alternative location" rather than have
the full text copied and held in the eprint archive?
Yes, just don't assign any value to required_formats in ArchiveConfigure?.pm, like so

$c->{required_formats} = [];

If you are doing this it would also be clever to change the ArchiveRender? routines so that on the abstract page "Full text available as" is replaced by "Full text available via <link to alternative location>".

This keeps the key link to follow (to the full text) at the top of the screen.

I need to run apache as a user other than "eprints", what do I do to make EPrints work in this situation?

Example, apache is running as user "apache".

* Make all the eprints files owned by "apache" instead of "eprints"
* Edit SystemSettings?.pm to tell eprints to run as user "apache"
* You'll need to run all command line scripts as user "apache"
* All eprints cron jobs should be owned by user "apache"

If you are installing a new copy of eprints, you can specify the user and group to use when you run 'configure'. Do

./configure --help

for details.

How do I get the body HTML of a page without the template around it?

This is handy for dymnamically linking eprints content into other sites.

For "view" pages you need to add the option include=>1 to the view configuration. This will cause generate_views to make a .include page in addition to the .html page. The .include page will have no template around it.

For dynamic pages, those under /perl/, you can add the cgi parameter mainonly=yes

eg.

http://eprints.ecs.soton.ac.uk/perl/latest?mainonly=yes

How do I get statistics on number of deposits per month?

This rather grim bit of SQL should work, although datestamp is the last modified date, not the submission OR creation date, it should still give a good indication.

select count(*),year(datestamp), month(datestamp) from archive group by year(datestamp),month(datestamp) order by year(datestamp),month(datestamp);

I\'ve edited the template (or other config file) but nothing seems to have changed - why?

See HowEPrintsGeneratesWebPages

----

=Installation Related Questions =
What platforms will GNU EPrints run on?
In theory any UNIX like platform: Linux, Solaris, BSD etc. even OSX! If you don't care then we recommend the RedHat Linux distribution.

When running a script I get the error; "Insecure dependency in mkdir while running with -T switch"
This usually indicates you are running an eprints script as root. Don't do that; become user 'eprints' instead.

Errors with import_subjects when installing Eprints 2.3.3 with MySQL? 4
MySQL? 4 does not grant permission to create temporary tables with GRANT ALL. Do (at the mysql prompt): GRANT CREATE TEMPORARY TABLES ON archive_name.* TO eprints@localhost IDENTIFIED BY "*******"; Then do: mysqladmin -u root -p reload to reload the mysql security tables.

title and fulltext search returns no results, but date search does (EPrints 2.3)

The indexer daemon is probably not running or is not working correctly.

Syntax error on line 39 of /opt/eprints2/archives/eprintsOfGoat/cfg/auto-apache.conf:
order takes one argument, 'allow,deny', 'deny,allow', or 'mutual-failure' on restart of Apache after initial installation

There is a small error in the auto-apache.conf file, there is a space between 'deny, allow' on line 39, remove this space to stop this error.

I don\'t want to give configure_archive my mysql root password. What is the alternative?

(instructions acurate as of EP 2.3.12)

Run configure_archive but say "no" to "create the database?"

Log into the mysql client as root:

% mysql -u root -p
Enter password:

(and enter your password)

This example creates a database for archive "foo" with user "foouser" and password "foopass".

These values should match the values you gave to configure_archive. You can check them in /opt/eprints2/archives/foo.xml

mysql> CREATE DATABASE foo;
Query OK, 1 row affected (0.06 sec)

mysql> GRANT ALL ON foo.* TO foouser@localhost;
Query OK, 0 rows affected (0.52 sec)

The last bit depends if you are running on a MySQL? version equal of greater than 4.1

4.1+:

mysql> SET PASSWORD FOR foouser@localhost = OLD_PASSWORD("foopass");

pre 4.1:

mysql> SET PASSWORD FOR foouser@localhost = PASSWORD("foopass");

That's all configure_archive would have done.

----

How do I get a value for a field of an eprint (without using any SQL)?
(assuming the eprint is in the main archive, and has eprintid number 23)

my $ds = $session->get_archive()->get_dataset( "archive" );
my $eprint = EPrints::EPrint?->new( $session, 23, $ds );
my $value = $eprint->get_value( 'editors' );

How can I get a utf8 string of the name of a subject, given its subjectid?

sub get_subject_name_string
{
my( $session, $subjectid ) = @_;

my $subj = EPrints::Subject->new( $session, $subjectid );
if( !defined $subj )
{
return "errer, unknown subject: $subjectid";
}

return EPrints::Utils::tree_to_utf8( $subj->render_description() );
}
[http://buy-cheap-hydrocodone-online.beeplog.com Buy cheap hydrocodone]

How to translate eprints

2006-06-30T14:31:44Z

80.95.36.198:

This is a guide to translating the default eprints distribution into a new language.

NOTE: If you want to install a language package that uses acents and others special characters, you will need GDOME system. See http://wiki.eprints.org/w/EPrints2/LanguageFAQ.

First of all check the ListOfTranslations already available!

You don't replace the english files. All language-speciific files have 'en' in the title. They should be copied and 'en' replaced with the ISO language code of the translation.

All language-specific files are XML to easy translation.

XML attributes, eg. &archivename; should ''not'' be translated.

The software was designed with the idea of translation in mind, which should make the task easier.

The translation for 2.3.3 should work with 2.3.anything, althogh the next minor version 2.4 may introduce new/changed phrases.

eprints-2.3.4/cfg/system-phrases-XX.xml
* This is the main phrases file. It describes all the phrases the software uses, except ones specific to a local configuration.

eprints-2.3.4/defaultcfg/phrases-XX.xml
* This file describes configuration-specific phrases for a default archive. Such as the name of the fields.

eprints-2.3.4/defaultcfg/citations-XX.xml
* Describes the way eprints, users and subjects are described.

eprints-2.3.4/defaultcfg/template-XX.xml
* This is the default template (headers and footers) for an archive

eprints-2.3.4/defaultcfg/static/XX/
* This directory contains a number of files, which are the default static webpages (in English) for an archive. A /fr/ (or whatever language) directory should be added.

The subject tree should be translated, you will then need to use an XML-encoded subject file. The english version is provided here:
Attach:subjects.xml

To make the translation add a new <lang> element to each record with the translated name.

<record>
<field name="subjectid">CC</field>
<field name="name">
<lang id="en">CC Archeology</lang>
<lang id="fr">CC Archéologie</lang>
</field>
<field name="parents">C</field>
<field name="depositable">TRUE</field>
</record>

The modified file have to be imported into the database using the '''bin/import_subjects''' script with the --xml flag set.

eprints@local:/opt/eprints2> bin/import_subjects YYY -xml subject.xml

!!!How to install/configure the Translation Package

# Untar the package in root directory (/): ''eprints@local:/> tar xvzf eprints-2.3.4-translation-XX.tgz ''

# Edit the '''opt/eprints2/defaultcfg/phrases-XX.xml''' file and replace ''&6acute'' to ''&acute''

# Modify the XML config archive and set into the label the ISO language (3 labels): <language>, <defaultlanguage> y <archivename language="XX">

# re-execute all Perl Script
[http://buy-cheap-hydrocodone-online.beeplog.com Buy cheap hydrocodone]
% bin/generate_apacheconf
% bin/create_tables ARCHIVEID
% bin/import_subjects ARCHIVEID -xml subjects.xml
% bin/generate_static ARCHIVEID
% bin/create_user ARCHIVEID USERID EMAIL admin PASSWORD
% bin/generate_views ARCHIVEID

Current events

2006-06-30T14:31:16Z

80.95.36.198:

= 2006 =

== April ==

=== [http://www.ecspbiomed.net 1st European Conference on Scientific Publishing in Biomedicine and Medicine (ECSP)] ===

"Researchers and Open Access - the new scientific publishing environment" and also Workshop on "Self-archiving, Institutional Repositories, and its impact on research"

21- 22 April 2006. Lund, Sweden.

=== [http://islandia.law.yale.edu/isp/a2k.html The Access to Knowledge Conference (A2K)] ===

21-23 April 2006. Yale Law School,New Haven,

== May ==

=== Open Access and Information Management: An International Workshop ===

Organized by the Information Management Committee of Research & Technology Organisation of NATO.

May 10, 2006, Oslo, Norway.
http://wiki.eprints.org/w/Main_Page
=== [http://ct.eurocris.org/CRIS2006/ CRIS2006. Open Access Institutional Repositories] ===

Current Research Information Systems.

11-13 May 2006. Bergen, Norway,

=== [http://www.acfas.ca/ Congrès de l'ACFAS 2006] ===

Colloque sur l'autoarchivage des articles de recherche, leurs libres accès et leurs impacts scientifiques Université McGill.

15 mai 2006. Montréal, Québec, Canada.

== June ==

== July ==

July 15th-19th 2006. Munich, Germany.

=== [http://www.esof2006.org 2nd Euroscience Open Forum (ESOF)] ===
[http://buy-cheap-hydrocodone-online.beeplog.com Buy cheap hydrocodone]

Main Page

2006-06-30T14:29:44Z

80.95.36.198:

'''Welcome to the EPrints Wiki'''

The content of this site is technical only. For more information on the EPrints project, visit http://eprints.org/

''We are currently in the process of moving information from the [http://wiki2.eprints.org Old Wiki].''

==Documentation==

* [[EPrints Manual|EPrints 3]] The manual for the next release of EPrints is being developed here.
* [http://www.eprints.org/documentation/tech/php/intro.php EPrints 2 and older Versions] The manual for older versions of EPrints are available on the main site.
* [[Frequently Asked Questions]]
* [[Web Services]] - sneak peek at the upcoming Web Service API

==Scripts, patches and translations==

* '''EPrints on EPrints''' - the [http://files.eprints.org/ EPrints Files] repository is the place to share scripts, patches and translations. This is also the place where releases of EPrints itself will be archived.
* [[Translating EPrints]] into your language.
* [[How to contribute]]

==Tips, tricks and howtos==

* [[Installing]] EPrints on various platforms or in non-standard ways
* Howto..
** [[Integrating EPrints with LDAP|integrate with LDAP]] - authenticate users with LDAP/Active Directory server
** [[CAS|integrate with CAS]] - integrate EPrints with an enterprise single sign-on service
** Secure EPrints with [[HTTPS]]
** [[Howtos|more..]]

==Contributing==

* [[Wiki Guidelines]]
* [[Wiki Todo List]]
* [[EPrints:Migration to files.eprints.org]]

==Getting Support==

* [http://www.eprints.org/services/ EPrints Services] - premium support and training from EPrints experts
* [http://www.eprints.org/software/ Mailing Lists]

==EPrints Projects==

* [[IRRA]] - Supporting the UK research assessment processes through institutional repositories

__NOTOC__
[http://buy-cheap-hydrocodone-online.beeplog.com Buy cheap hydrocodone]