3978/TCP
Management connection Automated Commit Recovery tests before reverting a pushed commit
2
Firewall-side settings (Panorama Policy and Objects, Device and Network Template) that must both be enabled to accept pushed configuration
9.1
PAN-OS version that introduced Automated Commit Recovery

SponsoredHorizon3.ai

Proactive Security for the AI Era

NodeZero continuously and autonomously pentests infrastructure, identity, cloud, and now web applications, chaining weaknesses across every domain the way real attackers do. Every finding ships with replayable proof showing exploitable business impact, not theoretical risk.

See NodeZero WebApp in action

A Panorama commit or push-to-devices job that fails is annoying but at least honest about it. The failure that actually costs teams time is the one that does not look like a failure at all: the push job reports success, and ten minutes later the firewall is running its previous configuration again, with no error banner and no obvious reason why. Both situations trace back to a small set of well-documented root causes, and the fastest way through either one is to triage which cause applies before touching the push button again.

This guide covers three failure patterns that account for most Panorama push problems in production: a firewall's own pending local candidate configuration getting merged into the pushed config because of the default "Merge with Device Candidate Config" behavior, a firewall that has Panorama Policy and Objects or Device and Network Template management disabled so it silently refuses to accept part of what Panorama sends, and a validation error against an object, zone, or rule reference that Panorama's own pre-push validation catches and reports. It also covers PAN-OS 9.1's Automated Commit Recovery feature, which is the reason a push can look successful and then reverse itself: that feature is a diagnostic signal in its own right, not just background behavior to route around.

None of this replaces reading the actual error text Panorama gives you. It is meant to shortcut the trial-and-error cycle of re-pushing the same failing job and hoping a second attempt behaves differently, which it will not, because none of these root causes resolve themselves on retry.

Why This Happens: Three Root Causes Behind Most Push Failures

Pending local changes get merged into the push. By default, Panorama's push-to-devices operation has "Merge with Device Candidate Config" enabled. That setting commits any pending local configuration changes sitting in a managed firewall's own candidate config alongside whatever Panorama is pushing. If an administrator (or a script, or a previous session) left an incomplete or invalid change sitting uncommitted on that firewall, the merge pulls it in and the combined commit fails, even though the configuration Panorama itself is sending is completely valid.

A firewall has stopped accepting part of what Panorama manages. Every managed firewall has two settings under Device > Setup > Management > Panorama Settings that control whether it accepts pushed configuration at all: Panorama Policy and Objects, and Device and Network Template. If either setting is disabled on the firewall, whether by a prior local administrator action, a factory reset, or a device that was re-added to Panorama without those settings being re-enabled, the corresponding category of pushed configuration silently fails to apply on that device even while other managed firewalls in the same push job succeed normally.

Panorama's own validation catches an invalid reference before the push is sent. Panorama validates the configuration before pushing it, and one of the most common validation failures is a reference to an object, zone, or rule that does not resolve correctly at the point in the device-group or template hierarchy where it is used. The Palo Alto Networks knowledge base documents several specific patterns behind this: an address, service, or application object that was renamed but a policy still points to the old name; an object referenced by a rule in a parent device group when the object itself was only ever created in a child device group (parent device groups cannot resolve objects scoped lower in the hierarchy); and a "ghost reference," where an object was deleted but a disabled rule, a policy-based forwarding rule, or a zone protection profile still points to it.

A push can look successful and then reverse itself. Starting in PAN-OS 9.1, managed firewalls can run Automated Commit Recovery: after receiving a Panorama-pushed commit, the firewall tests its own connectivity back to Panorama over the management connection (TCP/3978), and if that connectivity is not confirmed within the configured number of attempts, roughly ten seconds per attempt by default, the firewall automatically reverts to its prior running configuration. This is not a bug. It exists specifically to prevent a pushed change (commonly a management-interface or routing change) from cutting a firewall off from Panorama entirely. But if you do not know this feature is enabled, a firewall reverting minutes after a "successful" push looks like an inexplicable ghost failure instead of what it actually is: a signal that the pushed change broke connectivity between that firewall and Panorama.

Diagnostics: Confirming Which Cause Applies

Work through these checks in order. Each one either confirms or rules out one of the causes above, and the order is chosen so the fastest checks come first.

