3. Open the AnywhereUSB Manager client/software, and verify you're not connected to any Groups on your Hub. If a Group is currently connected, right-click that Group, then chose the "Disconnect from Group" option.
Before continuing, the Status displayed for all Groups should be "No one is using this group" (see below):
4. From the Hub's Web User Interface (WebUI) menu, access the System --> AnywhereUSB Configuration page, then slide the Enable USB debug logging option into the "on" position, and use the Apply button in the upper-right corner of the page to make the settings change take effect.
Note: The Enable USB debug logging feature will turn "off" again if Hub is rebooted - do not reboot the Hub until this testing procedure is complete.
5. Whether or not your Hub is being managed with Digi Remote Manager®, the Central Management option should be turned "off" from the Hub's WebUI menu under System --> Device Configuration --> Central Management, then hitting Apply (see image below). Disabling Central Management is useful to produce the best logging results, by removing logfile traffic associated with this service temporarily (see Important Note below the following image):
(Important Note: The Central Management option setting is persistent across reboots - Digi recommends re-enabling Central Management for all Hubs being provisioned on the Digi Remote Manager IoT Device Management/Monitoring platform.
6. Under the Hub's WebUI menu, open System --> Administration --> Terminal to access the Hub's built-in Console/CommandLine Interface (hereafter referrred to as "CLI"), then login as the admin user. If Shell access has been enabled for the admin login on your device, select the Admin CLI option (see below).
Note: Establishing an SSH connection to the Hub in order to access the CLI can be used instead of the WebUI's Terminal option, when preferred.
7. The Hub's default log size is short where this troubleshooting is concerned, and may wrap quickly after usbtrace is started in the following step (Example: with the default setting "3000", a log can fill in 70 seconds with typical usbtrace-enabled debug traffic).
The debug log size should therefore be increased to increase the liklihood of capturing the event of interest with the following CLI command:
> config system log local max_size 60000
(Important Note: The max_size configuration change is persistent across reboots - Digi recommends changing this value back to the default value (3000) after this procedure is complete, and the results have been provided to Digi Tech Support for analysis. The value can be reverted to default by returning the value of 60000 back to 3000, using a command similar to the above.
8. Start the usbtrace debug log with the following CLI command:
> system usbtrace start
9. In the AnywhereUSB Manager client software, connect to whichever Group(s) will allow access to the USB port(s) where the USB device(s) under investigation will be plugged into (in the next step).
***The next four steps are time-sensitive: Steps 12 - 14 must be completed as soon after the issue has been reproduced (Steps 10 and 11) as possible***
10. Plug the USB device(s) with the "behavior of interest" being tested for into the USB port(s) which will be necessary to replicate the issue.
11. Take any additional steps necessary to reproduce the "failed" state (i.e. the status or issue you're troubleshooting), such as connecting to the USB device with an application which uses the USB device, etc.
12. When the "issue" occurs, immediately take note of the time shown on a local wall clock, phone, etc., and if possible, the amount of time it took to reproduce that state or issue after the usbtrace began. This allows your "behavior of interest" to be cross-referenced within the logfiles created during the next few steps.
13. From the WebUI "Terminal" window, use the following CLI commands (usbtrace will be running) to first stop the usbtrace debugging process, then save the output to a file called capture1.pcap:
system usbtrace stop
> system usbtrace save capture1.pcap
14. While still in the Terminal window, capture a Support Report and write it to the /etc/config/usbtrace folder using the following command:
> system support-report path /etc/config/usbtrace
(All of the preceding CLI commands are visible within the screenshot below)
15. Exit the Terminal mode with command "exit", then "q" for quit as shown below:
Disconnected from Admin CLI
Access selection menu:
a: Admin CLI
Select access or quit [admin] : q
16. Access the File System area via the Hub's WebUI menu as follows: