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 details page help you troubleshoot and test your switch.

To access the switch utilities:

  1. On the Mist portal, click Switches on the left pane.

  2. Click a switch from the List tab to open the switch details page.

  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. You can download a log of your remote shell session by clicking the download button in the upper right portion of the Remote Shell session.

  • 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 details page.

  • Upgrade Firmware—Upgrade switches directly from the switch details page. 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:

    For more information, see Upgrade Junos OS Software on Your Switch.

  • Create Template—Create a switch configuration template based on the switch configuration. See also: Create a Switch Configuration Template.

  • Snapshot Device—Store a recovery snapshot in the OAM (Operations, Administrations and Maintenance) volume. The recovery snapshot in the OAM volume can be used to boot the switch in case of corrupt configuration or firmware update failure.

  • 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. For more information, see Replace a Switch.

    Note:

    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.

  • Sync Configuration—Sometimes, the configuration push to a switch might fail for various reasons. In such cases, you can use this option to resend the configuration to the switch. The Sync Configuration operation will overwrite any configuration defined on the switch manually through the CLIs.

Related Documentation