Package Overview

The N-Squared Service Daemon software is package into a single package called n2svcd. This package is designed to be installed on Linux based systems such as RedHat Linux and Debian. Installation is performed using standard package management tools - yum and rpm on RedHat based systems, apt-get and dpkg on debian based systems.

The N-Squared PI Plus is similarly packaged into a single package called n2pip.

This document provides instructions for installing these two packages.

OS Support

The Service Daemon and PI Plus are supported on the following systems:

RedHat based systems:

Debian based systems:

RedHat Installation: n2svcd

Required Package Installation via yum

The n2svcd packages had a number of pre-requisites. If installing on to a server with access to the standard package repositories across the Internet use the following commands to retrieve and install them:

yum install lua lua-devel
yum install lksctp-tools lksctp-tools-devel
yum install rsyslog
yum install make gcc

yum install 'perl(DBI)' 'perl(JSON)' 'perl(Time::HiRes)' 'perl(Test::Differences)' 
yum install 'perl(Module::Load)' 'perl(List::MoreUtils)' 'perl(Date::Format)'
yum install 'perl(Error)'

Required Package Installation via rpm

If yum is unable to access the standard package repositories, retrieve the packages listed below (N-Squared can provide these) and install via rpm.

This list is a combination of the above packages and the pre-requisites required for installing these specifical packages into a clean install of RedHat (or CentOS) 6.4.

If installing into a RedHat 6.4 (rather than CentOS) system, install these packages first:

To install, use the following command:

rpm -Uvh package-list

Where package-list is the complete list of packages separated by spaces (i.e. perl-5.10.1-136.el6.x86_64.rpm ...). Note that it is important to install packages at once to ensure all dependencies are met.

For both RedHat and CentOS 6.4 systems, install the following packages:

As with previously, install with the command:

rpm -Uvh package-list

Additional Packages Required

A number of standard packages are unavailable via yum. These must be installed from rpm and are available from N-Squared:

As with previously, install with the command:

rpm -Uvh package-list

Oracle Installation

The N2SVCD Service Dameon 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

The packages required are:

Once downloaded, install via RPM:

rpm -Uvh 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

Oracle Perl DB Driver

The Oracle DB driver must be built for the platform. To install, as root, retrieve the Perl DBD::Oracle driver v1.74 from the URL:

http://search.cpan.org/CPAN/authors/id/P/PY/PYTHIAN/DBD-Oracle-1.74.tar.gz

and build and install on the target platform:

cp DBD-Oracle-1.74.tar.gz /tmp/
cd /tmp/
tar zvfx DBD-Oracle-1.74.tar.gz
cd DBD-Oracle-1.74
perl Makefile.PL
make install

Package Installation

Once all pre-requisites are installed as described above, the n2svd package is to be installed. The package will be named with the version included in the file name - for example n2svcd-6.0.10-1.noarch.rpm, where 6.0.10 is the version number.

rpm -Uvh n2svcd-1.0.14-1.noarch.rpm

Post-Installation Checks

To confirm that the n2svcd package has installed successfully, check that the n2svcd process is executing:

ps -ef | grep n2sv[d]

Depending on configuration, this is expected to display one or more n2svcd processes running:

root     13016     1  0 Aug13 ?        00:00:00 /bin/sh -e -c bash /usr/share/n2svcd/bin/n2svcd_upstart_startup.sh /bin/sh
root     13017 13016  0 Aug13 ?        00:29:25 /usr/bin/perl /usr/share/n2svcd/bin/n2svcd --config=/etc/n2svcd/n2svcd.xml
root     13027 13017  0 Aug13 ?        00:00:55 /usr/bin/perl /usr/share/n2svcd/bin/n2svcd --config=/etc/n2svcd/n2svcd.xml

Confirm that the correct version of the n2svcd package is installed:

rpm -q n2svcd

This will respond with the package name, including the version number.

RedHat Installation: n2pip

The N-Squared PI Plus package n2pip is dependant on the n2svd package. Once the n2svcd package is installed, n2pip can be installed. The package will be named with the version included in the file name - for example n2pip-1.0.0-1.noarch.rpm, where 1.0.0 is the version number.

rpm -Uvh n2pip-1.0.0-1.noarch.rpm

After installation, edit the n2svcd configuration file:

/etc/n2svcd/n2svcd.xml

And configure the PI Plus as required. Once configured, restart the Service Daemon:

restart n2svcd

This will restart the n2svcd processes, reloading the configuration and enabling the PI Plus as configured.