Troubleshooting

Troubleshooting with systemd

Ghaf uses systemd and systemctl to manage services.

This document focuses on troubleshooting common issues with systemd services on Ghaf.

Since security is the utmost priority, every service has restricted access to resources, which is achieved through hardened service configurations. While these restrictions enhance security, they may also limit the functionality of certain services. If a service fails, it may be necessary to adjust its configuration to restore functionality.

Our current troubleshooting scenarios are the following:

• Analyzing system logs
• Debugging systemd using systemctl
• Inspecting services with systemd-analyze
• Using strace for debugging the initialization sequence
• Early shell access