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:
- codeready-builder-for-rhel-8-x86_64-rpms
- rhel-8-for-x86_64-appstream-rpms
- rhel-8-for-x86_64-baseos-rpms
- EPEL Release
- Base
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.
- Read and execute our Perl code.
- Connect to external network sources.
- Allow Apache to spawn Java processes which depend on execmem.
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.