Regardless of how you start them, you configure the TCAP backends using the following command-line options:

Option Argument Default Effect

Common options
❎ = required

 
-help

n/a

Displays a brief summary of supported options, then exits.

 
-version

n/a

Displays backend version information, then exits.

 
-verbose

n/a

Shows a summary of configured options, then continues with normal execution.

 
-ln

logical process name

❎ if not started using START-PROCESS

Sets the Signalware logical process name — must be unique within this CE.

 
-lssn

numeric SSN
❎

Sets the local SSN to accept traffic on.

 
-node

SS7 logical node name
❎

Sets the logical SS7 node to bind to, corresponding to a node configured using configureNodes.

 
-port

numeric TCP port
❎

Sets the local TCP port to accept Rhino connections on. Must be unique within this CE.

 
-trace

n/a

Enables logging of a brief summary of received/sent TCAP traffic to stderr.

 
-backup

backup process name

Enables recovery, and specifies a backend process that will act as the backup process for this process.

See Configuring for Failover and Recovery.

Options not usually needed in normal operation, but supported for tuning and debugging

 
-debug

n/a

Enables Signalware library debug logging.

 
-tcapdebug

hexadecimal debug mask

Enables Signalware TCAP stack debug logging.

 
-maxdialogs

numeric value

 
32000

Sets maximum concurrent TCAP dialogs for this backend.

 
-maxisms

numeric value

 
31990

Sets maximum concurrent TCAP ISMs for this backend.

 
-maxtimers

numeric value

 
31990

Sets maximum concurrent TCAP timers for this backend.

 
-maxtblocks

numeric value

 
255

Sets maximum number of TCAP components per network message.

 
-debugflags

comma-separated flag list

Enables backend debug logging; use
-debugflags help for a list of supported flags.

 
-scostimeout

numeric value in seconds

 
1800

(30 minutes)

Sets the lifetime of backup dialog data stored in SCOS.

Other options supported by start-backend.sh

 
-scripthelp

n/a

Shows a brief summary of extra options supported by the script and exits.

 
-type

backend type string

 
itutcap

no other values currently supported

Specifies the type of backend to use.

 
-variant

SS7 variant string

 
C7

Specifies the SS7 variant to use, either C7 or J7.

 
-binpath

path to backend install

the directory containing start-backend.sh

Specifies the base path to find binaries in.

 
-logfile

path to log file

Redirects all backend logging to append to the specified file.

Note

See the table of substitutions.

At most one of -logfile or -logpipe may be specified. If neither is specified, stdout and stderr logging are not redirected.

 
-logpipe

command line followed by --

Redirects all backend logging using a pipe to the given command (shell escapes will be interpreted).

Arguments following -logpipe are passed to the pipe command, until -- is seen; arguments following -- are treated as normal script arguments.

Note

See the table of substitutions.

At most one of -logfile or -logpipe may be specified. If neither is specified, stdout and stderr logging are not redirected.

 
-ulimit

arguments to the ulimit shell command

Changes resource limit parameters before executing the backend. For example, -ulimit -c unlimited will enable unlimited-size core dumps. See help ulimit.

Table of substitutions

The -logfile and -logpipe perform substitutions on their argument to produce a final filename or command line:

String Substituted by…​ 
%%

a literal single percent character (%).

 
%t

the backend type
(set using -type).

 
%s

the local SSN
(set using -lssn).

 
%v

the SS7 variant in use
(set using -variant).

 
%p

the TCP port in use
(set using -port).

 
%P

the PID of the backend process.
Previous page Next page