Redhat 6.9
Redhat 6.9 Installation
Introduction
Please check that the assumptions and requirements documented in the installation overview have been suitably completed.
Pre-Requisites
Due to the Perl DBD::Oracle
driver installation, a large
number of pre-requisite packages for the driver build are
required. In addition, a large number of Perl packages are
required for the successful running of N2FE.
Install the necessary dependencies (via yum
if available):
yum install perl-CGI perl-CGI-Session.noarch \
perl-libwww-perl.noarch perl-JSON.noarch \
perl-MIME-Types.noarch perl-Time-HiRes \
perl-BSD-Resource perl-Clone perl-Compress-Raw-Zlib \
perl-Compress-Zlib perl-DBI perl-devel \
perl-ExtUtils-MakeMaker \
perl-ExtUtils-ParseXS perl-HTML-Parser \
perl-HTML-Tagset perl-IO-Compress-Base \
perl-IO-Compress-Zlib perl-libs perl-Module-Pluggable \
perl-Pod-Escapes perl-Pod-Simple perl-Test-Harness \
perl-Test-Simple perl-TimeDate perl-URI perl-version \
perl-XML-Parser perl-Digest-SHA1 \
mpfr glibc nss-softokn-freebl cpp ppl cloog-ppl \
gcc perl-Net-LibIDN perl-Net-SSLeay perl-IO-Socket-SSL \
perl-Class-Singleton perl-List-MoreUtils \
perl-Params-Validate perl-DateTime \
perl-DateTime-Format-DateParse \
perl-IO-String.noarch
If yum
is not available on this platform, you must manually obtain the
following packages to satisfy the dependency requirements for Jarvis,
the Oracle Instant Client, and N2FE itself.
This list of packages assumes that you have used the “Web Server” installation option. If you have used another installation option, you may find that some of these packages are already installed.
These filenames are the latest versions available at the time of writing this documentation. If new versions are available when installing, it should be safe to use those later versions instead.
You will require the following packages from RpmFind.net, or your official package repository:
rpm -Uvh \
perl-CGI-3.51-144.el6.x86_64.rpm \
perl-CGI-Session-4.35-6.el6.noarch.rpm \
perl-DBD-Pg-2.15.1-4.el6_3.x86_64.rpm \
perl-FreezeThaw-0.45-5.el6.noarch.rpm \
perl-JSON-2.15-5.el6.noarch.rpm \
perl-libwww-perl-5.833-5.el6.noarch.rpm \
perl-MIME-Types-1.28-2.el6.noarch.rpm \
perl-Time-HiRes-1.9721-144.el6.x86_64.rpm \
perl-BSD-Resource-1.29.03-3.el6.x86_64.rpm \
perl-Clone-0.31-3.1.el6.x86_64.rpm \
perl-Compress-Raw-Zlib-2.021-144.el6.x86_64.rpm \
perl-Compress-Zlib-2.021-144.el6.x86_64.rpm \
perl-DBI-1.609-4.el6.x86_64.rpm \
perl-devel-5.10.1-144.el6.x86_64.rpm \
perl-ExtUtils-MakeMaker-6.55-144.el6.x86_64.rpm \
perl-ExtUtils-ParseXS-2.2003.0-144.el6.x86_64.rpm \
perl-HTML-Parser-3.64-2.el6.x86_64.rpm \
perl-HTML-Tagset-3.20-4.el6.noarch.rpm \
perl-IO-Compress-Base-2.021-144.el6.x86_64.rpm \
perl-IO-Compress-Zlib-2.021-144.el6.x86_64.rpm \
perl-libs-5.10.1-144.el6.x86_64.rpm \
perl-Module-Pluggable-3.90-144.el6.x86_64.rpm \
perl-Pod-Escapes-1.04-144.el6.x86_64.rpm \
perl-Pod-Simple-3.13-144.el6.x86_64.rpm \
perl-Test-Harness-3.17-144.el6.x86_64.rpm \
perl-Test-Simple-0.92-144.el6.x86_64.rpm \
perl-TimeDate-1.16-13.el6.noarch.rpm \
perl-URI-1.40-2.el6.noarch.rpm \
perl-version-0.77-144.el6.x86_64.rpm \
perl-XML-Parser-2.36-7.el6.x86_64.rpm \
perl-Digest-SHA1-2.12-2.el6.x86_64.rpm \
cloog-ppl-0.15.7-1.2.el6.x86_64.rpm \
cpp-4.4.7-18.el6_9.2.x86_64.rpm \
gcc-4.4.7-18.el6_9.2.x86_64.rpm \
glibc-2.12-1.209.el6_9.2.i686.rpm \
mpfr-2.4.1-6.el6.x86_64.rpm \
nss-softokn-freebl-3.14.3-23.3.el6_8.i686.rpm \
ppl-0.10.2-11.el6.x86_64.rpm \
perl-Net-LibIDN-0.12-3.el6.x86_64.rpm \
perl-Net-SSLeay-1.35-10.el6_8.1.x86_64.rpm \
perl-IO-Socket-SSL-1.31-3.el6_8.2.noarch.rpm \
perl-DateTime-Format-DateParse-0.04-1.1.el6.noarch.rpm \
perl-DateTime-0.5300-3.el6.x86_64.rpm \
perl-Params-Validate-0.92-3.el6.x86_64.rpm \
perl-List-MoreUtils-0.22-10.el6.x86_64.rpm \
perl-Class-Singleton-1.4-6.el6.noarch.rpm \
perl-IO-String-1.08-1.2.el6.rfx.noarch.rpm
In addition, you will need to install the following packages which may not be available from the official Redhat Repository. You will need to obtain these from RpmFind.Net:
rpm -Uvh perl-Apache-DBI-1.09-1.el6.noarch.rpm \
perl-Carp-Always-0.09-2.el6.noarch.rpm \
perl-Object-MultiType-0.05-3.el6.noarch.rpm \
perl-XML-Smart-1.6.9-4.el6.noarch.rpm \
perl-LWP-Protocol-https-6.04-4.el7.noarch.rpm \
perl-Text-CSV-1.21-1.el6.rf.noarch.rpm
Oracle Installation
N2FE has dependencies on the Oracle Instant Client. To install the client, download the Linux instant client packages from this URL:
http://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html
Once downloaded, install via RPM:
rpm -Uvh oracle-instantclient12.2-basic-12.2.0.1.0-1.x86_64.rpm \
oracle-instantclient12.2-devel-12.2.0.1.0-1.x86_64.rpm \
oracle-instantclient12.2-sqlplus-12.2.0.1.0-1.x86_64.rpm
Oracle Perl DBD Driver
For licensing reasons, the Oracle DB driver for Perl must be built for the platform
on the platform itself. To install, retrieve the latest version of the Perl DBD::Oracle
driver from:
http://search.cpan.org/CPAN/authors/id/M/MJ/MJEVANS/.
Note that a slightly earlier version (1.74) is available from the historical owner of this package at http://search.cpan.org/CPAN/authors/id/P/PY/PYTHIAN/. If necessary, the v1.74 release may be used instead.
Then build and install on the target platform as follows:
export ORACLE_HOME=/usr/lib/oracle/12.2/client64
export LD_LIBRARY_PATH=$ORACLE_HOME/lib
ln -s /usr/share/oracle/12.2/client64/demo/demo.mk /usr/share/oracle/12.2/client64/
cd /path/to/dbd/oracle/package
tar zvfx DBD-Oracle-1.75_2.tar.gz
cd DBD-Oracle-1.75_2
perl Makefile.PL
make install
Note that these instructions are abridged from the DBD::Oracle
package documentation. If these instructions
do not generate a successfully built and installed DBD::Oracle
driver, consult the package instructions, or
contact N-Squared.
If your shell’s umask is not 0022
, ensure that the permissions on this directory and its children are 755
:
/usr/local/lib64/perl5
e.g.
chmod -R 755 /usr/local/lib64/perl5
You will need to add this to the list of shared library paths used by Apache, so that Apache HTTPD can find the Oracle shared libraries.
echo /usr/lib/oracle/12.2/client64/lib > /etc/ld.so.conf.d/oracle.conf
ldconfig
Set up Apache
In the Apache2 configuration, configure the ServerName
variable to be the name of the host:
vi /etc/httpd/conf/httpd.conf
Install & Configure Jarvis
The Jarvis framework is a lightweight, single-package installation which provides a RESTful API for serving data to the web-client application. The installation package for Jarvis can be obtained from N-Squared’s support site, here, and the following are abridged installation instructions for Jarvis. For full installation instructions, please see the Jarvis installation guide.
If not already installed using the yum/rpm installation list above, retrieve the following dependencies for Jarvis from RpmFind.Net and then install them:
rpm -Uvh perl-Object-MultiType-0.05-3.el6.noarch.rpm \
perl-XML-Smart-1.6.9-4.el6.noarch.rpm
If not already installed using the yum/rpm installation list above, retrieve the following dependencies (from Yum if available):
yum install perl-CGI.x86_64 perl-CGI-Session.noarch \
perl-libwww-perl.noarch perl-JSON.noarch \
perl-MIME-Types.noarch perl-Time-HiRes.x86_64
If yum
is not available on this platform, you may manually obtain the
following packages from RpmFind.net:
rpm -Uvh \
perl-CGI-3.51-144.el6.x86_64.rpm \
perl-CGI-Session-4.35-6.el6.noarch.rpm \
perl-DBD-Pg-2.15.1-4.el6_3.x86_64.rpm \
perl-FreezeThaw-0.45-5.el6.noarch.rpm \
perl-JSON-2.15-5.el6.noarch.rpm \
perl-libwww-perl-5.833-5.el6.noarch.rpm \
perl-MIME-Types-1.28-2.el6.noarch.rpm \
perl-Time-HiRes-1.9721-144.el6.x86_64.rpm \
Then, install Jarvis. To install the current latest version:
rpm -Uvh jarvis-6.3.8-1.noarch.rpm
Install N2FE
Once all pre-requisites are installed as described above, the n2fe
package is to be installed. The package will be named with the version
included in the file name - for example n2fe-3.1.0-1.noarch.rpm
, where
3.1.0 is the version number.
rpm -Uvh n2fe-x.x.x-1.noarch.rpm
Replacing x.x.x with the package version number being installed.
Once installed, follow the post-installation configuration instructions.