Skip to main content
zendodg
Staff
Staff
July 22, 2026

Technical Tip: Why it is not possible to rename a FortiSwitch in a Multi-Tenancy Environment

  • July 22, 2026
  • 0 replies
  • 27 views

Description

This article describes why it is not possible to rename a FortiSwitch in a 'Multi-Tenancy' environment.

Scope

FortiGate, FortiSwitch, FortiOS v7.4.x and above.

Solution

'Multi-Tenancy' refers to the process of exporting FortiSwitch ports from a VDOM to another on FortiOS.

The following error is seen upon trying to rename a switch in a 'Multi-Tenancy' environment:

FGT-LAB (managed-switch) # rename S124FPTM12345678 to SwAcceso1
Multi tenancy parent switch S124FPTM12345678 cannot be renamed.
Command fail. Return code 1


This option is blocked because the configuration name in different VDOMS should match in configuration options.

The workaround is to 'un-export' all ports from VDOMs and then export them again.

config switch-controller managed-switch
    edit <switch-id>
        config ports
            edit "portX"
                unset export-to
            next
        end
    next
end


Rename FortiSwitch:

config switch-controller managed-switch
    rename <old-id> to <new-name>
end


And finally, export the FortiSwitch ports to VDOMs again.

    Thought Leadership Security Summit. Outpace New Threats with AI - enhanced defense. Tuesday, Septmeber 15, 8:30 AM - 2:30 PM PT. The Golf Club at Newcastle, WA.
    Fortinet Flag the Hack. Wednesday, August 26, 9:00 AM - 5:00 PM ET, COSM, Atlanta, GA.