Overview

At runtime, radiusd can be told to print out debugging information that may be useful for troubleshooting. In addition to debug output, the server software includes utilities that can be used to troubleshoot server problems, and the log file may include messages that would be helpful to resolve a problem.

Debug Output

Debugging output by the server can be turned on when starting the server at a specified level of output. You can use the raddbginc command to turn debugging on and off or set the level of output while the server is running.

Syntax of raddbginc

raddbginc [-di IPC-directory] pid level

pid: The process ID of radiusd. You can determine this with the ps and grep commands as follows:
ps -eaf | grep radiusd
level: The debug level to set. 0 debug logging disabled., through 4 for the highest debug level.
-di IPC-directory: Required option if radiusd installed in a non-default location. The default is /var/opt/aaa/ipc. IPC-directory must match the path given by the radiusd -di option or match the value in Server Manager's Modify AAA Server Connection screen.

All of the debug output is sent to the /var/opt/aaa/logs/radius.debug file, in the default directory or in an alternate location specified by the radiusd -dl option. Refer to Table 4-2 “radiusd Options” for more information on radiusd options.

Debug Levels

When starting radiusd, you can turn on debug output and set the level of output with the -x option. Each instance of the -x option at the command line will increase the debug level by one. After the server is started, you can continue to control debugging output with the raddbginc command.

These levels provide more information at higher levels, as follows:

1 = Minimal information.
2 = Level 1 information, plus high-level FSM output and some function tracing.
3 = Level 2 information with full function tracing.
4 = Level 3 information with low-level FSM and configuration file output.

Overview

Technical documentation

» Table of Contents

» Glossary

» Index

Debug Output

Debug Levels