🟠 High   ⏱ 5–30 min  Last verified: 19 May 2026
Affected versions: SUSE Linux Enterprise Server 16

📖 ~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

salt-minion logs `SaltReqTimeoutError` repeatedly and no jobs run from the master.

Environment & Reproduction

Observed after upgrading salt to the SLES 16 default version.

Root Cause Analysis

Master public key changed or TCP/4505-4506 are blocked by an updated firewall zone.

Quick Triage

Confirm DNS and TCP: `nc -vz salt.example.com 4505` and `nc -vz salt.example.com 4506`.

Step-by-Step Diagnosis

Tail `/var/log/salt/minion` while restarting the minion to capture the auth handshake.

Illustrative mockup for sles-16 — salt_minion-master_terminal
Terminal diagnostics for salt-minion cannot reach salt-master after upgrade — Illustrative mockup — Progressive Robot

Solution – Primary Fix

Accept the minion key on the master (`salt-key -A`) and restart `salt-minion`.

Still having issues? Our IT Solutions & Services team can diagnose and resolve this for you. Get in touch for a free consultation.

Illustrative mockup for sles-16 — salt_minion-master_logs
Logs and evidence for salt-minion cannot reach salt-master after upgrade — Illustrative mockup — Progressive Robot

Solution – Alternative Approaches

Switch to `salt-ssh` for a small fleet while resolving connectivity at scale.

Verification & Acceptance Criteria

`salt ” test.ping` returns True from the master.

Rollback Plan

Revert firewall changes if they cut off `salt-master` ports unexpectedly.

Prevention & Hardening

Pin the minion-master version pair and roll out via staged channels.

Often presents alongside `ssl handshake failure` if TLS pillar/grain is involved.

Related tutorial: View the step-by-step tutorial for sles-16.

View all sles-16 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

SaltStack documentation packaged in `salt-doc` and SUSE manuals.

Need Expert Help?

If you cannot resolve this yourself, our team offers hands-on Server Management, Managed IT Services, and flexible Support Plans. Contact us today — we respond within one business day.