Installation

The N2C5 software is provided as Debian packages.

Package Conventions

In order to support multiple N2C5 instances to exist side-by-side, the package name and package directory typically includes a suffix e.g. "-prod", "-model".

E.g. the following package:

n2c5-model_1.2.0-1_all.deb

This is a package which is will install into the following directories and files:

/usr/share/n2c5-model/...

Typically it will be accessed via a URL such as:

http://{hostname}/n2c5-model/subscriber

The back-end services are provided by the Jarvis framework, and would be configured in the file:

/etc/jarvis/n2c5-model.xml

Typical {suffix} values are "prod", "model", "test" or "dev".

Pre-Requisites

Before installing any N2C5 package, you must first install some pre-requisites. First install the following base packages from N-Squared.

jarvis

Refer to the separate Jarvis Documentation, including the list of Jarvis pre-requisites.

In addition, you will typically require the following Ubuntu packages. Assuming you have an Internet connection available, you can simply install these via the Ubuntu command-line package manager, apt-get.

* [updated list required] *

Package Installation

Debian packages are installed as the "root" user, e.g.:

dpkg --install n2c5-{suffix}_{version}_all.deb

Package Post-Installation

If this is the first installation of this package, you should compile and install the Perl XS "IDL" module as the "root" user.

cd /usr/share/n2c5-{suffix}/idl
perl Makefile.PL
make install

If this is the first installation of this package, then you must also copy the sample "n2svcd.xml" into the "/etc/jarvis" directory, and configure it to your requirements.

cp /usr/share/n2c5-dev/etc/jarvis/n2c5.xml /etc/jarvis/n2c5-{suffix}.xml

The syntax and interpretation of this configuration file is described in a following section.