Difference between revisions of "Issues with installing EPrints on RHEL / CentOS / Rocky 8"

From EPrints Documentation
Jump to: navigation, search
(Added issues with RHEL 8)
(Updated instructions for XML::LibXSLT)
 
(17 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==== elinks package longer available ====
+
==== elinks package is no longer available ====
The RPM package elinks is no longer available in RHEL 8.  elinks is probably no longer needed so if installing from source use the following YUM command line:
+
The RPM package <tt>elinks</tt> is no longer available in RHEL / CentOS / Rocky 8 even with EPEL package repository<tt>elinks</tt> is only needed if are intending to upload web pages or XML files and these need to be indexed by EPrints, so if installing from source use the following DNF command line:
  
  yum install libxml2 libxslt httpd mod_perl perl-DBI perl-DBD-MySQL perl-IO-Socket-SSL perl-Time-HiRes \
+
  dnf install libxml2 libxslt httpd mod_perl perl-DBI perl-DBD-MySQL perl-IO-Socket-SSL perl-Time-HiRes \
    perl-CGI perl-Digest-MD5 perl-Digest-SHA perl-JSON perl-XML-LibXML perl-XML-LibXSLT perl-XML-SAX \
+
    perl-CGI perl-Digest-MD5 perl-Digest-SHA perl-JSON perl-XML-LibXML perl-XML-LibXSLT perl-XML-SAX \
    perl-LWP-Protocol-https perl-MIME-Lite perl-Text-Unidecode tetex-latex wget gzip tar ImageMagick \
+
    perl-MIME-Lite perl-Text-Unidecode perl-JSON perl-Unicode-Collate perl-Pod-LaTeX tetex-latex wget \
    poppler-utils chkconfig unzip
+
    gzip tar ImageMagick poppler-utils chkconfig unzip cpan
  
 +
Alternatively, for RHEL 8 you can enable the <tt>codeready-builder</tt> repository, which still has <tt>elinks</tt> available:
 +
 +
subscription-manager repos --enable "codeready-builder-for-rhel-8-$(arch)-rpms"
  
==== Compatibility issues with XML::LibXLST ====
+
If you are running CentOS 8 (or Rocky 8) you can similarly enable the <tt>powertools</tt> repository:
Sometimes the Perl module XML::LibXLST packaged in the perl-XML-LibXSLT package causes segmentation faults with the Apache httpd webserver.  Therefore, it may be better to install this Perl module using CPAN (as the root user):
 
  
  yum purge perl-XML-LibXSLT
+
  dnf config-manager --set-enabled powertools
cpan XML::LibXSLT
 
  
==== Missing Perl modules ====
+
==== perl-IO-String package is no longer available ====
There are a number of perl Modules that EPrints requires that are no longer installed by the dependencies list above.  Some of these packages are available through YUM and can be installed as follows:
+
The RPM package <tt>perl-IO-String</tt> is no longer available in RHEL / CentOS / Rocky 8 even with EPEL package repository. You can enable the <tt>codeready-builder</tt> repository, which still has <tt>perl-IO-String</tt> available:
  
  yum install perl-JSON perl-Unicode-Collate cpan perl-Pod-LaTeX
+
  subscription-manager repos --enable "codeready-builder-for-rhel-8-$(arch)-rpms"
  
There are a few Perl modules not available through YUM, these can be installed through CPAN:
+
If you are running CentOS 8 (or Rocky 8) you can similarly enable the <tt>powertools</tt> repository:
  
  cpan TeX::Encode
+
  dnf config-manager --set-enabled powertools
  cpan YAML
+
 
 +
==== Sub-dependency packages perl-MIME-Types and perl-Digest-SHA1 are no longer available ====
 +
<tt>perl-MIME-Lite</tt> package requires <tt>perl-MIME-Types</tt> package and <tt>perl-Apache-DBI</tt> requires <tt>perl-Digest-SHA1</tt> package neither of which available on RHEL / CentOS / Rocky 8, even with EPEL repository enabled.  You can enable the <tt>codeready-builder</tt> repository, which still has these packahes available:
 +
 
 +
subscription-manager repos --enable "codeready-builder-for-rhel-8-$(arch)-rpms"
 +
 
 +
If you are running CentOS 8 (or Rocky 8) you can similarly enable the <tt>powertools</tt> repository:
 +
 
 +
dnf config-manager --set-enabled powertools
 +
 
 +
==== Compatibility issues with XML::LibXSLT ====
 +
Installing <tt>XML::LibXSLT</tt> either through the <tt>perl-XML-LibXSLT</tt> RPM or CPAN causes <tt>httpd</tt> to generate a segmentation fault when you try to start it.  The most straightfarward solution to this is to run <tt>httpd</tt> in <tt>mpm-prefork</tt> rather than <tt>mpm-event</tt> mode.  This can be acheived by editing <tt>/etc/httpd/conf.modules.d/00-mpm.conf</tt> and commenting out the following line:
 +
LoadModule mpm_event_module modules/mod_mpm_event.so
 +
and uncommenting the <tt>mpm-prefork</tt> line:
 +
LoadModule mpm_prefork_module modules/mod_mpm_prefork.so
 +
The alternative solution is to make sure that <tt>XML::LibXSLT</tt> is not installed through the <tt>perl-XML-LibXSLT</tt> RPM or CPAN.  EPrints will still run without this but you will not be able to use XSLT-based import plugins. Unless you have installed any additional import plugins, the only ones affected are Atom XML and OpenXML Bibliography.

Latest revision as of 11:18, 24 September 2023

elinks package is no longer available

The RPM package elinks is no longer available in RHEL / CentOS / Rocky 8 even with EPEL package repository. elinks is only needed if are intending to upload web pages or XML files and these need to be indexed by EPrints, so if installing from source use the following DNF command line:

dnf install libxml2 libxslt httpd mod_perl perl-DBI perl-DBD-MySQL perl-IO-Socket-SSL perl-Time-HiRes \
   perl-CGI perl-Digest-MD5 perl-Digest-SHA perl-JSON perl-XML-LibXML perl-XML-LibXSLT perl-XML-SAX \
   perl-MIME-Lite perl-Text-Unidecode perl-JSON perl-Unicode-Collate perl-Pod-LaTeX tetex-latex wget \
   gzip tar ImageMagick poppler-utils chkconfig unzip cpan

Alternatively, for RHEL 8 you can enable the codeready-builder repository, which still has elinks available:

subscription-manager repos --enable "codeready-builder-for-rhel-8-$(arch)-rpms"

If you are running CentOS 8 (or Rocky 8) you can similarly enable the powertools repository:

dnf config-manager --set-enabled powertools

perl-IO-String package is no longer available

The RPM package perl-IO-String is no longer available in RHEL / CentOS / Rocky 8 even with EPEL package repository. You can enable the codeready-builder repository, which still has perl-IO-String available:

subscription-manager repos --enable "codeready-builder-for-rhel-8-$(arch)-rpms"

If you are running CentOS 8 (or Rocky 8) you can similarly enable the powertools repository:

dnf config-manager --set-enabled powertools

Sub-dependency packages perl-MIME-Types and perl-Digest-SHA1 are no longer available

perl-MIME-Lite package requires perl-MIME-Types package and perl-Apache-DBI requires perl-Digest-SHA1 package neither of which available on RHEL / CentOS / Rocky 8, even with EPEL repository enabled. You can enable the codeready-builder repository, which still has these packahes available:

subscription-manager repos --enable "codeready-builder-for-rhel-8-$(arch)-rpms"

If you are running CentOS 8 (or Rocky 8) you can similarly enable the powertools repository:

dnf config-manager --set-enabled powertools

Compatibility issues with XML::LibXSLT

Installing XML::LibXSLT either through the perl-XML-LibXSLT RPM or CPAN causes httpd to generate a segmentation fault when you try to start it. The most straightfarward solution to this is to run httpd in mpm-prefork rather than mpm-event mode. This can be acheived by editing /etc/httpd/conf.modules.d/00-mpm.conf and commenting out the following line:

LoadModule mpm_event_module modules/mod_mpm_event.so

and uncommenting the mpm-prefork line:

LoadModule mpm_prefork_module modules/mod_mpm_prefork.so

The alternative solution is to make sure that XML::LibXSLT is not installed through the perl-XML-LibXSLT RPM or CPAN. EPrints will still run without this but you will not be able to use XSLT-based import plugins. Unless you have installed any additional import plugins, the only ones affected are Atom XML and OpenXML Bibliography.