RHEL 7 systemctl Restart Hangs Due to ExecStop Timeout

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution – Primary Fix
7. Solution – Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

systemctl restart blocks deployment pipeline because daemon takes too long in stop phase and exceeds maintenance window.

Environment & Reproduction

RHEL 7 custom unit with blocking ExecStop script reproduces hanging restart under moderate load.

Root Cause Analysis

ExecStop script waits on unreachable dependencies and TimeoutStopSec is set excessively high for this service.

Quick Triage

Inspect systemctl status, check journalctl timing spans, verify network/firewalld reachability, and review SELinux denials.

Step-by-Step Diagnosis

Trace stop script execution path, measure latency per step, and capture signals delivered by systemd.

Solution – Primary Fix

Optimize ExecStop, set realistic TimeoutStopSec, add KillMode controls, and restart service via systemctl.

Solution – Alternative Approaches

Use async shutdown helper, split cleanup into oneshot service, or invoke legacy service script during transition.

Verification & Acceptance Criteria

Restart duration drops to target threshold and service recovers to active state without timeout warnings.

Rollback Plan

Revert unit override and scripts, daemon-reload, then restart to previous known behavior if instability appears.

Prevention & Hardening

Benchmark stop/start routines regularly and enforce performance budgets in change reviews for service units.

Related Errors & Cross-Refs

Related to start-limit bursts, orphan worker shutdown, and journalctl truncation hiding extended stop diagnostics.

Related tutorial: View the step-by-step tutorial for rhel-7.

View all rhel-7 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Use systemd timeout and kill behavior docs with RHEL-specific service management recommendations.