Auto-Restart Files

When enabled, the auto-restart module (radiusd script), acts as a watchdog daemon monitoring the status of the SBR Carrier executable, and restarting it as needed. Auto-restart is disabled by default. Regardless of whether auto-restart is enabled, the SBR Carrier software is always started and stopped using this command:

/opt/JNPRsbr/radius/sbrd start radius

/opt/JNPRsbr/radius/sbrd stop radius

Auto-restart is enabled by configuring the WATCHDOG* parameters in the sbrd.conf file, and fine-tuned by configuring the radiusd.conf file. See sbrd.conf File, and radiusd.conf File.

Perl must be installed on the Steel-Belted Radius Carrier server if you want to use the automatic restart module.

Note: If Perl version 5 is not installed, the radiusd script will not run, even if enabled by configuration, and SBR Carrier will operate without the auto-restart module running.

Perl SNMP Support

You can configure the auto-restart module to send SNMP traps to record auto-restart events. Perl SNMP support resides in the Perl SNMP_Session module, which provides access to remote SNMP agents.

Perl SNMP support allows Steel-Belted Radius Carrier to send SNMP traps to a variety of SNMP agents, including the Sun Management Center, which is distributed with some Sun hardware platforms. Sun Management Center is not required to run radiusd.

Perl System Log Support

The optional perl package syslog.ph is used to log the watchdog daemon status. You can configure auto-restart to send system log messages to record auto-restart events. To use system log reporting, you can use the h2ph utility to create a syslog.ph file. This example assumes site_perl/5.005 is in @INC:

su - root
cd /user/include/sys
/usr/perl15/bin/h2ph -d /usr/perl15/site_perl/5.005 syslog.h

If you do not want to use system log, use the -d or --logfile options for the radiusd command to open a regular log file (radiusd.log).

sbrd.conf File

To enable the auto-restart module, you must edit the sbrd.conf file using the following procedure:

Note: The following procedure is dependent upon you enabling the auto startup scripts when you install SBR Carrier.

1. If SBR Carrier is already running, become superuser and type this command to stop the server:

   /opt/JNPRsbr/radius/sbrd stop radius

2. Edit sbrd.conf to set WATCHDOGENABLE=1 (or 0 to disable)
3. Type this command to restart the server:

   /opt/JNPRsbr/radius/sbrd start radius

   Note: If you are running the optional SSR module, the command to start/stop only the SSR cluster is /opt/JNPRsbr/radius/sbrd start/stop ssr. This controls SSR without starting or stopping the SBR.

radiusd.conf File

The default radiusd.conf settings cause the auto-restart feature to work this way:

If the radius server executable fails to respond to status polling from radiusd within 17 seconds, radiusd attempts to stop radius using SIGTERM (a polite shutdown). If radius does not shut down within 60 seconds, SIGKILL (a hard kill) is used to stop it. After shutdown by either method, radiusd starts a new radius child process. If this radius child does not respond to status polling within 60 seconds of startup, it is presumed dead; a misconfiguration of the server is assumed; and radiusd terminates with a critical error.

While the auto-restart module is enabled, all informational, debugging, warning, error, and critical messages from radiusd are recorded here:

• Syslog—Messages are written to the syslog system logging facility.
• Log file—If syslog is not available, messages are written to the server log file specified using the --logfile option in the sbrd.conf WATCHDOGOPTS parameter.

  Note: If Perl is not installed in the /usr/local/bin/ directory, this error message occurs when you start the SBR Carrier server: ./S90sbrd: /RadiusHome/radiusd: not found To fix this error, edit the first line of the radiusd file in the RADIUS directory so that the directory structure points to the correct Perl interpreter executable: #!/usr/local/bin/perl

radiusd.conf Configuration File

The radiusd.conf configuration file (Table 38) provides settings for the radiusd auto-restart module.