Fortinet black logo

CLI Reference

ha manage

ha manage

Use this command from the CLI of a FortiGate unit in an HA cluster to log into the CLI of another unit in the cluster. Usually you would use this command from the CLI of the primary unit to log into the CLI of a subordinate unit. However, if you have logged into a subordinate unit CLI, you can use this command to log into the primary unit CLI, or the CLI of another subordinate unit.

You can use CLI commands to manage the cluster unit that you have logged into. If you make changes to the configuration of any cluster unit (primary or subordinate unit) these changes are synchronized to all cluster units.

Syntax

execute ha manage  Slave cluster index.
        {string}   Slave cluster index.

Selecting the unit to log into

To select the unit to log into you enter its operating cluster index. The operating cluster index is assigned by the FGCP according to cluster unit serial number. The cluster unit with the highest serial number has an operating cluster index of 0. The cluster unit with the second highest serial number has an operating cluster index of 1 and so on.

Enter ? to list the operating cluster indexes of the cluster units that you can log into. The list does not show the unit that you are already logged into.

Example

This example shows how to log into a subordinate unit in a cluster of three FortiGate units. In this example, you have already logged into the primary unit. The primary unit has serial number FGT3082103000056. The subordinate units have serial numbers FGT3012803021709 and FGT3082103021989.

execute ha manage ?

<id> please input slave cluster index.

<0> Subsidary unit FGT3012803021709

<1> Subsidary unit FGT3082103021989

Type 0 and press enter to connect to the subordinate unit with serial number FGT3012803021709 and log in with a valid administrator account. The CLI prompt changes to the host name of this unit. To return to the primary unit, type exit.

From the subordinate unit you can also use the execute ha manage command to log into the primary unit or into another subordinate unit. Enter the following command:

execute ha manage ?

<id> please input slave cluster index.

<1> Subsidary unit FGT3082103021989

<2> Subsidary unit FGT3082103000056

Type 2 and press enter to log into the primary unit or type 1 and press enter to log into the other subordinate unit with a valid administrator account. The CLI prompt changes to the host name of this unit.

ha manage

Use this command from the CLI of a FortiGate unit in an HA cluster to log into the CLI of another unit in the cluster. Usually you would use this command from the CLI of the primary unit to log into the CLI of a subordinate unit. However, if you have logged into a subordinate unit CLI, you can use this command to log into the primary unit CLI, or the CLI of another subordinate unit.

You can use CLI commands to manage the cluster unit that you have logged into. If you make changes to the configuration of any cluster unit (primary or subordinate unit) these changes are synchronized to all cluster units.

Syntax

execute ha manage  Slave cluster index.
        {string}   Slave cluster index.

Selecting the unit to log into

To select the unit to log into you enter its operating cluster index. The operating cluster index is assigned by the FGCP according to cluster unit serial number. The cluster unit with the highest serial number has an operating cluster index of 0. The cluster unit with the second highest serial number has an operating cluster index of 1 and so on.

Enter ? to list the operating cluster indexes of the cluster units that you can log into. The list does not show the unit that you are already logged into.

Example

This example shows how to log into a subordinate unit in a cluster of three FortiGate units. In this example, you have already logged into the primary unit. The primary unit has serial number FGT3082103000056. The subordinate units have serial numbers FGT3012803021709 and FGT3082103021989.

execute ha manage ?

<id> please input slave cluster index.

<0> Subsidary unit FGT3012803021709

<1> Subsidary unit FGT3082103021989

Type 0 and press enter to connect to the subordinate unit with serial number FGT3012803021709 and log in with a valid administrator account. The CLI prompt changes to the host name of this unit. To return to the primary unit, type exit.

From the subordinate unit you can also use the execute ha manage command to log into the primary unit or into another subordinate unit. Enter the following command:

execute ha manage ?

<id> please input slave cluster index.

<1> Subsidary unit FGT3082103021989

<2> Subsidary unit FGT3082103000056

Type 2 and press enter to log into the primary unit or type 1 and press enter to log into the other subordinate unit with a valid administrator account. The CLI prompt changes to the host name of this unit.