Network Enabler Multi-Domain Configuration Example
This example configuration is for a single Network Enabler (NE) connected to three sub-domains in a cloud native deployment.
Because the NE in this example is running on an external server, the Traffic Routing Agent (TRA) must be disabled in the process_control.cfg configuration file on the NE server:
# services to start, in the startup order
service = snmp, mtx -s snmp_agent
service = rcc, mtx -s route_cache_controller
#service = rccl2, mtx -s route_cache_controller_l2
#service = rcp, mtx -s route_cache_proxy
#service = traffic, mtx -s traffic_manager
service = ne, mtx -s network_enabler
features:
networkEnabler: false
# CCF configuration
# To enable CCF change following answer to "y"Optional Feature:Do you want to enable Call Control Functionality (CCF) (y/n)?y
Optional Feature:Are you licensed to enable Call Control Functionality (CCF) (y/n)?y
How many links do you want?1
Camel Gateway Link 1:What is the link name?cgw_link_1
Camel Gateway Link 1:What is the remote address?<IP address of the NE server>
Camel Gateway Link 1:What is the remote port?29050
Camel Gateway Link 1: What is the ASP identifier?
Do you want to prompt for advanced link configuration (y/n)?y
What is the transport protocol?TCP
Camel Gateway defaults: What is the local address?
Camel Gateway defaults: What is the local port?
What is the remote port?
Camel Gateway defaults: What is the link initiation?connect
Camel Gateway defaults: What is the receive buffer size in bytes?
Camel Gateway defaults: What is the send buffer size in bytes?
Camel Gateway defaults: What is the link heartbeat interval in milliseconds?1000
Camel Gateway defaults: What is the SIGTRAN network role?ASP
Camel Gateway defaults: What is the SIGTRAN traffic-mode to use?loadshare
Camel Gateway defaults: Do you wish to validate incoming M3UA DPCs (y/n)?n
Camel Gateway defaults: Do you want the M3UA link state to be actively managed (y/n)?n
Do you want to prompt for advanced route configuration (y/n)?n
Camel Gateway defaults: What is the priority of this route?0
Camel Gateway defaults: What is the originating point-code?
Camel Gateway defaults: What is the destination point-code?
Camel Gateway defaults: What is the routing-context?-1
Camel Gateway defaults: What is the M3UA network-indicator?2
Camel Gateway defaults: Do you want SCCP SCMG messages sent on this route (y/n)?y
Camel Gateway defaults: What is the maximum SCCP segment size?3952
Camel Gateway: How many routes do you want?0
The following engine configuration enables CCF on domain 2:
# CCF configuration
# To enable CCF change following answer to "y"
Optional Feature:Do you want to enable Call Control Functionality (CCF) (y/n)?y
Optional Feature:Are you licensed to enable Call Control Functionality (CCF) (y/n)?y
How many links do you want?1
Camel Gateway defaults:What is the remote port?.
Camel Gateway Link 1:What is the link name?cgw_link_1
Camel Gateway Link 1:What is the remote address?<IP address of the NE server>
Camel Gateway Link 1:What is the remote port?29060
Camel Gateway Link 1: What is the ASP identifier?
Do you want to prompt for advanced link configuration (y/n)?y
What is the transport protocol?TCP
Camel Gateway defaults: What is the local address?
Camel Gateway defaults: What is the local port?
What is the remote port?
Camel Gateway defaults: What is the link initiation?connect
Camel Gateway defaults: What is the receive buffer size in bytes?
Camel Gateway defaults: What is the send buffer size in bytes?
Camel Gateway defaults: What is the link heartbeat interval in milliseconds?1000
Camel Gateway defaults: What is the SIGTRAN network role?ASP
Camel Gateway defaults: What is the SIGTRAN traffic-mode to use?loadshare
Camel Gateway defaults: Do you wish to validate incoming M3UA DPCs (y/n)?n
Camel Gateway defaults: Do you want the M3UA link state to be actively managed (y/n)?n
Do you want to prompt for advanced route configuration (y/n)?n
Camel Gateway defaults: What is the priority of this route?0
Camel Gateway defaults: What is the originating point-code?
Camel Gateway defaults: What is the destination point-code?
Camel Gateway defaults: What is the routing-context?-1
Camel Gateway defaults: What is the M3UA network-indicator?2
Camel Gateway defaults: Do you want SCCP SCMG messages sent on this route (y/n)?y
Camel Gateway defaults: What is the maximum SCCP segment size?3952
Camel Gateway: How many routes do you want?0
The following engine configuration enables CCF on domain 3:
# CCF configuration
# To enable CCF change following answer to "y"
Optional Feature:Do you want to enable Call Control Functionality (CCF) (y/n)?y
Optional Feature:Are you licensed to enable Call Control Functionality (CCF) (y/n)?y
How many links do you want?1
Camel Gateway Link 1:What is the link name?cgw_link_1
Camel Gateway Link 1:What is the remote address?<IP address of the NE server>
Camel Gateway Link 1:What is the remote port?29070
Camel Gateway Link 1: What is the ASP identifier?
Do you want to prompt for advanced link configuration (y/n)?y
What is the transport protocol?TCP
Camel Gateway defaults: What is the local address?
Camel Gateway defaults: What is the local port?
What is the remote port?
Camel Gateway defaults: What is the link initiation?connect
Camel Gateway defaults: What is the receive buffer size in bytes?
Camel Gateway defaults: What is the send buffer size in bytes?
Camel Gateway defaults: What is the link heartbeat interval in milliseconds?1000
Camel Gateway defaults: What is the SIGTRAN network role?ASP
Camel Gateway defaults: What is the SIGTRAN traffic-mode to use?loadshare
Camel Gateway defaults: Do you wish to validate incoming M3UA DPCs (y/n)?n
Camel Gateway defaults: Do you want the M3UA link state to be actively managed (y/n)?n
Do you want to prompt for advanced route configuration (y/n)?n
Camel Gateway defaults: What is the priority of this route?0
Camel Gateway defaults: What is the originating point-code?
Camel Gateway defaults: What is the destination point-code?
Camel Gateway defaults: What is the routing-context?-1
Camel Gateway defaults: What is the M3UA network-indicator?2
Camel Gateway defaults: Do you want SCCP SCMG messages sent on this route (y/n)?y
Camel Gateway defaults: What is the maximum SCCP segment size?3952
Camel Gateway: How many routes do you want?0
The NE must be configured in the /opt/tra/custom/create_config.info configuration file on the NE server. The following section defines general NE configuration and the external link to the network (STP):
Optional Feature:Are you licensed to enable Call Control Functionality (CCF) (y/n)?y
Optional Feature:Do you want to enable Call Control Functionality (CCF) (y/n)?y
Do you want to use a Traffic Routing Agent (TRA) for sub-domain routing (y/n)?y
What is the engines' route-cache network mode?server
How many Network Enablers do you have?1
Do you want to configure cross-links between Network Enablers (y/n)?y
Network Enabler 1:Enter associated engine ID?1
Network Enabler 1:What are the M3UA IP addresses?<IP address of the NE server>
Network Enabler 1:What are the internal M3UA IP addresses?<IP address of the NE server>
Network Enabler 1:What is the M3UA point-code?401
Do you want to enable special handling of messages when a domain is unreachable (y/n)?n
Engine 1:Cluster 1:LogicalBlade 1:What are the M3UA IP addresses?
Network Enabler:How many links do you want?1
# Common Network Enabler
Network Enabler defaults:Do you want to prompt for advanced link configuration (y/n)?y
Network Enabler defaults:What is the transport protocol?SCTP
Network Enabler defaults: What is the local address?
Network Enabler defaults:What is the local port?
Network Enabler defaults:What is the remote port?
Network Enabler defaults: What is the link initiation?
Network Enabler defaults: What is the receive buffer size in bytes?
Network Enabler defaults: What is the send buffer size in bytes?
Network Enabler defaults: How many SCTP output streams to use?0
Network Enabler defaults: How many SCTP input streams to use?0
Network Enabler defaults: What is the link heartbeat interval in milliseconds?1000
Network Enabler defaults:What is the SIGTRAN network role?ASP
Network Enabler defaults:What is the SIGTRAN traffic-mode to use?loadshare
Network Enabler defaults: Do you wish to validate incoming M3UA DPCs (y/n)?n
Network Enabler defaults:Do you want the M3UA link state to be actively managed (y/n)?n
Network Enabler defaults:Do you want to prompt for advanced route configuration (y/n)?y
Network Enabler defaults:What is the priority of this route?
Network Enabler defaults: What is the originating point-code?
Network Enabler defaults:What is the routing-context?
Network Enabler defaults: What is the network-appearance?
Network Enabler defaults: Assume that the destination point-code is available (y/n)?y
Network Enabler defaults:What is the M3UA network-indicator?2
Network Enabler defaults: What is the M3UA message-priority?0
Network Enabler defaults: Use the SCCP CdPA point-code as the M3UA destination (y/n)?n
Network Enabler defaults: What is the SCCP importance value?
Network Enabler defaults: Do you want M3UA and SCCP OPCs synchronized (y/n)?n
Network Enabler defaults:What is the maximum SCCP segment size?0
# Local Network Enabler
Network Enabler Link 1:What is the link name?NELink1
Network Enabler Link 1: What is the local address? <IP address of the NE server>
Network Enabler Link 1: What is the local port?2905
Network Enabler Link 1:What is the remote address?<IP address of the STP>
Network Enabler Link 1: What is the remote port?2905
Network Enabler Link 1: What is the link initiation?connect
Network Enabler Link 1:What is the ASP identifier?
Network Enabler Link 1: What is the priority floor for relayed messages?
Network Enabler Link 1: What is the priority of this route?.
Network Enabler Link 1:What is the destination point-code?402
Network Enabler Link 1: What is the GTT global-title replacement prefix?
Network Enabler Link 1: What is the GTT replacement SCCP point-code?
Network Enabler Link 1: What is the GTT replacement SCCP SSN?
Network Enabler Link 1: What is the GTT replacement routing-indicator?
Network Enabler Link 1:Do you want SCCP SCMG messages sent on this route (y/n)?y
Network Enabler Link 1: Do you want route availability controlled by received SCMG (y/n)?n
Network Enabler: How many routes do you want?1
Network Enabler:How many routing policy rules do you want?0
Network Enabler Route 1: What link does this route use?NELink1
Network Enabler Route 1: Is this a global-title route (y/n)?n
Network Enabler Route 1: What is the first point-code to match?
Network Enabler Route 1: What is the last point-code to match?
Network Enabler Route 1: What is the priority of this route?0
The following section in the /opt/tra/custom/create_config.info configuration file on the NE server defines the internal links between the NE on the NE server and the engine pods in each sub-domain. In this example, there is one pod per sub-domain. An internal link must be configured for each Kubernetes engine pod to connect to. The ASP identifier must point to the appropriate domain, for example, ASP 1 points to domain 1, ASP 2 points to domain 2, and ASP 3 points to domain 3:
# Common Network Enabler Internal
Network Enabler Internal: How many links do you want?3 <the number of internal links = number engine pods that will connect>
Network Enabler Internal defaults: Do you want to prompt for advanced link configuration (y/n)?y
Network Enabler Internal defaults: What is the transport protocol?TCP
Network Enabler Internal defaults: What is the local address?
Network Enabler Internal defaults: What is the local port?.
Network Enabler Internal defaults: What is the remote port?.
Network Enabler Internal defaults: What is the link initiation?listen
Network Enabler Internal defaults: What is the receive buffer size in bytes?
Network Enabler Internal defaults: What is the send buffer size in bytes?
Network Enabler Internal defaults: What is the link heartbeat interval in milliseconds?1000
Network Enabler Internal defaults: What is the SIGTRAN network role?SGP
Network Enabler Internal defaults: What is the SIGTRAN traffic-mode to use?loadshare
Network Enabler Internal defaults: Do you wish to validate incoming M3UA DPCs (y/n)?n
Network Enabler Internal defaults: Do you want the M3UA link state to be actively managed (y/n)?n
Network Enabler Internal defaults: Do you want to prompt for advanced route configuration (y/n)?y
Network Enabler Internal defaults: What is the priority of this route?0
Network Enabler Internal defaults: What is the originating point-code?
Network Enabler Internal defaults: What is the destination point-code?
Network Enabler Internal defaults: What is the routing-context?
Network Enabler Internal defaults: What is the network-appearance?
Network Enabler Internal defaults: Assume that the destination point-code is available (y/n)?y
Network Enabler defaults:What is the M3UA network-indicator?2
Network Enabler Internal defaults: What is the M3UA message-priority?0
Network Enabler Internal defaults: Use the SCCP CdPA point-code as the M3UA destination (y/n)?y
Network Enabler Internal defaults: What is the SCCP importance value?
Network Enabler Internal defaults: Do you want M3UA and SCCP OPCs synchronized (y/n)?n
Network Enabler Internal defaults: Do you want route availability controlled by received SCMG (y/n)?y
Network Enabler Internal defaults: What is the maximum SCCP segment size?3952
Network Enabler Internal Link 1:What is the link name?int_link_1
Network Enabler Internal Link 1:What is the local port?29050
Network Enabler Internal Link 1:What is the remote address?10.10.10.10
Network Enabler Internal Link 1:What is the remote port?29600
Network Enabler Internal Link 1:What is the ASP identifier?1 *** important that this references the correct domain***
Network Enabler Internal Link 1:What is the priority floor for relayed messages?
Network Enabler Internal Link 1: What is the GTT global-title replacement prefix?
Network Enabler Internal Link 1: What is the GTT replacement SCCP point-code?
Network Enabler Internal Link 1: What is the GTT replacement SCCP SSN?
Network Enabler Internal Link 1: What is the GTT replacement routing-indicator?
Network Enabler Internal Link 1:Do you want SCCP SCMG messages sent on this route (y/n)?n
Network Enabler Internal Link 2: What is the link name?int_link_2
Network Enabler Internal Link 2: What is the local port?29060
Network Enabler Internal Link 2: What is the remote address?10.10.10.10
Network Enabler Internal Link 2: What is the remote port?29601
Network Enabler Internal Link 2: What is the ASP identifier?2
Network Enabler Internal Link 2: What is the priority floor for relayed messages?
Network Enabler Internal Link 2: What is the GTT global-title replacement prefix?
Network Enabler Internal Link 2: What is the GTT replacement SCCP point-code?
Network Enabler Internal Link 2: What is the GTT replacement SCCP SSN?
Network Enabler Internal Link 2: What is the GTT replacement routing-indicator?
Network Enabler Internal Link 2: Do you want SCCP SCMG messages sent on this route (y/n)?n
Network Enabler Internal Link 3: What is the link name?int_link_3
Network Enabler Internal Link 3: What is the local port?29070
Network Enabler Internal Link 3: What is the remote address?10.10.10.10
Network Enabler Internal Link 3: What is the remote port?29602
Network Enabler Internal Link 3: What is the ASP identifier?3
Network Enabler Internal Link 3: What is the priority floor for relayed messages?
Network Enabler Internal Link 3: What is the GTT global-title replacement prefix?
Network Enabler Internal Link 3: What is the GTT replacement SCCP point-code?
Network Enabler Internal Link 3: What is the GTT replacement SCCP SSN?
Network Enabler Internal Link 3: What is the GTT replacement routing-indicator?
Network Enabler Internal Link 3: Do you want SCCP SCMG messages sent on this route (y/n)?n
Network Enabler Internal: How many routes do you want?0
Route Cache Controller Configuration
The Route Cache Controller must be configured on the NE server and on the TRA-RT processing server on the engine. For this example, the following configuration is set in the rcc_base.cfg file on the NE server:
#
# Basic properties file used as input to the route-cache config generator
# utility
#
# This empty properties file is a starting point for Route-Cache Controller
# service configuration
#
# Usage instructions:
# The file consists of configuration sections specified by '[section-name]',
# key-value pairs specified by 'key = value', and comments such as this (line
# starts with '#')
# Go over the different sections, follow the instructions and set the
# appropriate parameters.
# Once complete, this file is expected to be passed as input to the
# Route-Cache Services config generator utility
#
[service]
# Either 'rcc' or 'rcp'; specifies which service is being configured.
# 'rcc' refers to the Route-Cache-Controller
# 'rcp' refers to the Route-Cache-Proxy
# Subsequent sections are service specific
type = rcc
network_mode=client
#------------------------------------------------------------------------------
# route-cache table configuration
#------------------------------------------------------------------------------
[routecache]
# set the capacity in terms of number of records
sessions.capacity = 20000000
subscribers.capacity = 20000000
# if managing subscribers directly/administratively, set the following:
# admin_subscribers.capacity =
# session and subscriber identifiers maximum length in bytes
sessions.max_key_length = 128
subscribers.max_key_length = 128
# maximum route-cache checkpoint age in minutes.
# setting this to a positive value enables checkpoint age check.
# if enabled and a checkpoint's age exceeds the set value the checkpoint is
# considered invalid and will eventually get discarded
checkpoint.max_age = 0
# checkpoint base directory.
# if relative created off the working directory.
checkpoint.base_directory = /var/tra/rcc_data
# admin checkpoint base directory.
# if relative created off the working directory.
admin_checkpoint.base_directory = /var/tra/rcc_data
#------------------------------------------------------------------------------
# main processing Route-Cache-Agent configuration
#------------------------------------------------------------------------------
[main]
rca.address =
rca.remote.1.address = <ip of the tra-rt ingress>
rca.remote.1.port = 4090
The following configuration is set in the rcc_base.cfg file on the TRA-RT on the engine:
# Basic properties file used as input to the route-cache config generator
# utility
#
# This properties file is a starting point for Route-Cache Controller
# service configuration in client mode in Kubernetes environment.
# Some configuration parameters must be fixed in Kubernetes environment and
# marked DO NOT SET
#
# Usage instructions:
# The file consists of configuration sections specified by '[section-name]',
# key-value pairs specified by 'key = value', and comments such as this (line
# starts with '#')
# Go over the different sections, follow the instructions and set the
# appropriate parameters.
#------------------------------------------------------------------------------
# route-cache service configuration
#------------------------------------------------------------------------------
[service]
# DO NOT SET
type = rcc
# DO NOT SET
network_mode = client
#------------------------------------------------------------------------------
# route-cache table configuration
#------------------------------------------------------------------------------
[routecache]
# set the capacity in terms of number of records
sessions.capacity = 20000000
subscribers.capacity = 20000000
# if managing subscribers directly/administratively, set the following:
# admin_subscribers.capacity =
# session and subscriber identifiers maximum length in bytes
sessions.max_key_length = 128
subscribers.max_key_length = 128
# if managing subscribers directly/administratively, set the following:
# admin_subscribers.max_key_length =
# maximum route-cache checkpoint age in minutes.
# setting this to a positive value enables checkpoint age check.
# if enabled and a checkpoint's age exceeds the set value the checkpoint is
# considered invalid and will eventually get discarded
checkpoint.max_age = 0
# NOTE: This path MUST match the Persistent Volume mount path
# DO NOT SET
checkpoint.base_directory = /rcc_data
# NOTE: This path MUST match the Persistent Volume mount path
# DO NOT SET
admin_checkpoint.base_directory = /rcc_data
# DO NOT SET
[main]
rca.address =
rca.remote.1.address = 127.0.0.1
rca.remote.1.port = 4090
IpTables Configuration
Because the NE and the TRA are not running on the same server, the following lines must be removed from the /op/tra/data/mtx_config_base.xml file:
<remote_agent id="0">
<address>127.0.0.1</address>
<port>9902</port>
<debug_name>TM</debug_name>
</remote_agent>
The IpTables configuration must be updated to change the source port to the value expected by the NE, for example:
*nat
:PREROUTING ACCEPT [531829:39423552]
:INPUT ACCEPT [75053:11791038]
:OUTPUT ACCEPT [5874:446919]
:POSTROUTING ACCEPT [5874:446919]
-A INPUT -p tcp -m tcp --dport 29050 -j SNAT --to-source 10.10.10.10:29600
-A INPUT -p tcp -m tcp --dport 29060 -j SNAT --to-source 10.10.10.10:29601
-A INPUT -p tcp -m tcp --dport 29070 -j SNAT --to-source 10.10.10.10:29602
COMMIT
Adding an Extra Pod to a Domain
The following configuration example shows updated NE configuration for an extra pod on domain 1. The NE internal links are now configured so that:
- int_link_1 is the NE internal link to pod 1 on domain 1.
- int_link_2 is the NE internal link to pod 2 on domain 1.
- int_link_3 is the NE internal link to pod 1 on domain 2.
- int_link_4 is the NE internal link to pod 1 on domain 3.
Network Enabler Internal: How many links do you want?4
Network Enabler Internal Link 1:What is the link name?int_link_1
Network Enabler Internal Link 1:What is the local port?29050
Network Enabler Internal Link 1:What is the remote address?10.10.10.10
Network Enabler Internal Link 1:What is the remote port?29600
Network Enabler Internal Link 1:What is the ASP identifier?1
Network Enabler Internal Link 1:What is the priority floor for relayed messages?
Network Enabler Internal Link 1: What is the GTT global-title replacement prefix?
Network Enabler Internal Link 1: What is the GTT replacement SCCP point-code?
Network Enabler Internal Link 1: What is the GTT replacement SCCP SSN?
Network Enabler Internal Link 1: What is the GTT replacement routing-indicator?
Network Enabler Internal Link 1:Do you want SCCP SCMG messages sent on this route (y/n)?n
Network Enabler Internal Link 2: What is the link name?int_link_2
Network Enabler Internal Link 2: What is the local port?29050
Network Enabler Internal Link 2: What is the remote address?10.10.10.10
Network Enabler Internal Link 2: What is the remote port?29051
Network Enabler Internal Link 2: What is the ASP identifier?1
Network Enabler Internal Link 2: What is the priority floor for relayed messages?
Network Enabler Internal Link 2: What is the GTT global-title replacement prefix?
Network Enabler Internal Link 2: What is the GTT replacement SCCP point-code?
Network Enabler Internal Link 2: What is the GTT replacement SCCP SSN?
Network Enabler Internal Link 2: What is the GTT replacement routing-indicator?
Network Enabler Internal Link 2: Do you want SCCP SCMG messages sent on this route (y/n)?n
Network Enabler Internal Link 3: What is the link name?int_link_3
Network Enabler Internal Link 3: What is the local port?29060
Network Enabler Internal Link 3: What is the remote address?10.10.10.10
Network Enabler Internal Link 3: What is the remote port?29601
Network Enabler Internal Link 3: What is the ASP identifier?2
Network Enabler Internal Link 3: What is the priority floor for relayed messages?
Network Enabler Internal Link 3: What is the GTT global-title replacement prefix?
Network Enabler Internal Link 3: What is the GTT replacement SCCP point-code?
Network Enabler Internal Link 3: What is the GTT replacement SCCP SSN?
Network Enabler Internal Link 3: What is the GTT replacement routing-indicator?
Network Enabler Internal Link 3: Do you want SCCP SCMG messages sent on this route (y/n)?n
Network Enabler Internal Link 4: What is the link name?int_link_4
Network Enabler Internal Link 4: What is the local port?29070
Network Enabler Internal Link 4: What is the remote address?10.10.10.10
Network Enabler Internal Link 4: What is the remote port?29602
Network Enabler Internal Link 4: What is the ASP identifier?3
Network Enabler Internal Link 4: What is the priority floor for relayed messages?
Network Enabler Internal Link 4: What is the GTT global-title replacement prefix?
Network Enabler Internal Link 4: What is the GTT replacement SCCP point-code?
Network Enabler Internal Link 4: What is the GTT replacement SCCP SSN?
Network Enabler Internal Link 4: What is the GTT replacement routing-indicator?
Network Enabler Internal Link 4: Do you want SCCP SCMG messages sent on this route (y/n)?n
Network Enabler Internal: How many routes do you want?0
-A INPUT -p tcp -m tcp --dport 29050 -j SNAT --to-source 10.10.10.10:29050-51