Fortinet black logo

FortiLink Guide

Defining names for managed switches

Defining names for managed switches

Starting in FortiOS 7.4.0, you can use names for managed FortiSwitch units in switch-controller CLI commands. The user-defined name is also used in the FortiOS GUI and logs. The FortiSwitch unitʼs serial number is saved in a new read-only field.

Follow these rules for defining a managed FortiSwitch name:

  • The name can be a maximum of 16 characters in length.

  • Use numbers (0-9), letters (a-z and A-Z), dashes, and underscores for the managed FortiSwitch name.

When you upgrade from FortiOS 7.4.0, the FortiSwitch unitʼs serial number is used as the managed FortiSwitch name if a managed FortiSwitch name has not been defined. If you downgrade from FortiOS 7.4.0 to FortiOS 6.4.x, the managed FortiSwitch name is changed to the FortiSwitch unitʼs serial number.

Using the GUI
  1. Go to WiFi & Switch Controller > Managed FortiSwitches.

  2. Select an unauthorized FortiSwitch unit and then click Edit.

  3. In the Name field, enter a name for the managed FortiSwitch unit.

  4. Click OK to save the new name.

Using the CLI

config switch-controller managed-switch

rename <FortiSwitch_serial_number> to <managed_FortiSwitch_name>

end

For example:

config switch-controller managed-switch

rename S524DN4K16000116 to Distribution

end

Other CLI changes

In FortiOS 7.4.0, the following CLI changes were made:

  • When you pre-configure a managed switch, you must use the set sn command under config switch-controller managed-switch to store the FortiSwitch serial number. For example:

    config switch-controller managed-switch

    edit switch1

    set sn S524DNTV21000212

    set fsw-wan1-peer fortilink

    set fsw-wan1-admin enable

    next

    end

  • The execute switch-controller get-sync-status switch-id <managed_FortiSwitch_name> command uses the user-defined switch name, and the execute switch-controller get-sync-status serial <FortiSwitch_serial_number> command uses the FortiSwitch serial number. For example:

    • execute switch-controller get-sync-status serial S524DN4K16000116

    • execute switch-controller get-sync-status switch-id Racktray-127

  • There is a new set isl-peer-device-sn command under config switch-controller managed-switch to store the serial number of the ISL peer device. For example:

    config switch-controller managed-switch

    edit Distribution

    config ports

    edit port2

    set isl-local-trunk-name isltrunk1

    set isl-peer-port-name port23

    set isl-peer-device-name islpeerswitch

    set isl-peer-device-sn S124EN5918003682

    next

    end

    next

    end

  • The following switch-controller CLI commands now use the user-defined FortiSwitch name:

    • diagnose switch-controller trigger config-sync <managed_FortiSwitch_name>

    • execute switch-controller get-conn-status

    • execute switch-controller get-physical-conn standard <port_name>

    • execute switch-controller get-sync-status all

    • execute switch-controller get-upgrade-status

Defining names for managed switches

Starting in FortiOS 7.4.0, you can use names for managed FortiSwitch units in switch-controller CLI commands. The user-defined name is also used in the FortiOS GUI and logs. The FortiSwitch unitʼs serial number is saved in a new read-only field.

Follow these rules for defining a managed FortiSwitch name:

  • The name can be a maximum of 16 characters in length.

  • Use numbers (0-9), letters (a-z and A-Z), dashes, and underscores for the managed FortiSwitch name.

When you upgrade from FortiOS 7.4.0, the FortiSwitch unitʼs serial number is used as the managed FortiSwitch name if a managed FortiSwitch name has not been defined. If you downgrade from FortiOS 7.4.0 to FortiOS 6.4.x, the managed FortiSwitch name is changed to the FortiSwitch unitʼs serial number.

Using the GUI
  1. Go to WiFi & Switch Controller > Managed FortiSwitches.

  2. Select an unauthorized FortiSwitch unit and then click Edit.

  3. In the Name field, enter a name for the managed FortiSwitch unit.

  4. Click OK to save the new name.

Using the CLI

config switch-controller managed-switch

rename <FortiSwitch_serial_number> to <managed_FortiSwitch_name>

end

For example:

config switch-controller managed-switch

rename S524DN4K16000116 to Distribution

end

Other CLI changes

In FortiOS 7.4.0, the following CLI changes were made:

  • When you pre-configure a managed switch, you must use the set sn command under config switch-controller managed-switch to store the FortiSwitch serial number. For example:

    config switch-controller managed-switch

    edit switch1

    set sn S524DNTV21000212

    set fsw-wan1-peer fortilink

    set fsw-wan1-admin enable

    next

    end

  • The execute switch-controller get-sync-status switch-id <managed_FortiSwitch_name> command uses the user-defined switch name, and the execute switch-controller get-sync-status serial <FortiSwitch_serial_number> command uses the FortiSwitch serial number. For example:

    • execute switch-controller get-sync-status serial S524DN4K16000116

    • execute switch-controller get-sync-status switch-id Racktray-127

  • There is a new set isl-peer-device-sn command under config switch-controller managed-switch to store the serial number of the ISL peer device. For example:

    config switch-controller managed-switch

    edit Distribution

    config ports

    edit port2

    set isl-local-trunk-name isltrunk1

    set isl-peer-port-name port23

    set isl-peer-device-name islpeerswitch

    set isl-peer-device-sn S124EN5918003682

    next

    end

    next

    end

  • The following switch-controller CLI commands now use the user-defined FortiSwitch name:

    • diagnose switch-controller trigger config-sync <managed_FortiSwitch_name>

    • execute switch-controller get-conn-status

    • execute switch-controller get-physical-conn standard <port_name>

    • execute switch-controller get-sync-status all

    • execute switch-controller get-upgrade-status