Advanced Device Troubleshooting

Advanced device check aims to identify, diagnose, and debug issues on your device at an advanced level using commands. The Commands tab on the Tools page lists commands specific to a particular device to test the device entity and collect results based on your selection. When a troubleshooting operation is initiated, Aruba Central establishes a session with the devices selected for the troubleshooting operation and displays the output in the Device Output section.

To perform advanced troubleshooting on devices, complete the following steps:

1. In the Network Operations app, select one of the following options:

To select a group, label, site, or all devices in the filter, set the filter to one of the options under Groups, Labels, or Sites. For all devices, set the filter to Global.

The dashboard context for the selected filter is displayed.

To select a device in the filter:

a. Set the filter to Global.

b. Under Manage, click Devices, and then click Access Points, Switches, or Gateways.

A list of devices is displayed in the List view.

c. Click a device listed under Device Name.

The dashboard context for the device is displayed.

2. Under Analyze > Tools, click the Commands tab.

The Commands page is displayed.

3. Select a device. Network administrators can perform advanced troubleshooting on the following types of devices managed by Aruba Central:

Access Points

Switches

Controllers

Devices which are already running shall not execute newly added commands.

Troubleshooting Access Points

 

Advance troubleshooting is available for both Instant APs and Campus APs. You must have a web-socket connection to run commands on APs.

To troubleshoot APs at an advanced level:

1. In the Network Operations app, select one of the following options:

To select a group, label, site, or all devices in the filter, set the filter to one of the options under Groups, Labels, or Sites. For all devices, set the filter to Global.

The dashboard context for the selected filter is displayed.

To select a device in the filter:

a. Set the filter to Global.

b. Under Manage, click Devices > Access Points.

A list of devices is displayed in the List view.

c. Click an access point listed under Device Name for which you want to perform diagnostic test.

The dashboard context for the access point is displayed.

2. Under Analyze > Tools, click Commands.

3. In the Commands tab, select the device type as Access Point.

4. From the Available Devices drop-down list, select the AP. You can select multiple APs.

5. Select any command category and the Commands pane displays the associated commands.

6. Click Add> to add the selected commands to the Selected Commands pane.

7. (Optional) Enter the client MACMedia Access Control. A MAC address is a unique identifier assigned to network interfaces for communications on a network. or IP address of the selected command and click Apply. If you do not want to apply any filter, click Apply without entering any value in the client MAC or IP address field.

8. (Optional) Select command(s) and click <Remove to remove selected command(s) or click <Remove All to clear the Selected Commands pane.

9. (Optional) To set a frequency for automatically executing the troubleshooting commands:

a. Click the Repeat check box.

b. Specify an interval for executing the troubleshooting commands. You can also specify how frequently the commands must be executed during a given interval.

c. Click Reset to modify the values in all the fields, and Cancel All for canceling all the repeats. Click the stop icon to stop a particular repeat.

10. Click Run. The output is displayed in the Device Output section.

	Under Category, only CAP Troubleshoot commands can be added to troubleshoot Campus APs. Other categories are applicable for Instant AP.
	To perform advanced troubleshooting on APs, the minimum software version required on Instant APs is 6.4.3.1-4.2.0.3. To perform advanced troubleshooting on Mobility Access Switches, the minimum version support is 7.4.0.6.

Troubleshooting Switches

To troubleshoot switches at an advanced level:

1. In the Network Operations app, select one of the following options:

To select a group, label, site, or all devices in the filter, set the filter to one of the options under Groups, Labels, or Sites. For all devices, set the filter to Global.

The dashboard context for the selected filter is displayed.

To select a device in the filter:

a. Set the filter to Global.

b. Under Manage, click Devices > Switches.

A list of devices is displayed in the List view.

c. Click a switch listed under Device Name for which you want to perform diagnostic test.

The dashboard context for the switch is displayed.

2. Under Analyze > Tools, click Commands.

3. In the Commands tab, select the device type as Switch.

4. From the Available Devices drop-down list, select the switch. You can select multiple switches.

5. Select any command category and the Commands pane displays the associated commands.

6. Click Add> to add the selected commands to the Selected Commands pane.

7. (Optional) Enter the client MAC or IP address of the selected command and click Apply. If you do not want to apply any filter, click Apply without entering any value in the client MAC or IP address field.

