Cisco Catalyst SD-WAN Multitenancy Guide, Releases 26.x and Later

PDF

Update SD-WAN Controller placement for a tenant

Updated: June 21, 2026

Want to summarize with AI?

Log in

Describes how to migrate a tenant to a different pair of SD-WAN Controllers by selecting replacement controllers in SD-WAN Manager.

You can migrate a tenant to a different pair of SD-WAN Controller if the currently assigned controllers cannot support the tenant’s revised WAN edge device forecast.

During migration, change one controller at a time to ensure continuous availability and prevent traffic disruption.

Procedure

1.

Log in to SD-WAN Manager as the provider admin user.

2.

From the menu, choose Administration > Tenant Management.

3.

Locate the tenant to migrate and click … next to the tenant organization name.

4.

Click Update Controller Placement.

5.

In the Update Controller Placement slide-in pane, configure these:

  1. Source Controller (currently applied)

    1. Click the drop-down list to view the tenant’s currently assigned controllers.

    2. SD-WAN Managershows reachability and utilization details for each controller:

      • Tenant hosting capacity (max 24 tenants)

      • Used device capacity (max 1000 devices)

      • Memory utilization (%)

      • CPU utilization (%)

    3. Select the check box next to one of the currently assigned controllers.

  2. Destination controller

    1. Click the drop-down list to view available controllers not currently assigned to the tenant.

    2. SD-WAN Manager shows reachability and utilization details for each controller.

      • Tenant hosting capacity (max 24 tenants)

      • Used device capacity (max 1000 devices)

      • Memory utilization (%)

      • CPU utilization (%)

    3. Select the checkbox next to the controller you want to assign.

    Note

    If the selected controller cannot support the tenant’s devices, the update operation fails.

6.

Click Update.

7.

To change the second controller assigned to the tenant, repeat steps 5–6.

SD-WAN Manager starts the Tenant Controller Update task, migrating the tenant details from the previous controller to the new controller.

What to do next

After the task completes successfully, view the updated tenant information, including the assigned SD-WAN Controllers, on Administration > Tenant Management.