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.