config system ha
Configure HA.
config system ha
Description: Configure HA.
set arps {integer}
set arps-interval {integer}
set authentication [enable|disable]
set auto-virtual-mac-interface <interface-name1>, <interface-name2>, ...
set backup-hbdev <name1>, <name2>, ...
set check-secondary-dev-health [enable|disable]
set cpu-threshold {user}
set encryption [enable|disable]
set evpn-ttl {integer}
set failover-hold-time {integer}
set ftp-proxy-threshold {user}
set gratuitous-arps [enable|disable]
set group-id {integer}
set group-name {string}
set ha-direct [enable|disable]
set ha-eth-type {string}
config ha-mgmt-interfaces
Description: Reserve interfaces to manage individual cluster units.
edit <id>
set dst {ipv4-classnet}
set gateway {ipv4-address}
set gateway6 {ipv6-address}
set interface {string}
next
end
set ha-mgmt-status [enable|disable]
set ha-uptime-diff-margin {integer}
set hb-interval {integer}
set hb-interval-in-milliseconds [100ms|10ms]
set hb-lost-threshold {integer}
set hbdev {user}
set hc-eth-type {string}
set hello-holddown {integer}
set http-proxy-threshold {user}
set imap-proxy-threshold {user}
set ipsec-phase2-proposal {option1}, {option2}, ...
set key {password}
set l2ep-eth-type {string}
set link-failed-signal [enable|disable]
set load-balance-all [enable|disable]
set logical-sn [enable|disable]
set memory-based-failover [enable|disable]
set memory-compatible-mode [enable|disable]
set memory-failover-flip-timeout {integer}
set memory-failover-monitor-period {integer}
set memory-failover-sample-rate {integer}
set memory-failover-threshold {integer}
set memory-threshold {user}
set mode [standalone|a-a|...]
set monitor {user}
set multicast-ttl {integer}
set nntp-proxy-threshold {user}
set override [enable|disable]
set override-wait-time {integer}
set password {password}
set pingserver-failover-threshold {integer}
set pingserver-flip-timeout {integer}
set pingserver-monitor-interface {user}
set pingserver-secondary-force-reset [enable|disable]
set pop3-proxy-threshold {user}
set priority {integer}
set route-hold {integer}
set route-ttl {integer}
set route-wait {integer}
set schedule [none|leastconnection|...]
set session-pickup [enable|disable]
set session-pickup-connectionless [enable|disable]
set session-pickup-delay [enable|disable]
set session-pickup-expectation [enable|disable]
set session-pickup-nat [enable|disable]
set session-sync-dev {user}
set smtp-proxy-threshold {user}
set ssd-failover [enable|disable]
set standalone-config-sync [enable|disable]
set standalone-mgmt-vdom [enable|disable]
set sync-config [enable|disable]
set sync-packet-balance [enable|disable]
set unicast-gateway {ipv4-address}
set unicast-hb [enable|disable]
set unicast-hb-netmask {ipv4-netmask}
set unicast-hb-peerip {ipv4-address}
config unicast-peers
Description: Number of unicast peers.
edit <id>
set peer-ip {ipv4-address}
next
end
set unicast-status [enable|disable]
set uninterruptible-primary-wait {integer}
set upgrade-mode [simultaneous|uninterruptible|...]
config vcluster
Description: Virtual cluster table.
edit <vcluster-id>
set monitor {user}
set override [enable|disable]
set override-wait-time {integer}
set pingserver-failover-threshold {integer}
set pingserver-flip-timeout {integer}
set pingserver-monitor-interface {user}
set pingserver-secondary-force-reset [enable|disable]
set priority {integer}
set vdom <name1>, <name2>, ...
next
end
set vcluster-status [enable|disable]
set weight {user}
end
config system ha
|
Parameter |
Description |
Type |
Size |
Default |
||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
arps |
Number of gratuitous ARPs (1 - 60). Lower to reduce traffic. Higher to reduce failover time. |
integer |
Minimum value: 1 Maximum value: 60 |
5 |
||||||||||||||||||||||||||||||||
|
arps-interval |
Time between gratuitous ARPs (1 - 20 sec). Lower to reduce failover time. Higher to reduce traffic. |
integer |
Minimum value: 1 Maximum value: 20 |
8 |
||||||||||||||||||||||||||||||||
|
authentication |
Enable/disable heartbeat message authentication. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
auto-virtual-mac-interface |
The physical interface that will be assigned an auto-generated virtual MAC address. Interface name. |
string |
Maximum length: 15 |
|
||||||||||||||||||||||||||||||||
|
backup-hbdev |
Backup heartbeat interfaces. Must be the same for all members. Interface name. |
string |
Maximum length: 79 |
|
||||||||||||||||||||||||||||||||
|
check-secondary-dev-health |
Enable/disable secondary dev health check for session load-balance in HA A-A mode. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
cpu-threshold |
Dynamic weighted load balancing CPU usage weight and high and low thresholds. |
user |
Not Specified |
|
||||||||||||||||||||||||||||||||
|
encryption |
Enable/disable heartbeat message encryption. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
evpn-ttl |
HA EVPN FDB TTL on primary box (5 - 3600 sec). |
integer |
Minimum value: 5 Maximum value: 3600 |
60 |
||||||||||||||||||||||||||||||||
|
failover-hold-time |
Time to wait before failover (0 - 300 sec, default = 0), to avoid flip. |
integer |
Minimum value: 0 Maximum value: 300 |
0 |
||||||||||||||||||||||||||||||||
|
ftp-proxy-threshold |
Dynamic weighted load balancing weight and high and low number of FTP proxy sessions. |
user |
Not Specified |
|
||||||||||||||||||||||||||||||||
|
gratuitous-arps |
Enable/disable gratuitous ARPs. Disable if link-failed-signal enabled. |
option |
- |
enable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
group-id |
HA group ID (0 - 1023; or 0 - 7 when there are more than 2 vclusters). Must be the same for all members. |
integer |
Minimum value: 0 Maximum value: 1023 |
0 |
||||||||||||||||||||||||||||||||
|
group-name |
Cluster group name. Must be the same for all members. |
string |
Maximum length: 32 |
|
||||||||||||||||||||||||||||||||
|
ha-direct |
Enable/disable using ha-mgmt interface for syslog, remote authentication (RADIUS), FortiAnalyzer, FortiSandbox, sFlow, and Netflow. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
ha-eth-type |
HA heartbeat packet Ethertype (4-digit hex). |
string |
Maximum length: 4 |
8890 |
||||||||||||||||||||||||||||||||
|
ha-mgmt-status |
Enable to reserve interfaces to manage individual cluster units. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
ha-uptime-diff-margin |
Normally you would only reduce this value for failover testing. |
integer |
Minimum value: 1 Maximum value: 65535 |
300 |
||||||||||||||||||||||||||||||||
|
hb-interval |
Time between sending heartbeat packets (1 - 20). Increase to reduce false positives. |
integer |
Minimum value: 1 Maximum value: 20 |
2 |
||||||||||||||||||||||||||||||||
|
hb-interval-in-milliseconds |
Units of heartbeat interval time between sending heartbeat packets. Default is 100ms. |
option |
- |
100ms |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
hb-lost-threshold |
Number of lost heartbeats to signal a failure (1 - 60). Increase to reduce false positives. |
integer |
Minimum value: 1 Maximum value: 60 |
6 ** |
||||||||||||||||||||||||||||||||
|
hbdev |
Heartbeat interfaces. Must be the same for all members. Enter <interface> <priority> pairs to specify the priority of each heartbeat interface. Higher priority takes precedence. |
user |
Not Specified |
|
||||||||||||||||||||||||||||||||
|
hc-eth-type |
Transparent mode HA heartbeat packet Ethertype (4-digit hex). |
string |
Maximum length: 4 |
8891 |
||||||||||||||||||||||||||||||||
|
hello-holddown |
Time to wait before changing from hello to work state (5 - 300 sec). |
integer |
Minimum value: 5 Maximum value: 300 |
20 |
||||||||||||||||||||||||||||||||
|
http-proxy-threshold |
Dynamic weighted load balancing weight and high and low number of HTTP proxy sessions. |
user |
Not Specified |
|
||||||||||||||||||||||||||||||||
|
imap-proxy-threshold |
Dynamic weighted load balancing weight and high and low number of IMAP proxy sessions. |
user |
Not Specified |
|
||||||||||||||||||||||||||||||||
|
ipsec-phase2-proposal |
IPsec phase2 proposal. |
option |
- |
|
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
key |
Key. |
password |
Not Specified |
|
||||||||||||||||||||||||||||||||
|
l2ep-eth-type |
Telnet session HA heartbeat packet Ethertype (4-digit hex). |
string |
Maximum length: 4 |
8893 |
||||||||||||||||||||||||||||||||
|
link-failed-signal |
Enable to shut down all interfaces for 1 sec after a failover. Use if gratuitous ARPs do not update network. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
load-balance-all |
Enable to load balance TCP sessions. Disable to load balance proxy sessions only. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
logical-sn * |
Enable/disable usage of the logical serial number. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
memory-based-failover |
Enable/disable memory based failover. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
memory-compatible-mode |
Enable/disable memory compatible mode. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
memory-failover-flip-timeout |
Time to wait between subsequent memory based failovers in minutes (6 - 2147483647, default = 6). |
integer |
Minimum value: 6 Maximum value: 2147483647 |
6 |
||||||||||||||||||||||||||||||||
|
memory-failover-monitor-period |
Duration of high memory usage before memory based failover is triggered in seconds (1 - 300, default = 60). |
integer |
Minimum value: 1 Maximum value: 300 |
60 |
||||||||||||||||||||||||||||||||
|
memory-failover-sample-rate |
Rate at which memory usage is sampled in order to measure memory usage in seconds (1 - 60, default = 1). |
integer |
Minimum value: 1 Maximum value: 60 |
1 |
||||||||||||||||||||||||||||||||
|
memory-failover-threshold |
Memory usage threshold to trigger memory based failover (0 means using conserve mode threshold in system.global). |
integer |
Minimum value: 0 Maximum value: 95 |
0 |
||||||||||||||||||||||||||||||||
|
memory-threshold |
Dynamic weighted load balancing memory usage weight and high and low thresholds. |
user |
Not Specified |
|
||||||||||||||||||||||||||||||||
|
mode |
HA mode. Must be the same for all members. FGSP requires standalone. |
option |
- |
standalone |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
monitor |
Interfaces to check for port monitoring (or link failure). |
user |
Not Specified |
|
||||||||||||||||||||||||||||||||
|
multicast-ttl |
HA multicast TTL on primary (5 - 3600 sec). |
integer |
Minimum value: 5 Maximum value: 3600 |
600 |
||||||||||||||||||||||||||||||||
|
nntp-proxy-threshold |
Dynamic weighted load balancing weight and high and low number of NNTP proxy sessions. |
user |
Not Specified |
|
||||||||||||||||||||||||||||||||
|
override |
Enable and increase the priority of the unit that should always be primary (master). |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
override-wait-time |
Delay negotiating if override is enabled (0 - 3600 sec). Reduces how often the cluster negotiates. |
integer |
Minimum value: 0 Maximum value: 3600 |
0 |
||||||||||||||||||||||||||||||||
|
password |
Cluster password. Must be the same for all members. |
password |
Not Specified |
|
||||||||||||||||||||||||||||||||
|
pingserver-failover-threshold |
Remote IP monitoring failover threshold (0 - 50). |
integer |
Minimum value: 0 Maximum value: 50 |
0 |
||||||||||||||||||||||||||||||||
|
pingserver-flip-timeout |
Time to wait in minutes before renegotiating after a remote IP monitoring failover. |
integer |
Minimum value: 6 Maximum value: 2147483647 |
60 |
||||||||||||||||||||||||||||||||
|
pingserver-monitor-interface |
Interfaces to check for remote IP monitoring. |
user |
Not Specified |
|
||||||||||||||||||||||||||||||||
|
pingserver-secondary-force-reset |
Enable to force the cluster to negotiate after a remote IP monitoring failover. |
option |
- |
enable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
pop3-proxy-threshold |
Dynamic weighted load balancing weight and high and low number of POP3 proxy sessions. |
user |
Not Specified |
|
||||||||||||||||||||||||||||||||
|
priority |
Increase the priority to select the primary unit (0 - 255). |
integer |
Minimum value: 0 Maximum value: 255 |
128 |
||||||||||||||||||||||||||||||||
|
route-hold |
Time to wait between routing table updates to the cluster (0 - 3600 sec). |
integer |
Minimum value: 0 Maximum value: 3600 |
10 |
||||||||||||||||||||||||||||||||
|
route-ttl |
TTL for primary unit routes (5 - 3600 sec). Increase to maintain active routes during failover. |
integer |
Minimum value: 5 Maximum value: 3600 |
10 |
||||||||||||||||||||||||||||||||
|
route-wait |
Time to wait before sending new routes to the cluster (0 - 3600 sec). |
integer |
Minimum value: 0 Maximum value: 3600 |
0 |
||||||||||||||||||||||||||||||||
|
schedule |
Type of A-A load balancing. Use none if you have external load balancers. |
option |
- |
round-robin |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
session-pickup |
Enable/disable session pickup. Enabling it can reduce session down time when fail over happens. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
session-pickup-connectionless |
Enable/disable UDP and ICMP session sync. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
session-pickup-delay |
Enable to sync sessions longer than 30 sec. Only longer lived sessions need to be synced. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
session-pickup-expectation |
Enable/disable session helper expectation session sync for FGSP. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
session-pickup-nat |
Enable/disable NAT session sync for FGSP. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
session-sync-dev |
Offload session-sync process to kernel and sync sessions using connected interface(s) directly. |
user |
Not Specified |
|
||||||||||||||||||||||||||||||||
|
smtp-proxy-threshold |
Dynamic weighted load balancing weight and high and low number of SMTP proxy sessions. |
user |
Not Specified |
|
||||||||||||||||||||||||||||||||
|
ssd-failover * |
Enable/disable automatic HA failover on SSD disk failure. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
standalone-config-sync |
Enable/disable FGSP configuration synchronization. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
standalone-mgmt-vdom |
Enable/disable standalone management VDOM. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
sync-config |
Enable/disable configuration synchronization. |
option |
- |
enable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
sync-packet-balance |
Enable/disable HA packet distribution to multiple CPUs. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
unicast-gateway * |
Default route gateway for unicast interface. |
ipv4-address |
Not Specified |
0.0.0.0 |
||||||||||||||||||||||||||||||||
|
unicast-hb * |
Enable/disable unicast heartbeat. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
unicast-hb-netmask * |
Unicast heartbeat netmask. |
ipv4-netmask |
Not Specified |
0.0.0.0 |
||||||||||||||||||||||||||||||||
|
unicast-hb-peerip * |
Unicast heartbeat peer IP. |
ipv4-address |
Not Specified |
0.0.0.0 |
||||||||||||||||||||||||||||||||
|
unicast-status * |
Enable/disable unicast connection. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
uninterruptible-primary-wait |
Number of minutes the primary HA unit waits before the secondary HA unit is considered upgraded and the system is started before starting its own upgrade (15 - 300, default = 30). |
integer |
Minimum value: 15 Maximum value: 300 |
30 |
||||||||||||||||||||||||||||||||
|
upgrade-mode |
The mode to upgrade a cluster. |
option |
- |
uninterruptible |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
vcluster-status |
Enable/disable virtual cluster for virtual clustering. |
option |
- |
disable |
||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||
|
weight |
Weight-round-robin weight for each cluster unit. Syntax <priority> <weight>. |
user |
Not Specified |
0 40 |
||||||||||||||||||||||||||||||||
* This parameter may not exist in some models.
** Values may differ between models.
config ha-mgmt-interfaces
|
Parameter |
Description |
Type |
Size |
Default |
|---|---|---|---|---|
|
dst |
Default route destination for reserved HA management interface. |
ipv4-classnet |
Not Specified |
0.0.0.0 0.0.0.0 |
|
gateway |
Default route gateway for reserved HA management interface. |
ipv4-address |
Not Specified |
0.0.0.0 |
|
gateway6 |
Default IPv6 gateway for reserved HA management interface. |
ipv6-address |
Not Specified |
:: |
|
id |
Table ID. |
integer |
Minimum value: 0 Maximum value: 4294967295 |
0 |
|
interface |
Interface to reserve for HA management. |
string |
Maximum length: 15 |
|
config unicast-peers
|
Parameter |
Description |
Type |
Size |
Default |
|---|---|---|---|---|
|
id |
Table ID. |
integer |
Minimum value: 0 Maximum value: 4294967295 |
0 |
|
peer-ip |
Unicast peer IP. |
ipv4-address |
Not Specified |
0.0.0.0 |
config vcluster
|
Parameter |
Description |
Type |
Size |
Default |
||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
monitor |
Interfaces to check for port monitoring (or link failure). |
user |
Not Specified |
|
||||||
|
override |
Enable and increase the priority of the unit that should always be primary (master). |
option |
- |
disable |
||||||
|
|
|
|||||||||
|
override-wait-time |
Delay negotiating if override is enabled (0 - 3600 sec). Reduces how often the cluster negotiates. |
integer |
Minimum value: 0 Maximum value: 3600 |
0 |
||||||
|
pingserver-failover-threshold |
Remote IP monitoring failover threshold (0 - 50). |
integer |
Minimum value: 0 Maximum value: 50 |
0 |
||||||
|
pingserver-flip-timeout |
Time to wait in minutes before renegotiating after a remote IP monitoring failover. |
integer |
Minimum value: 6 Maximum value: 2147483647 |
60 |
||||||
|
pingserver-monitor-interface |
Interfaces to check for remote IP monitoring. |
user |
Not Specified |
|
||||||
|
pingserver-secondary-force-reset |
Enable to force the cluster to negotiate after a remote IP monitoring failover. |
option |
- |
enable |
||||||
|
|
|
|||||||||
|
priority |
Increase the priority to select the primary unit (0 - 255). |
integer |
Minimum value: 0 Maximum value: 255 |
128 |
||||||
|
vcluster-id |
ID. |
integer |
Minimum value: 1 Maximum value: 30 |
1 |
||||||
|
vdom |
Virtual domain(s) in the virtual cluster. Virtual domain name. |
string |
Maximum length: 79 |
|
||||||