Fortinet white logo
Fortinet white logo

CLI Reference

config system federated-upgrade

config system federated-upgrade

Coordinate federated upgrades within the Security Fabric.

config system federated-upgrade
    Description: Coordinate federated upgrades within the Security Fabric.
    set failure-device {string}
    set failure-reason [none|internal|...]
    set next-path-index {integer}
    config node-list
        Description: Nodes which will be included in the upgrade.
        edit <serial>
            set coordinating-fortigate {string}
            set device-type [fortigate|fortiswitch|...]
            set setup-time {user}
            set time {user}
            set timing [immediate|scheduled]
            set upgrade-path {user}
        next
    end
    set status [disabled|initialized|...]
    set upgrade-id {integer}
end

config system federated-upgrade

Parameter

Description

Type

Size

Default

failure-device

Serial number of the node to include.

string

Maximum length: 79

failure-reason

Reason for upgrade failure.

option

-

none

Option

Description

none

No failure.

internal

An internal error occurred.

timeout

The upgrade timed out.

device-type-unsupported

The device type was not supported by the FortiGate.

download-failed

The image could not be downloaded.

device-missing

The device was disconnected from the FortiGate.

version-unavailable

An image matching the device and version could not be found.

staging-failed

The image could not be pushed to the device.

reboot-failed

The device could not be rebooted.

device-not-reconnected

The device did not reconnect after rebooting.

node-not-ready

A device in the CSF tree was not ready.

no-final-confirmation

The coordinating FortiGate did not confirm the upgrade.

no-confirmation-query

A downstream FortiGate did not initiate final confirmation.

next-path-index

The index of the next image to upgrade to.

integer

Minimum value: 0 Maximum value: 10

0

status

Current status of the upgrade.

option

-

disabled

Option

Description

disabled

No federated upgrade has been configured.

initialized

The upgrade has been configured.

downloading

The image is downloading in preparation for the upgrade.

device-disconnected

The image downloads are complete, but one or more devices have disconnected.

ready

The image download finished and the upgrade is pending.

staging

The upgrade is confirmed and images are being staged.

final-check

The upgrade is ready and final checks are in progress.

upgrade-devices

The upgrade is ready and devices are being rebooted.

cancelled

The upgrade was cancelled due to the tree not being ready.

confirmed

The upgrade was confirmed and reboots are running.

done

The upgrade completed successfully.

failed

The upgrade failed due to a local issue.

upgrade-id

Unique identifier for this upgrade.

integer

Minimum value: 0 Maximum value: 4294967295

0

config node-list

Parameter

Description

Type

Size

Default

coordinating-fortigate

Serial number of the FortiGate unit that controls this device.

string

Maximum length: 79

device-type

What type of device this node represents.

option

-

fortigate

Option

Description

fortigate

This device is a FortiGate.

fortiswitch

This device is a FortiSwitch.

fortiap

This device is a FortiAP.

serial

Serial number of the node to include.

string

Maximum length: 79

setup-time

When the upgrade was configured. Format hh:mm yyyy/mm/dd UTC.

user

Not Specified

time

Scheduled time for the upgrade. Format hh:mm yyyy/mm/dd UTC.

user

Not Specified

timing

Whether the upgrade should be run immediately, or at a scheduled time.

option

-

immediate

Option

Description

immediate

Begin the upgrade immediately.

scheduled

Begin the upgrade at a configured time.

upgrade-path

Image IDs to upgrade through.

user

Not Specified

config system federated-upgrade

config system federated-upgrade

Coordinate federated upgrades within the Security Fabric.

config system federated-upgrade
    Description: Coordinate federated upgrades within the Security Fabric.
    set failure-device {string}
    set failure-reason [none|internal|...]
    set next-path-index {integer}
    config node-list
        Description: Nodes which will be included in the upgrade.
        edit <serial>
            set coordinating-fortigate {string}
            set device-type [fortigate|fortiswitch|...]
            set setup-time {user}
            set time {user}
            set timing [immediate|scheduled]
            set upgrade-path {user}
        next
    end
    set status [disabled|initialized|...]
    set upgrade-id {integer}
end

config system federated-upgrade

Parameter

Description

Type

Size

Default

failure-device

Serial number of the node to include.

string

Maximum length: 79

failure-reason

Reason for upgrade failure.

option

-

none

Option

Description

none

No failure.

internal

An internal error occurred.

timeout

The upgrade timed out.

device-type-unsupported

The device type was not supported by the FortiGate.

download-failed

The image could not be downloaded.

device-missing

The device was disconnected from the FortiGate.

version-unavailable

An image matching the device and version could not be found.

staging-failed

The image could not be pushed to the device.

reboot-failed

The device could not be rebooted.

device-not-reconnected

The device did not reconnect after rebooting.

node-not-ready

A device in the CSF tree was not ready.

no-final-confirmation

The coordinating FortiGate did not confirm the upgrade.

no-confirmation-query

A downstream FortiGate did not initiate final confirmation.

next-path-index

The index of the next image to upgrade to.

integer

Minimum value: 0 Maximum value: 10

0

status

Current status of the upgrade.

option

-

disabled

Option

Description

disabled

No federated upgrade has been configured.

initialized

The upgrade has been configured.

downloading

The image is downloading in preparation for the upgrade.

device-disconnected

The image downloads are complete, but one or more devices have disconnected.

ready

The image download finished and the upgrade is pending.

staging

The upgrade is confirmed and images are being staged.

final-check

The upgrade is ready and final checks are in progress.

upgrade-devices

The upgrade is ready and devices are being rebooted.

cancelled

The upgrade was cancelled due to the tree not being ready.

confirmed

The upgrade was confirmed and reboots are running.

done

The upgrade completed successfully.

failed

The upgrade failed due to a local issue.

upgrade-id

Unique identifier for this upgrade.

integer

Minimum value: 0 Maximum value: 4294967295

0

config node-list

Parameter

Description

Type

Size

Default

coordinating-fortigate

Serial number of the FortiGate unit that controls this device.

string

Maximum length: 79

device-type

What type of device this node represents.

option

-

fortigate

Option

Description

fortigate

This device is a FortiGate.

fortiswitch

This device is a FortiSwitch.

fortiap

This device is a FortiAP.

serial

Serial number of the node to include.

string

Maximum length: 79

setup-time

When the upgrade was configured. Format hh:mm yyyy/mm/dd UTC.

user

Not Specified

time

Scheduled time for the upgrade. Format hh:mm yyyy/mm/dd UTC.

user

Not Specified

timing

Whether the upgrade should be run immediately, or at a scheduled time.

option

-

immediate

Option

Description

immediate

Begin the upgrade immediately.

scheduled

Begin the upgrade at a configured time.

upgrade-path

Image IDs to upgrade through.

user

Not Specified