Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


Replace a Switch

You can replace a switch in your Juniper Mist™ network from the switch details page without disrupting network services.

Before replacing a switch, ensure the following:

  • The old switch that needs to be replaced is claimed or adopted by your organization and is assigned to a site. This switch can be in Connected or Disconnected state.

  • The new switch being added is not assigned to any site in the organization. Furthermore, the new switch is listed on the Inventory page with the status Unassigned.

To replace a switch:

  1. Click Switches on the left navigation pane of the Mist portal.
  2. On the list tab, click the switch that needs to be replaced.
    The switch details page appears.
  3. Select the Replace Switch option from the Utilities drop-down list on the details.
  4. From the MAC Address of the unassigned switch drop-down list, select the MAC address of the unassigned switch. This is the replacement switch—the switch you will use to replace the switch that you selected in Step 2. If the Mist network doesn't include any unassigned switches, the Mist portal doesn't display unassigned switches. In that case, this drop-down list doesn't show any MAC addresses.

    By default, Mist copies the configuration of the existing switch to the new switch. To discard any specific configurations that you don't want to copy to the new switch, select the appropriate check boxes on the Replace Switch window.

    If the new switch has a different number of ports than the switch being replaced, Mist discards the port configuration automatically. If the current switch template on the site doesn't cover the configuration requirement of your new switch, we recommend that you assign a different template. Assign your site a template with a configuration that meets the requirements of the new switch. See Configure Switches.

  5. Click Replace.
    When Mist replaces the switch, the new switch takes the place of the old switch on the Mist portal. The status of the old switch changes to Unassigned. You can view the old switch on the Inventory page.
Switch replacement using APIs

To replace a switch using APIs, make a POST API call as shown in the example below:

On the discard list, you can specify the attributes that you do not want to copy to the new switch configuration. If the discard list is blank, Mist copies all the existing switch attributes from the old switch to the new switch.

  • If a switch with a higher number of ports is being replaced with a switch with a lower number of ports, the port configuration is applied only to the ports with overlapping port numbers. The rest of the port configurations are discarded.

  • If a switch with mge ports is being replaced with a switch with ge ports or vice versa, the port configurations are not applied to the switch.