Usb Assistant Tool is a very useful way to check your device identification before registering or to solve problems in your edge node network access.
In case your edge node does not appear as connected in Panel, it may be caused by two different reasons:
- The deviceId provided to Panel is incorrect.
- Your edge node cannot connect to the internet because of some network issue (wrong configuration, DNS problems, no gateway available, etc).
In those cases, a debugging tool is necessary to check the problem easily. In Barbara edge nodes you can use a simple USB pen drive to access this information.
Prepare your USB Pendrive
Your USB pen drive MUST be formatted in FAT32 format.
You can check your USB pen drive file format by following the next steps:
- Insert the USB pen drive into your laptop.
- Go to File Manager, search for the unit of the USB pen drive and make right-click over it.
- Select “properties” in the menu and check “File system” in General Tab.
In case your USB pen drive has another file format you will need to format it by selecting the “FAT32” file system:
- In File Manager, make right-click again over the icon of your USB pen drive to make the menu appear. Then, press “Format”.
- In the format menu, select “FAT32” file format.
Insert your USB Pendrive in your Node Edge
The USB Debugging Tool will be available after the first boot-up process, which may take up to 10 minutes to finish the first time you power on your edge node.
Once your edge node has finished the bootup process the USB Debugging Tool is ready. In that case, just insert your USB pen drive into your node and wait 20 seconds. Then, just extract it. All the debugging information is ready to be analyzed.
Check BarbaraID, OS Version, Network status and Docker Support of your edge node
Once you insert again your USB Pendrive into your laptop, you will see a new folder “barbara” in the root folder of your pen drive.
File “barbarainfo.txt”
Inside that folder, a file called “barbarainfo.txt” will be available:
Open this file with a text editor, you will see the following information:
Timestamp:
1668447480
Barbara ID:
bt3pro-XXXXXXXXXXXX
Barbara OS version:
4.1.0
Barbara OS UTC:
1663987840
Network info:
Iface name: lo IP: 127.0.0.1/8
Iface name: lo IP: ::1/128
Iface name: eth0 IP: 172.16.50.78/24
Iface name: eth0 IP: fe80::a2c4:a02b:e863:8df/64
Iface name: wlan0 IP: 172.16.50.152/24
Iface name: wlan0 IP: fe80::653c:945d:556e:c782/64
Iface name: br-f65c41cbb749 IP: 172.19.0.1/16
Iface name: br-f65c41cbb749 IP: fe80::42:77ff:fea2:7305/64
Iface name: docker0 IP: 172.17.0.1/16
Iface name: br-7fcbe17829ab IP: 172.18.0.1/16
Connectivity status:
NmStateConnectedGlobal
Docker support:
true
Timestamp
This field contains the device time when the “barbarainfo.txt” file was saved to USB pen drive. This information is recorded in Unix timestamp format.
Timestamp:
1668596989
Unix time is a date and time representation widely used in computing. It measures time by the number of seconds that have elapsed since 00:00:00 UTC on 1 January 1970, the beginning of the Unix epoch.
https://en.wikipedia.org/wiki/Unix_time
If you need to convert to a human-readable format, you can use an online tool like:
Barbara ID
This field is the edge node identifier in Barbara system, also called “Device Id”.
Barbara ID:
bt3pro-XXXXXXXXXXXX
You can check it in the “Device Details” view in Barbara Panel.
This identifier is unique for every edge node and it’s mandatory for registering a device in Panel.
In case your device does not appear as “online” after registration in Barbara Panel, check that the device_Id that appears in Panel is the same as the one in this file.
If they are different, delete the edge node in Barbara and register it again with this “Barbara Id” information.
Barbara OS Version
Information of the OS Version installed in the edge node.
Barbara OS version:
4.1.0
You can check the OS Version in PANEL in the “Device details” view, by just pressing the button “Update OS Version”, as you can see below:
Barbara OS UTC
Identifier of the Barbara OS Version installed in the edge node.
Barbara OS UTC:
1663987840
Network Info
List of all connected network interfaces and their IP address.
Network info:
Iface name: lo IP: 127.0.0.1/8
Iface name: lo IP: ::1/128
Iface name: eth0 IP: 172.16.50.78/24
Iface name: eth0 IP: fe80::9656:54ba:cc94:69cb/64
Iface name: wwan0 IP: 172.16.50.78/24
Iface name: wwan0 IP: fe80::9656:54ba:cc94:69cb/64
Iface name: docker0 IP: 172.17.0.1/16
Iface name: docker0 IP: fe80::42:13ff:feee:9788/64
In this list you will find two lines for every interface connected containing:
- Iface Name: name of the detected interface in both lines.
- IPv4 of every interface in the first line.
- IPv6 of every interface in the second line.
Connectivity Status
In this item, you will find your actual network status.
Connectivity status:
NmStateConnectedGlobal
If the device is successfully connected the status must be “NmStateConnectedGlobal“.
In case your edge node does not go online, you can check this item to have more information about the problem. There are different statuses that will allow you to debug the problem and find the proper solution:
- NmStateUnknown: Networking state is unknown. This indicates a daemon error that makes it unable to reasonably assess the state.
- NmStateAsleep: Networking is not enabled, the system is being suspended or resumed from suspension.
- NmStateDisconnected: There is no active network connection.
- NmStateDisconnecting: Network connections are being cleaned up.
- NmStateConnecting: A network connection is being started
- NmStateConnectedLocal: There is only local IPv4 and/or IPv6 connectivity, but no default route to access the Internet.
- NmStateConnectedSite: There is only site-wide IPv4 and/or IPv6 connectivity. This means a default route is available, but the Internet connectivity check (see “Connectivity” property) did not succeed.
- NmStateConnectedGlobal: There is global IPv4 and/or IPv6 Internet connectivity This means the Internet connectivity check succeeded.
Docker Support
This field indicates (true/false) if the current edge node is docker compatible or not.
Docker support:
true
File “[deviceId]-CurrentNetworkConfig.json”
This file will only be available in case the edge node is offline.
This file is a JSON file that contains information about the current configuration applied to available interfaces.
[
{
"eth0": {
"dns": "none",
"gateway": "none",
"ip": "none",
"metric": 2,
"netmask": "none",
"type": "ethernet"
}
},
{
"wlan0": {
"dns": "none",
"gateway": "none",
"ip": "none",
"metric": 1,
"netmask": "none",
"psk": "none",
"ssid": "none",
"type": "wlan"
}
}
]
File “[deviceId]-NetworkTemplate.json”
This file will only be available in case the edge node is offline.
This file is a template to add a configuration for available interfaces. This is a way to solve the network problems, the process will be explained in the next point.
[
{
"wlan0": {
"dns": "",
"gateway": "",
"ip": "",
"metric": 1,
"netmask": "",
"psk": "",
"ssid": "",
"type": "wlan"
}
},
{
"eth0": {
"dns": "",
"gateway": "",
"ip": "",
"metric": 2,
"netmask": "",
"type": "ethernet"
}
}
]
Adding a configuration to the edge node.
Network configuration via USB Assistant Tool is a valuable way to fix network problems.
In those cases in which the node is not connected and we cannot configure it from PANEL, we can use the USB Assistant Tool to change the configuration of any detected interface.
- Open file “[deviceId]-networkTemplate.json” with an editor and modify the necessary parameters of the interface you want to configure. Leave empty those parameters that are not mandatory.
- In case you only need to configure the current device, save this modified file as “[deviceId]-network.json”. For example, if your deviceId is “bt3pro-XXXXXXXXXXXX”, you must save it as “bt3pro-XXXXXXXXXXXX-network.json”.
- In case you need to configure several devices using the same USB, save this modified file just as “network.json”. These “network.json” settings will apply to any device, as long as the file “[deviceId]-network.json” does not exist in the folder.
- Insert the USB in your edge node and wait around 30 seconds. If the provided configuration is correct the device will go online.
In those cases when even changing network configuration via USB Assistant Tool the edge node is not connected, check the “BarbaraInfo.txt” file. The field “Connectivity Status” will provide more information about the causes of the problem.