Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation  Back up to About Overview 
  
[+] Expand All
[-] Collapse All

sbrd.conf File

The sbrd.conf file (Table 35) is an executable Bourne shell script that is invoked by the sbrd process to initialize the execution environment for Steel-Belted Radius Carrier.

Note: In previous versions of server software, users were instructed to modify the sbrd script if they wanted to change its settings. The sbrd.conf file makes direct modification to the sbrd script unnecessary. Do not modify the sbrd script.

For example:

#!/bin/sh
################################################################################
# sbrd.conf
################################################################################
# This is an executable Bourne shell script, invoked by sbrd in order to
# initialize the execution environment for Steel-Belted Radius software.
# Among others, RADIUSDIR and SELF are read-only constants defined in the
# sbrd script.  Do not attempt to modify these read-only constants.

# Edit these lines to enable configurations that open many files concurrently.
# Management of high file descriptors is required beyond around 224 open files.
# Do not exceed the 1024 file limitation that exists for 32-bit applications.
# Solaris pfiles and Open Source lsof utilities are able to report open files.
ULIMIT_OPEN_FILES=1024  # typically 256 - 1024 inclusive, "disabled", or ""
RADIUS_HIGH_FDS=1  # management of high file descriptors (0=disable, 1=enable)
#ORACLE_MSB_FILE="$ORACLE_HOME/rdbms/mesg/ocius.msb"  # absolute filename, or ""

# Edit this line to configure the file mode creation mask, see umask(1).
# Specify an explicit value in order to override the current environment.
# Specify "" to use the current environment as is without modification.
RADIUSUMASK=""  # either a valid umask argument, or ""

# Radius executable, options, and arguments
RADIUS="radius"
RADIUSOPTS=""
RADIUSARGS="sbr.xml"
RADIUS_PRIVATE_DIR="$RADIUSDIR"

# Watchdog executable, options, and arguments
WATCHDOGENABLE=0  # Edit this line to enable watchdog (0=disable, 1=enable)
WATCHDOG="radiusd"
WATCHDOGOPTS="--config $RADIUSDIR/radiusd.conf --pidfile $RADIUSDIR/radius.pid"
WATCHDOGOPTS="$WATCHDOGOPTS --logfile $RADIUSDIR/radiusd.log"
WATCHDOGARGS="$RADIUSDIR/$SELF"

#Configuration parameter to start GWrelay process (0=no, 1=yes)
GWRELAYENABLE=0

# Edit these lines to interpose arbitrary libraries, e.g. libumem.so allocator.
# We prefer /lib/libumem.so over the default /usr/lib/libmtmalloc.so for
# performant, scalable, multi-threaded memory allocation with optional debug.
# Uncomment UMEM_ variables to enable libumem.so debug, see umem_debug(3MALLOC).
# WARNING:  Enabling libumem.so debug has a noticeable impact on performance!
RADIUS_LD_PRELOAD="/lib/libumem.so"  # a space separated list of libs, or ""
#UMEM_DEBUG="default"  # Uncomment to enable libumem.so debug facilities
#UMEM_LOGGING="transaction"  # Uncomment to enable libumem.so in-memory logs

# Edit these lines to configure the management of radius specific core files.
# Specify an explicit value in order to override the current environment.
# Specify "disabled" to use the current environment as is without modification.
# Specify "" to use the current environment as is and adjust if inappropriate.
ULIMIT_CORE_SIZE=""  # either a valid ulimit -c argument, "disabled", or ""
ULIMIT_CORE_COUNT=3  # either 0 - 999999999, "unlimited", "disabled", or ""

# WARNING: Following parameters are auto-configured. Manual editing is not recommended.
WEBSERVER_JAVA_HOME=
CUSTOM_JVM_PATH=

Note: Do not include spaces in parameter settings in the sbrd.conf file.
Correct: ULIMIT_CORE_COUNT=1024
Incorrect: ULIMIT_CORE_COUNT = 1024

Table 35: sbrd.conf Syntax

Parameter

Function

ULIMIT_CORE_SIZE

Specifies the size of core files generated if SBR Carrier fails.

  • If set to a value, ULIMIT_CORE_SIZE specifies the maximum size for core files in 512-byte blocks (Solaris).
  • If set to disabled, SBR Carrier uses the current environment without changes.
  • If set to "" (two double-quotes with no space between), SBR Carrier uses the current environment, making adjustments as needed.

