Redhat 8

Redhat 8 Installation

Introduction

Please check that the assumptions and requirements documented in the installation overview have been suitably completed.

RHEL Subscriptions

The following RHEL subscriptions are required to be present on the installation server:

Pre-Requisites

A large number of prerequisites for both N2FE and the Perl DBD::Oracle are required.

Install the necessary dependencies (via yum):

Install core packages:

yum install httpd mod_ssl mod_fcgid nano htop gcc java-1.8.0-openjdk-devel perl-ExtUtils-MakeMaker make

Start and enable apache:

systemctl enable httpd
service httpd start

Install core Perl packages:

yum install perl-CGI perl-DBI perl-HTTP-Cookies perl-JSON perl-JSON-XS perl-MIME-Types perl-XML-LibXML perl-Clone perl-DateTime-Format-DateParse perl-IO-String perl-Switch perl-File-Fetch

Oracle Dependencies

Oracle provides Perl database drives that allow N2FE to interface with the SMS database. This is however a manual installation process as Oracle has not made these available on any automatic repositories.

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-instantclient-basic-21.1.0.0.0-1.x86_64.rpm
rpm -Uvh oracle-instantclient-devel-21.1.0.0.0-1.x86_64.rpm
rpm -Uvh oracle-instantclient-sqlplus-21.1.0.0.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/.

At the time of writing the latest version available is V1.80.

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/](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/21/client64
export LD_LIBRARY_PATH=$ORACLE_HOME/lib

ln -s /usr/share/oracle/21/client64/demo/demo.mk /usr/share/oracle/21/client64/

cd /path/to/dbd/oracle/package
tar zvfx DBD-Oracle-1.80.tar.gz
cd DBD-Oracle-1.80
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.

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/21/client64/lib > /etc/ld.so.conf.d/oracle.conf
ldconfig

The server will need to be rebooted to ensure changes are applied. Failure to reboot may result in a ORA-12546 error:

reboot

Set up Apache

In the Apache2 configuration, configure the ServerName variable to be the name of the host:

vi /etc/httpd/conf/httpd.conf

Core Package Installation

Packages are available from the N-Squared RPM repository. For specific configuration instructions contact N-Squared.

Jarvis

Install the Jarvis package from the N-Squared repository:

yum install jarvis

N2FE GUI

Install the N2FE GUI package from the N-Squared repository:

yum install n2fe

Firewall Rules

Open ports for HTTPD applications:

# GUIS
firewall-cmd --zone=public --add-port=80/tcp  --permanent
firewall-cmd --zone=public --add-port=443/tcp --permanent

Restart firewalld to apply the new configuration:

service firewalld restart

SELinux Configuration

Set rules that allow Apache to perform various tasks.

setsebool -P httpd_read_user_content 1
setsebool -P httpd_can_network_connect 1
setsebool -P httpd_execmem 1

N2FE Configuration

One installation is complete follow the post-installation configuration instructions.