Troubleshoot a Switch Using the CLI

ExtremeCloud IQ Controller provides a remote console to enable diagnostic debugging of ExtremeXOS® switches. To troubleshoot using the EXOS CLI commands, use the remote console to open a live console session to an EXOS switch.

Note

ExtremeCloud IQ Controller remote console to a switch does not support 200 Series switches.

You can initiate remote console to a switch from any ExtremeCloud IQ Controller in an availability pair. A switch deployed in a remote office behind a firewall or Network Address Translation (NAT) is reachable from the ExtremeCloud IQ Controller remote console.

To access the live console from the switch Troubleshooting tab, the ExtremeXOS switch must be in GUI-Mode. To set the switch mode, select the settings button and then select Advanced. For more information on Switch mode, see Access the Switch CLI.

To access the remote console on the Troubleshooting tab:

Go to Monitor > Devices > Switches.
Select an EXOS switch (not the check box).
Select Troubleshooting > Switch Remote Console > Connect.
The switch console opens. Log in with your ExtremeCloud IQ Controller credentials.
To terminate the console session, select Disconnect.

Consider the following about a remote console on the Troubleshooting tab:

One console session is allowed to a switch at a time. Subsequent connection requests to the same switch are rejected.
You can open up to 100 simultaneous remote consoles, each to a separate switch.
It can take up to 60 seconds for the switch to connect.
Avoid modifying the switch configuration from the Troubleshooting tab.
Read-only users of ExtremeCloud IQ Controller cannot access the Troubleshooting tab.
Modifications made during the CLI diagnostics session are not preserved on ExtremeCloud IQ Controller.
After you leave the Troubleshooting tab, the remote session is terminated. There is no history or current status of a connection.

For information on ExtremeXOS CLI commands, see ExtremeXOS documentation.