Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


Switch Utilities

The Switch Utilities on the switch dashboard help you troubleshoot and test your switch.

To access the switch utilities:

  1. Click Switches on the left pane in the Mist portal.

  2. Click a switch from the List tab.

  3. Select the utility or tool from the Utilities drop-down list on the upper right of the page.

The switch utilities include the following tools:

  • Testing tools—Use the switch testing tools to check the switch connectivity and monitor the switch health. The following tools are available:

    • Ping—Check the host reachability and network connectivity. To run the test, specify a hostname and then click Ping. You can also specify the number of packets to be transmitted in the test.

    • Traceroute—View the route that packets take to a specified network host. Use this option as a debugging tool to locate the points of failure in a network. To run the test, specify a hostname, port, and a timeout value, and then click Traceroute.

    • Cable Test —Run a Cable Test on a port to monitor the connection health of the cable on the specified port. To run the test, specify the interface name (example: ge-0/0/4) and then click Cable Test. This action runs a time domain reflectometry (TDR) diagnostic test on the specified interface and displays results. A TDR test characterizes and locates faults on twisted-pair Ethernet cables. For example, it can detect a broken twisted pair and provide the approximate distance to the break. It can also detect polarity swaps, pair swaps, and excessive skew.

    • Bounce Port—Restart any unresponsive ports on your switch. To restart a port, specify the interface name (example: ge-0/0/4) and then click Bounce Port.

  • Remote Shell—Access the command line directly through the Mist portal. You can enter commands on the switch's CLI without making a physical connection to the console port or using SSH.

  • Send Switch Log to Mist—When you experience an issue with a switch, use this option to securely send the switch logs to Mist. The Juniper Mist support team uses these logs to understand the issue and provide troubleshooting support.

  • Reboot Switch—Reboot the switch directly from the Switch dashboard.

  • Upgrade Firmware—Upgrade switches directly from Switch dashboard. Before performing an upgrade, ensure that the switch has enough storage and a stable SSH connectivity to Mist cloud. If the switch doesn't have enough space, the upgrade will fail. To free up the space, run the following command as a root user:

  • Create Template—Create a switch configuration template based on the switch configuration.

  • Snapshot Device—Store a recovery snapshot in the OAM (Operations, Administrations and Maintenance) volume, which holds a full backup that can be used in case something goes wrong with the switch configuration.

  • Download Junos Config—Use this tool to download the switch's Junos configuration in a text file.

  • Replace Switch—Replace a switch without disrupting the network services on your network topology. By default, this action copies the existing switch configuration to the new switch. You can also choose to discard specific configurations that you don't want to copy to the new switch.


    If the new switch has a different number of ports than the switch being replaced, the port configuration is discarded. If the current switch template doesn't cover the configuration requirement of your new switch, we recommend that you assign your site with a different template that covers the new switch. See Configure Switches.