Stop FortiGate Upgrade Failures Now with FortiManager

Stop FortiGate Upgrade Failures Now with FortiManager

Description

Upgrade FortiGate using FortiManager with GUI, templates, HA support, troubleshooting steps, and screenshots in this simple step-by-step guide.

Scope

This guide explains how to upgrade FortiGate using FortiManager step by step. It is designed for both beginners and experienced network administrators.

You will learn:

  • GUI upgrade method
  • Firmware Template upgrade
  • HA cluster behavior
  • Troubleshooting and debug commands

Solution 

Prerequisite: Check Firmware Upgrade License

Before upgrading, make sure the FortiGate has a valid firmware license.

Run this on FortiManager CLI:

				
					diagnose fmupdate fds-dump subs
				
			

 This confirms the FMWR (firmware) license status

Method 1: Upgrade via GUI (Device Manager)
Step 1: Open Device Manager

Go to:

Device Manager → Managed FortiGate

Double-click the target device.

Under Firmware Version, click:

⇒ Upgrade Firmware

Stop FortiGate Upgrade Failures Now with FortiManager - Device Manager
Step 2: Select Firmware Version

Choose the required firmware version/image and click:

⇒ Upgrade

FortiOS 7.4+ Layout Change
  • UI layout is slightly different in newer versions
  • No direct “Backup Config” option

Instead, use:
Revision History → Snapshot (for backup)

Stop FortiGate Upgrade Failures Now with FortiManager - FortiOS 7.4+ Layout Change
Step 3: Firmware Download Prompt

Before the upgrade, a prompt appears:

 Select:
“Let Device Download Firmware from FortiGuard”

✔ Use ONLY if firmware is NOT imported in FortiManager

Stop FortiGate Upgrade Failures Now with FortiManager - Upgrade Downgrade Frimware
Step 4: Monitor Upgrade Progress

Track upgrade status until completion.

Method 2: Upgrade Using Firmware Templates (Advanced)
Step 1: Create Firmware Template

Go to:

Device Manager → Firmware Templates → Create New

Select:

  • Platform
  • Firmware version
Stop FortiGate Upgrade Failures Now with FortiManager - Firmware version
Step 2: Select Upgrade Path

 Always choose:
Recommended Upgrade Path

Stop FortiGate Upgrade Failures Now with FortiManager - Select Upgrade Path
Step 3: Assign Devices
  • Right-click template → Assign to Device/Group
  • Move devices to Selected Entries
  • Click OK
Step 4: Verify Assignment

Devices appear under template.

Stop FortiGate Upgrade Failures Now with FortiManager - Verify Assignment
Stop FortiGate Upgrade Failures Now with FortiManager
Step 5: Start Upgrade
  • Right-click template → Upgrade Now
  • Confirm upgrade
Stop FortiGate Upgrade Failures Now with FortiManager - Start Upgrade
Stop FortiGate Upgrade Failures Now with FortiManager - Confirm upgrade
HA Cluster Upgrade Behavior (IMPORTANT)
  • Upgrade process is SAME as standalone
  • Only primary device appears in FortiManager
  • Secondary device upgrades automatically

 This is normal behavior

Works only if HA cluster is healthy

Debug & Monitoring (CRITICAL)
FortiManager Debug
				
					diagnose fwmanager fwm-log
				
			

Shows live upgrade logs

FortiGate Debug

Run on console:

				
					diagnose debug cli 8
diagnose debug enable
				
			
Task Monitoring
  • Check upgrade job in Task Monitor
Stop FortiGate Upgrade Failures Now with FortiManager - Task Monitor
CRITICAL WARNING (HA Outage Issue)

During HA upgrade:

 If disk check is required:

  • FortiManager reboots firewall twice
  • Can cause network outage
Real Problem
  • Primary reboots
  • Secondary reboots too quickly
  • Both devices go down

 Result:

  • Network outage
  • Version mismatch
Workaround (VERY IMPORTANT)

Disable disk check before upgrade:

				
					config fmupdate fwm-setting
set check-fgt-disk disable
end
				
			
Troubleshooting Commands

Use these on FortiManager:

				
					diagnose fwmanager fwm-log
diagnose fwmanager service-restart
				
			
Notes / Best Practices
  • Always verify license before upgrade
  • Use recommended upgrade path
  • Monitor upgrade via Task Monitor
  • Take config backup (Revision History)
  • Avoid upgrading during peak hours
  • Check HA health before upgrade
FAQ

Use:

diagnose fmupdate fds-dump subs

Yes, using Firmware Templates

Yes, secondary upgrades automatically via primary

Due to simultaneous reboot during disk check

Disable disk check before upgrade

Related Article 
Comments are closed.