☰
Navigation :

Ubuntu 12.04

Ubuntu 12.04 Installation

Introduction

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

Pre-Requisites

The following pre-requisites are required for Ubuntu 12.04:

For all publically available Perl packages, install the necessary dependencies (via apt if available):

sudo apt-get install libdatetime-format-dateparse-perl libtext-csv-perl

If apt is not available on this platform, you must manually obtain the these packages to satisfy the dependency requirements for Jarvis, Oracle Instant Client, and N2FE itself.

This list of packages assumes that you have used the Debian LTS server installation option. If you have used another installation option, you may find that some of these packages are already installed, or additionally some packages may be missing.

Oracle Installation

The Oracle DBI drivers cannot be installed as a binary source, and must be downloaded and compiled on the platform where installation is to occur. First, install the ‘Alien’ program:

sudo apt-get install alien

Access the Oracle Instant Client download page and download the three installation packages listed below. These are the Oracle 12c instant client and client library packages for Linux.

You must accept the OTN Licence Agreement. Download the “Basic”, “SqlPlus” & “SDK/Devel” packages. Versions may differ.

oracle-instantclient12.1-basic-12.1.0.1.0-1.x86_64.rpm
oracle-instantclient12.1-sqlplus-12.1.0.1.0-1.x86_64.rpm
oracle-instantclient12.1-devel-12.1.0.1.0-1.x86_64.rpm

Use the alien program to convert the .rpm packages into .deb format.

sudo alien oracle-instantclient12.1-basic-12.1.0.1.0-1.x86_64.rpm
sudo alien oracle-instantclient12.1-sqlplus-12.1.0.1.0-1.x86_64.rpm
sudo alien oracle-instantclient12.1-devel-12.1.0.1.0-1.x86_64.rpm

Install the .deb packages.

sudo dpkg --install oracle-instantclient12.1-basic_12.1.0.1.0-2_amd64.deb
sudo dpkg --install oracle-instantclient12.1-sqlplus_12.1.0.1.0-2_amd64.deb
sudo dpkg --install oracle-instantclient12.1-devel_12.1.0.1.0-2_amd64.deb

Set the ORACLE_HOME environment variable.

export LD_LIBRARY_PATH=/usr/lib/oracle/12.1/client64/lib

sqlplus64 smf/smf@<hostname-or-ip-address>/SMF

Download the DBD Oracle drivers from CPAN: Note: when setting up CPAN for the first time when asked for the installation approach enter sudo

sudo su -
export ORACLE_HOME=/usr/lib/oracle/12.1/client64/lib
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/lib/oracle/12.1/client64/lib/
export PATH=$PATH:/usr/lib/oracle/12.1/client64/bin
cpan install DBD::Oracle

This will build and install the Perl Oracle DBI drivers using the installed Oracle client libraries.

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.

To install the current latest version:

sudo dpkg --install jarvis_x.x.x-x_all.deb

Refer to the Jarvis installation guide for detailed configuration instructions.

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.0.0-1_all.deb, where 3.0.0 is the version number.

sudo dpkg --install n2fe_x.x.x-1_all.deb

Replacing x.x.x with the package version number being installed.

Apache Configuration

N2FE is a web application, served by Apache. The default configuration configures N2FE to be accessible at http://host/n2fe/ however this may not be suitable for the environment.

The Apache configuration can be adjusted by editing the Apache2 configuration file:

vi /etc/apache2/conf-enabled/n2fe.conf

N2FE Configuration

With N2FE installed, complete the post-installation steps.