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:
- Oracle DBI Drivers for Perl
- Jarvis
- Publically available Perl packages:
- DateTime::Format::DateParse
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.