Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

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:

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

Specifies the options for the auto-restart module.

Options are:

  • --config—Specifies the configuration file.

  • --pidfile—Specifies the file that contains the server process ID.

  • --logfile—Specifies the server log file name. If syslog is not available, log messages are written to the server log file.

    Note: By default, the filename specified in the --config, --pidfile, or --logfile option is assumed to be located in the \$RADIUSDIR directory. If you want to specify a file in a different directory, you must add the directory path along with the filename—for example, /tmp/radiusd.conf.

  • --debug—(Optional) Enables the debugging mode.

  • --syslog—(Optional) Specifies the syslog connection method.

  • --force—(Optional) Forces a server restart as needed. This option should be used with caution as hard kill signals (SIGKILL) may be sent as a last resort.

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.

SHUTDOWNTIMEOUT

Specifies the maximum number of seconds to wait for outstanding database transactions when the server is in the process of shutting down.

You can enter a value in the range from 45 through 360 seconds. Default value is 45 seconds.

Note: You must set this parameter based on the memory usage of SBR Carrier process. If the memory is in the range 8–20 GB, set this parameter to a value greater than 200 seconds. If the memory is greater than 20 GB, set this parameter to 360 seconds.

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 SIGTRAN? [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 SIGTRAN? [n]:”. Do not modify this parameter without consulting Juniper Networks Technical Support.

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.8.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.