Upgrading vm-series plugin version cause one of HA units transition to "Non-Functional" state
3747
Created On 10/11/23 00:23 AM - Last Modified 05/08/25 22:24 PM
Symptom
- VM-series plugin version on one of HA units being upgraded
- There is a mismatch on vm-series plugin version between PA-VM HA units (ex: PA-VM-1: v2.1.4; PA-VM-2: v2.1.0)
- HA peer unit with lower vm-series plugin version transitioned to "Non-Functional" state
Environment
- VM Series Firewalls
- PAN-OS 9.1 and above
- High Availability
- VM-Series Plugin
Cause
Per design, HA device with lower vm-series plugin version compared to HA peer will transition to "Non-Functional" state
Resolution
- When installing the plugin on VM-Series firewalls in an HA pair, install the higher version VM-Series plugin on the active peer before the passive peer.
- After installing the plugin on the active peer it transitions the passive peer to a non-functional state.
- Installing the plugin later on the passive peer returns the passive peer to a functional state.
- The information is documented at PAN-OS Upgrade Guide: Upgrade the VM-Series PANOS Software (HA Pair)
Plugin Upgrade Procedure:
- Check the latest Release Notes for details on whether a new VM-Series plugin affects your environment.
- Log in to the VM-Series firewall and check the dashboard to view the plugin version or CLI (> show system info | match vm_series).
- Select Device > Plugins to view the plugin version. Use Check Now to check for updates.
- Select the version of the plugin and click Install in the Action column to install the plugin.
Additional Information
Example:
- Suspend PA-VM-1 (passive) and upgrade the vm-series plugin from 2.1.0 to 2.1.4
PA-VM-1(suspended)> show system info | match vm_series
vm_series: vm_series-2.1.4 (vm-series plugin version upgraded from 2.1.0 to 2.1.4)
PA-VM-1(suspended)> show log system opaque contains Plugin
YYYY/MM/DD hh:mm:ss info general general 0 Plugin vm_series-2.1.4 installed.
- Now the active PA-VM-2: will transition to Non-Functional state because it has the lower vm-series plugin
PA-VM-2(non-functional)> show system info | match vm_series
vm_series: vm_series-2.1.0 (lower vm-series plugin version)
PA-VM-2(non-functional)> show log system start-time equal YYYY/MM/DD@hh:mm:ss
YYYY/MM/DD hh:mm:ss high ha peer-ve 0 HA Group 1: VMS version only compatibility matches
YYYY/MM/DD hh:mm:ss critical general general 0 Chassis Master Alarm: HA-event
YYYY/MM/DD hh:mm:ss critical ha state-c 0 HA Group 1: Moved from state Active to state Non-Functional