Default value is "".

ULIMIT_CORE_COUNT

Specifies the number of core files maintained on the SBR Carrier server. If the maximum number of core files already exists on the server, SBR Carrier discards the oldest core files and generates a new core file if it fails.

  • If set to a number in the range 0–999,999,999, the server maintains the specified number of core files.
  • If set to unlimited, SBR Carrier does not discard existing core files if it generates a new one.
  • If set to disabled, SBR Carrier uses the current environment without changes.
  • If set to "" (two double-quotes with no space between), SBR Carrier uses the current environment, making adjustments as needed.

Default value is 3.

ULIMIT_OPEN_FILES

Specifies the number of open files that the SBR Carrier process can have open at one time.

  • If set to a number in the range 256–1024, the server maintains the specified number of open files.
  • If set to disabled, SBR Carrier uses the current environment without changes.
  • If set to "" (two double-quotes with no space between), SBR Carrier uses the current environment, making adjustments as needed.

Default value is 1024.

Note: ULIMIT_OPEN_FILES should never be set less than 256. RADIUS_HIGH_FDS should always be set to 1 unless Juniper Networks Technical Support advises otherwise. Together these parameters ensure that SBR Carrier is always able to open at least 256 regular files. This is especially important for sites that configure multiple Oracle plug-ins.

RADIUSMASK

Specifies the file permissions that are withheld when new log files are created.

  • If set to an umask argument, log files are created with the specified permissions withheld from Owner, Group, and Other users.
  • If set to "", log files are created with the default access permissions established by the ambient umask for Owner, Group, and Other users.

    For information about how to configure and use umask to control file permission settings, and about using the user file creation mode mask, see the SBR Carrier Administration and Configuration Guide.

RADIUS_HIGH_FDS

  • If set to 0, management of file descriptors is disabled.
  • If set to 1, management of file descriptors is enabled.

Default value is 1.

Note: RADIUS_HIGH_FDS should always be set to 1 unless Juniper Networks Technical Support advises otherwise.

ULIMIT_OPEN_FILES should never be set less than 256. Together these parameters ensure that SBR Carrier is always able to open at least 256 regular files. This is especially important for sites that configure multiple Oracle plug-ins.

ORACLE_MSB_FILE

Specifies the absolute path to the locale-specific Oracle message file.

  • If you enter "", Oracle will open multiple instances of this read-only file.
  • If RADIUS_HIGH_FDS is 1 and you specify a valid ORACLE_MSB_FILE (absolute path ending in a file name), SBR Carrier avoids opening multiple instances of this read-only file, thereby helping to ensure that the server is always able to open at least 256 regular files. This is especially important for sites that configure multiple Oracle plug-ins.

Default value is "".

RADIUS

Default value is “radius”.

Note: Do not change this value unless instructed to do so by Juniper Networks Technical Support.

RADIUSOPTS

Specifies options used when running SBR Carrier.

Default value is "".

Note: Do not change this value unless instructed to do so by Juniper Networks Technical Support.

RADIUSARGS

Default value is “sbr.xml”.

Note: Do not change this value unless instructed to do so by Juniper Networks Technical Support.

RADIUS_PRIVATE_DIR

Default value is “$RADIUSDIR”.

Note: Do not change this value unless instructed to do so by Juniper Networks Technical Support.

RADIUS_LD_PRELOAD

Specifies an arbitrary space-separated list of libraries to be interposed on the RADIUS process. In particular, this parameter overrides mtmalloc with the new umem memory allocator.

If commented out or set to "", the parameter does not override anything and the sbrd process uses the mtmalloc memory allocator as in previous releases.

The default value "/lib/libumem.so", uses the umem memory allocator, which provides improved memory handling, instead of mtmalloc.

Note: In addition to improved performance considerations, the umem memory allocator offers optional debug features that are controlled by the UMEM_DEBUG and UMEM_LOGGING parameters. See the Solaris umem_debug(3MALLOC) manual pages for more information.

UMEM_DEBUG

This parameter enables and controls debug features of the umem memory allocator that is enabled by the RADIUS_LD_PRELOAD parameter.

  • If commented out or set to "", disables umem debugging for better performance. In this case, the UMEM_LOGGING parameter must also be commented out or set to "".
  • If uncommented, this parameter should be set to "default" in order to enable umem debugging. In this case, the UMEM_LOGGING parameter must also be uncommented and set to "transaction".

