Ubuntu 14.04 LTS – dist-upgrade aborts with held broken packages

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

dist-upgrade fails with held or broken package messages, blocking security and feature updates.

Environment & Reproduction

Often appears after mixed repositories, partial upgrades, or manually pinned packages.

Root Cause Analysis

Dependency resolver cannot satisfy version constraints for one or more required packages.

Quick Triage

List held packages, inspect dependency tree, and validate repository priority settings.

Step-by-Step Diagnosis

Run simulation mode and collect exact package conflict output for remediation.

Solution – Primary Fix

Release holds, repair package state, and retry dist-upgrade using supported repositories.

Solution – Alternative Approaches

Disable conflicting third-party repositories temporarily to isolate dependency issues.

Verification & Acceptance Criteria

Upgrade simulation and execution complete with no held-broken dependency errors.

Rollback Plan

Reinstate previous repository and hold configuration if required to stabilize services.

Prevention & Hardening

Enforce repository governance and periodic dependency health checks before upgrades.

Related Errors & Cross-Refs

Related messages include unmet dependencies, kept back packages, and resolver failures.

Related tutorial: View the step-by-step tutorial for Ubuntu 14.04 LTS.

View all Ubuntu 14.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Consult Ubuntu packaging and apt dependency resolution guidance.