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

Specifies the type of backend to use, either itutcap or ansitcap.

 -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