Difference between revisions of "Installing EPrints on RHEL/Fedora/CentOS"

From EPrints Documentation
Jump to: navigation, search
m (Drn@ecs.soton.ac.uk moved page Installing EPrints 3 on RedHat Enterprise 5 to Installing EPrints on RHEL/Fedora/CentOS: Version numbers are stupid page should be be about latest versions.)
Line 3: Line 3:
 
==Requirements==
 
==Requirements==
  
* RedHat Enterprise/CentOS 7 (earlier versions may work)
+
* RedHat Enterprise (RHEL) / CentOS 7 or Fedora 25+ (earlier versions may work)  
  
==Installing==
+
==Installing from EPrints 3.3.x RPM ==
  
 
Add the rpm.eprints.org repository key:
 
Add the rpm.eprints.org repository key:
Line 14: Line 14:
  
 
  rpm -ivh http://rpm.eprints.org/eprints/noarch/rpm-eprints-org-1-1.noarch.rpm
 
  rpm -ivh http://rpm.eprints.org/eprints/noarch/rpm-eprints-org-1-1.noarch.rpm
 
... on '''RHEL 5.x only''' the rpm.eprints.org RHEL updates repository:
 
 
rpm -ivh http://rpm.eprints.org/RHEL/5Server/noarch/rpm-eprints-org-RHEL-5-1.noarch.rpm
 
 
... on '''RHEL 6.x only''' install antiword if installing EPrints 3.2.x or earlier (from 3.3 onwards only used to as a Word -> PDF converter so not strictly necessary):
 
 
rpm -ivh http://rpm.eprints.org/RHEL/5/i386/antiword-0.37-1.i386.rpm
 
# or for 64 bit:
 
rpm -ivh http://rpm.eprints.org/RHEL/5/x86_64/antiword-0.37-1.x86_64.rpm
 
  
 
Upgrade your XML libraries:
 
Upgrade your XML libraries:
Line 31: Line 21:
 
Install EPrints 3:
 
Install EPrints 3:
  
  yum install eprints # 3.3.x and later
+
  yum install eprints  
yum install eprints3 # 3.2.x
+
+
  
 
===Other sources for dependencies===
 
===Other sources for dependencies===
Line 77: Line 65:
 
=== Upgrade from previous 3.3 ===
 
=== Upgrade from previous 3.3 ===
 
After a upgrading from previous 3.3, your existing repository's database may need updating.  
 
After a upgrading from previous 3.3, your existing repository's database may need updating.  
  bin/epadmin update [arcid]
+
  bin/epadmin update [archive_id]

Revision as of 10:08, 1 September 2017


Requirements

  • RedHat Enterprise (RHEL) / CentOS 7 or Fedora 25+ (earlier versions may work)

Installing from EPrints 3.3.x RPM

Add the rpm.eprints.org repository key:

rpm -ivh http://rpm.eprints.org/rpm-eprints-org-key-1-1.noarch.rpm

... the rpm.eprints.org EPrints repository:

rpm -ivh http://rpm.eprints.org/eprints/noarch/rpm-eprints-org-1-1.noarch.rpm

Upgrade your XML libraries:

yum upgrade libxml2 libxslt perl-XML-LibXML perl-XML-LibXSLT

Install EPrints 3:

yum install eprints 

Other sources for dependencies

The following RPM repositories may be useful for finding other dependencies required by EPrints that aren't part of the core RHEL system.

http://fedoraproject.org/wiki/EPEL - Fedora Extras for RHEL.

http://pkgs.repoforge.org/rpmforge-release/ - RPMforge, which covers a very large range of Perl modules plus others.

ImageMagick provide an RPM for RHEL/CentOS 5. At time of writing the RPM requires fftw3, fltk, jasper and openexr which are available from RPMForge. libwebp is available from rpm.eprints.org.

SELinux

If you're using SELinux on your server you will need to give Apache read/write access to the documents directory for all repositories you create and the eprints var folder (indexer log, ticker files):

chcon -R -h -t httpd_sys_script_rw_t /usr/share/eprints/archives/[repoid]/documents/
chcon -R -h -t httpd_sys_script_rw_t /usr/share/eprints/var/

you may also need to tell SELinux to allow apache to talk on the network (maybe only if your database is on a separate server

setsebool -P httpd_can_network_connect=1

Getting Started

Getting Started with EPrints 3

Troubleshooting

Failed to parse XML file

When installing EPrints on RHEL6 (may apply to other versions), If you get the error:

Failed to parse XML file:
/usr/share/eprints/lib/lang/en/phrases/system.xml: Entity: line 396: parser error : Entity 'nbsp' not defined age or title page. If there are more...

Run

sed -i 's/ / /g' /usr/share/eprints/lib/lang/en/phrases/system.xml

then navigate to the root of your EPrints install (/opt/eprints or /usr/share/eprints) and run

bin/generate_views *repository_id*
bin/epadmin reload *repository_id*

Upgrade from previous 3.3

After a upgrading from previous 3.3, your existing repository's database may need updating.

bin/epadmin update [archive_id]