8. (Optional) Select command(s) and click <Remove to remove selected command(s) or click <Remove All to clear the Selected Commands pane.

9. (Optional) To set a frequency for automatically executing the troubleshooting commands:

a. Click the Repeat check box.

b. Specify an interval for executing the troubleshooting commands. You can also specify how frequently the commands must be executed during a given interval.

c. Click Reset to modify the values in all the fields, and Cancel All for canceling all the repeats. Click the stop icon to stop a particular repeat.

10. Click Run. The output is displayed in the Device Output section.

Troubleshooting Controllers

You must have a web-socket connection to run commands on controllers.

To troubleshoot Controllers at an advanced level:

1. In the Network Operations app, select one of the following options:

To select a group, label, site, or all devices in the filter, set the filter to one of the options under Groups, Labels, or Sites. For all devices, set the filter to Global.

The dashboard context for the selected filter is displayed.

To select a device in the filter:

a. Set the filter to Global.

b. Under Manage, click Devices > Controllers.

A list of devices is displayed in the List view.

c. Click a switch listed under Device Name for which you want to perform diagnostic test.

The dashboard context for the controller is displayed.

2. Under Analyze > Tools, click Commands.

3. In the Commands tab, select the device type as Controllers.

4. From the Available Devices drop-down list, select the controller. You can select multiple controllers.

5. Select any command category and the Commands pane displays the associated commands.

6. Click Add> to add the selected commands to the Selected Commands pane.

7. If you have selected a command marked with either '*' or '+', enter the filtration parameters as displayed in the Additional Filters dialog box. For more information, see Mandatory filters— Commands marked with '*'.

8. (Optional) Select command(s) and click <Remove to remove selected command(s) or click <Remove All to clear the Selected Commands pane.

9. (Optional) To set a frequency for automatically executing the troubleshooting commands:

a. Click the Repeat check box.

b. Specify an interval for executing the troubleshooting commands. You can also specify how frequently the commands must be executed during a given interval.

c. Click Reset to modify the values in all the fields, and Cancel All for canceling all the repeats. Click the stop icon to stop a particular repeat.

10. Click Run. The output is displayed in the Device Output section.

Filtering Commands

In order to streamline the debug process and avoid huge data generation while troubleshooting, few commands enable Client MAC address, IP Address, and Port filtration. There are two types of filtration available:

Mandatory filters— Commands marked with '*'

1. Based on your device perform the task till step 4.

2. Select the command marked with '*' and click Add.

The Additional Filters dialog box appears.

3. Enter the Client MAC address/ IP Address/ Port number as required.

4. Click Apply.

In case of mandatory filter commands, if you do no enter the filtering parameters in the additional filters dialog box, the command does not get added to the selected command pane and you cannot perform the troubleshooting.

5. (Optional) Click Edit All to reset the filtration parameters for all the commands added in the selected command pane.

Optional filters— Commands marked with '+'

1. Based on your device perform the task till step 4.

2. Select the command marked with '*' and click Add.

The Additional Filters dialog box appears.

3. Enter the Client MAC address/ IP Address/ Port number as required.

4. Click Apply.

In case of optional filter commands, if you do no enter the filtering parameters in the additional filters dialog box, the command still gets added to the selected command pane and you can perform your troubleshooting.

5. (Optional) Click Edit All to reset the filtration parameters for all the commands added in the selected command pane.

Command filtration is not available for CAP Troubleshoot commands.

Viewing the Device Output

After you execute troubleshooting commands on the devices, Aruba Central displays the output in the Device Output section of the Tools page.

If there are multiple devices, select the device for which you want to view the output. It shows the status of the tests as, in progress, complete, and the buffer time.

Output history of device with buffer space issues shall be automatically cleared.

You can perform the following tasks from the Device Output section:

Click Clear to clear the output. You can clear the output for a single device or for all devices. The Clear option is disabled for read-only users.

Click the Search icon to search for text in the output.

Click the Email icon and click Send to send the output as an email. You can also add email recipients in the CC field.

Click the Export to export the command output as a zip file.

Click the maximize icon to maximize the device output pane.

For more information on the output displayed for the CLI commands, see the following documents:

Aruba Instant CLI Reference Guide for Instant AP CLI command output

HPE ArubaOS-Switch Management and Configuration Guide for Aruba Switch CLI command output

ArubaOS 7.4.x CLI Reference Guide for Mobility Access Switches CLI command output