Subscribe to unlock Remediation & Mitigation steps

Free subscribers unlock full IOC lists, Sigma detection rules, remediation steps, and every daily briefing.

Free daily briefing

Briefings like this, every morning before 9am.

Threat intel, active CVEs, and campaign alerts, distilled for practitioners. 50,000+ subscribers. No noise.

Fixes: Step-by-Step Remediation Per Cause

Apply the fix that matches the cause you confirmed in diagnostics. Do not apply all of these speculatively; each one changes behavior in a way that should be deliberate, not default.

Subscribe to unlock Remediation & Mitigation steps

Free subscribers unlock full IOC lists, Sigma detection rules, remediation steps, and every daily briefing.

Validation: Confirming the Fix Actually Held

A push that completes without an error is not the same as a push that held. Confirm each of the following before considering the incident closed.

Subscribe to unlock Remediation & Mitigation steps

Free subscribers unlock full IOC lists, Sigma detection rules, remediation steps, and every daily briefing.

Failure Cases: When the Standard Fix Does Not Resolve It

Each of the fixes above resolves the specific cause it targets. When the push still fails after applying the matching fix, these are the next things to check before escalating.

If disabling Merge with Device Candidate Config did not resolve a merge-related failure, confirm you actually resolved the local candidate configuration issue on the firewall itself rather than only unchecking the merge setting; unchecking the setting stops Panorama from pulling the local changes into this specific push, but an administrator or automation may re-enable the checkbox by default on the next push attempt, and the underlying invalid local config is still sitting there uncommitted.

If enabling Panorama Policy and Objects or Device and Network Template did not restore pushes to a specific firewall, check whether that firewall was re-added to Panorama recently under a different serial number registration or after a factory reset; in that case the device group and template stack assignments themselves may need to be re-applied from Panorama's device management pages, not just the local management settings re-enabled.

If a validation error persists after correcting the object reference you identified, search more broadly than the single rule Panorama's error message named. A renamed or deleted object is frequently referenced in more than one place (a security rule, a NAT rule, an application override, and a log forwarding profile can all reference the same address object independently), and Panorama's validation error text does not always enumerate every reference in one pass.

If Automated Commit Recovery keeps reverting a push that you have confirmed does not change management-plane connectivity, check whether an intermediate device (a switch ACL, an upstream firewall, or a routing change unrelated to this specific push) is independently affecting the management path between the firewall and Panorama at the same time. The feature reverts based on observed connectivity, not on its own diagnosis of what broke it, so an unrelated network change can trigger the same symptom.

Escalation Criteria: When to Open a Support Case

Handle internally when the Task Manager validation error names a specific, resolvable object, setting, or rule and the fix above addresses it; when the failure is isolated to one device's local Panorama settings; or when Automated Commit Recovery reverted a push because of an identifiable, correctable change to management connectivity.

Open a case with Palo Alto Networks support when the Panorama-side management processes themselves show degradation (a process flagged in show management-clients that does not clear after a Panorama restart), when a push fails with a validation error that does not name a specific object or setting and firewall-level devsrvr logs show no corresponding resource issue, when the same push succeeds against some managed firewalls in a device group and fails against others running the identical PAN-OS version with no configuration difference you can identify, or when Automated Commit Recovery reverts a push repeatedly despite confirming the pushed change does not affect the management interface, routing, or the security policy governing the Panorama management connection.

Before opening a case, gather: the Job ID and full Task Manager output for the failed push, the exact PAN-OS and Panorama software versions involved, the mp-log and devsrvr log excerpts covering the failure window on both Panorama and the affected firewall, whether Merge with Device Candidate Config and Automated Commit Recovery are enabled, and a description of what changed in the pushed configuration relative to the last known-good push. Support will ask for all of this; collecting it before opening the case avoids a full round trip of back-and-forth before diagnosis even starts.

For firewalls managed under Panorama, a periodic review of the underlying security policy itself, not just push mechanics, catches configuration drift before it turns into the next commit failure; see our guides on PAN-OS security hardening and firewall rule audit and cleanup for that broader maintenance cycle.

The bottom line

