SVC Installation
Overall Installation Steps
The high-level steps for installing and configuring N2IWF runtime nodes are:
- Determine the server(s) that will support the runtime nodes, bearing in mind the supported operating systems and minimum server requirements.
- Ensure the installation pre-requisites are met.
- Install the SVC package.
- Perform any required post-installation steps.
- Update the N2SVCD configuration as desired.
Installation Pre-requisites
OS-specific Setup
Refer to the specific Red Hat or Debian instructions for any pre-requisites as required.
Lua
Each N2IWF SVC instance requires Lua to be available at version 5.2+. Specifically, both lua and luac must be present
in the PATH for all users. Consult your operating system documentation to determine the appropriate package to
install.
If your distribution does not support Lua at version 5.2+, N-Squared maintains a pre-packaged, separately-installable version of Lua that meets N2IWF’s requirements. Contact N-Squared Support to discuss access to this if required.
N2SVCD
The N-Squared application framework N2SVCD must be installed. Follow the installation steps for this, noting any prerequisites.
The N2IWF SVC package also expects that the default N2SVCD configuration directory exists:
/etc/n2svcd
Be sure to apply any applicable N2SVCD post-installation steps once installation is complete.
N2SCP
The package n2scp-svc is required if CAMEL/INAP calls or CAMEL SMS are to be used. Refer to the
N2SCP installation instructions
for installation details.
N2SIP
The package n2sip-svc is required if SIP calls are to be used. Refer to the
N2SIP installation instructions
for installation details.
Installation Steps
Follow the appropriate installation steps depending on your installation sources.
From N-Squared Repository
Execute the instructions specific to your operating system:
| RHEL 8 / RHEL 9 | Other RPM-based Systems | DEB-based Systems |
|---|---|---|
sudo dnf install n2iwf-svc |
sudo yum install n2iwf-svc |
sudo apt-get install n2iwf-svc |
As Manual Installation
Transfer the provided package file to the target node, then follow the instructions specific to your operating system.
Execute (adjusting as appropriate for package location and version details) the following:
| RPM-based Systems | DEB-based Systems |
|---|---|
sudo rpm -Uvh /path/to/n2iwf-svc-M.m.p-b.noarch.rpm |
sudo dpkg -i /path/to/n2iwf-svc_M.m.p-b_all.deb |
Post-Installation Steps
N2SVCD Integration
The N2IWF runtime uses several N2SVCD applications to perform traffic handling functions. These applications must be configured according to the traffic type and charging model used.
Once N2SVCD is updated, restart the service:
sudo systemctl restart n2svcd
Reporting Integration
Statistics and/or EDRs may be disabled or sent to a data repository. Note that if EDRs are not disabled or transferred, they may eventually fill the file system.
Firewall
The firewall (if any) on the SVC node must be updated to allow:
- Establishment of the inbound or outbound SIGTRAN and/or SIP/RTP connectivity to the core network.
- Outbound Diameter requests to the OCS.
- Outbound database requests to the CUG database, as required.
If required, the firewall (if any) on the SVC node may also be updated to allow:
- Inbound requests for the N2SVCD administrative GUI/API.
If statistics and EDRs are to be retained, the firewall must be updated to allow access for:
- Outbound statistics measurements to the repository.
- Outbound EDRs to the repository.
The exact commands to do this will depend both on the firewall on your platform and also which port(s) are in use.