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

From EPrints Documentation
Jump to: navigation, search
(Missing Perl modules)
(Updated formatting)
(14 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
 +
 
 +
==== perl-IO-String package is no longer available ====
 +
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:
 +
 
 +
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
 +
 
 +
==== 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 ====
 +
Sometimes the Perl module <tt>XML::LibXSLT</tt> packaged in the <tt>perl-XML-LibXSLT</tt> package causes segmentation faults with the Apache <tt>httpd</tt> webserver.  Therefore, it may be better to install this Perl module using CPAN (as the root user):
 +
 
 +
  yum erase perl-XML-LibXSLT
 
  cpan XML::LibXSLT
 
  cpan XML::LibXSLT
  
==== Missing Perl modules ====
+
If you have installed the <tt>eprints</tt> RPM either locally or though DNF (i.e. new YUM). You will not be able to remove <tt>perl-XML-LibXSLT</tt> RPM without it forcing EPrints to be uninstalled.  Therefore, you should manually remove <tt>/usr/lib64/perl5/vendor_perl/auto/XML/LibXSLT/</tt> rather than uninstalling the package before installing it using CPAN.
There are a number of perl Modules that EPrints requires that are not available through the standard (inc. EPEL) Yum repositories, these can be installed through CPAN:
 
 
 
cpan TeX::Encode
 
cpan YAML
 

Revision as of 22:16, 18 February 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

Sometimes the Perl module XML::LibXSLT 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 erase perl-XML-LibXSLT
cpan XML::LibXSLT

If you have installed the eprints RPM either locally or though DNF (i.e. new YUM). You will not be able to remove perl-XML-LibXSLT RPM without it forcing EPrints to be uninstalled. Therefore, you should manually remove /usr/lib64/perl5/vendor_perl/auto/XML/LibXSLT/ rather than uninstalling the package before installing it using CPAN.