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 | Other RPM-based Systems | DEB-based Systems |
---|---|---|
sudo dnf install lksctp-tools |
sudo yum 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 | Other RPM-based Systems | DEB-based Systems |
---|---|---|
sudo dnf install kernel-modules-extra |
sudo yum 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:
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
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 n2sv[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:
[root@demo n2svcd]# rpm -qa n2svcd
n2svcd-7.8.0-2.noarch
N2SVCD Control
The N2SVCD platform is controlled via standard systemd commands, i.e.:
sudo systemctl start n2svcd
to start the N2SVCD service.sudo systemctl stop n2svcd
to stop the N2SVCD service.sudo systemctl restart n2svcd
to restart the N2SVCD service.
Depending on your installed OS, System V commands may also be used, i.e.:
sudo service n2svcd start
to start the N2SVCD service.sudo service n2svcd stop
to stop the N2SVCD service.sudo service n2svcd restart
to restart the N2SVCD service.
The N2SVCD platform may be automatically started on boot by enabling its service:
sudo systemctl enable n2svcd
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.
- The
n2in
user. To remove this user:sudo userdel n2in
- The directory
/etc/n2svcd
and any application configuration files within. To remove this directory:sudo rm -rf /etc/n2svcd
- The directory
/var/log/n2svcd
and any application log files within. To remove this directory:sudo rm -rf /var/log/n2svcd
- The directory
/etc/logrotate.d/n2svcd
and any log configuration files within. To remove this directory:sudo rm -rf /etc/logrotate.d/n2svcd