Post Installation Tasks

Post-Installation Tasks

TCP Configuration

Some firewalls or switches may drop TCP connections to or from N2SVCD and other endpoints if they are inactive and the TCP keepalive value is too high. It is recommended that this be set no higher than 600.

To find the current value, execute:

sudo cat /proc/sys/net/ipv4/tcp_keepalive_time

To update the value (in this case to 600), execute:

sudo cat << EOF >> /etc/sysctl.d/99-n2svcd.conf
net.ipv4.tcp_keepalive_time=600
EOF
sudo sysctl --system

SCTP Configuration

SCTP Buffer Sizes

If SIGTRAN is to be used within N2SVCD, it is recommended to update the SCTP buffer sizings to deal with higher levels of throughput.

cat << EOF >> /etc/sysctl.d/99-n2svcd.conf
net.core.rmem_default=2097152
net.core.wmem_default=2097152
net.core.rmem_max=2097152
net.core.wmem_max=2097152
EOF
sysctl --system

SCTP Traffic Support

Ensure that the SCTP toolset is available:

RHEL 8 / 9 DEB-based Systems
sudo dnf install lksctp-tools sudo apt-get install lksctp-tools

Check that the platform supports SCTP traffic:

sudo checksctp

If the output from the command is not SCTP supported, continue with the steps below.

Install additional kernel modules:

RHEL 8 / 9 DEB-based Systems
sudo dnf install kernel-modules-extra apt-get install linux-modules-extra

Note that for DEB-based systems, the package name for the extra modules may include your kernel version number.

Remove any blacklist entries that stop the kernel module from loading:

for i in /etc/modprobe.d/* ; do sudo perl -pi -e 's/^blacklist sctp$/#blacklist sctp/' $i ; done

Reboot to enable SCTP support:

sudo reboot

After reboot, confirm that SCTP is supported, as above.

Oracle Installation

The N2SVCD Service Daemon when connecting to an Oracle database via the DBApp 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-instantclient-basic-21.1.0.0.0-1.x86_64.rpm \
         oracle-instantclient-devel-21.1.0.0.0-1.x86_64.rpm \
         oracle-instantclient-sqlplus-21.1.0.0.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.80 (or later) from the URL:

https://cpan.metacpan.org/authors/id/M/MJ/MJEVANS/DBD-Oracle-1.80.tar.gz

… and build and install on the target platform. First install Perl pre-requisites for building software:

yum install perl-ExtUtils-MakeMaker make gcc

Then build the package itself:

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

Dynaloader

After installing the n2lua package, the OS dynamic library loader will need to be updated in order to utilize the installed package.

Create a new dynaloader link:

vim /etc/ld.so.conf.d/liblua.conf

Adding:

/opt/n2lua/lib/

Update the dynaloader index:

ldconfig

SAR

sar (System Activity Reporter) is a useful unix tool for system monitoring. It is highly recommended that this is installed on all systems.

To enable, install into systemd:

systemctl enable sysstat

Post-Installation Checks

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

ps -ef | grep n2svc[d]

Depending on configuration, this is expected to display one or more n2svcd processes running. Immediately after a fresh install a single process will be shown:

[root@demo n2svcd]# ps -ef | grep n2svc[d]
n2in       92774       1  0 08:47 ?        00:00:01 n2svcd n2svcd.xml   

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

rpm -qa n2svcd

This will respond with the package name, including the version number, architecture and OS:

[root@demo n2svcd]# rpm -qa n2svcd
n2svcd-8.3.2-13.el9.x86_64

N2SVCD Control

The N2SVCD platform is controlled via standard systemd commands, i.e.:

The N2SVCD platform may be automatically started on boot by enabling its service:

sudo systemctl enable n2svcd

N2SVCD Management GUI

To enable the N2SVCD management GUI with a HTTP interface, configure the ManageApp module in the n2svcd.xml configuration as documented in the linked page. On most systems, the firewall will also require altering to allow traffic:

firewall-cmd --zone=public --add-port=8088/tcp --permanent
systemctl restart firewalld

N2SVCD Removal

If the N2SVCD software is removed, some automatically-created items are left in-place. If desired, these can be removed manually if desired once uninstallation is complete.