SIS supports both SIP and IN network interface types. Each type of network interface supports a number of mandatory and optional configuration properties. Below are the configuration parameters for SIP and IN network interface definitions.
- SIP network interface definition parameters
- IN network interface definition parameters
- General settings
- Network interface definition parameters specific to the OCSS7 stack
- Network interface definition parameters specific to the Signalware stack
- Network interface definition parameters specific to the MACH7 stack
- Network interface definition parameters specific to the simulated TCAP stack
SIP network interface definition parameters
Parameter | Description | Default |
---|---|---|
IP address |
The IP address or hostname for the SIS.
The SIS will listen on this address.
The address An IP address range may also be used, using address/mask notation; for example, Example: |
none |
Virtual addresses |
Optional comma-separated list of alternative addresses that the SIS is known by, such as virtual addresses provided by an external load balancer. DNS NAPTR or SRV names for the SIS should also be specified here. The SIS treats requests that are routed to these addresses as destined for the SIS; they must be processed by the SIS before forwarding. Addresses may also include a port number, which would specify the load balancer port, if an external load balancer provides the virtual address on a different port to the SIS.
If no port is specified then the SIS will match the virtual address on any port.
If the literal string If this property is set, and the Example: |
an empty list |
Use virtual address in URIs |
If true, the first virtual address (if defined) is used in SIP URIs. |
false |
Port |
Port that will be used for unencrypted SIP transports (UDP, TCP). |
5060 |
Secure port |
Port that will be used for encrypted SIP transports (TLS). |
5061 |
SIP transports |
SIP transports to be supported by the SIS. This is a comma-separated list containing one or more of |
UDP TCP |
Via sent-by address |
Specifies an IP address or hostname that will be used in the "sent-by" field of Via headers added by the SIS. If a value is not specified the SIS will use the local IP address of the node. In some scenarios it may be necessary to specify a value to use a virtual server address.
Example: |
null |
IN network interface definition parameters
Below are general default network interface settings, followed by those specific to the OCSS7, Signalware, MACH7, and simulated TCAP stacks.
Using TCAP stacks
|
General settings
Parameter | Description | Default |
---|---|---|
Local SCCP address |
SCCP address assigned to the SIS instance, included in dialog open requests sent by the SIS instance to the network. See also SCCP Address Format and Administering the CGIN Resource Adaptor Entity. Example: |
none |
Responder SCCP address |
SCCP address used by the SIS when sending responses to received dialog open requests. This setting is optional and only needs to be specified if an address different to that filled in by the TCAP stack when sending open responses is required. See also SCCP Address Format. Example: |
auto |
Default TCAP invoke timeout |
The timeout period, measure in milliseconds, the SIS uses whenever it needs to send non-service-specified invoke requests to the network. |
5000 |
Default dialog activity timeout |
The default timeout period, measured in milliseconds, for dialogs with no activity before they are terminated. |
1800000 |
TCAP fibers maximum pool size |
The maximum number of threads in the TCAP layer fiber pool. If zero, then a pool is not used: work is done directly in the I/O thread. |
4 |
TCAP fibers queue size |
The maximum number of waiting fibers in the TCAP layer fiber pool. If the queue becomes full and there are less than the maximum number of worker threads, a new thread is started. If the queue is full and no more threads are permitted, then subsequent fiber tasks are executed directly by the calling thread (usually the I/O thread). A zero-sized queue is possible and implies that work is either immediately assigned an idle thread, or the work is done by the calling thread. |
250 |
Inbound ACN aliases |
Comma-separated list of values in |
none |
Outbound ACN mappings |
Comma-separated list of values in |
none |
Relaxed BER decoding rules |
Specifies whether or not to relax the BER decoding rules to allow certain types of malformed data. If true, then some malformed BER encodings in protocol data will be accepted:
If false, then the BER rules are strictly enforced and malformed data will be rejected. This property applies to the decoding of application protocol data contained within operations, errors, and user information. It does not apply to the decoding of the surrounding TCAP data; TCAP data is always strictly decoded. |
false |
TCAP stack |
Name of the TCAP stack for the SIS to use. Four stacks are currently supported:
Example: |
none |
Network interface definition parameters specific to the OCSS7 stack
These parameters only need valid values if using the OCSS7 TCAP stack. |
Parameter | Description | Default |
---|---|---|
SGCs |
Comma-separated list of The SIS will attempt to establish a connection to all of the configured |
localhost:12201 |
URL List |
Comma-separated list of This parameter cannot be used with |
none |
URL List Retry Interval |
The wait interval in milliseconds between subsequent connection attempts to the TCAP Managers. The value applies to all manager connections. |
1000 |
Local SSN |
The subsystem number used when the local-sccp-address property does not provide one, for example in the case when it is set to |
-1 |
Open Transactions Capacity |
The maximum number of open transactions (dialogs) at any moment in time. Valid range: 1000-2000000 |
1000000 |
Max Scheduler Threads |
The maximum number of threads used by the scheduler. Valid range: 1-100. |
10 |
Scheduler Node List Size |
The number of events that may be scheduled on a single scheduler thread. This value multiplied with the value for Max Scheduler Threads should be directly proportional to Open Transactions Capacity. Valid range: 0 (autosize) or 1000-2000000. |
0 |
Waiting Tasks Capacity |
The maximum number of inbound messages and timeout events that may be waiting to be processed at any moment in time. This value should be directly proportional to Open Transactions Capacity. Valid range: 0 (autosize) or 1000-2000000. |
0 |
Worker Group Queues |
The number of threads used by the worker group to process timeout events and inbound messages. Valid range: 1-100. |
100 |
Worker Queue Size |
The maximum number of tasks in one worker queue. This value multiplied with the value for Worker Group Queues should be directly proportional to (2 * Waiting Tasks Capacity). Valid range: 0 (autosize) or 1000-2000000. |
0 |
Sender Queue Size |
The maximum number of outbound messages in the sender queue. This value is directly proportional to Open Transactions Capacity. Valid range: 0 (autosize) or 1000-2000000. |
0 |
Heartbeat Enabled |
This property only affects operation when connecting to SGC versions 1.0.1 and older. Heartbeat is always enabled when connecting to SGCs 1.1.0 and newer. Enables or disables the heartbeat between the TCAP stack and the SGC. Also enables the heartbeat timeout detection mechanism. N.B. If the heartbeat is enabled on the SGC it must also be enabled here. Valid values: true or false |
true |
Heartbeat Period |
The period between heartbeat sends in seconds. Heartbeat timeout is also a function of this value (twice this value). When connecting to SGC version 1.0.1 and older the value configured here must match that configured on the SGC. When connecting to SGC version 1.1.0 and newer, this value is communicated to the SGC during handshake negotation. It is not necessary to separately configure the SGC’s heartbeat. Valid range: 1+ |
5 |
Network interface definition parameters specific to the Signalware stack
These parameters only need valid values if using the signalware TCAP stack.
|
Parameter | Description | Default | ||
---|---|---|---|---|
Backends |
Comma-separated list of Example: |
none |
||
Base weight |
Base incoming traffic weight advertised to backends. This property is a comma-separated list that must include at least one numeric item — the weight value used by any node that does not explicitly specify a weight. Additional items may specify weights for particular nodes, using the form For example, the value Each weight is a positive integer used to balance load between nodes. The values have no particular unit other than relative to each other. A node will receive new dialogs in proportion to its weight; for example, two nodes with weights of 10 will receive about the same number of dialogs each, and a node with a weight of 20 will receive twice as many as a node with a weight of 10.
The actual weight used for a particular node is the base weight specified here, modified by the function defined by weight function below, based on the amount of traffic that node has processed. |
100 |
||
Weight function |
Definition of the weight function applied to "full-rate" weights to find the actual rate to use. This is used to gradually increase load on a newly-joined cluster node, so as not to immediately swamp it with traffic. The function is specified as a series of comma-separated values
|
0.01,10,0.10,1000, 0.50,5000,1.00 |
||
Fiber map size |
The number of fibers in the fixed-size fiber map used to process incoming traffic. This value must be at least as large as the value of the TCAP Fibers Queue Size property. |
256 |
||
Dialog allocation timeout |
The maximum time, in milliseconds, to block while waiting to allocate a new dialog before returning an error to the calling service code. |
5000 |
||
Dialog pool size |
The size of the pre-allocation pool for outgoing dialogs. This pool is used to satisfy requests for new outgoing dialogs, and is refilled asynchronously. If the pool becomes empty due to a high rate of dialog creation, outgoing dialogs must wait for the backend to allocate a new dialog, increasing latency. One pool is maintained per backend connection. |
100 |
Network interface definition parameters specific to the MACH7 stack
These parameters only need valid values if using the MACH7 TCAP stack. |
Parameter | Description | Default |
---|---|---|
Backends |
Comma-separated list of |
192.168.1.130:12070, 192.168.1.185- 193.168.1.185:12070 |
SCCP bind address |
SCCP address for binding SLEE. If Point-Code (pc) and SCCP Sub System Number (ssn) fields are set in the Local SCCP Address, there is no need to provide pc and ssn in this property. However, nwApp (network apperance) information can be provided. If both the Local SCCP Address and SCCP Bind Address are set, then they must have same pc and ssn values. If pc and ssn are not set in the Local SCCP Address, then they must be set in this property. |
ri=pcssn,pc=4012, ssn=100,nwApp=0 |
SLEE cluster ID |
This property is used by the stack to pass Rhino cluster information to the ASC process, so that ASC can distinguish two SLEEs with same node ID from each other. |
100 |
ASC correlated cluster ID |
This property is used by the ASC process to register with the AN as part of the cluster. This cluster ID will be used for advanced routing through AN for correlated messages. |
0 |
Frontend <⇒ backend communication protocol |
This property is used to define the communication protocol between the FrontEnd and BackEnd of MACH-AN. It must be either |
SCTP |
Frontend <⇒ backend heartbeat timer and threshold |
This property is used to define the heartbeat timer and heartbeat threshold used to detect failure of the frontend to backend communication. The format of this parameter is: |
1000:3 |
Network interface definition parameters specific to the simulated TCAP stack
These parameters only need valid values if using the simulated TCAP stack. |
Parameter | Description | Default |
---|---|---|
Listen addresses |
Comma-separated list of |
none |
Maximum dialogs |
Maximum number of concurrent dialogs to support. |
10000 |
Routing table |
Path to the file containing the routing table description. |
${rhino.dir.home} ${/}config${/} tcapsim-routing-table.txt |
Global title translation table |
Path to the file containing the global translation table description |
${rhino.dir.home}${/} config${/} tcapsim-gt-table.txt |