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.

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

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

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