First diagnostic

Run a diagnostic before every Dolibarr upgrade. It is your insurance against an unexpected production outage.

When to run a diagnostic

• Before any major upgrade (e.g. 20.x → 21.x)
• After large custom module or extrafield changes
• When preparing cloning to a target instance

Steps

1. Open Knot › Migration › Mission Control.
2. Pick the source version (auto-detected) and a signed target reference version.
3. Confirm: the engine builds a snapshot (5–30 s on an average instance).
4. The comparator downloads the target reference snapshot and renders the analysis report.
5. Review schema, modules, extrafields, and integration sections.

Click to enlarge

×

Severity levels

Level	Typical action
Information	Document, no blocker
Warning	Schedule a fix before cutover
Critical	Block the upgrade until resolved

Partial failures

An unreadable custom module does not abort the whole diagnostic: see Degraded modes and Diagnostic failed.

Next

Analysis workflow Detailed operator walkthrough.

Snapshots Understand the frozen capture.