Default value is commented out, that is, umem debugging are disabled for better performance.

Caution: Enabling debug features of the umem memory allocator will noticeably impact SBR performance and memory utilization.

UMEM_LOGGING

This parameter enables and controls debug features of the umem memory allocator that is enabled by the RADIUS_LD_PRELOAD parameter.

  • If commented out or set to "", disables umem in-memory debug logs for better performance. In this case, the UMEM_DEBUG parameter must also be commented out or set to "".
  • If uncommented, should be set to "transaction" in order to enable umem in-memory debug logs. In this case, the UMEM_DEBUG parameter must also be uncommented and set to "default".

Default value is commented out, that is, umem in-memory debug logs are disabled for better performance.

Caution: Enabling debug features of the umem memory allocator will noticeably impact SBR performance and memory utilization.

WATCHDOGENABLE

  • If set to 0, auto-restart, which restarts the SBR Carrier server if it fails, is disabled.
  • If set to 1, auto-restart is enabled.

    Default value is 0.

This parameter is set from your input to the Steel-Belted Radius Carrier configuration script.

WATCHDOG

Specifies the name of the auto-restart module.

Default value is radiusd.

Note: Do not change this value unless instructed to do so by Juniper Networks Technical Support.

WATCHDOGOPTS

Default value is --config $RADIUSDIR/radiusd.conf --pidfile $RADIUSDIR/radius.pid ----logfile $RADIUSDIR/radiusd.log.

Note: Do not change this value unless instructed to do so by Juniper Networks Technical Support.

WATCHDOGARGS

Default value is $RADIUSDIR/$SELF.

Note: Do not change this value unless instructed to do so by Juniper Networks Technical Support.

GWRELAYENABLE

Specifies whether to start the GWrelay process while executing the ./sbrd start script.

  • If set to 1, the GWrelay process is started.
  • If set to 0, the GWrelay process is not started. You should manually start the GWrelay process (if applicable) by using the ./sbrd start GWrelay command.

Note: This parameter is automatically populated after running the SBR Carrier configuration script.

SS7LDAP_ADDRESS= 127.0.0.1

This parameter is automatically populated after running the Steel-Belted Radius Carrier configuration script and answering “Yes” to the question: “Do you want to configure for use with SS7? [n]:”.

Do not modify this parameter without consulting Juniper Networks Technical Support.

SS7LDAP_PORT=389

This parameter is automatically populated after running the Steel-Belted Radius Carrier configuration script and answering “Yes” to the question: “Do you want to configure for use with SS7? [n]:”. Do not modify this parameter without consulting Juniper Networks Technical Support.

STANDALONEMODE

This parameter configures the use of the separate session database process for a standalone SBR Carrier.

  • If set to local, the sbrd script starts only the RADIUS process. SBR Carrier is started in single-process accounting mode. You must use this value only if you have set the PersistSessions parameter in the radius.ini file as 1 (local) or 0 (none).
  • If set to cstserver, the sbrd script starts the separate session database process, followed by the RADIUS process. SBR Carrier is started in dual-process accounting mode. You must use this value only if you set the PersistSessions parameter in the radius.ini file to 3 (cstserver).

Default value is local, if your SBR Carrier server is a 32-bit Linux machine.

Default value is cstserver, if your SBR Carrier server is a 64-bit Linux machine.

Note: In a 64-bit Linux machine, the separate session database process should be disabled (that is, the Enable parameter in the dbclusterRPC.gen should be set to 0) when you manually place SBR Carrier into single-process accounting mode from dual-process accounting mode.

CUSTOM_JVM_PATH

This parameter specifies the path where the libjvm.so file is located. This parameter also sets the LD_LIBRARY_PATH environment variable to point to the location of the libjvm.so file.

Note: Do not edit this parameter manually. This parameter is automatically populated after running the SBR Carrier configuration script.

WEBSERVER_JAVA_HOME

This parameter specifies the path where the Java 1.7.0 or later version that is used to start the webserver for launching the Web GUI is installed in your system.

Note: Do not edit this parameter manually. This parameter is automatically populated after running the SBR Carrier configuration script.

Modified: 2018-01-11