Difference between revisions of "Installing EPrints on RHEL/Fedora/CentOS"
(→SELinux) |
(→SELinux: added SELinux network permission) |
||
| (19 intermediate revisions by 5 users not shown) | |||
| Line 3: | Line 3: | ||
==Requirements== | ==Requirements== | ||
| − | * RedHat Enterprise | + | * RedHat Enterprise/CentOS 7 (earlier versions may work) |
==Installing== | ==Installing== | ||
| Line 11: | Line 11: | ||
rpm -ivh http://rpm.eprints.org/rpm-eprints-org-key-1-1.noarch.rpm | rpm -ivh http://rpm.eprints.org/rpm-eprints-org-key-1-1.noarch.rpm | ||
| − | ... the rpm.eprints.org RHEL updates repository | + | ... the rpm.eprints.org EPrints repository: |
| + | |||
| + | 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 | 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/ | + | 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 25: | Line 31: | ||
Install EPrints 3: | Install EPrints 3: | ||
| − | yum install eprints3 | + | yum install eprints # 3.3.x and later |
| + | yum install eprints3 # 3.2.x | ||
| + | |||
| + | |||
| + | ===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. | ||
| + | |||
| + | [http://www.imagemagick.org/script/binary-releases.php 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 [http://rpm.eprints.org/RHEL/5/ rpm.eprints.org]. | ||
==SELinux== | ==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: | + | 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 / | + | 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== | ||
[[Getting Started with EPrints 3]] | [[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/'''&'''nbsp;/ /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 [arcid] | ||
Revision as of 13:46, 14 October 2016
Contents
Requirements
- RedHat Enterprise/CentOS 7 (earlier versions may work)
Installing
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
... 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:
yum upgrade libxml2 libxslt perl-XML-LibXML perl-XML-LibXSLT
Install EPrints 3:
yum install eprints # 3.3.x and later yum install eprints3 # 3.2.x
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 [arcid]