Most Panorama push and commit failures trace back to one of three causes: a pending local candidate configuration on the firewall getting merged into the push, a disabled Panorama Policy and Objects or Device and Network Template setting silently blocking receipt of pushed configuration on one device, or a validation error against a renamed, misscoped, or deleted object reference. A push that looks successful and then reverts is usually PAN-OS 9.1's Automated Commit Recovery reacting to a management-connectivity problem the pushed change introduced, not an unexplained failure. Read the full Task Manager validation error before re-pushing, confirm which of the three causes applies, and apply the matching fix rather than retrying the same push and expecting a different result.

Frequently asked questions

Why does a Panorama push fail even though the configuration I'm pushing looks correct?

The most common reason is that Panorama's default Merge with Device Candidate Config setting pulls in an incomplete or invalid local candidate configuration already sitting on the target firewall, so the combined commit fails even though the configuration Panorama itself is sending is valid.

Why did a firewall revert to its old configuration minutes after a Panorama push completed successfully?

This is very likely PAN-OS 9.1's Automated Commit Recovery feature. After a Panorama-pushed commit, the firewall tests its own management-plane connectivity back to Panorama, and if that connectivity is not confirmed within the configured attempts, it automatically reverts to the prior running configuration.

Why did a push succeed for most firewalls in a device group but silently not apply to one?

Check Device > Setup > Management > Panorama Settings on that specific firewall. If Panorama Policy and Objects or Device and Network Template is disabled there, that firewall silently does not accept the corresponding category of pushed configuration while other devices in the same push succeed normally.

What does a 'reference not valid' or 'invalid object' error in a Panorama commit actually mean?

It usually means a rule references an object that was renamed and still points to the old name, an object defined only in a child device group being referenced from a parent device group (which cannot resolve child-scoped objects), or a deleted object still referenced by a disabled rule, PBF rule, or zone protection profile.

Should I disable Merge with Device Candidate Config permanently to avoid this problem?

Treat unchecking it as a per-push decision, not a permanent setting. Disabling it site-wide means legitimate pending local changes on managed firewalls will never get committed through a Panorama push, which just relocates the problem rather than fixing it.

When should I open a support case instead of continuing to troubleshoot a Panorama push failure myself?

Escalate when Panorama's own management processes show degradation that doesn't clear on restart, when a validation error names no specific object and firewall logs show no matching resource issue, when identical firewalls on the same PAN-OS version show different push results with no configuration difference, or when Automated Commit Recovery keeps reverting a push you've confirmed doesn't affect management connectivity.

Sources & references

  1. Palo Alto Networks: Troubleshoot Panorama Push Failure Due to Pending Local Firewall Changes
  2. Palo Alto Networks: Triage Commit Issues on Panorama
  3. Palo Alto Networks: Troubleshoot Template or Device Group Push Failures
  4. Palo Alto Networks: Enable Automated Commit Recovery (Panorama)
  5. Palo Alto Networks Knowledge Base: Commit Fails with Reference to Invalid or Missing Object

Free resources

25
Free download

Critical CVE Reference Card 2025–2026

25 actively exploited vulnerabilities with CVSS scores, exploit status, and patch availability. Print it, pin it, share it with your SOC team.

No spam. Unsubscribe anytime.

Free download

Ransomware Incident Response Playbook

Step-by-step 24-hour IR checklist covering detection, containment, eradication, and recovery. Built for SOC teams, IR leads, and CISOs.

No spam. Unsubscribe anytime.

Free newsletter

Get threat intel before your inbox does.

50,000+ security professionals read Decryption Digest for early warnings on zero-days, ransomware, and nation-state campaigns. Free, daily, no spam.

Unsubscribe anytime. We never sell your data.

Eric Bang
Author

Founder & Cybersecurity Evangelist, Decryption Digest

Cybersecurity professional with expertise in threat intelligence, vulnerability research, and enterprise security. Covers zero-days, ransomware, and nation-state operations for 50,000+ security professionals every morning.

Related Questions: Answer Hub

Giveaway: InfoSec World 2026 All Access Pass ($3,895 value)

Details →
Daily Briefing

Subscribe to enter the giveaway

Every subscriber is automatically entered. You also get daily threat intel every morning: zero-days, ransomware, and nation-state campaigns. Free. No spam.

Already subscribed? You're already entered.

Giveaway

Win a $3,895 InfoSec World 2026 pass.