Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

Starting and Stopping a Standalone Steel-Belted Radius Carrier Server

 

After you have successfully run the configure script, you need to start the Steel-Belted Radius Carrier server. To begin, start the SBR daemon using sbrd (see sbrd). Make sure that you can stop it and check the server status from a terminal command line.

sbrd

sbrd

You use the sbrd script to start, stop, or restart the RADIUS process (and LDAP process only if SS7 is configured) on standalone Steel-Belted Radius Carrier servers. The LDAP process (slapd) is used to store session information only if SS7 is configured. The sbrd script may be in either of two directories on servers, depending on whether they have been configured to automatically start all procedures or not using the autoboot functionality that is configured when running the configure script. All sbrd commands are executed by root.

Running sbrd on a Standalone Server

Running sbrd on a Standalone Server

Syntax

Executing start, stop, or restart always starts the RADIUS process. Whether the LDAP process starts when you execute start, stop, or restart depends on whether you enable or disable SS7 while running the configure script. If you answer n when prompted “Do you want to configure for use with SS7? [n]:”, SS7 is disabled and the LDAP process is not started when you execute start, stop, or restart. In this case, the available sbrd usage is:

However, if you answer y when prompted “Do you want to configure for use with SS7? [n]:”, SS7 is enabled and the LDAP process is started when you execute start, stop, or restart. In this case, the available sbrd usage is:

If SS7 is enabled, the start, stop, and restart arguments start, stop, and stop and restart both the RADIUS and LDAP (slapd) processes on the local Steel-Belted Radius Carrier server. For example, invoking sbrd start starts both the RADIUS and LDAP (slapd) processes on the local SBRC server. You can also use these arguments with either the radius or ss7ldapdb option to individually start, stop, and stop and restart the RADIUS and LDAP (slapd) processes on the local SBRC server. For example sbrd start radius starts just the RADIUS process on the local server.

Options

  • The clean argument removes lock files that prevent reinitializing the database more than once. You should use this argument only if things go wrong during the initial installation and configuration.

  • The hup option operates as the kill -HUP command does on SBR Carrier nodes, but does not require the process ID. Executing sbrd hup authGateway issues the SIGHUP (1) signal to all the authGateway processes running on SBR Carrier. To issue the SIGHUP (1) signal only to the specific authGateway process, you must execute the hup option with the authGateway process name, for example: sbrd hup authGateway GMT.

  • The force argument makes sbrd attempt to disregard or overcome any errors that occur when processing the command. Normal behavior without the argument is to halt on errors. For example, sbrd start does not attempt to start software that is already running, but sbrd start force ignores a running process. This may produce unintended results, so use force with great care.

  • The -v option displays additional information about the RADIUS process along with basic information such as the SBR package version, SBR process status, and SBR process ID. If you have changed the default Lightweight Directory Access Protocol (LDAP) Configuration Interface (LCI) password, you should use the -p option to specify the password. For more information about the RADIUS status information, see Displaying RADIUS Status Information.

Starting the RADIUS Server

Starting the RADIUS Server

To start the RADIUS and LDAP processes manually, execute as root:

If you change configuration settings for your Steel-Belted Radius Carrier server, you may need to restart Steel-Belted Radius Carrier to make the changes effective. As an alternative to issuing a sbrd stop command immediately followed by a sbrd start command, you can use the sbrd restart command to restart Steel-Belted Radius Carrier. When you issue the sbrd restart command, Steel-Belted Radius Carrier shuts down and then immediately restarts the RADIUS processes.

Stopping the RADIUS Server

Stopping the RADIUS Server

Use the following commands to stop the RADIUS server:

When you execute the sbrd stop command, Steel-Belted Radius Carrier allows its subsystems to complete outstanding work and release resources, and then stops the RADIUS processes gracefully.

If Steel-Belted Radius Carrier fails to stop after you issue the sbrd stop command, you can use the optional force argument to terminate all subsystems immediately.

Displaying RADIUS Status Information

Displaying RADIUS Status Information

You can use the following command to display basic information (such as SBR package version, SBR process status, and SBR process ID) about the RADIUS process:

The system responds with:

You can use the sbrd status command with the -v option to display the following additional information about the RADIUS process along with the preceding information:

  • Loaded Plug-in Information—Displays the name, version, and status of the loaded authentication and accounting plug-ins. The InitializationString value of the plug-in is displayed as the name of the plug-in.

  • License Status—Displays the license key, feature name, and license status with expiry date.

  • IP Pool Information—Displays the pool name, IP range of the pool, total number of addresses in the pool, and total number of available addresses in the pool.

    Note

    This information is displayed only for the SBR standalone version.

  • IP Ranges and IP Caches—For IP ranges, displays the pool name, start address of the pool, end address of the pool, and total number of addresses in the pool. For IP caches, displays the pool name, total number of addresses in the pool, and percentage of the addresses in the pool that are cached.

    Note

    This information is displayed only for the SBR cluster version.

  • Statistics Information—Displays statistical information about SBR such as current sessions count, SBR uptime (in seconds), current rate details, and average transaction rate since the SBR server started. The transaction rate is calculated using the following formula:

    Transaction Rate = Total Transaction Count / SBR Running Time

    where:

    Total Transaction Count = Total Authentication Transactions + Total Accounting Transactions

    Note

    The current rates are updated at a time interval of one second.

  • Radius Ports Information—Displays protocols, port types, and port numbers on which the SBR Carrier server is listening.

  • Proxy Configuration Information—Displays proxy names and their IP addresses.

  • CST Store Information—Displays the active session store and the time when the last session persistence switchover occurred.

  • authGateway Process Information—Displays all the active authGateway process information.

Note

To display this additional information, you need to enable the Lightweight Directory Access Protocol (LDAP) Configuration Interface (LCI) in the radius.ini file. If you have changed the default LCI password (which we strongly recommend), you should use the -p option to specify the password, that is ./sbrd status -v -p [LCI password].

To display additional information about the RADIUS process along with the basic information, execute the following command:

The system responds with: