System diagnostics

7.7. System diagnostics#

This page describes tools that help you inspect the current state of a system running Nubus for UCS and identify common problems. It covers command-line system status logging and diagnostic functions in the Management UI.

7.7.1. Command-line diagnostics#

Run univention-system-stats to write the current system status to the /var/log/univention/system-stats.log file. The command logs the following values:

  • The free disk space on the system partitions: df -lhT.

  • The current process list: ps auxf.

  • Two top lists of the current processes and system load, top -b -n2.

  • The current free system memory: free.

  • The time elapsed since the system started: uptime.

  • Temperature, fan, and voltage indexes from lm-sensors with the command sensors.

  • A list of the current Samba connections: smbstatus.

To configure system status logging:

  1. Set the UCR variable system/stats/cron to the required cron expression. For example, use 0,30 * * * * to log the status every 30 minutes.

  2. Set the UCR variable system/stats to yes.

7.7.2. Diagnostics in the Management UI#

The Management UI provides modules to inspect running processes and diagnose known system problems.

7.7.2.1. View processes in the Management UI#

Open the Process overview management module to view the current processes on the system. To sort the processes, click the corresponding table header for one of the following properties:

  • CPU utilization in percent

  • The username under which the process runs

  • Memory consumption in percent

  • The process ID

To terminate a process, open the More menu and choose one of the following actions:

Terminate

The Terminate action sends the process the SIGTERM signal. Use this action for controlled program termination.

Force terminate

A program can sometimes stop responding, for example after a crash. In this case, use Force terminate to send the SIGKILL signal and force the process to stop.

In general, use SIGTERM first because many programs can then shut down in a controlled way and save open files.

See also

POSIX signals in Signal (IPC) - Wikipedia

for information about POSIX signals for inter-process communication.

7.7.2.2. Run system diagnostics in the Management UI#

Open the System diagnostics management module to analyze a system running Nubus for UCS for known problems.

The module checks known problem scenarios. If the module can fix a detected problem automatically, it shows an additional button for that action. It also links to related articles and corresponding management modules.

On this page